نام (NAME)

ippeveprinter - برنامه کاربردی چاپگر IPP Everywhere برای cups

خلاصه دستور (SYNOPSIS)

ippeveprinter [ --help ] [ --no-web-forms ] [ --pam-service service ] [ --version ] [ -2 ] [ -A ] [ -D device-uri ] [ -F output-type/subtype ] [ -K keypath ] [ -M manufacturer ] [ -P filename.ppd ] [ -V ipp-version ] [ -a filename.conf ] [ -c command ] [ -d spool-directory ] [ -f type/subtype[,...] ] [ -i iconfile.png ] [ -k ] [ -l location ] [ -m model ] [ -n hostname ] [ -p port ] [ -r subtype[,subtype] ] [ -s speed[,color-speed] ] [ -v[vvv] ] service-name

توضیحات (DESCRIPTION)

ippeveprinter یک کارساز پروتکل چاپ اینترنتی (IPP) ساده و سازگار با مشخصات IPP Everywhere (PWG 5100.14) است. از این ابزار می‌توان برای آزمایش نرم‌افزارهای کلاینت یا به عنوان یک کارساز چاپ بسیار پایه استفاده کرد که برای هر کار چاپ‌شده (job)، یک دستور را اجرا می‌کند.

گزینه‌ها (OPTIONS)

گزینه‌های زیر توسط ippeveprinter پشتیبانی می‌شوند:

--help: نمایش نحوه استفاده از برنامه.
--no-web-forms: غیرفعال‌سازی فرم‌های رابط کاربری وب که برای به‌روزرسانی رسانه و میزان مواد مصرفی استفاده می‌شوند.
--pam-service service: تنظیم نام سرویس PAM. سرویس پیش‌فرض "cups" است.
--version: نمایش نسخه CUPS.
-2: گزارش پشتیبانی از چاپ دورو (duplex).
-A: فعال‌سازی احراز هویت برای چاپگر ایجادشده. ippeveprinter از PAM برای احراز هویت اعتبارنامه‌های HTTP Basic استفاده می‌کند.
-D device-uri: تنظیم URI دستگاه برای خروجی چاپ. این شناسه (URI) می‌تواند نام یک فایل، دایرکتوری، یا یک URI سوکت شبکه به فرم "socket://ADDRESS[:PORT]" باشد (که در آن شماره درگاه پیش‌فرض 9100 است). در صورت تعیین یک دایرکتوری، ippeveprinter با استفاده از شناسه و نام کار چاپ، یک فایل خروجی ایجاد خواهد کرد.
-F output-type/subtype[,...]: نوع رسانه MIME خروجی را مشخص می‌کند. در صورتی که گزینه -P تعیین شده باشد، مقدار پیش‌فرض "application/postscript" است.
-M manufacturer: تنظیم سازنده چاپگر. مقدار پیش‌فرض "Example" است.
-P filename.ppd: بارگذاری مشخصه‌های چاپگر از فایل PPD تعیین‌شده. این گزینه معمولاً همراه با دستور چاپگر ippeveps(7) استفاده می‌شود ("-c ippeveps";).
-V 1.1
-V 2.0: حداکثر نسخه IPP برای گزارش را تعیین می‌کند. مقدار 2.0 پیش‌فرض است.
-c command: اجرای دستور مشخص‌شده برای هر سندی که چاپ می‌شود. اگر "command" یک مسیر مطلق ("/path/to/command") نباشد، ippeveprinter دستور را در زیرپوشه "command" از دایرکتوری باینری CUPS (معمولاً /usr/lib/cups/command یا /usr/libexec/cups/command) جستجو می‌کند. از دستور cups-config(1) می‌توان برای کشف دایرکتوری باینری صحیح استفاده کرد ("cups-config --serverbin"). علاوه بر این، از متغیر محیطی CUPS_SERVERBIN می‌توان برای بازنویسی مسیر پیش‌فرض این دایرکتوری استفاده نمود — برای جزئیات بیشتر صفحه راهنمای cups(1) را ببینید.
-d spool-directory: دایرکتوری نگه‌داری فایل‌های چاپی را مشخص می‌کند. مقدار پیش‌فرض، یک دایرکتوری درون دایرکتوری موقت جاری کاربر است.
-f type/subtype[,...]: فهرستی از انواع رسانه MIME که کارساز می‌پذیرد را مشخص می‌کند. مقدار پیش‌فرض به نوع چاپگر ایجادشده بستگی دارد.
-i iconfile.png: فایل آیکون چاپگر را برای کارساز مشخص می‌کند. این فایل باید تصویری با فرمت PNG باشد. مقدار پیش‌فرض، یک تصویر PNG ارائه‌شده به صورت داخلی است.
-k: اسناد چاپی را در دایرکتوری صف (spool) نگه می‌دارد و آن‌ها را حذف نمی‌کند.
-l location: رشته موقعیت مکانی خوانا برای انسان را که توسط کارساز گزارش می‌شود، تعیین می‌کند. مقدار پیش‌فرض، یک رشته خالی است.
-m model: نام مدل چاپگر را تعیین می‌کند. مقدار پیش‌فرض "Printer" است.
-n hostname: نام میزبانی (hostname) را که توسط کارساز گزارش می‌شود، تعیین می‌کند. مقدار پیش‌فرض، نام بازگردانده‌شده توسط دستور hostname(1) است.
-p port: شماره درگاهی (port) که باید به آن گوش فرا داده شود را مشخص می‌کند. مقدار پیش‌فرض، یک شماره اختصاصی کاربر از 8000 تا 8999 است.
-r off: تبلیغات سرویس DNS-SD را به طور کامل غیرفعال می‌کند.
-r subtype[,subtype]: زیرنوع‌های (subtypes) DNS-SD برای تبلیغ را مشخص می‌کند. چندین زیرنوع را با کاما از هم جدا کنید. مقدار پیش‌فرض "_print" است.
-s speed[,color-speed]: سرعت چاپگر را بر حسب صفحه در دقیقه مشخص می‌کند. اگر دو عدد مشخص شود و عدد دوم بزرگتر از صفر باشد، کارساز پشتیبانی از چاپ رنگی را گزارش خواهد کرد. مقدار پیش‌فرض "10,0" است.
-v[vvv]: هنگام ثبت وقایع در خروجی خطای استاندارد، خروجی را با جزئیات کامل (یا بسیار مفصل) نمایش می‌دهد.

وضعیت خروج (EXIT STATUS)

برنامه ippeveprinter در صورتی که قادر به پردازش آرگومان‌های خط فرمان یا ثبت سرویس IPP نباشد، مقدار 1 را برمی‌گرداند. در غیر این صورت، ippeveprinter تا زمان توقف به اجرای پیوسته ادامه می‌دهد.

سازگاری با استانداردها (CONFORMING TO)

برنامه ippeveprinter مختص به CUPS است و با مشخصات IPP Everywhere (PWG 5100.14) مطابقت دارد.

محیط (ENVIRONMENT)

ippeveprinter متغیرهای محیطی که با "IPP_" شروع می‌شوند را برای تمامی مشخصه‌های کار IPP در درخواست چاپ اضافه می‌کند. برای نمونه، هنگام اجرای یک دستور برای کار IPP شامل مشخصه الگوی کار "media"، متغیر محیطی "IPP_MEDIA" با مقدار آن مشخصه تنظیم می‌شود.

علاوه بر این، تمامی مشخصه‌های توصیف چاپگر "xxx-default" و "pwg-xxx" پروتکل IPP به محیط افزوده می‌شوند. برای نمونه، متغیر محیطی "IPP_MEDIA_DEFAULT" با مقدار پیش‌فرض مشخصه الگوی کار "media" تنظیم خواهد شد.

مقدارهای شمارشی (Enumerated) به کلمات کلیدی معادل خود تبدیل می‌شوند. برای نمونه، یک مشخصه الگوی کار "print-quality" با مقدار شمارشی 3 تبدیل به متغیر محیطی "IPP_PRINT_QUALITY" با مقدار "draft" می‌شود. این تبدیل رشته‌ای تنها برای مشخصه‌های استاندارد الگوی کار انجام می‌گیرد، که در حال حاضر شامل "finishings"، "orientation-requested" و "print-quality" است.

در نهایت، متغیر محیطی "CONTENT_TYPE" شامل نوع رسانه MIME سندی است که چاپ می‌شود، متغیر محیطی "DEVICE_URI" شامل URI دستگاه مشخص‌شده با گزینه "-D" است، متغیر محیطی "OUTPUT_FORMAT" شامل نوع رسانه MIME خروجی است و متغیر محیطی "PPD" شامل نام فایل PPD مشخص‌شده با گزینه "-P" است.

خروجی دستور (COMMAND OUTPUT)

دستورات چاپ، داده‌های آماده برای چاپگر را به خروجی استاندارد ارسال می‌کنند، مگر اینکه مستقیماً با یک چاپگر ارتباط برقرار نمایند.

دستورات چاپ می‌توانند پیام‌ها را در خروجی خطای استاندارد با یکی از پیشوندهای زیر به ippeveprinter بازگردانند:

ATTR: attribute=value[ attribute=value]: مشخصه(های) نام‌برده را با مقدارهای ارائه‌شده تنظیم می‌کند. در حال حاضر تنها مشخصه‌های وضعیت کار "job-impressions" و "job-impressions-completed" و مشخصه‌های وضعیت چاپگر "marker-xxx"، "printer-alert"، "printer-alert-description"، "printer-supply" و "printer-supply-description" قابل تنظیم هستند.
DEBUG: Debugging message: در صورتی که حداقل دو گزینه -v مشخص شده باشد، یک پیام اشکال‌زدایی را ثبت می‌کند.
ERROR: Error message: یک پیام خطا ثبت کرده و پیام را در مشخصه "job-state-message" کپی می‌کند.
INFO: Informational message: در صورتی که گزینه -v مشخص شده باشد، یک پیام اطلاعاتی/پیشرفت کار را ثبت کرده و پیام را در مشخصه "job-state-message" کپی می‌کند، مگر اینکه خطایی گزارش شده باشد.
STATE: keyword[,keyword,...]: مشخصه "printer-state-reasons" چاپگر را با کلیدواژه‌های فهرست‌شده تنظیم می‌کند.
STATE: -keyword[,keyword,...]: کلیدواژه‌های فهرست‌شده را از مشخصه "printer-state-reasons" چاپگر حذف می‌کند.
STATE: +keyword[,keyword,...]: کلیدواژه‌های فهرست‌شده را به مشخصه "printer-state-reasons" چاپگر اضافه می‌کند.

مثال‌ها (EXAMPLES)

اجرای ippeveprinter با نام سرویس My Cool Printer:

ippeveprinter "My Cool Printer"

اجرای دستور file(1) هر زمان که یک کار چاپ به کارساز ارسال شود:

ippeveprinter -c /usr/bin/file "My Cool Printer"

همچنین ببینید (SEE ALSO)

ippevepcl(7), ippeveps(7), گروه کاری پروتکل چاپ اینترنتی PWG (http://www.pwg.org/ipp)