.\"
.\" ippeveprinter man page for CUPS.
.\"
.\" Copyright © 2020-2024 by OpenPrinting.
.\" Copyright © 2014-2019 by Apple Inc.
.\"
.\" Licensed under Apache License v2.0.  See the file "LICENSE" for more
.\" information.
.\"
.TH ippeveprinter 1 "CUPS" "2021-02-28" "OpenPrinting"
.SH "نام (NAME)"
ippeveprinter \- برنامه کاربردی چاپگر IPP Everywhere برای cups
.SH "خلاصه دستور (SYNOPSIS)"
.B ippeveprinter
[
.B \-\-help
] [
.B \-\-no\-web\-forms
] [
.B \-\-pam\-service
.I service
] [
.B \-\-version
] [
.B \-2
] [
.B \-A
] [
.B \-D
.I device-uri
] [
.B \-F
.I output-type/subtype
] [
.B \-K
.I keypath
] [
.B \-M
.I manufacturer
] [
.B \-P
.I filename.ppd
] [
.B \-V
.I ipp-version
] [
.B \-a
.I filename.conf
] [
.B \-c
.I command
] [
.B \-d
.I spool-directory
] [
.B \-f
.I type/subtype[,...]
] [
.B \-i
.I iconfile.png
] [
.B \-k
] [
.B \-l
.I location
] [
.B \-m
.I model
] [
.B \-n
.I hostname
] [
.B \-p
.I port
] [
.B \-r
.I subtype[,subtype]
] [
.B \-s
.I speed[,color-speed]
] [
.B \-v[vvv]
]
.I service-name
.SH "توضیحات (DESCRIPTION)"
.B ippeveprinter
یک کارساز پروتکل چاپ اینترنتی (IPP) ساده و سازگار با مشخصات IPP Everywhere (PWG 5100.14) است. از این ابزار می‌توان برای آزمایش نرم‌افزارهای کلاینت یا به عنوان یک کارساز چاپ بسیار پایه استفاده کرد که برای هر کار چاپ‌شده (job)، یک دستور را اجرا می‌کند.
.SH "گزینه‌ها (OPTIONS)"
گزینه‌های زیر توسط
.B ippeveprinter
پشتیبانی می‌شوند:
.TP 5
.B \-\-help
نمایش نحوه استفاده از برنامه.
.TP 5
.B \-\-no\-web\-forms
غیرفعال‌سازی فرم‌های رابط کاربری وب که برای به‌روزرسانی رسانه و میزان مواد مصرفی استفاده می‌شوند.
.TP 5
\fB\-\-pam\-service \fIservice\fR
تنظیم نام سرویس PAM.
سرویس پیش‌فرض "cups" است.
.TP 5
.B \-\-version
نمایش نسخه CUPS.
.TP 5
.B \-2
گزارش پشتیبانی از چاپ دورو (duplex).
.TP 5
.B \-A
فعال‌سازی احراز هویت برای چاپگر ایجادشده.
.B ippeveprinter
از PAM برای احراز هویت اعتبارنامه‌های HTTP Basic استفاده می‌کند.
.TP 5
\fB\-D \fIdevice-uri\fR
تنظیم URI دستگاه برای خروجی چاپ.
این شناسه (URI) می‌تواند نام یک فایل، دایرکتوری، یا یک URI سوکت شبکه به فرم "socket://ADDRESS[:PORT]" باشد (که در آن شماره درگاه پیش‌فرض 9100 است).
در صورت تعیین یک دایرکتوری،
.B ippeveprinter
با استفاده از شناسه و نام کار چاپ، یک فایل خروجی ایجاد خواهد کرد.
.TP 5
\fB\-F \fIoutput-type/subtype[,...]\fR
نوع رسانه MIME خروجی را مشخص می‌کند.
در صورتی که گزینه \fB\-P\fR تعیین شده باشد، مقدار پیش‌فرض "application/postscript" است.
.TP 5
\fB\-M \fImanufacturer\fR
تنظیم سازنده چاپگر.
مقدار پیش‌فرض "Example" است.
.TP 5
\fB\-P \fIfilename.ppd\fR
بارگذاری مشخصه‌های چاپگر از فایل PPD تعیین‌شده.
این گزینه معمولاً همراه با دستور چاپگر
.BR ippeveps (7)
استفاده می‌شود ("\-c ippeveps").
.TP 5
\fB\-V 1.1\fR
.TP 5
\fB\-V 2.0\fR
حداکثر نسخه IPP برای گزارش را تعیین می‌کند.
مقدار 2.0 پیش‌فرض است.
.TP 5
\fB\-c \fIcommand\fR
اجرای دستور مشخص‌شده برای هر سندی که چاپ می‌شود.
اگر "command" یک مسیر مطلق ("/path/to/command") نباشد،
.B ippeveprinter
دستور را در زیرپوشه "command" از دایرکتوری باینری CUPS (معمولاً /usr/lib/cups/command یا /usr/libexec/cups/command) جستجو می‌کند.
از دستور
.BR cups-config (1)
می‌توان برای کشف دایرکتوری باینری صحیح استفاده کرد ("cups-config --serverbin").
علاوه بر این، از متغیر محیطی CUPS_SERVERBIN می‌توان برای بازنویسی مسیر پیش‌فرض این دایرکتوری استفاده نمود — برای جزئیات بیشتر صفحه راهنمای
.BR cups (1)
را ببینید.
.TP 5
\fB\-d \fIspool-directory\fR
دایرکتوری نگه‌داری فایل‌های چاپی را مشخص می‌کند.
مقدار پیش‌فرض، یک دایرکتوری درون دایرکتوری موقت جاری کاربر است.
.TP 5
\fB\-f \fItype/subtype[,...]\fR
فهرستی از انواع رسانه MIME که کارساز می‌پذیرد را مشخص می‌کند.
مقدار پیش‌فرض به نوع چاپگر ایجادشده بستگی دارد.
.TP 5
\fB\-i \fIiconfile.png\fR
فایل آیکون چاپگر را برای کارساز مشخص می‌کند.
این فایل باید تصویری با فرمت PNG باشد.
مقدار پیش‌فرض، یک تصویر PNG ارائه‌شده به صورت داخلی است.
.TP 5
.B \-k
اسناد چاپی را در دایرکتوری صف (spool) نگه می‌دارد و آن‌ها را حذف نمی‌کند.
.TP 5
\fB\-l \fIlocation\fR
رشته موقعیت مکانی خوانا برای انسان را که توسط کارساز گزارش می‌شود، تعیین می‌کند.
مقدار پیش‌فرض، یک رشته خالی است.
.TP 5
\fB\-m \fImodel\fR
نام مدل چاپگر را تعیین می‌کند.
مقدار پیش‌فرض "Printer" است.
.TP 5
\fB\-n \fIhostname\fR
نام میزبانی (hostname) را که توسط کارساز گزارش می‌شود، تعیین می‌کند.
مقدار پیش‌فرض، نام بازگردانده‌شده توسط دستور
.BR hostname (1)
است.
.TP 5
\fB\-p \fIport\fR
شماره درگاهی (port) که باید به آن گوش فرا داده شود را مشخص می‌کند.
مقدار پیش‌فرض، یک شماره اختصاصی کاربر از 8000 تا 8999 است.
.TP 5
.B \-r off
تبلیغات سرویس DNS-SD را به طور کامل غیرفعال می‌کند.
.TP 5
\fB\-r \fIsubtype[,subtype]\fR
زیرنوع‌های (subtypes) DNS-SD برای تبلیغ را مشخص می‌کند.
چندین زیرنوع را با کاما از هم جدا کنید.
مقدار پیش‌فرض "_print" است.
.TP 5
\fB\-s \fIspeed[,color-speed]\fR
سرعت چاپگر را بر حسب صفحه در دقیقه مشخص می‌کند.
اگر دو عدد مشخص شود و عدد دوم بزرگتر از صفر باشد، کارساز پشتیبانی از چاپ رنگی را گزارش خواهد کرد.
مقدار پیش‌فرض "10,0" است.
.TP 5
.B \-v[vvv]
هنگام ثبت وقایع در خروجی خطای استاندارد، خروجی را با جزئیات کامل (یا بسیار مفصل) نمایش می‌دهد.
.SH "وضعیت خروج (EXIT STATUS)"
برنامه
.B ippeveprinter
در صورتی که قادر به پردازش آرگومان‌های خط فرمان یا ثبت سرویس IPP نباشد، مقدار 1 را برمی‌گرداند.
در غیر این صورت،
.B ippeveprinter
تا زمان توقف به اجرای پیوسته ادامه می‌دهد.
.SH "سازگاری با استانداردها (CONFORMING TO)"
برنامه
.B ippeveprinter
مختص به CUPS است و با مشخصات IPP Everywhere (PWG 5100.14) مطابقت دارد.
.SH "محیط (ENVIRONMENT)"
.B ippeveprinter
متغیرهای محیطی که با "IPP_" شروع می‌شوند را برای تمامی مشخصه‌های کار IPP در درخواست چاپ اضافه می‌کند.
برای نمونه، هنگام اجرای یک دستور برای کار IPP شامل مشخصه الگوی کار "media"، متغیر محیطی "IPP_MEDIA" با مقدار آن مشخصه تنظیم می‌شود.
.LP
علاوه بر این، تمامی مشخصه‌های توصیف چاپگر "xxx-default" و "pwg-xxx" پروتکل IPP به محیط افزوده می‌شوند.
برای نمونه، متغیر محیطی "IPP_MEDIA_DEFAULT" با مقدار پیش‌فرض مشخصه الگوی کار "media" تنظیم خواهد شد.
.LP
مقدارهای شمارشی (Enumerated) به کلمات کلیدی معادل خود تبدیل می‌شوند.
برای نمونه، یک مشخصه الگوی کار "print-quality" با مقدار شمارشی 3 تبدیل به متغیر محیطی "IPP_PRINT_QUALITY" با مقدار "draft" می‌شود.
این تبدیل رشته‌ای تنها برای مشخصه‌های استاندارد الگوی کار انجام می‌گیرد، که در حال حاضر شامل "finishings"، "orientation-requested" و "print-quality" است.
.LP
در نهایت، متغیر محیطی "CONTENT_TYPE" شامل نوع رسانه MIME سندی است که چاپ می‌شود، متغیر محیطی "DEVICE_URI" شامل URI دستگاه مشخص‌شده با گزینه "\-D" است، متغیر محیطی "OUTPUT_FORMAT" شامل نوع رسانه MIME خروجی است و متغیر محیطی "PPD" شامل نام فایل PPD مشخص‌شده با گزینه "\-P" است.
.SH "خروجی دستور (COMMAND OUTPUT)"
دستورات چاپ، داده‌های آماده برای چاپگر را به خروجی استاندارد ارسال می‌کنند، مگر اینکه مستقیماً با یک چاپگر ارتباط برقرار نمایند.
.LP
دستورات چاپ می‌توانند پیام‌ها را در خروجی خطای استاندارد با یکی از پیشوندهای زیر به
.B ippeveprinter
بازگردانند:
.TP 5
\fBATTR: \fIattribute=value[ attribute=value]\fR
مشخصه(های) نام‌برده را با مقدارهای ارائه‌شده تنظیم می‌کند.
در حال حاضر تنها مشخصه‌های وضعیت کار "job-impressions" و "job-impressions-completed" و مشخصه‌های وضعیت چاپگر "marker-xxx"، "printer-alert"، "printer-alert-description"، "printer-supply" و "printer-supply-description" قابل تنظیم هستند.
.TP 5
\fBDEBUG: \fIDebugging message\fR
در صورتی که حداقل دو گزینه \-v مشخص شده باشد، یک پیام اشکال‌زدایی را ثبت می‌کند.
.TP 5
\fBERROR: \fIError message\fR
یک پیام خطا ثبت کرده و پیام را در مشخصه "job-state-message" کپی می‌کند.
.TP 5
\fBINFO: \fIInformational message\fR
در صورتی که گزینه \-v مشخص شده باشد، یک پیام اطلاعاتی/پیشرفت کار را ثبت کرده و پیام را در مشخصه "job-state-message" کپی می‌کند، مگر اینکه خطایی گزارش شده باشد.
.TP 5
\fBSTATE: \fIkeyword[,keyword,...]\fR
مشخصه "printer-state-reasons" چاپگر را با کلیدواژه‌های فهرست‌شده تنظیم می‌کند.
.TP 5
\fBSTATE: -\fIkeyword[,keyword,...]\fR
کلیدواژه‌های فهرست‌شده را از مشخصه "printer-state-reasons" چاپگر حذف می‌کند.
.TP 5
\fBSTATE: +\fIkeyword[,keyword,...]\fR
کلیدواژه‌های فهرست‌شده را به مشخصه "printer-state-reasons" چاپگر اضافه می‌کند.
.SH "مثال‌ها (EXAMPLES)"
اجرای
.B ippeveprinter
با نام سرویس My Cool Printer:
.nf

    ippeveprinter "My Cool Printer"
.fi
.LP
اجرای دستور
.BR file (1)
هر زمان که یک کار چاپ به کارساز ارسال شود:
.nf

    ippeveprinter \-c /usr/bin/file "My Cool Printer"
.fi
.SH "همچنین ببینید (SEE ALSO)"
.BR ippevepcl (7),
.BR ippeveps (7),
گروه کاری پروتکل چاپ اینترنتی PWG (http://www.pwg.org/ipp)
.SH "حق نشر (COPYRIGHT)"
Copyright \[co] 2020-2024 by OpenPrinting.