.\" -*- mode: troff; coding: utf-8 -*- .\" Automatically generated by Pod::Man 5.0102 (Pod::Simple 3.45) .\" .\" Standard preamble: .\" ======================================================================== .de Sp \" Vertical space (when we can't use .PP) .if t .sp .5v .if n .sp .. .de Vb \" Begin verbatim text .ft CW .nf .ne \\$1 .. .de Ve \" End verbatim text .ft R .fi .. .\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>. .ie n \{\ . ds C` "" . ds C' "" 'br\} .el\{\ . ds C` . ds C' 'br\} .\" .\" Escape single quotes in literal strings from groff's Unicode transform. .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" .\" If the F register is >0, we'll generate index entries on stderr for .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index .\" entries marked with X<> in POD. Of course, you'll have to process the .\" output yourself in some meaningful fashion. .\" .\" Avoid warning from groff about undefined register 'F'. .de IX .. .nr rF 0 .if \n(.g .if rF .nr rF 1 .if (\n(rF:(\n(.g==0)) \{\ . if \nF \{\ . de IX . tm Index:\\$1\t\\n%\t"\\$2" .. . if !\nF==2 \{\ . nr % 0 . nr F 2 . \} . \} .\} .rr rF .\" ======================================================================== .\" .IX Title "NEWSLOG 5" .TH NEWSLOG 5 2025-05-09 "INN 2.7.4" "InterNetNews Documentation" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l .nh .SH "نام (NAME)" newslog \- پرونده‌های گزارش وقایع INN .SH "توضیحات (DESCRIPTION)" .IX Header "DESCRIPTION" اکثر پرونده‌های گزارش وقایع (log) ایجادشده توسط برنامه‌های Usenet در دایرکتوری \fIpathlog\fR تنظیم‌شده در \fIinn.conf\fR قرار دارند و دارای پسوند \f(CW\*(C`.log\*(C'\fR هستند. معمولاً چندین نسخه با پسوند اضافی مانند \f(CW\*(C`.1\*(C'\fR، \f(CW\*(C`.2\*(C'\fR و غیره نگهداری می‌شوند \-\- هرچه شماره بزرگ‌تر باشد، لاگ قدیمی‌تر است. این نسخه‌های قدیمی در \fIpathlog\fR/OLD نگهداری می‌شوند؛ آن‌ها ممکن است فشرده‌سازی شده باشند و بنابراین پسوندی مانند \f(CW\*(C`.1.gz\*(C'\fR، \f(CW\*(C`.2.gz\*(C'\fR و غیره داشته باشند، تا حداکثر \f(CW\*(C`.nn.gz\*(C'\fR که در آن \f(CW\*(C`nn\*(C'\fR تعداد پرونده‌های گزارش قدیمی نگهداری‌شده توسط \fBscanlogs\fR است و توسط \fIlogcycles\fR در \fIinn.conf\fR تنظیم می‌شود. .PP اسکریپت \fBscanlogs\fR و ابزارهای مرتبط مسئول چرخش (rotate) و فشرده‌سازی این پرونده‌ها هستند. برخی پرونده‌های گزارش وقایع همیشه دارای داده هستند (مانند \fInews.notice\fR)، برخی دیگر تنها در صورت وجود مشکل حاوی داده خواهند بود (مانند \fInews.err\fR)، و برخی تنها در صورتی ایجاد می‌شوند که برنامه‌ای خاص استفاده شود (مانند \fIsend\-uucp.log\fR که توسط \fBsend-uucp\fR استفاده می‌شود) یا یک پارامتر پیکربندی تنظیم شده باشد (مانند \fIinnfeed.log\fR مورد استفاده توسط \fBinnfeed\fR هنگامی که \fIdebug-level\fR در \fIinnfeed.conf\fR تنظیم شده باشد). .PP علاوه بر این، اسکریپت \fBinnstat\fR اندازه تمام پرونده‌های گزارش وقایع را پایش می‌کند. .PP در اینجا پرونده‌های گزارش وقایع استفاده‌شده توسط INN آورده شده‌اند: .IP \fIcontrol.log\fR 4 .IX Item "control.log" این پرونده تعداد پیام‌های کنترلی newgroup و rmgroup دیده‌شده برای هر گروه خبری را نگه می‌دارد. این شمارش مربوط به تعداد پیام‌های کنترلی با آرگومان‌های مشخص‌شده است، صرف‌نظر از اینکه آیا واقعاً پردازش شده‌اند یا خیر. تمام آرگومان‌های کنترلی، از جمله موارد نامعتبر، شمرده می‌شوند. نمونه‌ای از خطوطی که در این پرونده گزارش وقایع یافت می‌شود: .Sp .Vb 3 \& 3 Control: newgroup foo.bar moderated \& 3 Control: rmgroup misc.removed \& 1 Control: newgroup misc.created .Ve .Sp این پرونده توسط \fBtally.control\fR به‌روزرسانی می‌شود، که در صورت وجود هر یک از این دو پرونده گزارش در \fIpathlog\fR توسط \fBscanlogs\fR فراخوانی می‌شود: .Sp .Vb 2 \& newgroup.log \& rmgroup.log .Ve .Sp این دو پرونده گزارش وقایع شامل یک خط خلاصه شامل شرح پیام کنترلی و اقدام انجام‌شده توسط \fBcontrolchan\fR هستند، که به دنبال آن مقاله با چهار فاصله تورفتگی و سپس یک خط خالی می‌آید. در حالی که این پرونده‌ها چرخانده (rotated) می‌شوند، پرونده \fIcontrol.log\fR چرخانده نمی‌شود تا شمارش پیام‌های کنترلی دیده‌شده حفظ شود. .Sp توجه داشته باشید که سایر پرونده‌های گزارش وقایع کنترلی نیز در صورت وجود توسط \fBscanlogs\fR چرخانده می‌شوند، اما محتوای آن‌ها خلاصه‌سازی نمی‌شود. نام آن‌ها به شرح زیر است: .Sp .Vb 8 \& checkgroups.log \& default.log \& ihave.log \& miscctl.log \& sendme.log \& sendsys.log \& senduuname.log \& version.log .Ve .Sp به منظور ایجاد این پرونده‌ها، فیلدهای و در ورودی‌های مربوطه \fIcontrol.ctl\fR باید به درستی تنظیم شوند. برای نمونه: .Sp .Vb 8 \& Type Action Meaning \& \-\-\-\- \-\-\-\-\-\- \-\-\-\-\-\-\- \& all log=miscctl Log all messages by default. \& newgroup doit=newgroup Create group and log message. \& newgroup log=newgroup Log message. \& rmgroup verify\-*=rmgroup PGP verify, remove group \& and log message. \& checkgroups doit=checkgroups Process and log message. .Ve .IP \fIcontrolbatch.log\fR 4 .IX Item "controlbatch.log" برنامه \fBcontrolbatch\fR تمام پیام‌های وضعیت را به این پرونده اضافه می‌کند. این پرونده توسط \fBscanlogs\fR چرخانده می‌شود. .IP \fIerrlog\fR 4 .IX Item "errlog" این پرونده شامل خروجی استاندارد و خطای استاندارد هر برنامه‌ای است که توسط \fBinnd\fR راه‌اندازی (spawn) می‌شود، مانند فیدهای کانال پیکربندی‌شده در \fInewsfeeds\fR. این پرونده معمولاً باید خالی باشد. در صورت خالی نبودن، \fBscanlogs\fR تعداد ۵۰ خط اول این پرونده گزارش را چاپ می‌کند تا در گزارش‌های روزانه Usenet تولیدشده توسط \fBnews.daily\fR نمایش داده شوند. سپس، \fBscanlogs\fR این پرونده گزارش را می‌چرخاند. .IP \fIexpire.log\fR 4 .IX Item "expire.log" به‌طور پیش‌فرض، هنگامی که \fBnews.daily\fR قصد دارد مقالات خبری قدیمی را منقضی کند، نام برنامه‌ای را که فراخوانی می‌کند به همراه \f(CW\*(C`start\*(C'\fR و زمان آغاز آن می‌نویسد. سپس هرگونه خروجی از آن برنامه با چهار فاصله تورفتگی نوشته می‌شود. پس از آن، نام برنامه به همراه \f(CW\*(C`end\*(C'\fR و زمان پایان آن نوشته می‌شود. .Sp برنامه‌های فراخوانی‌شده، در صورت نیاز، به ترتیب عبارتند از: \fBexpireover\fR، \fBctlinnd\fR (با گزینه \f(CW\*(C`lowmark\*(C'\fR)، \fBexpirerm\fR و \fBexpire\fR. مقالات حذف‌شده در \fIexpire.list\fR و نشانه‌های پایین (low mark) برای هر گروه خبری (یعنی شماره قدیمی‌ترین مقاله موجود در گروه خبری) در \fIexpire.lastlowmark\fR فهرست می‌شوند. .Sp پس از فرآیند انقضا، \fBscanlogs\fR پرونده \fIexpire.log\fR را می‌چرخاند. .IP \fIinnfeed.log\fR 4 .IX Item "innfeed.log" هنگامی که \fIdebug-level\fR در \fIinnfeed.conf\fR تنظیم شده باشد، \fBinnfeed\fR پیام‌های اشکال‌زدایی را به این پرونده اضافه می‌کند. توجه داشته باشید که نام این پرونده را می‌توان با پارامتر \fIlog-file\fR در \fIinnfeed.conf\fR تغییر داد. در هر صورت، پرونده گزارش مربوطه توسط \fBscanlogs\fR چرخانده می‌شود. .Sp علاوه بر این، پرونده \fIinnfeed\-delayed.conf\fR نیز بررسی می‌شود تا در صورت استفاده از delayer(8) به همراه \fBinnfeed\fR، پرونده گزارش احتمالی دیگری برای چرخش یافت شود. .Sp همچنین \fBinnfeed\fR در صورتی که \fIgen-html\fR روی false تنظیم شده باشد وضعیت خود را در \fIinnfeed.status\fR (یا نام تنظیم‌شده در \fIstatus-file\fR) ثبت می‌کند، اما این پرونده گزارش توسط \fBscanlogs\fR پردازش نمی‌شود. .IP \fInews\fR 4 .IX Item "news" این پرونده مقالات دریافت‌شده توسط \fBinnd\fR را ثبت می‌کند. خطوط نمونه عبارتند از: .Sp .Vb 5 \& Aug 25 13:37:41.839 + news.server.fr \& 1658 a.peer other.server.org inpaths! \& Aug 25 13:37:41.839 c news.server.fr \& Cancelling \& Aug 25 13:37:54.638 \- a.peer <23k82@bar.net> 437 Poison newsgroup .Ve .Sp خط اول نشان می‌دهد که مقاله‌ای از \f(CW\*(C`news.server.fr\*(C'\fR پذیرفته شده است (\f(CW\*(C`+\*(C'\fR). شناسه Message-ID آن \f(CW\*(C`\*(C'\fR است و ما مقاله را به دو همتا (\f(CW\*(C`a.peer\*(C'\fR و \f(CW\*(C`other.server.org\*(C'\fR، همان‌طور که در \fInewsfeeds\fR مشخص شده) و \f(CW\*(C`inpaths!\*(C'\fR (برای جزئیات بیشتر درباره آن، \fBninpaths\fR را ببینید) ارسال خواهیم کرد. خط دوم ذکر می‌کند که مقاله قبلی یک پیام لغو (\f(CW\*(C`c\*(C'\fR) برای \f(CW\*(C`\*(C'\fR است و پردازش شده است (در واقع، \fBcontrolchan\fR تمام مقالات کنترلی را به جز پیام‌های لغو که توسط \fBinnd\fR رسیدگی می‌شوند، پردازش می‌کند). خط سوم نشان می‌دهد مقاله‌ای که Message-ID آن \f(CW\*(C`<23k82@bar.net>\*(C'\fR است رد شده است (\f(CW\*(C`\-\*(C'\fR) زیرا در یک گروه خبری سمی (poison) ارسال شده است (یک فیلتر Perl یا Python واقع در \fIpathfilter\fR باید عامل این رد کردن بوده باشد). .Sp برای اطلاعات بیشتر در مورد قالب این پرونده گزارش، بخش "LOGGING" از صفحه راهنمای innd(8) را ببینید. .Sp ابزار \fBinnreport\fR مقالات ردشده گزارش‌شده در این پرونده را خلاصه می‌کند و \fBscanlogs\fR آن را می‌چرخاند. .IP \fInews.crit\fR 4 .IX Item "news.crit" تمام پیام‌های خطای بحرانی صادرشده توسط \fBinnd\fR از طریق syslog به این پرونده اضافه می‌شوند. این پرونده گزارش معمولاً باید خالی باشد. در صورت خالی نبودن، \fBscanlogs\fR تعداد ۵۰ خط اول این پرونده گزارش را چاپ می‌کند تا در گزارش‌های روزانه Usenet تولیدشده توسط \fBnews.daily\fR نمایش داده شوند. سپس، \fBscanlogs\fR این پرونده گزارش را می‌چرخاند. .Sp شما باید خط زیر را در پرونده \fIsyslog.conf\fR سیستم خود داشته باشید و از نویسه تب (tab) به عنوان جداکننده استفاده کنید: .Sp .Vb 1 \& news.crit /news.crit .Ve .Sp (یک مدخل نمونه نشان داده شده است؛ این مدخل باید با \fIpathlog\fR در \fIinn.conf\fR مطابقت داشته باشد و با تب جدا شده باشد.) .IP \fInews.err\fR 4 .IX Item "news.err" تمام پیام‌های خطای عمده صادرشده توسط \fBinnd\fR از طریق syslog به این پرونده اضافه می‌شوند. این پرونده گزارش معمولاً باید خالی باشد. در صورت خالی نبودن، \fBscanlogs\fR تعداد ۵۰ خط اول این پرونده گزارش را چاپ می‌کند تا در گزارش‌های روزانه Usenet تولیدشده توسط \fBnews.daily\fR نمایش داده شوند. سپس، \fBscanlogs\fR این پرونده گزارش را می‌چرخاند. .Sp شما باید خط زیر را در پرونده \fIsyslog.conf\fR سیستم خود داشته باشید و از نویسه تب به عنوان جداکننده استفاده کنید: .Sp .Vb 1 \& news.err /news.err .Ve .Sp (یک مدخل نمونه نشان داده شده است؛ این مدخل باید با \fIpathlog\fR در \fIinn.conf\fR مطابقت داشته باشد و با تب جدا شده باشد.) .IP \fInews.notice\fR 4 .IX Item "news.notice" تمام پیام‌های خطای استاندارد و پیام‌های وضعیت صادرشده توسط \fBinnd\fR، \fBinnfeed\fR، \fBnnrpd\fR و برخی برنامه‌های دیگر از طریق syslog به این پرونده اضافه می‌شوند. اسکریپت \fBscanlogs\fR از اسکریپت پرل \fBinnreport\fR برای خلاصه‌سازی این پرونده استفاده می‌کند. در صورت وجود خطوط ناشناخته در \fInews.notice\fR، ابزار \fBinnreport\fR همچنین تعداد خطوط ناشناخته به میزان \fImax_unknown\fR اول این پرونده گزارش را چاپ می‌کند تا در گزارش‌های روزانه Usenet تولیدشده توسط \fBnews.daily\fR نمایش داده شوند. این پارامتر را می‌توان در \fIinnreport.conf\fR تنظیم کرد. سپس، \fBscanlogs\fR این پرونده گزارش را می‌چرخاند. .Sp شما باید خط زیر را در پرونده \fIsyslog.conf\fR سیستم خود داشته باشید و از نویسه تب به عنوان جداکننده استفاده کنید: .Sp .Vb 1 \& news.notice \-/news.notice .Ve .Sp (یک مدخل نمونه نشان داده شده است؛ این مدخل باید با \fIpathlog\fR در \fIinn.conf\fR مطابقت داشته باشد و با تب جدا شده باشد.) .Sp علامت خط تیره به عنوان نخستین نویسه مسیر \fInews.notice\fR به syslogd دستور می‌دهد که پرونده گزارش را با هر بار ثبت ورودی جدید با دیسک همگام نکند (در غیر این صورت کارایی را کاهش می‌دهد). بسته به دیمن syslog مورد استفاده شما، همگام‌سازی لاگ ممکن است به صورت پیش‌فرض از قبل غیرفعال باشد (برای نمونه در rsyslogd یا syslog-ng این‌گونه است). .IP \fInntpsend.log\fR 4 .IX Item "nntpsend.log" برنامه \fBnntpsend\fR تمام پیام‌های وضعیت را به این پرونده اضافه می‌کند. این پرونده توسط \fBscanlogs\fR چرخانده می‌شود. .IP \fIperl\-nocem.log\fR 4 .IX Item "perl-nocem.log" در صورتی که امکانات syslog در دسترس نباشد یا فلگ \fB\-l\fR به \fBperl-nocem\fR ارسال شود، برنامه \fBperl-nocem\fR تمام پیام‌های وضعیت را به این پرونده اضافه می‌کند (در غیر این صورت، از امکانات syslog استفاده می‌شود که در این صورت پیام‌های وضعیت به پرونده‌ای معمولاً با نام \fInews.notice\fR در \fIpathlog\fR اضافه می‌شوند). پرونده \fIperl\-nocem.log\fR توسط \fBinnreport\fR پردازش شده و توسط \fBscanlogs\fR چرخانده می‌شود. .IP \fIsend\-ihave.log\fR 4 .IX Item "send-ihave.log" برنامه \fBsend-ihave\fR تمام پیام‌های وضعیت را به این پرونده اضافه می‌کند. این پرونده توسط \fBscanlogs\fR چرخانده می‌شود. .IP \fIsend\-uucp.log\fR 4 .IX Item "send-uucp.log" برنامه \fBsend-uucp\fR تمام پیام‌های وضعیت را به این پرونده اضافه می‌کند. این پرونده توسط \fBscanlogs\fR چرخانده می‌شود. .IP \fIunwanted.log\fR 4 .IX Item "unwanted.log" این گزارش تعداد مقالاتی را نگه می‌دارد که به دلیل ارسال به گروه‌های خبری که در سایت محلی وجود ندارند، رد شده‌اند. این پرونده توسط \fBinnreport\fR در هنگام پردازش پرونده گزارش \fInews.notice\fR به‌روزرسانی می‌شود و به ترتیب عددی معکوس نگهداری می‌شود (محبوب‌ترین گروه ردشده در ابتدا). این پرونده چرخانده نمی‌شود تا شمارش مقالات ارسال‌شده به گروه‌های خبری که در پرونده \fIactive\fR سرور خبر وجود ندارند حفظ شود. .Sp توجه داشته باشید که \fIlogtrash\fR باید در \fIinn.conf\fR روی true تنظیم شده باشد تا این پرونده تولید شود. .PP در نهایت، این پرونده‌ها نیز در صورت وجود توسط \fBscanlogs\fR چرخانده می‌شوند، اما محتوای آن‌ها خلاصه‌سازی نمی‌شود. نام آن‌ها به شرح زیر است: .PP .Vb 3 \& badcontrol.log \& badpgp.log \& failedpgp.log .Ve .PP آن‌ها می‌توانند توسط برنامه‌هایی که مقالات را با PGP تأیید می‌کنند، مورد استفاده قرار گیرند. .SH "تاریخچه (HISTORY)" .IX Header "HISTORY" نوشته‌شده توسط Landon Curt Noll و Rich $alz برای InterNetNews. بازنویسی و تبدیل به POD توسط Julien Elie. .SH "همچنین ببینید (SEE ALSO)" .IX Header "SEE ALSO" control.ctl(5), ctlinnd(8), delayer(8), expire(8), expireover(8), expirerm(8), inn.conf(5), innd(8), innfeed.conf(5), innreport(8), innreport.conf(5), news.daily(8), nnrpd(8), nntpsend(8), scanlogs(8), send\-ihave(8), send\-uucp(8), syslog.conf(5), tally.control(8).