.\"
.\" cups-files.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 cups-files.conf 5 "CUPS" "2025-10-08" "OpenPrinting"
.SH "نام (NAME)"
cups\-files.conf \- فایل پیکربندی فایل‌ها و دایرکتوری‌ها برای cups
.SH "توضیحات (DESCRIPTION)"
فایل \fBcups\-files.conf\fR فایل‌ها و دایرکتوری‌های مورد استفاده زمان‌بند CUPS،
.BR cupsd (8)،
را پیکربندی می‌کند.
این فایل معمولاً در دایرکتوری \fI/etc/cups\fR قرار دارد.
.LP
هر خط در این فایل می‌تواند یک دستورالعمل پیکربندی، یک خط خالی یا یک توضیح (کامنت) باشد.
دستورالعمل‌های پیکربندی معمولاً شامل یک نام و صفر یا چند مقدار هستند که با نویسه فاصله از هم جدا شده‌اند.
نام و مقادیر دستورالعمل‌های پیکربندی به حروف بزرگ و کوچک حساس نیستند.
خطوط توضیحات با نویسه # آغاز می‌شوند.
.SS "دستورالعمل‌ها (DIRECTIVES)"
دستورالعمل‌های زیر توسط
.BR cupsd (8)
پشتیبانی می‌شوند:
.\"#AccessLog
.TP 5
\fBAccessLog\fR
.TP 5
\fBAccessLog \fIfilename\fR
.TP 5
\fBAccessLog stderr\fR
.TP 5
\fBAccessLog syslog\fR
نام فایل گزارش دسترسی را مشخص می‌کند.
تعیین یک نام فایل خالی، تولید گزارش دسترسی را غیرفعال می‌کند.
مقدار "stderr" موجب می‌شود ورودی‌های گزارش در صورت اجرای زمان‌بند در پیش‌زمینه به فایل خطای استاندارد و در صورت اجرا در پس‌زمینه به دیمن لاگ سیستم ارسال شوند.
مقدار "syslog" باعث می‌شود ورودی‌های گزارش به دیمن لاگ سیستم ارسال گردند.
نام سرور را می‌توان با استفاده از رشته "%s" در نام فایل‌ها گنجاند؛ به عنوان مثال:
.nf

    AccessLog /var/log/cups/%s-access_log

.fi
مقدار پیش‌فرض "/var/log/cups/access_log" است.
.\"#CacheDir
.TP 5
\fBCacheDir \fIdirectory\fR
دایرکتوری مورد استفاده برای فایل‌های موقت طولانی‌مدت (حافظه موقت/کَش) را مشخص می‌کند.
مقدار پیش‌فرض بسته به پلتفرم "/var/spool/cups/cache" یا "/var/cache/cups" است.
.\"#ConfigFilePerm
.TP 5
\fBConfigFilePerm \fImode\fR
مجوزهای دسترسی را برای تمام فایل‌های پیکربندی که توسط زمان‌بند نوشته می‌شوند تعیین می‌کند.
مقدار پیش‌فرض در macOS برابر با "0644" و در تمام سیستم‌عامل‌های دیگر "0640" است.
.LP
\fBنکته:\fR مجوزهای فایل \fIprinters.conf\fR در حال حاضر ماسک شده‌اند تا فقط دسترسی کاربر زمان‌بند (معمولاً root) مجاز باشد.
این کار به این دلیل انجام می‌شود که شناسه منابع یکنواخت (URI) دستگاه چاپگر گاهی حاوی اطلاعات احراز هویت حساسی است که نباید به‌طور عمومی در سیستم افشا شود.
هیچ راهی برای غیرفعال کردن این ویژگی امنیتی وجود ندارد.
.\"#CreateSelfSignedCerts
.TP 5
\fBCreateSelfSignedCerts yes\fR
.TP 5
\fBCreateSelfSignedCerts no\fR
مشخص می‌کند که آیا زمان‌بند به‌طور خودکار گواهی‌های خودامضاشده را برای اتصال‌های کلاینت با استفاده از TLS ایجاد کند یا خیر.
مقدار پیش‌فرض yes است.
.\"#DataDir
.TP 5
\fBDataDir \fIpath\fR
دایرکتوری محل قرارگیری فایل‌های داده را مشخص می‌کند.
مقدار پیش‌فرض معمولاً "/usr/share/cups" است.
.\"#DocumentRoot
.TP 5
\fBDocumentRoot \fIdirectory\fR
دایرکتوری ریشه را برای محتوای رابط وب CUPS مشخص می‌کند.
مقدار پیش‌فرض معمولاً "/usr/share/doc/cups" است.
.\"#ErrorLog
.TP 5
\fBErrorLog\fR
.TP 5
\fBErrorLog \fIfilename\fR
.TP 5
\fBErrorLog stderr\fR
.TP 5
\fBErrorLog syslog\fR
نام فایل گزارش خطا را مشخص می‌کند.
تعیین یک نام فایل خالی، تولید گزارش خطا را غیرفعال می‌کند.
مقدار "stderr" موجب می‌شود ورودی‌های گزارش در صورت اجرای زمان‌بند در پیش‌زمینه به فایل خطای استاندارد و در صورت اجرا در پس‌زمینه به دیمن لاگ سیستم ارسال شوند.
مقدار "syslog" باعث ارسال ورودی‌های گزارش به دیمن لاگ سیستم می‌شود.
نام سرور را می‌توان با استفاده از رشته "%s" در نام فایل‌ها گنجاند؛ به عنوان مثال:
.nf

    ErrorLog /var/log/cups/%s-error_log

.fi
مقدار پیش‌فرض "/var/log/cups/error_log" است.
.\"#FatalErrors
.TP 5
\fBFatalErrors none\fR
.TP 5
\fBFatalErrors all \fI\-kind \fR[ ... \fI\-kind \fR]
.TP 5
\fBFatalErrors \fIkind \fR[ ... \fIkind \fR]
مشخص می‌کند کدام خطاها مهلک بوده و موجب خروج زمان‌بند می‌شوند.
مقدار پیش‌فرض "config" است.
رشته‌های \fIkind\fR عبارتند از:
.RS 5
.TP 5
.B none
هیچ خطایی مهلک نیست.
.TP 5
.B all
تمام خطاهای زیر مهلک هستند.
.TP 5
.B browse
خطاهای راه‌اندازی مرور و هم‌رسانی مهلک هستند؛ برای مثال عدم موفقیت در اتصال به دیمن DNS-SD.
.TP 5
.B config
خطاهای نحوی فایل پیکربندی مهلک هستند.
.TP 5
.B listen
خطاهای گوش دادن (Listen) یا درگاه (Port) مهلک هستند؛ به‌جز خطاهای IPv6 روی آدرس لوپ‌بک یا آدرس‌های "any".
.TP 5
.B log
خطاهای ایجاد یا نوشتن در فایل گزارش مهلک هستند.
.TP 5
.B permissions
مجوزهای نادرست فایل‌های راه‌اندازی مهلک هستند؛ برای مثال فایل‌های کلید و گواهی مشترک TLS با مجوزهای خواندن همگانی.
.RE
.\"#Group
.TP 5
\fBGroup \fIgroup-name-or-number\fR
نام یا شناسه گروهی را تعیین می‌کند که هنگام اجرای برنامه‌های خارجی استفاده خواهد شد.
گروه پیش‌فرض مختص سیستم‌عامل است، اما معمولاً "lp" یا "nobody" است.
.RE
.\"#LogFileGroup
.TP 5
\fBLogFileGroup \fIgroup-name-or-number\fR
نام یا شناسه گروهی را تعیین می‌کند که برای فایل‌های گزارش استفاده خواهد شد.
گروه پیش‌فرض مختص سیستم‌عامل است، اما معمولاً "lp" یا "nobody" است.
.\"#LogFilePerm
.TP 5
\fBLogFilePerm \fImode\fR
مجوزهای تمام فایل‌های گزارشی را که زمان‌بند می‌نویسد مشخص می‌کند.
مقدار پیش‌فرض "0644" است.
.\"#PageLog
.TP 5
\fBPageLog \fR[ \fIfilename\fR ]
.TP 5
\fBPageLog stderr\fR
.TP 5
\fBPageLog syslog\fR
نام فایل گزارش صفحات را مشخص می‌کند.
مقدار "stderr" موجب می‌شود ورودی‌های گزارش در صورت اجرای زمان‌بند در پیش‌زمینه به فایل خطای استاندارد و در صورت اجرا در پس‌زمینه به دیمن لاگ سیستم ارسال شوند.
مقدار "syslog" باعث ارسال ورودی‌های گزارش به دیمن لاگ سیستم می‌شود.
تعیین یک نام فایل خالی، تولید گزارش صفحات را غیرفعال می‌سازد.
نام سرور را می‌توان با استفاده از رشته "%s" در نام فایل‌ها گنجاند؛ به عنوان مثال:
.nf

    PageLog /var/log/cups/%s-page_log

.fi
مقدار پیش‌فرض "/var/log/cups/page_log" است.
.\"#PassEnv
.TP 5
\fBPassEnv \fIvariable \fR[ ... \fIvariable \fR]
متغیر(های) محیطی مشخص‌شده را به فرآیندهای فرزند ارسال می‌کند.
نکته: متغیرهای محیطی استاندارد فیلتر و بک‌اند CUPS را نمی‌توان با استفاده از این دستورالعمل بازنویسی کرد.
.\"#PeerCred
.TP 5
\fBPeerCred off\fR
.TP 5
\fBPeerCred on\fR
.TP 5
\fBPeerCred root-only\fR
مشخص می‌کند که آیا از اعتبارنامه‌های همتا (peer credentials) برای احراز هویت هنگام برقراری ارتباط از طریق سوکت دامنه یونیکس استفاده شود یا خیر.
هنگامی که روی \fBon\fR تنظیم شود، اعتبارنامه‌های همتای هر کاربری برای احراز هویت پذیرفته می‌شود.
مقدار \fBoff\fR استفاده از اعتبارنامه‌های همتا را به‌طور کامل غیرفعال می‌کند، در حالی که مقدار \fBroot-only\fR اعتبارنامه‌های همتا را فقط برای کاربر root مجاز می‌داند.
نکته: به دلایل امنیتی، مقدار \fBon\fR برای احراز هویت درخواست‌های PUT به \fBroot-only\fR تقلیل می‌یابد.
.\"#RemoteRoot
.TP 5
\fBRemoteRoot \fIusername\fR
نام کاربری مرتبط با دسترسی‌های احراز هویت‌نشده توسط کلاینت‌هایی که ادعا می‌کنند کاربر root هستند را مشخص می‌کند.
مقدار پیش‌فرض "remroot" است.
.\"#RequestRoot
.TP 5
\fBRequestRoot \fIdirectory\fR
دایرکتوری حاوی کارهای چاپ و سایر داده‌های درخواست HTTP را مشخص می‌کند.
مقدار پیش‌فرض "/var/spool/cups" است.
.\"#Sandboxing
.TP 5
\fBSandboxing relaxed\fR
.TP 5
\fBSandboxing strict\fR
سطح محدودسازی امنیتی (sandboxing) اعمال‌شده روی فیلترهای چاپ، بک‌اندها و سایر فرآیندهای فرزند زمان‌بند را تعیین می‌کند.
مقدار پیش‌فرض "strict" است.
این دستورالعمل در حال حاضر فقط در macOS استفاده و پشتیبانی می‌شود.
.\"#ServerBin
.TP 5
\fBServerBin \fIdirectory\fR
دایرکتوری حاوی بک‌اندها، برنامه‌های CGI، فیلترها، برنامه‌های کمکی، اعلان‌کننده‌ها و مانیتورهای پورت را مشخص می‌کند.
مقدار پیش‌فرض بسته به پلتفرم "/usr/lib/cups" یا "/usr/libexec/cups" است.
.\"#ServerKeychain
.TP 5
\fBServerKeychain \fIpath\fR
محل قرارگیری گواهی‌های TLS و کلیدهای خصوصی را مشخص می‌کند.
مقدار پیش‌فرض در macOS برابر با "/Library/Keychains/System.keychain" و در تمام سیستم‌عامل‌های دیگر "/etc/cups/ssl" است.
سیستم‌عامل macOS از پایگاه‌داده زنجیره کلید خود برای ذخیره گواهی‌ها و کلیدها استفاده می‌کند، در حالی که سایر پلتفرم‌ها از فایل‌های جداگانه در دایرکتوری مشخص‌شده استفاده می‌کنند؛
.B *.crt
برای گواهی‌های با کدگذاری PEM و
.B *.key
برای کلیدهای خصوصی با کدگذاری PEM.
.\"#ServerRoot
.TP 5
\fBServerRoot \fIdirectory\fR
دایرکتوری حاوی فایل‌های پیکربندی سرور را مشخص می‌کند.
مقدار پیش‌فرض "/etc/cups" است.
.\"#SetEnv
.TP 5
\fBSetEnv \fIvariable value\fR
متغیر محیطی مشخص‌شده را برای ارسال به فرآیندهای فرزند تنظیم می‌کند.
نکته: متغیرهای محیطی استاندارد فیلتر و بک‌اند CUPS را نمی‌توان با استفاده از این دستورالعمل بازنویسی کرد.
.\"#StateDir
.TP 5
\fBStateDir \fIdirectory\fR
دایرکتوری مورد استفاده برای فایل‌های PID و فایل‌های گواهی محلی را مشخص می‌کند.
مقدار پیش‌فرض بسته به پلتفرم "/var/run/cups" یا "/etc/cups" است.
.\"#StripUserDomain
.TP 5
\fBStripUserDomain Yes\fR
.TP 5
\fBStripUserDomain No\fR
مشخص می‌کند که آیا در هنگام احراز هویت کاربر محلی، نام دامنه از نام کاربری حذف شود یا خیر (مانند تبدیل "user@example.com" به "user").
این رویه می‌تواند برای حفظ سازگاری با نسخه‌های قدیمی‌تر Kerberos مفید باشد.
با این حال، فعال کردن این گزینه می‌تواند پیامدهای منفی به همراه داشته باشد.
این کار ممکن است باعث سردرگمی بین کاربران دامنه و کاربران محلی با نام‌های یکسان شود، و به‌طور بالقوه منجر به تخصیص نادرست دسترسی‌های کاربر و افزایش ناخواسته سطح دسترسی (privilege escalation) گردد که یک ریسک امنیتی ایجاد می‌کند. بنابراین توصیه می‌شود در بیشتر موارد از استفاده از این گزینه خودداری شود.
.\"#SyncOnClose
.TP 5
\fBSyncOnClose Yes\fR
.TP 5
\fBSyncOnClose No\fR
مشخص می‌کند که آیا زمان‌بند پس از نوشتن فایل‌های پیکربندی یا وضعیت، فراخوانی
.BR fsync (2)
را انجام دهد یا خیر.
.\"#SystemGroup
.TP 5
\fBSystemGroup \fIgroup-name \fR[ ... \fIgroup-name\fR ]
گروه(هایی) را که برای احراز هویت گروهی \fI@SYSTEM\fR استفاده می‌شوند مشخص می‌کند.
مقدار پیش‌فرض شامل "admin"، "lpadmin"، "root"، "sys" و/یا "system" است.
.\"#TempDir
.TP 5
\fBTempDir \fIdirectory\fR
دایرکتوری محل ذخیره فایل‌های موقت کوتاه‌مدت را مشخص می‌کند.
مقدار پیش‌فرض "/var/spool/cups/tmp" است.
.\"#User
.TP 5
\fBUser \fIusername\fR
نام کاربری یا شناسه‌ای را که هنگام اجرای برنامه‌های خارجی استفاده می‌شود مشخص می‌کند.
مقدار پیش‌فرض "lp" است.
.SS "دستورالعمل‌های منسوخ‌شده (DEPRECATED DIRECTIVES)"
دستورالعمل‌های زیر منسوخ شده‌اند و در نسخه‌های آینده CUPS حذف خواهند شد:
.\"#FileDevice
.TP 5
\fBFileDevice Yes\fR
.TP 5
\fBFileDevice No\fR
مشخص می‌کند که آیا شبه‌دستگاه پرونده (file pseudo-device) می‌تواند برای صف‌های چاپگر جدید استفاده شود یا خیر.
شناسه URI با عنوان "file:///dev/null" همواره مجاز است.
دستگاه‌های فایلی را نمی‌توان با صف‌های چاپ خام ("raw") استفاده کرد - یک فایل PPD مورد نیاز است.
فایل مشخص‌شده برای هر کار چاپ رونویسی می‌شود.
نوشتن در دایرکتوری‌ها پشتیبانی نمی‌شود.
.\"#Printcap
.TP 5
\fBPrintcap \fIfilename\fR
فایلی را مشخص می‌کند که با فهرستی از صف‌های چاپ محلی پر می‌شود.
.\"#PrintcapFormat
.TP 5
\fBPrintcapFormat bsd\fR
.TP 5
\fBPrintcapFormat plist\fR
.TP 5
\fBPrintcapFormat solaris\fR
قالب مورد استفاده برای فایل Printcap را مشخص می‌کند.
مقدار "bsd" قالب تاریخی فایل printcap در LPD است.
مقدار "plist" قالب فایل plist متعلق به Apple است.
مقدار "solaris" قالب تاریخی فایل printcap در Solaris LPD است.
.SH "نکات (NOTES)"
زمان‌بند باید پس از اعمال تغییرات در فایل \fBcups-files.conf\fR به‌صورت دستی راه‌اندازی مجدد شود.
در لینوکس این کار معمولاً با استفاده از دستور
.BR systemctl (8)
انجام می‌شود، در حالی که در macOS دستور
.BR launchctl (8)
به کار می‌رود.
.SH "همچنین ببینید (SEE ALSO)"
.BR classes.conf (5),
.BR cups (1),
.BR cupsd (8),
.BR cupsd.conf (5),
.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.