نام (NAME)

inncheck - بررسی پرونده‌های پیکربندی و پایگاه‌دادهٔ INN

خلاصه دستور (SYNOPSIS)

inncheck [-afqv] [--noperm | --perm] [--pedantic] [file | file=path ...]

توضیحات (DESCRIPTION)

دستور inncheck پرونده‌های پیکربندی و پایگاه‌های دادهٔ مختلف را بررسی کرده و مواردی را در مورد آن‌ها راستی‌آزمایی می‌کند. موارد راستی‌آزمایی‌شده به پرونده‌ای که بررسی می‌شود بستگی دارد، اما به‌طور کلی شامل مواردی مانند مجوزها، مالکیت، خطاهای نحوی در پرونده‌های پیکربندی و غیره است.

دستور inncheck هیچ تغییری در هیچ پرونده‌ای ایجاد نمی‌کند -- صرفاً مواردی را که فکر می‌کند ممکن است نادرست باشد گزارش می‌دهد و رفع مشکل بر عهدهٔ اپراتور است.

مجموعهٔ پرونده‌های بررسی‌شده را می‌توان با استفاده از آرگومان‌های file یا file=path محدود کرد. برای نمونه، قرار دادن "incoming.conf" باعث می‌شود تنها پروندهٔ incoming.conf بررسی شود. استفاده از "incoming.conf=/tmp/incoming.conf" در خط فرمان باعث می‌شود که inncheck تنها پروندهٔ incoming.conf را راستی‌آزمایی کند، و این بررسی‌ها را به جای پروندهٔ پیش‌فرض بر روی پروندهٔ /tmp/incoming.conf انجام خواهد داد. تنظیم مسیر یک پرونده روی یک مقدار خالی مانند "incoming.conf=" باعث نادیده گرفتن بررسی آن پرونده می‌شود (این کار تنها همراه با -a معنا دارد، در غیر این صورت هیچ پرونده‌ای بررسی نخواهد شد).

مقادیر معتبر برای file عبارتند از:

active
control.ctl
control.ctl.local
expire.ctl
incoming.conf
inn.conf
innfeed.conf
moderators
newsfeeds
nntpsend.ctl
passwd.nntp
readers.conf
storage.conf

گزینه‌ها (OPTIONS)

-a, --all: اگر هر مقدار file یا جفت‌های file=path (پایین‌تر را ببینید) داده شوند، به‌طور معمول تنها پرونده‌هایی که به آن‌ها اشاره شده است بررسی می‌شوند. از پرچم -a (یا --all) برای تعیین اینکه تمام پرونده‌ها صرف‌نظر از این موضوع باید بررسی شوند، استفاده کنید. در این حالت، ساختار file=path مفیدتر خواهد بود.
-f, --fix: از پرچم -f (یا --fix) استفاده کنید تا inncheck دستور مناسب chown/chgrp/chmod لازم برای رفع مشکلی را که گزارش می‌دهد، چاپ کند. هر خط خروجی دیگر با یک علامت هش ("#") پیشوندگذاری می‌شود تا خروجی یک ورودی معتبر برای پوسته (shell) باشد. توجه داشته باشید که هنگام استفاده از این پرچم، باید از پرچم --perm نیز استفاده شود.
--noperm: برای جلوگیری از انجام هرگونه بررسی مجوزها یا مالکیت پرونده‌ها، از گزینهٔ --noperm استفاده کنید.
--pedantic: از گزینهٔ --pedantic برای دریافت گزارش‌هایی درباره مواردی استفاده کنید که لزوماً نادرست نیستند، اما ممکن است نشان‌دهندهٔ یک پیکربندی نامناسب باشند، مانند فقدان یک کلید در inn.conf.
--perm: دستور inncheck تمام پرونده‌ها را برای مشکلات مجوز بررسی می‌کند. اگر پرچم --perm استفاده شود، آن‌گاه تنها پرونده‌های مشخص‌شده با آرگومان‌های خط فرمان file یا file=path برای مشکلاتی غیر از مجوزها بررسی خواهند شد.
-q, --quiet: از گزینهٔ -q (یا --quiet) برای دریافت خروجی کمتر استفاده کنید.
-v, --verbose: از گزینهٔ -v (یا --verbose) برای دریافت خروجی با جزئیات بیشتر استفاده کنید.

مثال‌ها (EXAMPLES)

برای اینکه inncheck تمام پرونده‌ها را از نظر مشکلات نحو و مجوز بررسی کند، به‌سادگی اجرا کنید:

inncheck

توصیه می‌شود دستور زیر را اجرا کنید تا از تمام مشکلات بالقوه‌ای که inncheck می‌تواند شناسایی کند مطلع شوید:

inncheck -a --perm --pedantic

برای اینکه inncheck تمام پرونده‌ها را برای مشکلات مجوز بررسی کند و ساختار نحوی پرونده‌های active و incoming.conf را راستی‌آزمایی نماید، دستور زیر را اجرا کنید:

inncheck --perm active incoming.conf

برای رفع مشکلات مجوزهای ذکرشده در خروجی دستور بالا، آن را به‌صورت زیر تغییر دهید:

inncheck -f --perm | sh

(توجه داشته باشید که ذکر نام این دو پرونده بی‌فایده است زیرا مشکلات مجوز روی تمام پرونده‌ها بررسی می‌شود.)

برای اینکه inncheck پروندهٔ آزمایشی newsfeeds را در /var/tmp/newsfeeds.testing بررسی کند، دستور زیر را اجرا کنید:

inncheck newsfeeds=/var/tmp/newsfeeds.testing

برای اینکه inncheck تمام پرونده‌ها را همان‌طور که معمولاً انجام می‌دهد بررسی کند، اما مکانی متفاوت را برای پروندهٔ newsfeeds مشخص نماید و از بررسی پروندهٔ innfeed.conf صرف‌نظر کند، دستور زیر را اجرا کنید:

inncheck -a newsfeeds=/var/tmp/newsfeeds.testing innfeed.conf=

اشکالات (BUGS)

اگر گزینه‌های -f و --perm همراه با -a یا برخی آرگومان‌های file یا file=path که به پرونده‌ای با مشکل نحوی اشاره دارند با هم استفاده شوند، خروجی دیگر ورودی معتبری برای یک پوسته نخواهد بود.

در بیشتر موارد، inncheck در حال حاضر مقادیر گزینه‌هایی را که در چندین خط امتداد دارند به‌درستی درک نمی‌کند. اگر پیام‌های خطایی درباره علامت‌های نقل‌قول بسته‌نشده (runaway quotes) دریافت کردید، باید یا آن‌ها را نادیده بگیرید و درستی خطوط مربوطه را خودتان بررسی کنید، یا مقدار را در یک خط واحد ادغام نمایید.

تاریخچه (HISTORY)

نوشته‌شده توسط Brendan Kehoe <brendan@cygnus.com> و Rich Salz <rsalz@uunet.uu.net> برای InterNetNews. تبدیل‌شده به POD توسط Julien Elie.

همچنین ببینید (SEE ALSO)

active(5), control.ctl(5), expire.ctl(5), history(5), incoming.conf(5), inn.conf(5), innfeed.conf(5), moderators(5), newsfeeds(5), nntpsend.ctl(5), passwd.nntp(5), readers.conf(5), storage.conf(5).