.\" .\" cupsd-logs 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 cupsd-logs 5 "CUPS" "2021-02-28" "OpenPrinting" .SH "نام (NAME)" cupsd\-logs \- پرونده‌های گزارش وقایع cupsd (شامل access_log، error_log و page_log) .SH "توضیحات (DESCRIPTION)" .BR cupsd (8) به‌طور معمول سه پرونده گزارش وقایع را نگهداری می‌کند: .I access_log برای ردگیری درخواست‌های ارسال‌شده به زمان‌بند، .I error_log برای ردگیری پیشرفت و خطاها، و .I page_log برای ردگیری صفحه‌های چاپ‌شده. دستورالعمل‌های پیکربندی در .BR cupsd.conf (5) و .BR cups-files.conf (5) مشخص می‌کنند چه اطلاعاتی ثبت شود و در کجا ذخیره گردد. .SS "قالب پرونده گزارش دسترسی (ACCESS LOG FILE FORMAT)" پرونده \fIaccess_log\fR هر منبع HTTP را که توسط یک مرورگر وب یا کلاینت مورد دسترسی قرار گرفته است، فهرست می‌کند. هر خط در یک نسخه توسعه‌یافته از قالبی موسوم به «قالب گزارش مشترک» (Common Log Format) است که توسط بسیاری از سرورهای وب و ابزارهای گزارش‌گیری وب استفاده می‌شود: .nf \fIhost group user date-time \fR"\fImethod resource version\fR" \fIstatus bytes ipp-operation ipp-status\fR .fi برای مثال: .nf 10.0.1.2 - - [01/Dec/2005:21:50:28 +0000] "POST / HTTP/1.1" 200 317 CUPS-Get-Printers successful-ok-ignored-or-substituted-attributes localhost - - [01/Dec/2005:21:50:32 +0000] "GET /admin HTTP/1.1" 200 0 - - localhost - - [01/Dec/2005:21:50:32 +0000] "POST / HTTP/1.1" 200 157 CUPS-Get-Printers successful-ok-ignored-or-substituted-attributes localhost - - [01/Dec/2005:21:50:32 +0000] "POST / HTTP/1.1" 200 1411 CUPS-Get-Devices - localhost - - [01/Dec/2005:21:50:32 +0000] "GET /admin HTTP/1.1" 200 6667 - - .fi فیلد \fIhost\fR به‌طور معمول تنها یک نشانی IP خواهد بود، مگر اینکه دستورالعمل HostNameLookups را در پرونده \fIcupsd.conf\fR فعال کرده باشید یا نشانی IP مربوط به رایانه محلی شما باشد. .LP فیلد \fIgroup\fR همواره شامل "-" است. .LP فیلد \fIuser\fR نام کاربری احرازهویت‌شده کاربر درخواست‌دهنده است. اگر هیچ نام کاربری و گذرواژه‌ای برای درخواست ارائه نشده باشد، این فیلد شامل "-" خواهد بود. .LP فیلد \fIdate-time\fR تاریخ و زمان درخواست به وقت محلی است و در قالب "[DD/MON/YYYY:HH:MM:SS +ZZZZ]" قرار دارد. .LP فیلد \fImethod\fR متد HTTP استفاده‌شده است: "GET"، "HEAD"، "OPTIONS"، "POST" یا "PUT". درخواست‌های "GET" برای دریافت پرونده‌ها از سرور، چه برای رابط کاربری وب و چه برای دریافت پرونده‌های پیکربندی و لاگ، استفاده می‌شوند. درخواست‌های "HEAD" برای دریافت اطلاعات درباره یک منبع پیش از "GET" به کار می‌روند. درخواست‌های "OPTIONS" برای ارتقای اتصالات به رمزنگاری TLS استفاده می‌شوند. درخواست‌های "POST" برای فرم‌های رابط وب و درخواست‌های IPP به کار می‌روند. درخواست‌های "PUT" برای بارگذاری پرونده‌های پیکربندی استفاده می‌شوند. .LP فیلد \fIresource\fR نام پرونده منبع درخواست‌شده است. .LP فیلد \fIversion\fR نسخه مشخصات HTTP استفاده‌شده توسط کلاینت است. برای کلاینت‌های CUPS این مقدار همواره "HTTP/1.1" خواهد بود. .LP فیلد \fIstatus\fR شامل وضعیت نتیجه HTTP درخواست است، به شرح زیر: .RS 5 .TP 5 200 عملیات موفقیت‌آمیز. .TP 5 201 پرونده با موفقیت ایجاد/ویرایش شد. .TP 5 304 پرونده درخواست‌شده تغییری نکرده است. .TP 5 400 درخواست HTTP نامعتبر؛ معمولاً بدین معناست که یک برنامه مخرب در تلاش برای دسترسی به سرور شماست. .TP 5 401 دسترسی غیرمجاز، احراز هویت (نام کاربری + گذرواژه) الزامی است. .TP 5 403 دسترسی ممنوع است؛ معمولاً بدین معناست که کلاینت تلاش کرده به پرونده یا منبعی دسترسی یابد که مجوز دسترسی به آن را ندارد. .TP 5 404 پرونده یا منبع مورد نظر وجود ندارد. .TP 5 405 متد دسترسی به نشانی اینترنتی (URL) مجاز نیست؛ معمولاً بدین معناست که یک مرورگر وب از سرور شما به عنوان پروکسی استفاده می‌کند. .TP 5 413 درخواست بسیار حجیم است؛ معمولاً بدین معناست که یک کلاینت تلاش کرده پرونده‌ای بزرگ‌تر از حد مجاز MaxRequestSize را چاپ کند. .TP 5 426 ارتقا به اتصال رمزنگاری‌شده با TLS. .TP 5 500 خطای سرور؛ معمولاً زمانی رخ می‌دهد که سرور قادر به باز کردن یا ایجاد یک پرونده نیست \- برای جزئیات به پرونده error_log مراجعه کنید. .TP 5 501 کلاینت درخواست رمزنگاری داده است، اما پشتیبانی از رمزنگاری فعال/کامپایل نشده است. .TP 5 505 شماره نسخه HTTP پشتیبانی نمی‌شود؛ معمولاً بدین معناست که برنامه‌ای مخرب در تلاش برای دسترسی به سرور شماست. .RE .LP فیلد \fIbytes\fR شامل تعداد بایت‌های موجود در درخواست است. برای درخواست‌های POST، فیلد bytes شامل تعداد بایت‌های داده غیر IPP است که از کلاینت دریافت می‌شود. .LP فیلد \fIipp-operation\fR برای درخواست‌های غیر IPP شامل "-" و برای درخواست‌های POST حاوی یک درخواست IPP، شامل نام عملیات IPP است. .LP فیلد \fIipp-status\fR برای درخواست‌های غیر IPP شامل "-" و برای درخواست‌های POST حاوی یک پاسخ IPP، شامل نام کد وضعیت IPP است. .SS "قالب پرونده گزارش خطا (ERROR LOG FILE FORMAT)" پرونده \fIerror_log\fR پیام‌های ارائه‌شده از زمان‌بند را فهرست می‌کند \- خطاها، هشدارها و غیره. دستورالعمل LogLevel در پرونده .BR cupsd.conf (5) کنترل می‌کند چه پیام‌هایی ثبت شوند: .nf level date-time message .fi برای مثال: .nf I [20/May/1999:19:18:28 +0000] [Job 1] Queued on 'DeskJet' by 'mike'. D [20/May/1999:19:18:28 +0000] [Job 1] argv[0]="DeskJet" D [20/May/1999:19:18:28 +0000] [Job 1] argv[1]="1" D [20/May/1999:19:18:28 +0000] [Job 1] argv[2]="mike" D [20/May/1999:19:18:28 +0000] [Job 1] argv[3]="myjob" D [20/May/1999:19:18:28 +0000] [Job 1] argv[4]="1" D [20/May/1999:19:18:28 +0000] [Job 1] argv[5]="media= na_letter_8.5x11in sides=one-sided" D [20/May/1999:19:18:28 +0000] [Job 1] argv[6]="/var/spool/cups/ d000001-001" I [20/May/1999:19:21:02 +0000] [Job 2] Queued on 'DeskJet' by 'mike'. I [20/May/1999:19:22:24 +0000] [Job 2] Canceled by 'mike'. .fi فیلد \fIlevel\fR نوع پیام را مشخص می‌کند: .TP 5 A پیام هشدار فوری (LogLevel alert) .TP 5 C پیام خطای بحرانی (LogLevel crit) .TP 5 D پیام اشکال‌زدایی (LogLevel debug) .TP 5 d پیام اشکال‌زدایی تفصیلی (LogLevel debug2) .TP 5 E پیام خطای عادی (LogLevel error) .TP 5 I پیام اطلاعاتی (LogLevel info) .TP 5 N پیام اعلان (LogLevel notice) .TP 5 W پیام هشدار (LogLevel warn) .TP 5 X پیام خطای اضطراری (LogLevel emerg) .LP فیلد \fIdate-time\fR شامل تاریخ و زمان پیام است. قالب این فیلد با فیلد date-time در پرونده \fIaccess_log\fR یکسان است. .LP فیلد \fImessage\fR شامل یک پیام متنی با قالب آزاد است. پیام‌های حاصل از فیلترهای کار دارای پیشوند "[Job NNN]" هستند که در آن "NNN" شناسه کار است. .SS "قالب پرونده گزارش برگه (PAGE LOG FILE FORMAT)" پرونده \fIpage_log\fR تعداد کل صفحات (برگه‌ها) را که چاپ شده‌اند فهرست می‌کند. به‌طور پیش‌فرض، هر خط شامل اطلاعات زیر است: .nf \fIprinter user job-id date-time \fBtotal \fInum-sheets job-billing job-originating-host-name job-name media sides\fR .fi برای مثال ورودی یک کار دو صفحه‌ای به نام "myjob" ممکن است بدین صورت باشد: .nf DeskJet root 1 [20/May/1999:19:21:06 +0000] total 2 acme-123 localhost myjob na_letter_8.5x11in one-sided .fi از دستورالعمل PageLogFormat در پرونده .BR cupsd.conf (5) می‌توان برای تغییر این اطلاعات استفاده کرد. .LP فیلد \fIprinter\fR شامل نام چاپگری است که صفحه را چاپ کرده است. اگر کاری را به یک رده چاپگر ارسال کنید، این فیلد حاوی نام چاپگری خواهد بود که کار به آن تخصیص یافته است. .LP فیلد \fIuser\fR شامل نام کاربری است (صفت requesting-user-name در IPP) که این پرونده را برای چاپ ارسال کرده است. .LP فیلد \fIjob-id\fR شامل شماره کار صفحه‌ای است که چاپ می‌شود. .LP فیلد \fIdate-time\fR شامل تاریخ و زمان شروع چاپ صفحه است. قالب این فیلد دقیقاً مشابه فیلد date-time در پرونده \fIaccess_log\fR است. .LP فیلد \fInum-sheets\fR تعداد کل صفحات (برگه‌ها) را که برای این کار چاپ شده‌اند، ارائه می‌دهد. .LP فیلد \fIjob-billing\fR شامل رونوشتی از صفت‌های job-billing یا job-account-id ارائه‌شده در درخواست‌های Create-Job یا Print-Job پروتکل IPP است، یا در صورتی که هیچ‌کدام ارائه نشده باشند، شامل "-" خواهد بود. .LP فیلد \fIjob-originating-host-name\fR شامل نام میزبان یا نشانی IP کلاینتی است که کار را ارسال کرده است. .LP فیلد \fIjob-name\fR شامل رونوشتی از صفت job-name ارائه‌شده در درخواست‌های Create-Job یا Print-Job پروتکل IPP است، یا در صورتی که هیچ‌کدام ارائه نشده باشند، شامل "-" خواهد بود. .LP فیلد \fImedia\fR شامل رونوشتی از صفت media یا media-col/media-size ارائه‌شده در درخواست‌های Create-Job یا Print-Job پروتکل IPP است، یا در صورتی که ارائه نشده باشد، شامل "-" خواهد بود. .LP فیلد \fIsides\fR شامل رونوشتی از صفت sides ارائه‌شده در درخواست‌های Create-Job یا Print-Job پروتکل IPP است، یا در صورتی که ارائه نشده باشد، شامل "-" خواهد بود. .SH "همچنین ببینید (SEE ALSO)" .BR cupsd (8), .BR cupsd.conf (5), .BR cups-files.conf (5), راهنمای برخط CUPS (http://localhost:631/help) .SH "حق نشر (COPYRIGHT)" Copyright \[co] 2020-2024 by OpenPrinting.