.\"
.\" lpadmin man page for CUPS.
.\"
.\" Copyright © 2020-2024 by OpenPrinting.
.\" Copyright © 2007-2019 by Apple Inc.
.\" Copyright © 1997-2006 by Easy Software Products.
.\"
.\" Licensed under Apache License v2.0.  See the file "LICENSE" for more
.\" information.
.\"
.TH lpadmin 8 "CUPS" "2021-02-28" "OpenPrinting"
.SH "نام (NAME)"
lpadmin \- پیکربندی چاپگرها و کلاس‌های CUPS
.SH "خلاصه دستور (SYNOPSIS)"
.B lpadmin
[
.B \-E
] [
.B \-U
.I username
] [
\fB\-h \fIserver\fR[\fB:\fIport\fR]
]
.B \-d
.I destination
.br
.B lpadmin
[
.B \-E
] [
.B \-U
.I username
] [
\fB\-h \fIserver\fR[\fB:\fIport\fR]
]
.B \-p
.I destination
[
.B \-R
.I name-default
]
.I option(s)
.br
.B lpadmin
[
.B \-E
] [
.B \-U
.I username
] [
\fB\-h \fIserver\fR[\fB:\fIport\fR]
]
.B \-x
.I destination
.SH "توضیحات (DESCRIPTION)"
دستور
\fBlpadmin\fR
صف‌های چاپگر و کلاس ارائه‌شده توسط CUPS را پیکربندی می‌کند.
همچنین می‌تواند برای تعیین چاپگر یا کلاس پیش‌فرض سرور به کار رود.
.LP
هنگامی که گزینهٔ
\fI\-E\fR
پیش از گزینه‌های
\fI\-d\fR،
\fI\-p\fR
یا
\fI\-x\fR
مشخص شود، رمزنگاری را هنگام اتصال به سرور اجباری می‌کند.
.LP
شکل نخست دستور
(\fI\-d\fR)
چاپگر یا کلاس پیش‌فرض را روی
\fIdestination\fR
تنظیم می‌کند.
کارهای چاپ بعدی که از طریق دستورهای
.BR lp (1)
یا
.BR lpr (1)
ارسال می‌شوند، از این مقصد استفاده خواهند کرد؛ مگر اینکه کاربر با دستور
.BR lpoptions (1)
مقصد دیگری را مشخص نماید.
.LP
شکل دوم دستور
(\fI\-p\fR)
چاپگر یا کلاس نام‌برده را پیکربندی می‌کند. گزینه‌های بیشتر در ادامه شرح داده شده‌اند.
.LP
شکل سوم دستور
(\fI\-x\fR)
چاپگر یا کلاس
\fIdestination\fR
را حذف می‌کند.
تمام کارهایی که برای این مقصد در انتظار باشند حذف می‌شوند و هر کاری که هم‌اکنون در حال چاپ باشد متوقف (لغو) خواهد شد.
.SH "گزینه‌ها (OPTIONS)"
هنگام پیکربندی یک صف چاپگر، گزینه‌های زیر شناسایی می‌شوند:
.TP 5
\fB\-c \fIclass\fR
چاپگر نام‌برده
(\fIprinter\fR)
را به کلاس
\fIclass\fR
می‌افزاید.
اگر
\fIclass\fR
وجود نداشته باشد، به صورت خودکار ایجاد می‌شود.
.TP 5
\fB\-m \fImodel\fR
یک فایل استاندارد PPD را برای چاپگر از پوشهٔ
\fImodel\fR
یا با استفاده از یکی از رابط‌های درایور تنظیم می‌کند.
از گزینهٔ
\fI\-m\fR
همراه با دستور
.BR lpinfo (8)
برای دریافت فهرستی از مدل‌های پشتیبانی‌شده استفاده کنید.
مدل «raw» هر فایل PPD موجود را پاک می‌کند و مدل «everywhere» از چاپگری که توسط
\fIdevice-uri\fR
مشخص‌شده در IPP ارجاع داده شده، استعلام می‌گیرد.
نکته: مدل‌هایی غیر از «everywhere» منسوخ شده‌اند و در نگارش‌های آیندهٔ CUPS پشتیبانی نخواهند شد.
.TP 5
\fB\-o cupsIPPSupplies=true\fR
.TP 5
\fB\-o cupsIPPSupplies=false\fR
مشخص می‌کند که آیا مقادیر سطح مواد مصرفی IPP باید گزارش شوند یا خیر.
.TP 5
\fB\-o cupsSNMPSupplies=true\fR
.TP 5
\fB\-o cupsSNMPSupplies=false\fR
مشخص می‌کند که آیا مقادیر سطح مواد مصرفی SNMP‏ (RFC 3805) باید گزارش شوند یا خیر.
.TP 5
\fB\-o job\-k\-limit=\fIvalue\fR
محدودیت کیلوبایت را برای سهمیه‌بندی هر کاربر تنظیم می‌کند.
مقدار یک عدد صحیح بر حسب کیلوبایت است؛ یک کیلوبایت برابر ۱۰۲۴ بایت است.
.TP 5
\fB\-o job\-page\-limit=\fIvalue\fR
محدودیت تعداد صفحات را برای سهمیه‌بندی هر کاربر تنظیم می‌کند.
مقدار یک عدد صحیح از صفحاتی است که می‌توان چاپ کرد؛ صفحات دو‌رو دو صفحه محاسبه می‌شوند.
.TP 5
\fB\-o job\-quota\-period=\fIvalue\fR
دورهٔ زمانی حسابرسی را برای سهمیه‌بندی هر کاربر تنظیم می‌کند.
مقدار یک عدد صحیح بر حسب ثانیه است؛ هر روز ۸۶٬۴۰۰ ثانیه است.
.TP 5
\fB\-o job\-sheets\-default=\fIbanner\fR
.TP 5
\fB\-o job\-sheets\-default=\fIbanner\fB,\fIbanner\fR
صفحه(های) بنر پیش‌فرض را برای استفاده در کارهای چاپ تعیین می‌کند.
.TP 5
\fB\-o \fIname\fB=\fIvalue\fR
یک گزینهٔ PPD را برای چاپگر تنظیم می‌کند.
گزینه‌های PPD را می‌توان با استفاده از گزینهٔ
\fI\-l\fR
همراه با دستور
.BR lpoptions (1)
فهرست کرد.
.TP 5
\fB\-o \fIname\fB\-default=\fIvalue\fR
یک گزینهٔ پیش‌فرض سمت سرور را برای مقصد تعیین می‌کند.
برای هر گزینه در زمان چاپ می‌توان مقدار پیش‌فرض تعیین کرد؛ به عنوان مثال،
«\-o number-up-default=2»
برای تنظیم مقدار پیش‌فرض گزینهٔ «number-up» روی ۲.
.TP 5
\fB\-o port\-monitor=\fIname\fR
برنامهٔ ارتباطی دودویی مورد استفاده هنگام چاپ را روی «none»، «bcp» یا «tbcp» تنظیم می‌کند.
برنامهٔ پیش‌فرض «none» است.
پایشگر درگاه مشخص‌شده باید در فایل PPD چاپگر فهرست شده باشد.
.TP 5
\fB\-o printer\-error\-policy=\fIname\fR
سیاست مواجهه با خطاهایی مانند یافت نشدن یا عدم دسترسی به چاپگر، پشتیبانی نشدن قالب چاپی، شکست در ارسال داده‌های چاپ، یا کرش کردن یک یا چند فیلتر را تعیین می‌کند.
نام باید یکی از موارد «abort-job» (لغو کار در صورت خطا)، «retry-job» (تلاش مجدد برای کار در زمانی دیگر)، «retry-current-job» (تلاش مجدد فوری برای کار جاری)، یا «stop-printer» (متوقف کردن چاپگر در صورت خطا) باشد.
سیاست پیش‌فرض خطا برای چاپگرها «stop-printer» و برای کلاس‌ها «retry-current-job» است.
.TP 5
\fB\-o printer\-is\-shared=true\fR
.TP 5
\fB\-o printer\-is\-shared=false\fR
مقصد را در وضعیت هم‌رسانی‌شده/منتشر‌شده یا هم‌رسانی‌نشده/منتشر‌نشده قرار می‌دهد.
مقاصد هم‌رسانی‌شده/منتشر‌شده بر اساس پیکربندی مرور در
\fIcupsd.conf\fR
به صورت عمومی توسط سرور روی شبکهٔ محلی (LAN) اعلان می‌شوند، در حالی که مقاصد هم‌رسانی‌نشده اعلان نخواهند شد.
مقدار پیش‌فرض «true» است.
.TP 5
\fB\-o printer\-op\-policy=\fIname\fR
سیاست عملیات IPP مرتبط با مقصد را تعیین می‌کند.
این نام باید در فایل
\fIcupsd.conf\fR
در یک بخش Policy تعریف شده باشد.
سیاست عملیات پیش‌فرض «default» است.
.TP 5
\fB\-R \fIname\fB\-default\fR
گزینهٔ نام‌برده را از
\fIprinter\fR
حذف می‌کند.
.TP 5
\fB\-r \fIclass\fR
چاپگر نام‌برده را از
\fIclass\fR
حذف می‌کند.
اگر کلاس حاصل خالی شود، آن کلاس حذف خواهد شد.
.TP 5
\fB\-u allow:\fR{\fIuser\fR|\fB@\fIgroup\fR}{\fB,\fIuser\fR|\fB,@\fIgroup\fR}*
.TP 5
\fB\-u deny:\fR{\fIuser\fR|\fB@\fIgroup\fR}{\fB,\fIuser\fR|\fB,@\fIgroup\fR}*
.TP 5
\fB\-u allow:all\fR
.TP 5
\fB\-u deny:none\fR
کنترل دسترسی در سطح کاربر را روی یک مقصد تنظیم می‌کند.
نام‌هایی که با «@» آغاز می‌شوند به عنوان گروه‌های یونیکس تفسیر می‌گردند.
دو شکل اخیر، کنترل دسترسی در سطح کاربر را خاموش می‌کنند.
نکته: به کاربر «root» دسترسی ویژه‌ای داده نمی‌شود؛ استفاده از «\-u allow:foo,bar» به کاربران «foo» و «bar» اجازه دسترسی به چاپگر را می‌دهد اما به «root» دسترسی داده نمی‌شود.
.TP 5
\fB\-v "\fIdevice-uri\fB"\fR
ویژگی
\fIdevice-uri\fR
صف چاپگر را تنظیم می‌کند.
از گزینهٔ
\fI\-v\fR
همراه با دستور
.BR lpinfo (8)
برای دریافت فهرستی از نشانی‌های URI دستگاه‌ها و طرحواره‌های (schemes) پشتیبانی‌شده استفاده کنید.
.TP 5
\fB\-D "\fIinfo\fB"\fR
یک توضیح متنی از مقصد ارائه می‌دهد.
.TP 5
.B \-E
هنگامی که پیش از گزینه‌های
\fB\-d\fR،
\fB\-p\fR
یا
\fB\-x\fR
مشخص شود، استفاده از رمزنگاری TLS را در ارتباط با زمان‌بند اجباری می‌کند.
در غیر این صورت، مقصد را فعال کرده و کارها را می‌پذیرد؛ این معادل اجرای برنامه‌های
.BR cupsaccept (8)
و
.BR cupsenable (8)
روی مقصد است.
.TP 5
\fB\-L "\fIlocation\fB"\fR
یک مکان متنی برای مقصد مشخص می‌کند.
.SH "گزینه‌های منسوخ‌شده (DEPRECATED OPTIONS)"
گزینه‌های
\fBlpadmin\fR
زیر منسوخ شده‌اند:
.TP 5
\fB\-i \fIfilename\fR
این گزینه در گذشته یا برای فراهم کردن یک اسکریپت رابط System V یا (به عنوان یک اثر جانبی پیاده‌سازی) یک فایل PPD استفاده می‌شده است.
نکته: اسکریپت‌های رابط توسط CUPS پشتیبانی نمی‌شوند.
فایل‌های PPD و درایورهای چاپگر منسوخ شده‌اند و در نگارش‌های آیندهٔ CUPS پشتیبانی نخواهند شد.
.TP 5
\fB\-P \fIppd-file\fR
یک فایل توصیف چاپگر پست‌اسکریپت (PPD) را برای استفاده با چاپگر مشخص می‌کند.
نکته: فایل‌های PPD و درایورهای چاپگر منسوخ شده‌اند و در نگارش‌های آیندهٔ CUPS پشتیبانی نخواهند شد.
.SH "سازگاری با استانداردها (CONFORMING TO)"
برخلاف سامانهٔ چاپ System V، نرم‌افزار CUPS اجازه می‌دهد نام چاپگرها شامل هر نویسهٔ قابل چاپی به جز فاصله (SPACE)، تب (TAB)، «/» یا «#» باشد.
همچنین، نام‌های چاپگر و کلاس نسبت به بزرگی و کوچکی حروف حساس
\fIنیستند\fR.
.PP
در نهایت، نسخهٔ CUPS دستور
\fBlpadmin\fR
بسته به پیکربندی سامانهٔ چاپ ممکن است از کاربر رمز عبور دسترسی بخواهد.
این با نگارش System V که اجرای این دستور را مستلزم کاربر ریشه (root) می‌داند، تفاوت دارد.
.SH "نکات (NOTES)"
درایورها و بک‌اندهای چاپگر CUPS منسوخ شده‌اند و دیگر در نسخه‌های بعدی دارای امکانات جدید CUPS پشتیبانی نخواهند شد.
چاپگرهایی که از IPP پشتیبانی نمی‌کنند را می‌توان با استفاده از برنامه‌هایی مانند
.BR ippeveprinter (1)
پشتیبانی کرد.
.LP
نسخهٔ CUPS از
\fBlpadmin\fR
از تمام گزینه‌های پیکربندی سامانهٔ چاپ System V یا Solaris پشتیبانی نمی‌کند.
.PP
اسکریپت‌های رابط به دلایل امنیتی پشتیبانی نمی‌شوند.
.PP
معنای دوگانهٔ گزینهٔ
\fB\-E\fR
یک ویژگی نامتعارف تاریخی و مایهٔ تأسف است.
.PP
دستور
\fBlpadmin\fR
برای اعمال تغییرات در پیکربندی سامانهٔ چاپ، با زمان‌بند
(\fBcupsd\fR)
ارتباط برقرار می‌کند.
این اطلاعات پیکربندی در چندین فایل از جمله
\fIprinters.conf\fR
و
\fIclasses.conf\fR
ذخیره می‌شوند.
این فایل‌ها نباید مستقیماً ویرایش شوند و جزو جزئیات پیاده‌سازی CUPS به شمار می‌آیند که ممکن است در هر زمان تغییر کنند.
.SH "مثال (EXAMPLE)"
ایجاد یک صف چاپ IPP Everywhere:
.nf

    lpadmin -p myprinter -E -v ipp://myprinter.local/ipp/print -m everywhere

.fi
.SH "همچنین ببینید (SEE ALSO)"
.BR cupsaccept (8),
.BR cupsenable (8),
.BR lpinfo (8),
.BR lpoptions (1),
راهنمای برخط CUPS (http://localhost:631/help)
.SH "حق نشر (COPYRIGHT)"
Copyright \[co] 2020-2024 by OpenPrinting.