cupsd-logs(5) OpenPrinting cupsd-logs(5) نام (NAME) cupsd-logs - پرونده‌های گزارش وقایع cupsd (شامل access_log، error_log و page_log) توضیحات (DESCRIPTION) cupsd(8) به‌طور معمول سه پرونده گزارش وقایع را نگهداری می‌کند: access_log برای ردگیری درخواست‌های ارسال‌شده به زمان‌بند، error_log برای ردگیری پیشرفت و خطاها، و page_log برای ردگیری صفحه‌های چاپ‌شده. دستورالعمل‌های پیکربندی در cupsd.conf(5) و cups-files.conf(5) مشخص می‌کنند چه اطلاعاتی ثبت شود و در کجا ذخیره گردد. قالب پرونده گزارش دسترسی (ACCESS LOG FILE FORMAT) پرونده access_log هر منبع HTTP را که توسط یک مرورگر وب یا کلاینت مورد دسترسی قرار گرفته است، فهرست می‌کند. هر خط در یک نسخه توسعه‌یافته از قالبی موسوم به «قالب گزارش مشترک» (Common Log Format) است که توسط بسیاری از سرورهای وب و ابزارهای گزارش‌گیری وب استفاده می‌شود: host group user date-time "method resource version" status bytes ipp-operation ipp-status برای مثال: 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 - - فیلد host به‌طور معمول تنها یک نشانی IP خواهد بود، مگر اینکه دستورالعمل HostNameLookups را در پرونده cupsd.conf فعال کرده باشید یا نشانی IP مربوط به رایانه محلی شما باشد. فیلد group همواره شامل "-" است. فیلد user نام کاربری احرازهویت‌شده کاربر درخواست‌دهنده است. اگر هیچ نام کاربری و گذرواژه‌ای برای درخواست ارائه نشده باشد، این فیلد شامل "-" خواهد بود. فیلد date-time تاریخ و زمان درخواست به وقت محلی است و در قالب "[DD/MON/YYYY:HH:MM:SS +ZZZZ]" قرار دارد. فیلد method متد HTTP استفاده‌شده است: "GET"، "HEAD"، "OPTIONS"، "POST" یا "PUT". درخواست‌های "GET" برای دریافت پرونده‌ها از سرور، چه برای رابط کاربری وب و چه برای دریافت پرونده‌های پیکربندی و لاگ، استفاده می‌شوند. درخواست‌های "HEAD" برای دریافت اطلاعات درباره یک منبع پیش از "GET" به کار می‌روند. درخواست‌های "OPTIONS" برای ارتقای اتصالات به رمزنگاری TLS استفاده می‌شوند. درخواست‌های "POST" برای فرم‌های رابط وب و درخواست‌های IPP به کار می‌روند. درخواست‌های "PUT" برای بارگذاری پرونده‌های پیکربندی استفاده می‌شوند. فیلد resource نام پرونده منبع درخواست‌شده است. فیلد version نسخه مشخصات HTTP استفاده‌شده توسط کلاینت است. برای کلاینت‌های CUPS این مقدار همواره "HTTP/1.1" خواهد بود. فیلد status شامل وضعیت نتیجه HTTP درخواست است، به شرح زیر: 200 عملیات موفقیت‌آمیز. 201 پرونده با موفقیت ایجاد/ویرایش شد. 304 پرونده درخواست‌شده تغییری نکرده است. 400 درخواست HTTP نامعتبر؛ معمولاً بدین معناست که یک برنامه مخرب در تلاش برای دسترسی به سرور شماست. 401 دسترسی غیرمجاز، احراز هویت (نام کاربری + گذرواژه) الزامی است. 403 دسترسی ممنوع است؛ معمولاً بدین معناست که کلاینت تلاش کرده به پرونده یا منبعی دسترسی یابد که مجوز دسترسی به آن را ندارد. 404 پرونده یا منبع مورد نظر وجود ندارد. 405 متد دسترسی به نشانی اینترنتی (URL) مجاز نیست؛ معمولاً بدین معناست که یک مرورگر وب از سرور شما به عنوان پروکسی استفاده می‌کند. 413 درخواست بسیار حجیم است؛ معمولاً بدین معناست که یک کلاینت تلاش کرده پرونده‌ای بزرگ‌تر از حد مجاز MaxRequestSize را چاپ کند. 426 ارتقا به اتصال رمزنگاری‌شده با TLS. 500 خطای سرور؛ معمولاً زمانی رخ می‌دهد که سرور قادر به باز کردن یا ایجاد یک پرونده نیست - برای جزئیات به پرونده error_log مراجعه کنید. 501 کلاینت درخواست رمزنگاری داده است، اما پشتیبانی از رمزنگاری فعال/کامپایل نشده است. 505 شماره نسخه HTTP پشتیبانی نمی‌شود؛ معمولاً بدین معناست که برنامه‌ای مخرب در تلاش برای دسترسی به سرور شماست. فیلد bytes شامل تعداد بایت‌های موجود در درخواست است. برای درخواست‌های POST، فیلد bytes شامل تعداد بایت‌های داده غیر IPP است که از کلاینت دریافت می‌شود. فیلد ipp-operation برای درخواست‌های غیر IPP شامل "-" و برای درخواست‌های POST حاوی یک درخواست IPP، شامل نام عملیات IPP است. فیلد ipp-status برای درخواست‌های غیر IPP شامل "-" و برای درخواست‌های POST حاوی یک پاسخ IPP، شامل نام کد وضعیت IPP است. قالب پرونده گزارش خطا (ERROR LOG FILE FORMAT) پرونده error_log پیام‌های ارائه‌شده از زمان‌بند را فهرست می‌کند - خطاها، هشدارها و غیره. دستورالعمل LogLevel در پرونده cupsd.conf(5) کنترل می‌کند چه پیام‌هایی ثبت شوند: level date-time message برای مثال: 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'. فیلد level نوع پیام را مشخص می‌کند: A پیام هشدار فوری (LogLevel alert) C پیام خطای بحرانی (LogLevel crit) D پیام اشکال‌زدایی (LogLevel debug) d پیام اشکال‌زدایی تفصیلی (LogLevel debug2) E پیام خطای عادی (LogLevel error) I پیام اطلاعاتی (LogLevel info) N پیام اعلان (LogLevel notice) W پیام هشدار (LogLevel warn) X پیام خطای اضطراری (LogLevel emerg) فیلد date-time شامل تاریخ و زمان پیام است. قالب این فیلد با فیلد date- time در پرونده access_log یکسان است. فیلد message شامل یک پیام متنی با قالب آزاد است. پیام‌های حاصل از فیلترهای کار دارای پیشوند "[Job NNN]" هستند که در آن "NNN" شناسه کار است. قالب پرونده گزارش برگه (PAGE LOG FILE FORMAT) پرونده page_log تعداد کل صفحات (برگه‌ها) را که چاپ شده‌اند فهرست می‌کند. به‌طور پیش‌فرض، هر خط شامل اطلاعات زیر است: printer user job-id date-time total num-sheets job-billing job-originating-host-name job-name media sides برای مثال ورودی یک کار دو صفحه‌ای به نام "myjob" ممکن است بدین صورت باشد: DeskJet root 1 [20/May/1999:19:21:06 +0000] total 2 acme-123 localhost myjob na_letter_8.5x11in one-sided از دستورالعمل PageLogFormat در پرونده cupsd.conf(5) می‌توان برای تغییر این اطلاعات استفاده کرد. فیلد printer شامل نام چاپگری است که صفحه را چاپ کرده است. اگر کاری را به یک رده چاپگر ارسال کنید، این فیلد حاوی نام چاپگری خواهد بود که کار به آن تخصیص یافته است. فیلد user شامل نام کاربری است (صفت requesting-user-name در IPP) که این پرونده را برای چاپ ارسال کرده است. فیلد job-id شامل شماره کار صفحه‌ای است که چاپ می‌شود. فیلد date-time شامل تاریخ و زمان شروع چاپ صفحه است. قالب این فیلد دقیقاً مشابه فیلد date-time در پرونده access_log است. فیلد num-sheets تعداد کل صفحات (برگه‌ها) را که برای این کار چاپ شده‌اند، ارائه می‌دهد. فیلد job-billing شامل رونوشتی از صفت‌های job-billing یا job-account-id ارائه‌شده در درخواست‌های Create-Job یا Print-Job پروتکل IPP است، یا در صورتی که هیچ‌کدام ارائه نشده باشند، شامل "-" خواهد بود. فیلد job-originating-host-name شامل نام میزبان یا نشانی IP کلاینتی است که کار را ارسال کرده است. فیلد job-name شامل رونوشتی از صفت job-name ارائه‌شده در درخواست‌های Create-Job یا Print-Job پروتکل IPP است، یا در صورتی که هیچ‌کدام ارائه نشده باشند، شامل "-" خواهد بود. فیلد media شامل رونوشتی از صفت media یا media-col/media-size ارائه‌شده در درخواست‌های Create-Job یا Print-Job پروتکل IPP است، یا در صورتی که ارائه نشده باشد، شامل "-" خواهد بود. فیلد sides شامل رونوشتی از صفت sides ارائه‌شده در درخواست‌های Create-Job یا Print-Job پروتکل IPP است، یا در صورتی که ارائه نشده باشد، شامل "-" خواهد بود. همچنین ببینید (SEE ALSO) cupsd(8), cupsd.conf(5), cups-files.conf(5), راهنمای برخط CUPS (http://localhost:631/help) حق نشر (COPYRIGHT) Copyright © 2020-2024 by OpenPrinting. 2021-02-28 CUPS cupsd-logs(5)