.\" -*- 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 "INNCHECK 8" .TH INNCHECK 8 2022-07-10 "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)" inncheck \- بررسی پرونده‌های پیکربندی و پایگاه‌دادهٔ INN .SH "خلاصه دستور (SYNOPSIS)" .IX Header "SYNOPSIS" \&\fBinncheck\fR [\fB\-afqv\fR] [\fB\-\-noperm\fR | \fB\-\-perm\fR] [\fB\-\-pedantic\fR] [\fIfile\fR | \fIfile\fR\fB=\fR\fIpath\fR ...] .SH "توضیحات (DESCRIPTION)" .IX Header "DESCRIPTION" دستور \&\fBinncheck\fR پرونده‌های پیکربندی و پایگاه‌های دادهٔ مختلف را بررسی کرده و مواردی را در مورد آن‌ها راستی‌آزمایی می‌کند. موارد راستی‌آزمایی‌شده به پرونده‌ای که بررسی می‌شود بستگی دارد، اما به‌طور کلی شامل مواردی مانند مجوزها، مالکیت، خطاهای نحوی در پرونده‌های پیکربندی و غیره است. .PP دستور \&\fBinncheck\fR هیچ تغییری در هیچ پرونده‌ای ایجاد نمی‌کند \-\- صرفاً مواردی را که فکر می‌کند ممکن است نادرست باشد گزارش می‌دهد و رفع مشکل بر عهدهٔ اپراتور است. .PP مجموعهٔ پرونده‌های بررسی‌شده را می‌توان با استفاده از آرگومان‌های \fIfile\fR یا \&\fIfile\fR\fB=\fR\fIpath\fR محدود کرد. برای نمونه، قرار دادن \f(CW\*(C`incoming.conf\*(C'\fR باعث می‌شود تنها پروندهٔ \fIincoming.conf\fR بررسی شود. استفاده از \&\f(CW\*(C`incoming.conf=/tmp/incoming.conf\*(C'\fR در خط فرمان باعث می‌شود که \&\fBinncheck\fR تنها پروندهٔ \fIincoming.conf\fR را راستی‌آزمایی کند، و این بررسی‌ها را به جای پروندهٔ پیش‌فرض بر روی پروندهٔ \fI/tmp/incoming.conf\fR انجام خواهد داد. تنظیم مسیر یک پرونده روی یک مقدار خالی مانند \f(CW\*(C`incoming.conf=\*(C'\fR باعث نادیده گرفتن بررسی آن پرونده می‌شود (این کار تنها همراه با \fB\-a\fR معنا دارد، در غیر این صورت هیچ پرونده‌ای بررسی نخواهد شد). .PP مقادیر معتبر برای \fIfile\fR عبارتند از: .PP .Vb 10 \& active \& control.ctl \& control.ctl.local \& expire.ctl \& incoming.conf \& inn.conf \& innfeed.conf \& moderators \& newsfeeds \& nntpsend.ctl \& passwd.nntp \& readers.conf \& storage.conf .Ve .SH "گزینه‌ها (OPTIONS)" .IX Header "OPTIONS" .IP "\fB\-a\fR, \fB\-\-all\fR" 4 .IX Item "-a, --all" اگر هر مقدار \fIfile\fR یا جفت‌های \fIfile\fR\fB=\fR\fIpath\fR (پایین‌تر را ببینید) داده شوند، به‌طور معمول تنها پرونده‌هایی که به آن‌ها اشاره شده است بررسی می‌شوند. از پرچم \fB\-a\fR (یا \&\fB\-\-all\fR) برای تعیین اینکه \fIتمام\fR پرونده‌ها صرف‌نظر از این موضوع باید بررسی شوند، استفاده کنید. در این حالت، ساختار \fIfile\fR\fB=\fR\fIpath\fR مفیدتر خواهد بود. .IP "\fB\-f\fR, \fB\-\-fix\fR" 4 .IX Item "-f, --fix" از پرچم \fB\-f\fR (یا \&\fB\-\-fix\fR) استفاده کنید تا \&\fBinncheck\fR دستور مناسب \&\fBchown\fR/\fBchgrp\fR/\fBchmod\fR لازم برای رفع مشکلی را که گزارش می‌دهد، چاپ کند. هر خط خروجی دیگر با یک علامت هش (\f(CW\*(C`#\*(C'\fR) پیشوندگذاری می‌شود تا خروجی یک ورودی معتبر برای پوسته (shell) باشد. توجه داشته باشید که هنگام استفاده از این پرچم، باید از پرچم \&\fB\-\-perm\fR نیز استفاده شود. .IP \fB\-\-noperm\fR 4 .IX Item "--noperm" برای جلوگیری از انجام هرگونه بررسی مجوزها یا مالکیت پرونده‌ها، از گزینهٔ \&\fB\-\-noperm\fR استفاده کنید. .IP \fB\-\-pedantic\fR 4 .IX Item "--pedantic" از گزینهٔ \&\fB\-\-pedantic\fR برای دریافت گزارش‌هایی درباره مواردی استفاده کنید که لزوماً نادرست نیستند، اما ممکن است نشان‌دهندهٔ یک پیکربندی نامناسب باشند، مانند فقدان یک کلید در \fIinn.conf\fR. .IP \fB\-\-perm\fR 4 .IX Item "--perm" دستور \&\fBinncheck\fR تمام پرونده‌ها را برای مشکلات مجوز بررسی می‌کند. اگر پرچم \&\fB\-\-perm\fR استفاده شود، آن‌گاه \fIتنها\fR پرونده‌های مشخص‌شده با آرگومان‌های خط فرمان \fIfile\fR یا \&\fIfile\fR\fB=\fR\fIpath\fR برای مشکلاتی غیر از مجوزها بررسی خواهند شد. .IP "\fB\-q\fR, \fB\-\-quiet\fR" 4 .IX Item "-q, --quiet" از گزینهٔ \fB\-q\fR (یا \&\fB\-\-quiet\fR) برای دریافت خروجی کمتر استفاده کنید. .IP "\fB\-v\fR, \fB\-\-verbose\fR" 4 .IX Item "-v, --verbose" از گزینهٔ \fB\-v\fR (یا \&\fB\-\-verbose\fR) برای دریافت خروجی با جزئیات بیشتر استفاده کنید. .SH "مثال‌ها (EXAMPLES)" .IX Header "EXAMPLES" برای اینکه \&\fBinncheck\fR تمام پرونده‌ها را از نظر مشکلات نحو و مجوز بررسی کند، به‌سادگی اجرا کنید: .PP .Vb 1 \& inncheck .Ve .PP توصیه می‌شود دستور زیر را اجرا کنید تا از تمام مشکلات بالقوه‌ای که \&\fBinncheck\fR می‌تواند شناسایی کند مطلع شوید: .PP .Vb 1 \& inncheck \-a \-\-perm \-\-pedantic .Ve .PP برای اینکه \&\fBinncheck\fR تمام پرونده‌ها را برای مشکلات مجوز بررسی کند و ساختار نحوی پرونده‌های \fIactive\fR و \fIincoming.conf\fR را راستی‌آزمایی نماید، دستور زیر را اجرا کنید: .PP .Vb 1 \& inncheck \-\-perm active incoming.conf .Ve .PP برای رفع مشکلات مجوزهای ذکرشده در خروجی دستور بالا، آن را به‌صورت زیر تغییر دهید: .PP .Vb 1 \& inncheck \-f \-\-perm | sh .Ve .PP (توجه داشته باشید که ذکر نام این دو پرونده بی‌فایده است زیرا مشکلات مجوز روی تمام پرونده‌ها بررسی می‌شود.) .PP برای اینکه \&\fBinncheck\fR پروندهٔ آزمایشی \fInewsfeeds\fR را در \&\fI/var/tmp/newsfeeds.testing\fR بررسی کند، دستور زیر را اجرا کنید: .PP .Vb 1 \& inncheck newsfeeds=/var/tmp/newsfeeds.testing .Ve .PP برای اینکه \&\fBinncheck\fR تمام پرونده‌ها را همان‌طور که معمولاً انجام می‌دهد بررسی کند، اما مکانی متفاوت را برای پروندهٔ \fInewsfeeds\fR مشخص نماید و از بررسی پروندهٔ \&\fIinnfeed.conf\fR صرف‌نظر کند، دستور زیر را اجرا کنید: .PP .Vb 1 \& inncheck \-a newsfeeds=/var/tmp/newsfeeds.testing innfeed.conf= .Ve .SH "اشکالات (BUGS)" .IX Header "BUGS" اگر گزینه‌های \fB\-f\fR و \fB\-\-perm\fR همراه با \fB\-a\fR یا برخی آرگومان‌های \fIfile\fR یا \fIfile\fR\fB=\fR\fIpath\fR که به پرونده‌ای با مشکل نحوی اشاره دارند با هم استفاده شوند، خروجی دیگر ورودی معتبری برای یک پوسته نخواهد بود. .PP در بیشتر موارد، \&\fBinncheck\fR در حال حاضر مقادیر گزینه‌هایی را که در چندین خط امتداد دارند به‌درستی درک نمی‌کند. اگر پیام‌های خطایی درباره علامت‌های نقل‌قول بسته‌نشده (runaway quotes) دریافت کردید، باید یا آن‌ها را نادیده بگیرید و درستی خطوط مربوطه را خودتان بررسی کنید، یا مقدار را در یک خط واحد ادغام نمایید. .SH "تاریخچه (HISTORY)" .IX Header "HISTORY" نوشته‌شده توسط Brendan Kehoe و Rich Salz برای InterNetNews. تبدیل‌شده به POD توسط Julien Elie. .SH "همچنین ببینید (SEE ALSO)" .IX Header "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).