INNREPORT(8) InterNetNews Documentation INNREPORT(8)

innreport - خلاصه‌سازی پرونده‌های گزارش INN

innreport -f config-file [-config] [-help] [-v] [-[no]archive] [-[no]casesensitive] [-[no]graph] [-[no]html] [-[no]html-unknown] [-[no]notdaily] [-[no]unknown] [-cycle num-cycle] [-dir http-dir] [-index index-file] [-maxunrec num-lines] [-path pictures-dir] [-separator char] [-webpath pictures-path] log-file [log-file ...]

دستور innreport یک اسکریپت پرل (Perl) است که پرونده‌های گزارش INN را همراه با امکان اختیاری تولید خروجی HTML و نمودارها خلاصه‌سازی می‌کند. این دستور معمولاً توسط scanlogs(8) فراخوانی می‌شود که خروجی innreport را در گزارش‌های روزانهٔ یوزنت (Usenet) می‌گنجاند.

برنامه‌های پشتیبانی‌شده عبارتند از batcher، cnfsstat، controlchan، innd، innfeed، innxbatch، innxmit، nnrpd، nntplink (یک برنامهٔ خارجی)، overchan، perl-nocem و rnews.

دستور innreport همچنین شمار گروه‌های خبری را که به‌طور محلی توسط کارساز اخبار میزبانی نمی‌شوند اما مقالاتی برای آن‌ها دریافت شده است، در پروندهٔ گزارش unwanted.log به‌روزرسانی می‌کند. اگر این به‌روزرسانی نباید انجام شود (از آنجا که هنگام تجزیهٔ گزارش‌های روزانه فقط باید یک‌بار در روز رخ دهد)، پرچم -notdaily باید به innreport داده شود.

اگر می‌خواهید innreport در گزارش‌های HTML خود نمودار تولید کند، به کتابخانهٔ گرافیکی پرل GD.pm نیاز دارید.

حداقل یک پروندهٔ گزارش غیرخالی برای تجزیه باید در انتهای خط فرمانِ فراخوانندهٔ innreport ارائه شود.

تنها یک گزینه اجباری است:

مسیر کامل به پروندهٔ پیکربندی. این پرونده معمولاً innreport.conf در pathetc است، اما مقدار پیش‌فرضی وجود ندارد. این پرونده گزینه‌های مورد استفاده برای گزارش را فهرست می‌کند. گزینه‌های داده‌شده در خط فرمان هنگام فراخوانی innreport بر گزینه‌های موجود در پروندهٔ پیکربندی اولویت دارند.

سایر گزینه‌ها اختیاری هستند. افزودن پیشوند "no" به ابتدای گزینه‌های بولی، امکان غیرفعال کردن آن‌ها را فراهم می‌کند. برای نمونه، از -nograph برای حذف قابلیتی که -graph فعال می‌کند، استفاده کنید.

مشخص می‌کند که آیا در صورت فعال بودن گزارش‌های HTML، صفحات HTML و نمودارها بایگانی شوند یا خیر. هنگامی که این گزینه تنظیم شود (که حالت پیش‌فرض است)، تاریخی به نام پروندهٔ هر گزارش و هر نمودار اضافه خواهد شد. در غیر این صورت، تنها آخرین گزارش HTML نگهداری می‌شود.
مشخص می‌کند که آیا جستجو در پرونده‌های گزارش اخبار برای الگوهای از پیش تعیین‌شده به بزرگی و کوچکی حروف حساس باشد یا خیر. این گزینه به‌طور پیش‌فرض فعال است.
اطلاعات پیکربندی innreport را در خروجی استاندارد چاپ کرده و خارج می‌شود.
تعداد پرونده‌های گزارشی را که در صورت فعال بودن و بایگانی شدن گزارش‌های HTML باید نگهداری شوند، تعیین می‌کند. مقدار پیش‌فرض "0" است، به این معنی که تمام بایگانی‌ها نگهداری می‌شوند.
در صورت فعال بودن گزارش‌های HTML، دایرکتوری صفحات وب را تعیین می‌کند. مقدار پیش‌فرض، مقدار pathhttp تنظیم‌شده در inn.conf است.
اگر کتابخانهٔ گرافیکی پرل GD.pm نصب شده باشد و گزارش‌های HTML فعال باشند، نمودارها در صورت پشتیبانی توسط "GD" به‌صورت PNG تولید می‌شوند که در نسخه‌های امروزی چنین است (در غیر این صورت به‌صورت GIF تولید خواهند شد). حالت پیش‌فرض، فعال بودن تولید نمودار است.
یک پیام راهنما حاوی تمام گزینه‌های شناخته‌شده توسط innreport را در خروجی استاندارد چاپ کرده و خارج می‌شود.
علاوه بر گزارش متنی ساده که در خروجی استاندارد چاپ می‌شود، در صورت فعال بودن این گزینه، innreport گزارش‌های HTML نیز تولید می‌کند. این گزینه به‌طور پیش‌فرض غیرفعال است (یعنی -nohtml حالت پیش‌فرض است).
مشخص می‌کند که آیا ورودی‌های ناشناخته از پرونده‌های گزارش اخبار در صورت فعال بودن، در گزارش‌های HTML گزارش شوند یا خیر. این گزینه به‌طور پیش‌فرض همان مقداری را می‌گیرد که برای گزارش‌های متنی ساده تعیین شده است (همان‌طور که با گزینهٔ unknown تنظیم می‌شود).
در صورت فعال بودن گزارش‌های HTML، نام صفحهٔ وب شاخص را تعیین می‌کند. مقدار پیش‌فرض "index.html" است.
تعداد ورودی‌های ناشناخته از پرونده‌های گزارش اخبار را که هنگام تنظیم بودن گزینه‌های -unknown یا -html-unknown باید گزارش شوند، مشخص می‌کند. مقدار پیش‌فرض "50" است. استفاده از "-1" به این معنی است که هیچ محدودیتی وجود ندارد.
مشخص می‌کند که آیا اقدامات روزانه برای این اجرای innreport به تعویق بیفتد یا خیر. برخی اقدامات باید تنها یک‌بار در روز برای یک پروندهٔ گزارش انجام شوند (به‌ویژه unwanted.log). این گزینه به‌طور پیش‌فرض غیرفعال است، به این معنی که تمام اقدامات همیشه انجام می‌شوند، زیرا فرض بر این است که اجرای معمول scanlogs به‌صورت روزانه انجام می‌گیرد.
در صورت فعال بودن گزارش‌های HTML و درخواست تولید نمودارها، دایرکتوری تصاویر را تعیین می‌کند. مقدار پیش‌فرض pathhttp/pics است.

اگر هر دو گزینهٔ -dir و -webpath استفاده شوند اما -path استفاده نشود، دایرکتوری مورد استفاده برای تصاویر به‌طور پیش‌فرض برابر با http-dir تنظیم‌شده با -dir/pictures-path تنظیم‌شده با -webpath خواهد بود.

در صورت فعال بودن و بایگانی شدن گزارش‌های HTML، جداکنندهٔ بین ساعت، دقیقه و ثانیه را در نام پرونده‌ها تعیین می‌کند. مقدار پیش‌فرض "." است زیرا ممکن است ":" توسط تمام مرورگرهای وب به‌درستی خوانده نشود. دقت کنید که از "/" به‌عنوان جداکننده استفاده نکنید، و تنها از نویسه‌های معتبر برای نام پرونده استفاده نمایید.
مشخص می‌کند که آیا ورودی‌های ناشناخته از پرونده‌های گزارش اخبار در گزارش‌های متنی ساده گزارش شوند یا خیر. این گزینه به‌طور پیش‌فرض فعال است.
شماره نگارش innreport را در خروجی استاندارد چاپ کرده و خارج می‌شود.
در صورت فعال بودن گزارش‌های HTML و درخواست تولید نمودارها، مسیر وب تصاویر را در صفحات HTML تعیین می‌کند. مقدار پیش‌فرض "pics" است. این مسیر می‌تواند یک مسیر نسبی یا یک مسیر مطلق باشد. اگر از یک مسیر مطلق استفاده شود، باید -path را نیز به‌درستی تنظیم کنید؛ در غیر این صورت به‌درستی محاسبه نخواهد شد.

نوشته‌شده توسط Fabien Tassin <fta@sofaraway.org> برای InterNetNews. بازنویسی‌شده در قالب POD توسط Julien Elie.

innreport.conf(5), news.daily(8), newslog(5), scanlogs(8).

2022-07-10 INN 2.7.4