.\"
.\" ipptool man page.
.\"
.\" Copyright © 2020-2024 by OpenPrinting.
.\" Copyright © 2010-2019 by Apple Inc.
.\"
.\" Licensed under Apache License v2.0.  See the file "LICENSE" for more
.\" information.
.\"
.TH ipptool 1 "CUPS" "2021-10-20" "OpenPrinting"
.SH "نام (NAME)"
ipptool \- اجرای درخواست‌های پروتکل چاپ اینترنتی (IPP)
.SH "خلاصه دستور (SYNOPSIS)"
.B ipptool
[
.B \-\-help
] [
.B \-\-ippserver
.I filename
] [
.B \-\-stop\-after\-include\-error
] [
.B \-\-version
] [
.B \-4
] [
.B \-6
] [
.B \-C
] [
.B \-E
] [
.B \-I
] [
.B \-L
] [
.B \-P
.I filename.plist
] [
.B \-S
] [
.B \-T
.I seconds
] [
.B \-V
.I version
] [
.B \-X
] [
.B \-c
] [
.B \-d
.I name=value
] [
.B \-f
.I filename
] [
.B \-h
] [
.B \-i
.I seconds
] [
.B \-j
] [
.B \-n
.I repeat-count
] [
.B \-q
] [
.B \-t
] [
.B \-v ]
.I printer-uri
.I testfile
[ ...
.I testfile
]
.SH "توضیحات (DESCRIPTION)"
دستور
.B ipptool
درخواست‌های IPP را به
.I printer-uri
مشخص‌شده ارسال کرده و نتایج را آزمایش و/یا نمایش می‌دهد.
هر
.I testfile
نام‌برده، یک یا چند درخواست را به همراه وضعیت پاسخ مورد انتظار، ویژگی‌ها (attributes) و مقادیر تعریف می‌کند.
خروجی می‌تواند گزارشی به صورت متن ساده، متن قالب‌بندی‌شده، CSV یا XML در خروجی استاندارد باشد، و وضعیت خروج غیرصفر نشان‌دهنده شکست یک یا چند آزمایش است.
قالب
.I testfile
در
.BR ipptoolfile (5)
شرح داده شده است.
.SH "گزینه‌ها (OPTIONS)"
گزینه‌های زیر توسط
.B ipptool
شناسایی می‌شوند:
.TP 5
.B \-\-help
راهنمای برنامه را نمایش می‌دهد.
.TP 5
\fB\-\-ippserver \fIfilename\fR
مشخص می‌کند که نتایج آزمایش باید در فایل ویژگی‌های (attributes)
.B ippserver
نام‌برده نوشته شوند.
.TP 5
.B \-\-stop-after-include-error
به
.B ipptool
اعلام می‌کند در صورت وقوع خطا در یک فایل گنجانده‌شده (included)، متوقف شود. در حالت عادی
.B ipptool
پس از دستورالعمل INCLUDE با آزمایش‌های بعدی ادامه می‌دهد.
.TP 5
.B \-\-version
نسخه در حال استفاده از
.B ipptool
را نمایش می‌دهد.
.TP 5
.B \-4
مشخص می‌کند که
.B ipptool
باید با استفاده از IPv4 به چاپگر یا سرور متصل شود.
.TP 5
.B \-6
مشخص می‌کند که
.B ipptool
باید با استفاده از IPv6 به چاپگر یا سرور متصل شود.
.TP 5
.B \-C
مشخص می‌کند که درخواست‌ها باید با استفاده از هدر HTTP/1.1 با مقدار "Transfer\-Encoding: chunked" ارسال شوند، که برای انطباق در تمامی نسخه‌های IPP الزامی است.
حالت پیش‌فرض برای درخواست‌های دارای فایل پیوست، استفاده از "Transfer\-Encoding: chunked" و برای درخواست‌های بدون فایل پیوست، استفاده از "Content\-Length:" است.
.TP 5
.B \-E
هنگام اتصال به سرور با استفاده از هدر HTTP با عنوان "Upgrade"، رمزنگاری TLS را اجباری می‌کند.
.TP 5
.B \-I
مشخص می‌کند که
.B ipptool
با وجود خطاها به کار خود ادامه دهد.
.TP 5
.B \-L
مشخص می‌کند که درخواست‌ها باید با استفاده از هدر HTTP/1.0 با مقدار "Content\-Length:" ارسال شوند، که برای انطباق در تمامی نسخه‌های IPP الزامی است.
حالت پیش‌فرض برای درخواست‌های دارای فایل پیوست، استفاده از "Transfer\-Encoding: chunked" و برای درخواست‌های بدون فایل پیوست، استفاده از "Content\-Length:" است.
.TP 5
.BI \-P \ filename.plist
مشخص می‌کند که نتایج آزمایش علاوه بر گزارش آزمایشی معمول (\fB\-t\fR)، باید در فایل XML (Apple plist) نام‌برده نیز نوشته شود.
این گزینه با گزینه‌های \fB\-i\fR (فاصله زمانی) و \fB\-n\fR (تعداد تکرار) ناسازگار است.
.TP 5
.B \-S
رمزنگاری اختصاصی TLS را هنگام اتصال به سرور اجباری می‌کند.
.TP 5
.BI \-T \ seconds
مهلت زمانی (تایم‌اوت) درخواست‌های IPP را بر حسب ثانیه مشخص می‌کند.
.TP 5
.BI \-V \ version
نسخه پیش‌فرض IPP مورد استفاده را تعیین می‌کند: 1.0، 1.1، 2.0، 2.1 یا 2.2. اگر مشخص نشود، از نسخه 1.1 استفاده می‌شود.
.TP 5
.B \-X
مشخص می‌کند که خروجی XML (Apple plist) به‌جای گزارش متنی ساده مد نظر است.
این گزینه با گزینه‌های \fB\-i\fR (فاصله زمانی) و \fB\-n\fR (تعداد تکرار) ناسازگار است.
.TP 5
.B \-c
مشخص می‌کند که خروجی CSV (مقادیر جداشده با کاما) به‌جای خروجی متنی ساده مد نظر است.
.TP 5
.BI \-d \ name=value
متغیر نام‌برده را تعریف می‌کند.
.TP 5
.BI \-f \ filename
نام فایل پیش‌فرض درخواست را برای آزمایش‌ها تعریف می‌کند.
.TP 5
.B \-h
اعتبارسنجی هدرهای پاسخ HTTP.
.TP 5
.BI \-i \ seconds
مشخص می‌کند که (آخرین)
.I testfile
باید در فاصله زمانی مشخص‌شده تکرار شود.
این گزینه با گزینه \fB\-X\fR (خروجی XML plist) ناسازگار است.
.TP 5
.B \-j
مشخص می‌کند که
.B ipptool
خروجی JSON تولید خواهد کرد.
.TP 5
.B \-l
مشخص می‌کند که خروجی متنی ساده مورد نظر است.
.TP 5
.BI \-n \ repeat\-count
مشخص می‌کند که (آخرین)
.I testfile
باید به تعداد دفعات مشخص‌شده تکرار شود.
این گزینه با گزینه \fI\-X\fR (خروجی XML plist) ناسازگار است.
.TP 5
.B \-q
بی‌صدا کار کند و هیچ خروجی تولید نکند.
.TP 5
.B \-t
مشخص می‌کند که خروجی گزارش آزمایشی CUPS به‌جای خروجی متنی ساده مورد نظر است.
.TP 5
.B \-v
مشخص می‌کند که تمامی ویژگی‌های (attributes) درخواست و پاسخ باید در حالت آزمایشی CUPS (\fB\-t\fR) در خروجی درج شوند.
این حالت پیش‌فرض برای خروجی XML است.
.SH "وضعیت خروج (EXIT STATUS)"
برنامه
.B ipptool
در صورت موفقیت‌آمیز بودن تمام آزمایش‌ها مقدار 0 و در غیر این صورت مقدار 1 را برمی‌گرداند.
.SH "فایل‌ها (FILES)"
فایل‌های استاندارد زیر در دسترس هستند:
.nf

    color.jpg
    create\-printer\-subscription.test
    document\-a4.pdf
    document\-a4.ps
    document\-letter.pdf
    document\-letter.ps
    get\-completed\-jobs.test
    get\-jobs.test
    get\-notifications.test
    get\-printer\-attributes.test
    get\-subscriptions.test
    gray.jpg
    ipp\-1.1.test
    ipp\-2.0.test
    ipp\-2.1.test
    ipp\-2.2.test
    ipp\-everywhere.test
    onepage\-a4.pdf
    onepage\-a4.ps
    onepage\-letter.pdf
    onepage\-letter.ps
    print\-job.test
    print\-job\-deflate.test
    print\-job\-gzip.test
    testfile.jpg
    testfile.pcl
    testfile.pdf
    testfile.ps
    testfile.txt
    validate\-job.test
.fi
.SH "سازگاری با استانداردها (CONFORMING TO)"
برنامه
.B ipptool
منحصراً متعلق به CUPS است و تا نسخه 2.2 با پروتکل چاپ اینترنتی (Internet Printing Protocol) سازگاری دارد.
.SH "مثال‌ها (EXAMPLES)"
دریافت فهرستی از کارهای تکمیل‌شده برای «myprinter»:
.nf

    ipptool ipp://localhost/printers/myprinter get\-completed\-jobs.test
.fi
.LP
ارسال اعلان‌های ایمیل به «user@example.com» هنگام تغییر در «myprinter»:
.nf

    ipptool \-d recipient=mailto:user@example.com \\
        ipp://localhost/printers/myprinter create\-printer\-subscription.test
.fi
.SH "همچنین ببینید (SEE ALSO)"
.BR ipptoolfile (5),
ثبت‌نام‌های IPP در IANA (https://www.iana.org/assignments/ipp\-registrations),
کارگروه پروتکل چاپ اینترنتی PWG (https://www.pwg.org/ipp),
RFC 8011 (https://datatracker.ietf.org/doc/html/rfc8011)
.SH "حق نشر (COPYRIGHT)"
Copyright \[co] 2020-2024 by OpenPrinting.