INNREPORT(8) InterNetNews Documentation INNREPORT(8) نام (NAME) innreport - خلاصه‌سازی پرونده‌های گزارش INN خلاصه دستور (SYNOPSIS) 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 ...] توضیحات (DESCRIPTION) دستور 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 ارائه شود. گزینه‌ها (OPTIONS) تنها یک گزینه اجباری است: -f config-file مسیر کامل به پروندهٔ پیکربندی. این پرونده معمولاً innreport.conf در pathetc است، اما مقدار پیش‌فرضی وجود ندارد. این پرونده گزینه‌های مورد استفاده برای گزارش را فهرست می‌کند. گزینه‌های داده‌شده در خط فرمان هنگام فراخوانی innreport بر گزینه‌های موجود در پروندهٔ پیکربندی اولویت دارند. سایر گزینه‌ها اختیاری هستند. افزودن پیشوند "no" به ابتدای گزینه‌های بولی، امکان غیرفعال کردن آن‌ها را فراهم می‌کند. برای نمونه، از -nograph برای حذف قابلیتی که -graph فعال می‌کند، استفاده کنید. -archive یا -a مشخص می‌کند که آیا در صورت فعال بودن گزارش‌های HTML، صفحات HTML و نمودارها بایگانی شوند یا خیر. هنگامی که این گزینه تنظیم شود (که حالت پیش‌فرض است)، تاریخی به نام پروندهٔ هر گزارش و هر نمودار اضافه خواهد شد. در غیر این صورت، تنها آخرین گزارش HTML نگهداری می‌شود. -casesensitive مشخص می‌کند که آیا جستجو در پرونده‌های گزارش اخبار برای الگوهای از پیش تعیین‌شده به بزرگی و کوچکی حروف حساس باشد یا خیر. این گزینه به‌طور پیش‌فرض فعال است. -config اطلاعات پیکربندی innreport را در خروجی استاندارد چاپ کرده و خارج می‌شود. -cycle یا -c num-cycle تعداد پرونده‌های گزارشی را که در صورت فعال بودن و بایگانی شدن گزارش‌های HTML باید نگهداری شوند، تعیین می‌کند. مقدار پیش‌فرض "0" است، به این معنی که تمام بایگانی‌ها نگهداری می‌شوند. -dir یا -d http-dir در صورت فعال بودن گزارش‌های HTML، دایرکتوری صفحات وب را تعیین می‌کند. مقدار پیش‌فرض، مقدار pathhttp تنظیم‌شده در inn.conf است. -graph یا -g اگر کتابخانهٔ گرافیکی پرل GD.pm نصب شده باشد و گزارش‌های HTML فعال باشند، نمودارها در صورت پشتیبانی توسط "GD" به‌صورت PNG تولید می‌شوند که در نسخه‌های امروزی چنین است (در غیر این صورت به‌صورت GIF تولید خواهند شد). حالت پیش‌فرض، فعال بودن تولید نمودار است. -help یا -h یک پیام راهنما حاوی تمام گزینه‌های شناخته‌شده توسط innreport را در خروجی استاندارد چاپ کرده و خارج می‌شود. -html علاوه بر گزارش متنی ساده که در خروجی استاندارد چاپ می‌شود، در صورت فعال بودن این گزینه، innreport گزارش‌های HTML نیز تولید می‌کند. این گزینه به‌طور پیش‌فرض غیرفعال است (یعنی -nohtml حالت پیش‌فرض است). -html-unknown مشخص می‌کند که آیا ورودی‌های ناشناخته از پرونده‌های گزارش اخبار در صورت فعال بودن، در گزارش‌های HTML گزارش شوند یا خیر. این گزینه به‌طور پیش‌فرض همان مقداری را می‌گیرد که برای گزارش‌های متنی ساده تعیین شده است (همان‌طور که با گزینهٔ unknown تنظیم می‌شود). -index یا -i در صورت فعال بودن گزارش‌های HTML، نام صفحهٔ وب شاخص را تعیین می‌کند. مقدار پیش‌فرض "index.html" است. -maxunrec num-lines تعداد ورودی‌های ناشناخته از پرونده‌های گزارش اخبار را که هنگام تنظیم بودن گزینه‌های -unknown یا -html-unknown باید گزارش شوند، مشخص می‌کند. مقدار پیش‌فرض "50" است. استفاده از "-1" به این معنی است که هیچ محدودیتی وجود ندارد. -notdaily مشخص می‌کند که آیا اقدامات روزانه برای این اجرای innreport به تعویق بیفتد یا خیر. برخی اقدامات باید تنها یک‌بار در روز برای یک پروندهٔ گزارش انجام شوند (به‌ویژه unwanted.log). این گزینه به‌طور پیش‌فرض غیرفعال است، به این معنی که تمام اقدامات همیشه انجام می‌شوند، زیرا فرض بر این است که اجرای معمول scanlogs به‌صورت روزانه انجام می‌گیرد. -path یا -p pictures-dir در صورت فعال بودن گزارش‌های HTML و درخواست تولید نمودارها، دایرکتوری تصاویر را تعیین می‌کند. مقدار پیش‌فرض pathhttp/pics است. اگر هر دو گزینهٔ -dir و -webpath استفاده شوند اما -path استفاده نشود، دایرکتوری مورد استفاده برای تصاویر به‌طور پیش‌فرض برابر با http-dir تنظیم‌شده با -dir/pictures-path تنظیم‌شده با -webpath خواهد بود. -separator یا -s char در صورت فعال بودن و بایگانی شدن گزارش‌های HTML، جداکنندهٔ بین ساعت، دقیقه و ثانیه را در نام پرونده‌ها تعیین می‌کند. مقدار پیش‌فرض "." است زیرا ممکن است ":" توسط تمام مرورگرهای وب به‌درستی خوانده نشود. دقت کنید که از "/" به‌عنوان جداکننده استفاده نکنید، و تنها از نویسه‌های معتبر برای نام پرونده استفاده نمایید. -unknown مشخص می‌کند که آیا ورودی‌های ناشناخته از پرونده‌های گزارش اخبار در گزارش‌های متنی ساده گزارش شوند یا خیر. این گزینه به‌طور پیش‌فرض فعال است. -v شماره نگارش innreport را در خروجی استاندارد چاپ کرده و خارج می‌شود. -webpath یا -w pictures-path در صورت فعال بودن گزارش‌های HTML و درخواست تولید نمودارها، مسیر وب تصاویر را در صفحات HTML تعیین می‌کند. مقدار پیش‌فرض "pics" است. این مسیر می‌تواند یک مسیر نسبی یا یک مسیر مطلق باشد. اگر از یک مسیر مطلق استفاده شود، باید -path را نیز به‌درستی تنظیم کنید؛ در غیر این صورت به‌درستی محاسبه نخواهد شد. تاریخچه (HISTORY) نوشته‌شده توسط Fabien Tassin برای InterNetNews. بازنویسی‌شده در قالب POD توسط Julien Elie. همچنین ببینید (SEE ALSO) innreport.conf(5), news.daily(8), newslog(5), scanlogs(8). INN 2.7.4 2022-07-10 INNREPORT(8)