.\"
.\" cupsd.conf man page for CUPS.
.\"
.\" Copyright © 2020-2025 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 cupsd.conf 5 "CUPS" "2025-03-12" "OpenPrinting"
.SH "نام (NAME)"
cupsd.conf \- فایل اصلی پیکربندی سرور چاپ CUPS
.SH "توضیحات (DESCRIPTION)"
فایل
.I cupsd.conf
زمان‌بند CUPS، یعنی
.BR cupsd (8)،
را پیکربندی می‌کند.
این فایل معمولاً در دایرکتوری
.I /etc/cups
قرار دارد.
هر خط در این فایل می‌تواند یک دستورالعمل پیکربندی، یک خط خالی یا یک توضیح (کامنت) باشد.
دستورالعمل‌های پیکربندی معمولاً شامل یک نام و صفر یا چند مقدار هستند که با نویسه فاصله از هم جدا شده‌اند.
نام و مقادیر دستورالعمل‌های پیکربندی به حروف بزرگ و کوچک حساس نیستند.
خطوط توضیحات با نویسه # آغاز می‌شوند.
.SS "دستورالعمل‌های سطح بالا (TOP-LEVEL DIRECTIVES)"
دستورالعمل‌های سطح بالای زیر توسط
.BR cupsd (8)
شناخته و پشتیبانی می‌شوند:
.\"#AccessLogLevel
.TP 5
\fBAccessLogLevel config\fR
.TP 5
\fBAccessLogLevel actions\fR
.TP 5
\fBAccessLogLevel all\fR
سطح گزارش‌گیری را برای فایل AccessLog مشخص می‌کند.
سطح "config" زمان افزودن، حذف یا تغییر چاپگرها و کلاس‌ها و زمان دسترسی یا به‌روزرسانی فایل‌های پیکربندی را ثبت می‌کند.
سطح "actions" زمان ارسال، نگه‌داشتن، آزادسازی، تغییر یا لغو کارهای چاپ و هر یک از شرایط "config" را ثبت می‌کند.
سطح "all" تمامی درخواست‌ها را ثبت می‌کند.
سطح پیش‌فرض گزارش دسترسی "actions" است.
.\"#AutoPurgeJobs
.TP 5
\fBAutoPurgeJobs Yes\fR
.TP 5
\fBAutoPurgeJobs No\fR
.br
مشخص می‌کند که آیا داده‌های تاریخچه کارها در صورتی که دیگر برای سهمیه‌بندی‌ها لازم نباشند، به‌طور خودکار پاکسازی شوند یا خیر.
مقدار پیش‌فرض "No" است.
.\"#BrowseDNSSDSubTypes
.TP 5
.BI BrowseDNSSDSubTypes _subtype[,...]
فهرستی از زیرنوع‌های Bonjour را برای اعلان به ازای هر چاپگر به اشتراک گذاشته شده مشخص می‌کند.
به عنوان مثال، "BrowseDNSSDSubTypes _cups,_print" به کلاینت‌های شبکه اعلام می‌کند که هم اشتراک‌گذاری CUPS و هم IPP Everywhere پشتیبانی می‌شوند.
مقدار پیش‌فرض "_cups" است که برای کارکرد اشتراک‌گذاری چاپگر میان سیستم‌های استفاده‌کننده از CUPS ضروری است.
.\"#BrowseLocalProtocols
.TP 5
\fBBrowseLocalProtocols all\fR
.TP 5
\fBBrowseLocalProtocols dnssd\fR
.TP 5
\fBBrowseLocalProtocols none\fR
پروتکل‌های مورد استفاده برای اشتراک‌گذاری محلی چاپگر را مشخص می‌کند.
مقدار پیش‌فرض در سیستم‌هایی که از Bonjour پشتیبانی می‌کنند "dnssd" و در غیر این صورت "none" است.
.\"#BrowseWebIF
.TP 5
\fBBrowseWebIF Yes\fR
.TP 5
\fBBrowseWebIF No\fR
.br
مشخص می‌کند که آیا رابط وب CUPS اعلان (تبلیغ) شود یا خیر.
مقدار پیش‌فرض "No" است.
.\"#Browsing
.TP 5
\fBBrowsing Yes\fR
.TP 5
\fBBrowsing No\fR
.br
مشخص می‌کند که آیا چاپگرهای به اشتراک گذاشته شده اعلان شوند یا خیر.
مقدار پیش‌فرض "No" است.
.\"#DefaultAuthType
.TP 5
\fBDefaultAuthType Basic\fR
.br
نوع پیش‌فرض احراز هویت مورد استفاده را مشخص می‌کند.
مقدار پیش‌فرض "Basic" است.
.\"#DefaultEncryption
.TP 5
\fBDefaultEncryption Never\fR
.TP 5
\fBDefaultEncryption IfRequested\fR
.TP 5
\fBDefaultEncryption Required\fR
مشخص می‌کند که آیا برای درخواست‌های احراز هویت‌شده از رمزنگاری استفاده شود یا خیر.
مقدار پیش‌فرض "Required" است.
.\"#DefaultLanguage
.TP 5
\fBDefaultLanguage \fIlocale\fR
زبان پیش‌فرض مورد استفاده برای متن و محتوای وب را مشخص می‌کند.
مقدار پیش‌فرض "en" است.
.\"#DefaultPaperSize
.TP 5
\fBDefaultPaperSize Auto\fR
.TP 5
\fBDefaultPaperSize None\fR
.TP 5
\fBDefaultPaperSize \fIsizename\fR
اندازه پیش‌فرض کاغذ را برای صف‌های چاپ جدید مشخص می‌کند. مقدار "Auto" از پیش‌فرض وابسته به محلی‌سازی (locale) استفاده می‌کند، در حالی که "None" مشخص می‌کند هیچ اندازه کاغذی به صورت پیش‌فرض وجود ندارد.
نام‌های اندازه‌های خاص معمولاً "Letter" یا "A4" هستند.
مقدار پیش‌فرض "Auto" است.
.LP
\fBنکته:\fR اندازه پیش‌فرض کاغذ باید از نام اندازه موجود در فایل PPD استفاده کند و نه از نام اندازه رسانه خودتوصیف‌گر PWG.
.\"#DefaultPolicy
.TP 5
\fBDefaultPolicy \fIpolicy-name\fR
سیاست دسترسی پیش‌فرض را برای استفاده مشخص می‌کند.
سیاست دسترسی پیش‌فرض "default" است.
.\"#DefaultShared
.TP 5
\fBDefaultShared Yes\fR
.TP 5
\fBDefaultShared No\fR
مشخص می‌کند که آیا چاپگرهای محلی به‌طور پیش‌فرض به اشتراک گذاشته شوند یا خیر.
مقدار پیش‌فرض "Yes" است.
.\"#DirtyCleanInterval
.TP 5
\fBDirtyCleanInterval \fIseconds\fR
میزان تاخیر برای به‌روزرسانی فایل‌های پیکربندی و وضعیت را مشخص می‌کند.
مقدار 0 باعث می‌شود به‌روزرسانی در سریع‌ترین زمان ممکن، معمولاً ظرف چند میلی‌ثانیه رخ دهد.
مقدار پیش‌فرض "30" ثانیه است.
.\"#DNSSDHostName
.TP 5
.BI DNSSDHostName hostname.example.com
نام دامنه کاملاً واجد شرایط (FQDN) را برای سروری که برای اشتراک‌گذاری Bonjour استفاده می‌شود مشخص می‌کند.
مقدار پیش‌فرض معمولاً نام میزبان ".local" سرور است.
.\"#ErrorPolicy
.TP 5
\fBErrorPolicy abort-job\fR
مشخص می‌کند که یک کار چاپ ناموفق باید لغو (دور انداخته) شود، مگر اینکه برای چاپگر به نحو دیگری مشخص شده باشد.
.TP 5
\fBErrorPolicy retry-current-job\fR
مشخص می‌کند که یک کار چاپ ناموفق باید بلافاصله دوباره تلاش شود، مگر اینکه برای چاپگر به نحو دیگری مشخص شده باشد.
.TP 5
\fBErrorPolicy retry-job\fR
مشخص می‌کند که یک کار چاپ ناموفق باید در زمان دیگری دوباره تلاش شود، مگر اینکه برای چاپگر به نحو دیگری مشخص شده باشد.
.TP 5
\fBErrorPolicy stop-printer\fR
مشخص می‌کند که یک کار چاپ ناموفق باید چاپگر را متوقف کند، مگر اینکه برای چاپگر به نحو دیگری مشخص شده باشد. سیاست خطای 'stop-printer' پیش‌فرض است.
.\"#FilterLimit
.TP 5
\fBFilterLimit \fIlimit\fR
حداکثر هزینه فیلترهایی را که به طور همزمان اجرا می‌شوند مشخص می‌کند، که می‌تواند برای به حداقل رساندن مشکلات دیسک، حافظه و منابع پردازنده (CPU) استفاده شود.
حد 0 محدودسازی فیلتر را غیرفعال می‌کند.
یک چاپ معمولی در یک چاپگر غیر PostScript به محدودیت فیلتری در حدود 200 نیاز دارد.
یک چاپگر PostScript به حدود نیمی از آن (100) نیاز دارد.
تنظیم حد پایین‌تر از این آستانه‌ها عملاً زمان‌بند را به چاپ تنها یک کار در هر زمان محدود می‌کند.
حد پیش‌فرض "0" است.
.\"#FilterNice
.TP 5
\fBFilterNice \fInice-value\fR
اولویت زمان‌بندی (مقدار
.BR nice (8))
فیلترهایی را که برای چاپ یک کار اجرا می‌شوند، مشخص می‌کند.
مقدار nice از 0 (بالاترین اولویت) تا 19 (پایین‌ترین اولویت) متغیر است.
مقدار پیش‌فرض 0 است.
.TP 5
.\"#HostNameLookups
\fBHostNameLookups On\fR
.TP 5
\fBHostNameLookups Off\fR
.TP 5
\fBHostNameLookups Double\fR
مشخص می‌کند که آیا جستجوی معکوس روی کلاینت‌های متصل‌شونده انجام شود یا خیر.
تنظیم "Double" موجب می‌شود
.BR cupsd (8)
بررسی کند که نام میزبان به‌دست‌آمده از نشانی، با یکی از نشانی‌های بازگردانده‌شده برای آن نام میزبان مطابقت داشته باشد.
جستجوهای دوگانه همچنین از اتصال کلاینت‌هایی با نشانی‌های ثبت‌نشده به سرور شما جلوگیری می‌کنند.
مقدار پیش‌فرض "Off" است تا از مشکلات بالقوه عملکرد سرور ناشی از جستجوهای نام میزبان جلوگیری شود.
این گزینه را فقط در صورت نیاز قطعی روی "On" یا "Double" تنظیم کنید.
.\"#IdleExitTimeout
.TP 5
\fBIdleExitTimeout \fIseconds\fR
مدت زمانی را که قبل از خاموش شدن به دلیل عدم فعالیت باید منتظر ماند مشخص می‌کند.
مقدار پیش‌فرض "60" ثانیه است.
.LP
\fBنکته:\fR فقط زمانی کاربرد دارد که
.BR cupsd (8)
به صورت درخواستی (به عنوان مثال با \fB\-l\fR) اجرا شده باشد.
.\"#JobKillDelay
.TP 5
\fBJobKillDelay \fIseconds\fR
تعداد ثانیه‌هایی را مشخص می‌کند که قبل از متوقف کردن اجباری فیلترها و بک‌اند مرتبط با یک کار لغوشده یا نگه‌داشته‌شده باید منتظر ماند.
مقدار پیش‌فرض "300" است.
.\"#JobRetryInterval
.TP 5
\fBJobRetryInterval \fIseconds\fR
فاصله زمانی بین تلاش‌های مجدد کارها را بر حسب ثانیه مشخص می‌کند.
این مورد معمولاً برای صف‌های فکس استفاده می‌شود، اما می‌تواند با صف‌های چاپ معمولی که سیاست خطای آن‌ها "retry-job" است نیز استفاده شود.
مقدار پیش‌فرض "300" است.
.\"#JobRetryLimit
.TP 5
\fBJobRetryLimit \fIcount\fR
تعداد دفعات تلاش مجدد انجام‌شده برای کارها را مشخص می‌کند.
این مورد معمولاً برای صف‌های فکس استفاده می‌شود، اما می‌تواند با صف‌های چاپ معمولی که سیاست خطای آن‌ها "retry-job" است نیز به کار رود.
مقدار پیش‌فرض "5" است.
.\"#KeepAlive
.TP 5
\fBKeepAlive Yes\fR
.TP 5
\fBKeepAlive No\fR
مشخص می‌کند که آیا از اتصالات زنده نگه‌داشتن (keep-alive) در HTTP پشتیبانی شود یا خیر.
مقدار پیش‌فرض "Yes" است.
.\"#LimitIPP
.TP 5
\fB<Limit \fIoperation \fR...\fB> \fR... \fB</Limit>\fR
عملیات IPP را که در داخل یک بخش Policy محدود می‌شوند مشخص می‌کند. نام‌های عملیات IPP در ادامه در بخش "نام‌های عملیات IPP (IPP OPERATION NAMES)" فهرست شده‌اند.
.\"#Limit
.TP 5
\fB<Limit \fImethod \fR...\fB> \fR... \fB</Limit>\fR
.\"#LimitExcept
.TP 5
\fB<LimitExcept \fImethod \fR...\fB> \fR... \fB</LimitExcept>\fR
متدهای HTTP را که در داخل یک بخش Location محدود می‌شوند مشخص می‌کند. نام‌های متدهای HTTP در ادامه در بخش "نام‌های متد HTTP (HTTP METHOD NAMES)" فهرست شده‌اند.
.\"#LimitRequestBody
.TP 5
\fBLimitRequestBody \fIsize\fR
حداکثر اندازه فایل‌های چاپ، درخواست‌های IPP و داده‌های فرم HTML را مشخص می‌کند.
مقدار پیش‌فرض "0" است که بررسی محدودیت را غیرفعال می‌کند.
.\"#Listen
.TP 5
\fBListen \fIipv4-address\fB:\fIport\fR
.TP 5
\fBListen [\fIipv6-address\fB]:\fIport\fR
.TP 5
\fBListen *:\fIport\fR
.TP 5
\fBListen \fI/path/to/domain/socket\fR
برای برقراری اتصالات، به آدرس و پورت مشخص‌شده یا مسیر سوکت دامنه گوش می‌دهد.
چندین دستورالعمل Listen را می‌توان برای گوش دادن به چندین آدرس ارائه داد.
دستورالعمل Listen مشابه دستورالعمل Port است، اما به شما امکان می‌دهد دسترسی را به رابط‌ها یا شبکه‌های خاص محدود کنید.
.LP
\fBنکته:\fR عبارت‌های "Listen *:\fIport\fR" و "Port \fIport\fR" عملاً روی تمام آدرس‌های IP گوش می‌دهند، بنابراین نمی‌توانید آن‌ها را با دستورالعمل‌های Listen برای آدرس‌های صریح IPv4 یا IPv6 روی همان پورت ترکیب کنید.
.\"#Location
.TP 5
\fB<Location \fI/path\fB> \fR... \fB</Location>\fR
کنترل دسترسی را برای مکان نام‌برده مشخص می‌کند.
مسیرها در ادامه در بخش "مسیرهای مکان (LOCATION PATHS)" مستند شده‌اند.
.\"#LogDebugHistory
.TP 5
\fBLogDebugHistory \fInumber\fR
تعداد پیام‌های اشکال‌زدایی را که در صورت بروز خطا در یک کار چاپ برای ثبت در گزارش نگه‌داری می‌شوند، مشخص می‌کند. پیام‌های اشکال‌زدایی بدون در نظر گرفتن تنظیمات LogLevel ثبت می‌شوند.
.\"#LogLevel
.TP 5
\fBLogLevel \fRnone
.TP 5
\fBLogLevel \fRemerg
.TP 5
\fBLogLevel \fRalert
.TP 5
\fBLogLevel \fRcrit
.TP 5
\fBLogLevel \fRerror
.TP 5
\fBLogLevel \fRwarn
.TP 5
\fBLogLevel \fRnotice
.TP 5
\fBLogLevel \fRinfo
.TP 5
\fBLogLevel \fRdebug
.TP 5
\fBLogLevel \fRdebug2
سطح گزارش‌گیری را برای فایل ErrorLog مشخص می‌کند.
مقدار "none" تمام گزارش‌گیری‌ها را متوقف می‌کند، در حالی که "debug2" همه چیز را ثبت می‌نماید.
مقدار پیش‌فرض "warn" است.
.\"#LogTimeFormat
.TP 5
\fBLogTimeFormat \fRstandard
.TP 5
\fBLogTimeFormat \fRusecs
قالب تاریخ و زمان را در فایل‌های گزارش مشخص می‌کند.
مقدار "standard" پیش‌فرض است و ثانیه‌های کامل را ثبت می‌کند، در حالی که "usecs" میکروثانیه‌ها را ثبت می‌نماید.
.\"#MaxClients
.TP 5
\fBMaxClients \fInumber\fR
حداکثر تعداد کلاینت‌های همزمان را که توسط زمان‌بند مجاز شمرده می‌شوند مشخص می‌کند.
مقدار پیش‌فرض "100" است.
.\"#MaxClientPerHost
.TP 5
\fBMaxClientsPerHost \fInumber\fR
حداکثر تعداد کلاینت‌های همزمان مجاز از یک آدرس واحد را مشخص می‌کند.
مقدار پیش‌فرض برابر با مقدار MaxClients است.
.\"#MaxCopies
.TP 5
\fBMaxCopies \fInumber\fR
حداکثر تعداد رونوشت‌هایی را که یک کاربر می‌تواند از هر کار چاپ کند مشخص می‌کند.
مقدار پیش‌فرض "9999" است.
.\"#MaxHoldTime
.TP 5
\fBMaxHoldTime \fIseconds\fR
حداکثر زمانی را که یک کار می‌تواند در وضعیت نگه‌داری "نامحدود" (indefinite) باقی بماند تا پیش از اینکه لغو شود مشخص می‌کند.
مقدار پیش‌فرض "0" است که لغو خودکار کارهای نگه‌داشته‌شده را غیرفعال می‌کند.
.\"#MaxJobs
.TP 5
\fBMaxJobs \fInumber\fR
حداکثر تعداد کارهای همزمان مجاز را مشخص می‌کند.
برای مجاز بودن تعداد نامحدود کارها، آن را روی "0" قرار دهید.
مقدار پیش‌فرض "500" است.
.\"#MaxJobsPerPrinter
.TP 5
\fBMaxJobsPerPrinter \fInumber\fR
حداکثر تعداد کارهای همزمان مجاز به ازای هر چاپگر را مشخص می‌کند.
مقدار پیش‌فرض "0" است که تا سقف MaxJobs کار را به ازای هر چاپگر مجاز می‌داند.
.\"#MaxJobsPerUser
.TP 5
\fBMaxJobsPerUser \fInumber\fR
حداکثر تعداد کارهای همزمان مجاز به ازای هر کاربر را مشخص می‌کند.
مقدار پیش‌فرض "0" است که تا سقف MaxJobs کار را به ازای هر کاربر مجاز می‌شمارد.
.\"#MaxJobTime
.TP 5
\fBMaxJobTime \fIseconds\fR
حداکثر زمانی را که یک کار می‌تواند برای چاپ صرف کند، قبل از اینکه لغو شود مشخص می‌کند.
برای غیرفعال کردن لغو کارهای «گیرکرده»، مقدار آن را روی "0" قرار دهید.
مقدار پیش‌فرض "10800" (۳ ساعت) است.
.\"#MaxLogSize
.TP 5
\fBMaxLogSize \fIsize\fR
حداکثر اندازه فایل‌های گزارش را قبل از چرخش (دوران) آن‌ها مشخص می‌کند.
مقدار "0" چرخش فایل‌های لاگ را غیرفعال می‌کند.
مقدار پیش‌فرض "1048576" (۱ مگابایت) است.
.\"#MaxSubscriptions
.TP 5
\fBMaxSubscriptions \fInumber\fR
حداکثر تعداد اشتراک‌های رویداد همزمان مجاز را مشخص می‌کند.
برای مجاز بودن تعداد نامحدود اشتراک‌ها، مقدار را روی "0" قرار دهید.
مقدار پیش‌فرض "100" است.
.\"#MaxSubscriptionsPerJob
.TP 5
\fBMaxSubscriptionsPerJob \fInumber\fR
حداکثر تعداد اشتراک‌های رویداد همزمان مجاز به ازای هر کار را مشخص می‌کند.
مقدار پیش‌فرض "0" است که تا سقف MaxSubscriptions اشتراک را برای هر کار مجاز می‌شمارد.
.\"#MaxSubscriptionsPerPrinter
.TP 5
\fBMaxSubscriptionsPerPrinter \fInumber\fR
حداکثر تعداد اشتراک‌های رویداد همزمان مجاز به ازای هر چاپگر را مشخص می‌کند.
مقدار پیش‌فرض "0" است که تا سقف MaxSubscriptions اشتراک را به ازای هر چاپگر مجاز می‌داند.
.\"#MaxSubscriptionsPerUser
.TP 5
\fBMaxSubscriptionsPerUser \fInumber\fR
حداکثر تعداد اشتراک‌های رویداد همزمان مجاز به ازای هر کاربر را مشخص می‌کند.
مقدار پیش‌فرض "0" است که تا سقف MaxSubscriptions اشتراک را برای هر کاربر مجاز می‌شمارد.
.\"#MultipleOperationTimeout
.TP 5
\fBMultipleOperationTimeout \fIseconds\fR
حداکثر زمان مجاز بین فایل‌ها در یک کار چاپ چندفایلی را مشخص می‌کند.
مقدار پیش‌فرض "900" (۱۵ دقیقه) است.
.\"#Policy
.TP 5
\fB<Policy \fIname\fB> \fR... \fB</Policy>\fR
کنترل دسترسی را برای سیاست نام‌برده مشخص می‌کند.
.\"#Port
.TP 5
\fBPort \fInumber\fR
برای برقراری اتصالات، به شماره پورت مشخص‌شده گوش می‌دهد.
.\"#PreserveJobFiles
.TP 5
\fBPreserveJobFiles Yes\fR
.TP 5
\fBPreserveJobFiles No\fR
.TP 5
\fBPreserveJobFiles \fIseconds\fR
مشخص می‌کند که آیا فایل‌های کار (اسناد) پس از چاپ یک کار نگه‌داری شوند یا خیر.
اگر یک مقدار عددی مشخص شود، فایل‌های کار برای تعداد ثانیه‌های تعیین‌شده پس از چاپ حفظ می‌شوند.
مقدار پیش‌فرض "86400" (نگه‌داری به مدت ۱ روز) است.
.\"#PreserveJobHistory
.TP 5
\fBPreserveJobHistory Yes\fR
.TP 5
\fBPreserveJobHistory No\fR
.TP 5
\fBPreserveJobHistory \fIseconds\fR
مشخص می‌کند که آیا تاریخچه کار پس از چاپ شدن یک کار نگه‌داری شود یا خیر.
اگر یک مقدار عددی تعیین شود، تاریخچه کار برای تعداد ثانیه‌های مشخص‌شده پس از چاپ نگه‌داری می‌شود.
اگر "Yes" باشد، تاریخچه کار تا زمانی که به حد MaxJobs برسد نگه‌داری می‌شود.
مقدار پیش‌فرض "Yes" است.
.\"#ReadyPaperSizes
.TP 5
\fBReadyPaperSizes \fIsizename[,...]\fR
فهرستی از اندازه‌های احتمالی کاغذ را که به عنوان «آماده» (بارگذاری‌شده) گزارش می‌شوند، مشخص می‌کند.
فهرست واقعی تنها شامل اندازه‌هایی خواهد بود که هر چاپگر از آن‌ها پشتیبانی می‌کند.
مقدار پیش‌فرض در زمانی که اندازه کاغذ پیش‌فرض "Letter" باشد برابر با "Letter,Legal,Tabloid,4x6,Env10" و در غیر این صورت "A3,A4,A5,A6,EnvDL" است.
.LP
\fBنکته:\fR اندازه‌های کاغذ باید از نام‌های اندازه موجود در فایل PPD استفاده کنند و نه نام‌های رسانه خودتوصیف‌گر PWG.
.\"#ReloadTimeout
.TP 5
\fBReloadTimeout \fIseconds\fR
مدت زمانی را که باید قبل از راه‌اندازی مجدد زمان‌بند برای تکمیل کار منتظر ماند مشخص می‌کند.
مقدار پیش‌فرض "30" است.
.\"#ServerAdmin
.TP 5
\fBServerAdmin \fIemail-address\fR
آدرس ایمیل مدیر سرور را مشخص می‌کند.
مقدار پیش‌فرض "root@ServerName" است.
.\"#ServerAlias
.TP 5
\fBServerAlias \fIhostname \fR[ ... \fIhostname \fR]
.TP 5
\fBServerAlias *\fR
دستورالعمل ServerAlias برای اعتبارسنجی هدر Host در HTTP هنگام اتصال کلاینت‌ها از رابط‌های خارجی به زمان‌بند استفاده می‌شود.
استفاده از نام ویژه "*" می‌تواند سیستم شما را در معرض حملات شناخته‌شدهٔ بازپیوند DNS (DNS rebinding attacks) مبتنی بر مرورگر قرار دهد، حتی زمانی که دسترسی به سایت‌ها از طریق فایروال انجام شود.
اگر کشف خودکار نام‌های جایگزین کار نمی‌کند، توصیه می‌کنیم به جای استفاده از "*"، هر نام جایگزین را با یک دستورالعمل ServerAlias جداگانه فهرست کنید.
.\"#ServerName
.TP 5
\fBServerName \fIhostname\fR
نام میزبان کاملاً واجد شرایط (FQDN) سرور را مشخص می‌کند.
مقدار پیش‌فرض، مقداری است که توسط دستور
.BR hostname (1)
گزارش شده است.
.\"#ServerTokens
.TP 5
\fBServerTokens None\fR
.TP 5
\fBServerTokens ProductOnly\fR
.TP 5
\fBServerTokens Major\fR
.TP 5
\fBServerTokens Minor\fR
.TP 5
\fBServerTokens Minimal\fR
.TP 5
\fBServerTokens OS\fR
.TP 5
\fBServerTokens Full\fR
مشخص می‌کند چه اطلاعاتی در هدر Server پاسخ‌های HTTP گنجانده شود.
مقدار "None" هدر Server را غیرفعال می‌کند.
مقدار "ProductOnly" عبارت "CUPS" را گزارش می‌دهد.
مقدار "Major" عبارت "CUPS/major IPP/2" را گزارش می‌دهد.
مقدار "Minor" عبارت "CUPS/major.minor IPP/2.1" را گزارش می‌دهد.
مقدار "Minimal" عبارت "CUPS/major.minor.patch IPP/2.1" را گزارش می‌دهد.
مقدار "OS" عبارت "CUPS/major.minor.path (osname osversion) IPP/2.1" را گزارش می‌دهد.
مقدار "Full" عبارت "CUPS/major.minor.path (osname osversion; architecture) IPP/2.1" را گزارش می‌دهد.
مقدار پیش‌فرض "Minimal" است.
.\"#SSLListen
.TP 5
\fBSSLListen \fIipv4-address\fB:\fIport\fR
.TP 5
\fBSSLListen [\fIipv6-address\fB]:\fIport\fR
.TP 5
\fBSSLListen *:\fIport\fR
برای برقراری اتصالات رمزگذاری‌شده به آدرس و پورت مشخص‌شده گوش می‌دهد.
.\"#SSLOptions
.TP 5
\fBSSLOptions \fR[\fIAllowDH\fR] [\fIAllowRC4\fR] [\fIAllowSSL3\fR] [\fIDenyCBC\fR] [\fIDenyTLS1.0\fR] [\fIMaxTLS1.0\fR] [\fIMaxTLS1.1\fR] [\fIMaxTLS1.2\fR] [\fIMaxTLS1.3\fR] [\fIMinTLS1.0\fR] [\fIMinTLS1.1\fR] [\fIMinTLS1.2\fR] [\fIMinTLS1.3\fR] [\fINoSystem\fR]
.TP 5
\fBSSLOptions None\fR
گزینه‌های رمزنگاری را تنظیم می‌کند (فقط در /etc/cups/client.conf).
به‌طور پیش‌فرض، CUPS فقط از رمزنگاری با استفاده از TLS نسخه 1.0 یا بالاتر با مجموعه‌های رمزنگاری امنِ شناخته‌شده پشتیبانی می‌کند.
هنگام استفاده از گزینه‌های \fIAllow\fR امنیت کاهش می‌یابد.
هنگام استفاده از گزینه‌های \fIDeny\fR امنیت افزایش می‌یابد.
گزینه \fIAllowDH\fR مجموعه‌های رمزنگاری استفاده‌کننده از تبادل کلید ساده دیفی-هلمن را فعال می‌کند (در سیستم‌های مبتنی بر GNU TLS پشتیبانی نمی‌شود).
گزینه \fIAllowRC4\fR مجموعه‌های رمزنگاری ۱۲۸ بیتی RC4 را فعال می‌کند که برای برخی کلاینت‌های قدیمی‌تر مورد نیاز است.
گزینه \fIAllowSSL3\fR نسخه SSL 3.0 را فعال می‌کند که برای برخی کلاینت‌های قدیمی‌تر که از TLS 1.0 پشتیبانی نمی‌کنند لازم است.
گزینه \fIDenyCBC\fR تمام مجموعه‌های رمزنگاری CBC را غیرفعال می‌کند.
گزینه \fIDenyTLS1.0\fR پشتیبانی از TLS 1.0 را غیرفعال می‌کند \- این کار حداقل نسخه پروتکل را روی TLS 1.1 تنظیم می‌نماید.
گزینه‌های \fIMinTLS\fR حداقل نسخه TLS مورد پشتیبانی را تعیین می‌کنند.
گزینه‌های \fIMaxTLS\fR حداکثر نسخه TLS مورد پشتیبانی را تعیین می‌کنند.
گزینه \fINoSystem\fR اعمال سیاست‌های رمزنگاری سیستمی را غیرفعال می‌کند.
در حال حاضر همه سیستم‌عامل‌ها از TLS 1.3 پشتیبانی نمی‌کنند.
.\"#SSLPort
.TP 5
\fBSSLPort \fIport\fR
برای برقراری اتصالات رمزگذاری‌شده به پورت مشخص‌شده گوش می‌دهد.
.\"#StrictConformance
.TP 5
\fBStrictConformance Yes\fR
.TP 5
\fBStrictConformance No\fR
مشخص می‌کند که آیا زمان‌بند کلاینت‌ها را ملزم به پیروی دقیق از مشخصات IPP می‌کند یا خیر.
مقدار پیش‌فرض "No" است.
.\"#Timeout
.TP 5
\fBTimeout \fIseconds\fR
مهلت زمانی (timeout) درخواست HTTP را مشخص می‌کند.
مقدار پیش‌فرض "900" (۱۵ دقیقه) است.
.\"#WebInterface
.TP 5
\fBWebInterface yes\fR
.TP 5
\fBWebInterface no\fR
مشخص می‌کند که آیا رابط وب فعال باشد یا خیر.
مقدار پیش‌فرض "No" است.
.SS "نام‌های متد HTTP (HTTP METHOD NAMES)"
متدهای HTTP زیر توسط
.BR cupsd (8)
پشتیبانی می‌شوند:
.TP 5
GET
توسط یک کلاینت برای بارگیری آیکون‌ها و سایر منابع چاپگر و دسترسی به رابط وب CUPS استفاده می‌شود.
.TP 5
HEAD
توسط یک کلاینت برای دریافت نوع، اندازه و تاریخ تغییر منابع استفاده می‌شود.
.TP 5
OPTIONS
توسط یک کلاینت برای برقراری یک اتصال امن (SSL/TLS) استفاده می‌شود.
.TP 5
POST
توسط یک کلاینت برای ارسال درخواست‌های IPP و فرم‌های HTML از طریق رابط وب CUPS استفاده می‌شود.
.TP 5
PUT
توسط یک کلاینت برای بارگذاری فایل‌های پیکربندی استفاده می‌شود.
.SS "نام‌های عملیات IPP (IPP OPERATION NAMES)"
عملیات IPP زیر توسط
.BR cupsd (8)
پشتیبانی می‌شوند:
.TP 5
CUPS\-Accept\-Jobs
به یک چاپگر اجازه می‌دهد کارهای جدید را بپذیرد.
.TP 5
CUPS\-Add\-Modify\-Class
یک کلاس چاپگر را اضافه می‌کند یا تغییر می‌دهد.
.TP 5
CUPS\-Add\-Modify\-Printer
یک چاپگر را اضافه می‌کند یا تغییر می‌دهد.
.TP 5
CUPS\-Authenticate\-Job
کاری را که برای احراز هویت نگه‌داشته شده است آزاد می‌کند.
.TP 5
CUPS\-Delete\-Class
یک کلاس چاپگر را حذف می‌کند.
.TP 5
CUPS\-Delete\-Printer
یک چاپگر را حذف می‌کند.
.TP 5
CUPS\-Get\-Classes
فهرستی از کلاس‌های چاپگر را دریافت می‌کند.
.TP 5
CUPS\-Get\-Default
چاپگر یا کلاس چاپگر پیش‌فرض سرور را دریافت می‌کند.
.TP 5
CUPS\-Get\-Devices
فهرستی از دستگاه‌هایی که در حال حاضر در دسترس هستند را دریافت می‌کند.
.TP 5
CUPS\-Get\-Document
یک فایل سند را برای یک کار دریافت می‌کند.
.TP 5
CUPS\-Get\-PPD
یک فایل PPD را دریافت می‌کند.
.TP 5
CUPS\-Get\-PPDs
فهرستی از فایل‌های PPD نصب‌شده را دریافت می‌کند.
.TP 5
CUPS\-Get\-Printers
فهرستی از چاپگرها را دریافت می‌کند.
.TP 5
CUPS\-Move\-Job
یک کار را جابه‌جا می‌کند.
.TP 5
CUPS\-Reject\-Jobs
از پذیرش کارهای جدید توسط یک چاپگر جلوگیری می‌کند.
.TP 5
CUPS\-Set\-Default
چاپگر یا کلاس چاپگر پیش‌فرض سرور را تنظیم می‌کند.
.TP 5
Cancel\-Job
یک کار را لغو می‌کند.
.TP 5
Cancel\-Jobs
یک یا چند کار را لغو می‌کند.
.TP 5
Cancel\-My\-Jobs
یک یا چند کار ایجادشده توسط یک کاربر را لغو می‌کند.
.TP 5
Cancel\-Subscription
یک اشتراک را لغو می‌کند.
.TP 5
Close\-Job
کاری را که در انتظار اسناد بیشتر است می‌بندد.
.TP 5
Create\-Job
یک کار جدید بدون سند ایجاد می‌کند.
.TP 5
Create\-Job\-Subscriptions
یک اشتراک برای رویدادهای کار ایجاد می‌کند.
.TP 5
Create\-Printer\-Subscriptions
یک اشتراک برای رویدادهای چاپگر ایجاد می‌کند.
.TP 5
Get\-Job\-Attributes
اطلاعات مربوط به یک کار را دریافت می‌کند.
.TP 5
Get\-Jobs
فهرستی از کارها را دریافت می‌کند.
.TP 5
Get\-Notifications
فهرستی از اعلان‌های رویداد را برای یک اشتراک دریافت می‌کند.
.TP 5
Get\-Printer\-Attributes
اطلاعات مربوط به یک چاپگر یا کلاس چاپگر را دریافت می‌کند.
.TP 5
Get\-Subscription\-Attributes
اطلاعات مربوط به یک اشتراک را دریافت می‌کند.
.TP 5
Get\-Subscriptions
فهرستی از اشتراک‌ها را دریافت می‌کند.
.TP 5
Hold\-Job
از چاپ شدن یک کار جلوگیری می‌کند (آن را به حالت تعلیق درمی‌آورد).
.TP 5
Hold\-New\-Jobs
از چاپ شدن تمام کارهای جدید جلوگیری می‌کند.
.TP 5
Pause\-Printer
پردازش کارها توسط یک چاپگر یا کلاس چاپگر را متوقف می‌کند.
.TP 5
Pause\-Printer\-After\-Current\-Job
پردازش کارها توسط یک چاپگر یا کلاس چاپگر را پس از پایان کار فعلی متوقف می‌کند.
.TP 5
Print\-Job
یک کار جدید با یک سند واحد ایجاد می‌کند.
.TP 5
Purge\-Jobs
یک یا چند کار را لغو کرده و تاریخچه کار را پاک می‌کند.
.TP 5
Release\-Held\-New\-Jobs
به کارهایی که قبلاً معلق شده بودند اجازه چاپ می‌دهد.
.TP 5
Release\-Job
به یک کار اجازه چاپ می‌دهد.
.TP 5
Renew\-Subscription
یک اشتراک را تمدید می‌کند.
.TP 5
Restart\-Job
در صورت امکان، یک کار را مجدداً چاپ می‌کند.
.TP 5
Send\-Document
یک سند را به یک کار اضافه می‌کند.
.TP 5
Set\-Job\-Attributes
اطلاعات کار را تغییر می‌دهد.
.TP 5
Set\-Printer\-Attributes
اطلاعات چاپگر یا کلاس چاپگر را تغییر می‌دهد.
.TP 5
Validate\-Job
گزینه‌ها را برای یک کار جدید اعتبارسنجی می‌کند.
.SS "مسیرهای مکان (LOCATION PATHS)"
مسیرهای زیر معمولاً هنگام پیکربندی
.BR cupsd (8)
استفاده می‌شوند:
.TP 5
/
مسیر برای تمام عملیات دریافت (get-printers، get-jobs و غیره)
.TP 5
/admin
مسیر برای تمام عملیات مدیریتی (add-printer، delete-printer، start-printer و غیره)
.TP 5
/admin/conf
مسیر برای دسترسی به فایل‌های پیکربندی CUPS (cupsd.conf، client.conf و غیره)
.TP 5
/admin/log
مسیر برای دسترسی به فایل‌های گزارش CUPS (access_log، error_log، page_log)
.TP 5
/classes
مسیر برای تمام کلاس‌های چاپگر
.TP 5
/classes/name
منبع مربوط به کلاس چاپگر نام‌برده
.TP 5
/jobs
مسیر برای تمام کارها (hold-job، release-job و غیره)
.TP 5
/jobs/id
مسیر مربوط به کار مشخص‌شده
.TP 5
/printers
مسیر برای تمام چاپگرها
.TP 5
/printers/name
مسیر مربوط به چاپگر نام‌برده
.TP 5
/printers/name.png
مسیر فایل آیکون برای چاپگر نام‌برده
.TP 5
/printers/name.ppd
مسیر فایل PPD برای چاپگر نام‌برده
.SS "دستورالعمل‌های معتبر در بخش‌های LOCATION و LIMIT (DIRECTIVES VALID WITHIN LOCATION AND LIMIT SECTIONS)"
دستورالعمل‌های زیر ممکن است در بخش‌های Location و Limit در فایل \fBcupsd.conf\fR قرار گیرند:
.TP 5
\fBAllow all\fR
.TP 5
\fBAllow none\fR
.TP 5
\fBAllow \fIhost.domain.com\fR
.TP 5
\fBAllow *.\fIdomain.com\fR
.TP 5
\fBAllow \fIipv4-address\fR
.TP 5
\fBAllow \fIipv4-address\fB/\fInetmask\fR
.TP 5
\fBAllow \fIipv4-address\fB/\fImm\fR
.TP 5
\fBAllow [\fIipv6-address\fB]\fR
.TP 5
\fBAllow [\fIipv6-address\fB]/\fImm\fR
.TP 5
\fBAllow @IF(\fIname\fB)\fR
.TP 5
\fBAllow @LOCAL\fR
دسترسی از میزبان‌ها، دامنه‌ها، آدرس‌ها یا رابط‌های نام‌برده را مجاز می‌کند.
قالب @IF(name) از زیرشبکه‌های فعلی پیکربندی‌شده برای رابط نام‌برده استفاده می‌کند.
قالب @LOCAL از زیرشبکه‌های فعلی پیکربندی‌شده برای تمام رابط‌هایی که نقطه-به-نقطه (point-to-point) نیستند استفاده می‌کند؛ برای مثال رابط‌های اترنت و وای‌فای استفاده می‌شوند اما رابط‌های DSL و VPN استفاده نمی‌شوند.
دستورالعمل Order کنترل می‌کند که آیا خطوط Allow قبل از خطوط Deny ارزیابی شوند یا بعد از آن‌ها.
.TP 5
\fBAuthType None\fR
.TP 5
\fBAuthType Basic\fR
.TP 5
\fBAuthType Default\fR
نوع احراز هویت مورد نیاز را مشخص می‌کند.
مقدار "Default" با مقدار DefaultAuthType مطابقت دارد.
.TP 5
\fBDeny all\fR
.TP 5
\fBDeny none\fR
.TP 5
\fBDeny \fIhost.domain.com\fR
.TP 5
\fBDeny *.\fIdomain.com\fR
.TP 5
\fBDeny \fIipv4-address\fR
.TP 5
\fBDeny \fIipv4-address\fB/\fInetmask\fR
.TP 5
\fBDeny \fIipv4-address\fB/\fImm\fR
.TP 5
\fBDeny [\fIipv6-address\fB]\fR
.TP 5
\fBDeny [\fIipv6-address\fB]/\fImm\fR
.TP 5
\fBDeny @IF(\fIname\fB)\fR
.TP 5
\fBDeny @LOCAL\fR
دسترسی از میزبان‌ها، دامنه‌ها، آدرس‌ها یا رابط‌های نام‌برده را رد می‌کند.
قالب @IF(name) از زیرشبکه‌های فعلی پیکربندی‌شده برای رابط نام‌برده استفاده می‌کند.
قالب @LOCAL از زیرشبکه‌های فعلی پیکربندی‌شده برای تمام رابط‌هایی که نقطه-به-نقطه (point-to-point) نیستند استفاده می‌کند؛ برای مثال رابط‌های اترنت و وای‌فای استفاده می‌شوند اما رابط‌های DSL و VPN استفاده نمی‌شوند.
دستورالعمل Order کنترل می‌کند که آیا خطوط Deny قبل از خطوط Allow ارزیابی شوند یا بعد از آن‌ها.
.TP 5
\fBEncryption IfRequested\fR
.TP 5
\fBEncryption Never\fR
.TP 5
\fBEncryption Required\fR
سطح رمزنگاری مورد نیاز برای یک مکان خاص را مشخص می‌کند.
مقدار پیش‌فرض "IfRequested" است.
.TP 5
\fBOrder allow,deny\fR
مشخص می‌کند که دسترسی به‌طور پیش‌فرض رد شده است. سپس خطوط Allow و به دنبال آن خطوط Deny پردازش می‌شوند تا مشخص شود آیا یک کلاینت می‌تواند به یک منبع خاص دسترسی داشته باشد یا خیر.
.TP 5
\fBOrder deny,allow\fR
مشخص می‌کند که دسترسی به‌طور پیش‌فرض مجاز است. سپس خطوط Deny و به دنبال آن خطوط Allow پردازش می‌شوند تا مشخص شود آیا یک کلاینت می‌تواند به یک منبع خاص دسترسی داشته باشد یا خیر.
.TP 5
\fBRequire group \fIgroup-name \fR[ \fIgroup-name \fR... ]
مشخص می‌کند که یک کاربر احراز هویت‌شده باید عضو یکی از گروه‌های نام‌برده باشد.
.TP 5
\fBRequire user {\fIuser-name\fR|\fB@\fIgroup-name\fR} ...
مشخص می‌کند که یک کاربر احراز هویت‌شده باید با یکی از کاربران نام‌برده مطابقت داشته باشد یا عضو یکی از گروه‌های نام‌برده باشد.
نام گروه "@SYSTEM" متناظر با فهرست گروه‌های تعریف‌شده توسط دستورالعمل SystemGroup در فایل
.BR cups-files.conf (5)
است.
نام گروه "@OWNER" متناظر با مالک منبع است، به عنوان مثال فردی که کار چاپ را ارسال کرده است.
.LP
\fBنکته:\fR کاربر 'root' ویژگی خاصی ندارد و مانند هر حساب کاربری دیگری باید به آن امتیازات اعطا شود.
.TP 5
\fBRequire valid-user\fR
مشخص می‌کند که هر کاربر احراز هویت‌شده‌ای پذیرفته می‌شود.
.TP 5
\fBSatisfy all\fR
مشخص می‌کند که تمام شرایط Allow، AuthType، Deny، Order و Require باید برای اجازه دسترسی برآورده شوند.
.TP 5
\fBSatisfy any\fR
مشخص می‌کند در صورتی که هر یک از شرایط احراز هویت (AuthType/Require) یا آدرس (Allow/Deny/Order) برآورده شود، یک کلاینت می‌تواند به یک منبع دسترسی یابد.
به عنوان مثال، می‌توان از این گزینه برای الزامی کردن احراز هویت تنها برای دسترسی‌های از راه دور استفاده کرد.
.SS "دستورالعمل‌های معتبر در بخش‌های POLICY (DIRECTIVES VALID WITHIN POLICY SECTIONS)"
دستورالعمل‌های زیر ممکن است در بخش‌های Policy در فایل \fBcupsd.conf\fR قرار گیرند:
.TP 5
\fBJobPrivateAccess all\fR
.TP 5
\fBJobPrivateAccess default\fR
.TP 5
\fBJobPrivateAccess \fR{\fIuser\fR|\fB@\fIgroup\fR|\fB@ACL\fR|\fB@OWNER\fR|\fB@SYSTEM\fR} ...
یک فهرست دسترسی برای مقادیر خصوصی یک کار مشخص می‌کند.
فهرست دسترسی پیش‌فرض ("default") برابر با "@OWNER @SYSTEM" است.
مقدار "@ACL" با مقادیر requesting-user-name-allowed یا requesting-user-name-denied چاپگر نگاشت می‌شود.
مقدار "@OWNER" با مالک کار نگاشت می‌شود.
مقدار "@SYSTEM" با گروه‌های فهرست‌شده برای دستورالعمل SystemGroup در فایل
.BR cups-files.conf (5)
نگاشت می‌شود.
.TP 5
\fBJobPrivateValues all\fR
.TP 5
\fBJobPrivateValues default\fR
.TP 5
\fBJobPrivateValues none\fR
.TP 5
\fBJobPrivateValues \fIattribute-name \fR[ ... \fIattribute-name \fR]
فهرست مقادیر کار را برای خصوصی کردن مشخص می‌کند.
مقادیر پیش‌فرض ("default") عبارتند از "job-name"، "job-originating-host-name"، "job-originating-user-name" و "phone".
.TP 5
\fBSubscriptionPrivateAccess all\fR
.TP 5
\fBSubscriptionPrivateAccess default\fR
.TP 5
\fBSubscriptionPrivateAccess \fR{\fIuser\fR|\fB@\fIgroup\fR|\fB@ACL\fR|\fB@OWNER\fR|\fB@SYSTEM\fR} ...
یک فهرست دسترسی برای مقادیر خصوصی یک اشتراک مشخص می‌کند.
فهرست دسترسی پیش‌فرض ("default") برابر با "@OWNER @SYSTEM" است.
مقدار "@ACL" با مقادیر requesting-user-name-allowed یا requesting-user-name-denied چاپگر نگاشت می‌شود.
مقدار "@OWNER" با مالک کار نگاشت می‌شود.
مقدار "@SYSTEM" با گروه‌های فهرست‌شده برای دستورالعمل SystemGroup در فایل
.BR cups-files.conf (5)
نگاشت می‌شود.
.TP 5
\fBSubscriptionPrivateValues all\fR
.TP 5
\fBSubscriptionPrivateValues default\fR
.TP 5
\fBSubscriptionPrivateValues none\fR
.TP 5
\fBSubscriptionPrivateValues \fIattribute-name \fR[ ... \fIattribute-name \fR]
فهرست مقادیر اشتراک را برای خصوصی کردن مشخص می‌کند.
مقادیر پیش‌فرض ("default") عبارتند از "notify-events"، "notify-pull-method"، "notify-recipient-uri"، "notify-subscriber-user-name" و "notify-user-data".
.SS "دستورالعمل‌های منسوخ‌شده (DEPRECATED DIRECTIVES)"
دستورالعمل‌های زیر منسوخ شده‌اند و در نسخه‌های آینده CUPS حذف خواهند شد:
.TP 5
\fBAuthType Negotiate\fR
مشخص می‌کند که احراز هویت کربروس (Kerberos) مورد نیاز است.
.\"#Classification
.TP 5
\fBClassification \fIbanner\fR
.br
طبقه‌بندی امنیتی سرور را مشخص می‌کند.
هر نام بنر معتبری می‌تواند استفاده شود، از جمله "classified"، "confidential"، "secret"، "topsecret" و "unclassified"، یا بنر می‌تواند حذف شود تا عملکردهای چاپ امن غیرفعال گردند.
پیش‌فرض، نداشتن بنر طبقه‌بندی است.
.\"#ClassifyOverride
.TP 5
\fBClassifyOverride Yes\fR
.TP 5
\fBClassifyOverride No\fR
.br
مشخص می‌کند که آیا کاربران می‌توانند طبقه‌بندی (صفحه پوششی) کارهای چاپ منفرد را با استفاده از گزینه "job-sheets" لغو کنند یا خیر.
مقدار پیش‌فرض "No" است.
.TP 5
\fBDefaultAuthType Negotiate\fR
مشخص می‌کند که احراز هویت کربروس به‌طور پیش‌فرض مورد نیاز است.
.\"#GSSServiceName
.TP 5
\fBGSSServiceName \fIname\fR
نام سرویس را هنگام استفاده از احراز هویت کربروس مشخص می‌کند.
نام سرویس پیش‌فرض "http." است.
.\"#PageLogFormat
.TP 5
\fBPageLogFormat \fIformat-string\fR
قالب خطوط PageLog را مشخص می‌کند.
دنباله‌هایی که با نویسه درصد (%) آغاز می‌شوند با اطلاعات متناظر جایگزین می‌گردند، در حالی که تمام نویسه‌های دیگر عیناً کپی می‌شوند.
دنباله‌های درصد زیر شناخته می‌شوند:
.nf

    "%%" یک نویسه درصد منفرد درج می‌کند.
    "%{name}" مقدار صفت مشخص‌شدهٔ IPP را درج می‌کند.
    "%C" تعداد رونوشت‌ها را برای صفحه جاری درج می‌کند.
    "%P" شماره صفحه جاری را درج می‌کند.
    "%T" تاریخ و زمان جاری را در قالب گزارش مشترک درج می‌کند.
    "%j" شناسه کار (job ID) را درج می‌کند.
    "%p" نام چاپگر را درج می‌کند.
    "%u" نام کاربری را درج می‌کند.

.fi
مقدار پیش‌فرض رشته خالی است که ثبت گزارش صفحه را غیرفعال می‌کند.
رشته "%p %u %j %T %P %C %{job-billing} %{job-originating-host-name} %{job-name} %{media} %{sides}" یک گزارش صفحه با موارد استاندارد ایجاد می‌کند.
از "%{job-impressions-completed}" برای درج تعداد صفحات (روها) چاپ‌شده، یا از "%{job-media-sheets-completed}" برای درج تعداد برگه‌های چاپ‌شده استفاده کنید.
.SH "نکات (NOTES)"
دستورالعمل‌های پیکربندی فایل، دایرکتوری و کاربر که قبلاً در فایل \fBcupsd.conf\fR مجاز بودند، اکنون به منظور جلوگیری از انواع خاصی از حملات افزایش سطح دسترسی (privilege escalation)، در فایل
.BR cups-files.conf (5)
ذخیره می‌شوند.
.PP
زمان‌بند باید پس از اعمال تغییرات در فایل \fBcupsd.conf\fR به‌صورت دستی راه‌اندازی مجدد شود.
در لینوکس این کار معمولاً با استفاده از دستور
.BR systemctl (8)
انجام می‌شود، در حالی که در macOS دستور
.BR launchctl (8)
به کار می‌رود.
.PP
نام ماکروی @LOCAL می‌تواند گیج‌کننده باشد زیرا سیستمی که
.B cupsd
را اجرا می‌کند اغلب به مجموعه‌ای از زیرشبکه‌ها متفاوت از کلاینت‌هایش تعلق دارد.
.SH "سازگاری با استانداردها (CONFORMING TO)"
قالب فایل \fBcupsd.conf\fR بر اساس قالب فایل پیکربندی سرور وب آپاچی (Apache HTTP Server) است.
.SH "مثال‌ها (EXAMPLES)"
ثبت گزارش همه‌چیز با حداکثر اندازه فایل گزارش ۳۲ مگابایت:
.nf

    AccessLogLevel all
    LogLevel debug2
    MaxLogSize 32m

.fi
الزام احراز هویت برای دسترسی‌ها از خارج شبکه .10:
.nf

    <Location />
    Order allow,deny
    Allow from 10./8
    AuthType Basic
    Require valid-user
    Satisfy any
    </Location>
.fi
.SH "همچنین ببینید (SEE ALSO)"
.BR classes.conf (5),
.BR cups-files.conf (5),
.BR cupsd (8),
.BR mime.convs (5),
.BR mime.types (5),
.BR printers.conf (5),
.BR subscriptions.conf (5),
راهنمای آنلاین CUPS (http://localhost:631/help)
.SH "حق نشر (COPYRIGHT)"
Copyright \[co] 2020-2025 by OpenPrinting.