.\" -*- 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 "INNCONFVAL 1" .TH INNCONFVAL 1 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)" innconfval \- دریافت پارامترهای پیکربندی از فایل‌های پیکربندی .SH "خلاصه دستور (SYNOPSIS)" .IX Header "SYNOPSIS" \&\fBinnconfval\fR [\fB\-pstv\fR] [\fB\-f\fR \fIfile\fR] [\fB\-F\fR \fIfiletype\fR] [\fB\-i\fR \&\fIinnconffile\fR] [\fIparameter\fR ...] .PP \&\fBinnconfval\fR \fB\-C\fR [\fB\-i\fR \fIinnconffile\fR] .SH "توضیحات (DESCRIPTION)" .IX Header "DESCRIPTION" دستور \fBinnconfval\fR به‌طور معمول مقادیر پارامترهای مشخص‌شده در خط فرمان را از \fIinn.conf\fR چاپ می‌کند. به‌طور پیش‌فرض، این دستور تنها مقادیر پارامترها را چاپ می‌کند، اما اگر گزینه‌های \fB\-p\fR، \fB\-s\fR یا \fB\-t\fR داده شوند، در عوض پارامتر و مقدار آن را به ترتیب به شکل انتساب متغیر در Perl، پوسته Bourne shell یا Tcl چاپ می‌کند. اگر هیچ پارامتری به‌طور خاص درخواست نشود، \fBinnconfval\fR تمام مقادیر پارامترها را چاپ می‌کند (این حالت کاربرد چندانی ندارد مگر اینکه یکی از گزینه‌های \fB\-p\fR، \fB\-s\fR یا \fB\-t\fR مشخص شده باشد). .PP تمام پارامترها از \fIinn.conf\fR خوانده می‌شوند، به جز \fIversion\fR که همیشه رشته نسخه INN است. .PP از گزینه‌های \fB\-f\fR و \fB\-F\fR برای تعیین فایل پیکربندی دیگری جهت چاپ مقادیر پارامترها استفاده کنید. .PP در صورت استفاده از گزینه \fB\-C\fR، دستور \fBinnconfval\fR به جای چاپ مقادیر، فایل \fIinn.conf\fR را بررسی کرده و هرگونه مشکل یافت‌شده را در خروجی خطای استاندارد گزارش می‌دهد. .SH "گزینه‌ها (OPTIONS)" .IX Header "OPTIONS" .IP \fB\-C\fR 4 .IX Item "-C" بررسی \fIinn.conf\fR به جای چاپ مقادیر پارامترها؛ در صورتی که مشکلی یافت نشود با وضعیت \f(CW\*(C`0\*(C'\fR و در غیر این صورت با وضعیت \f(CW\*(C`1\*(C'\fR خارج می‌شود. .IP "\fB\-f\fR \fIfile\fR" 4 .IX Item "-f file" استفاده از \fIfile\fR به عنوان فایل پیکربندی مبدأ برای نوع ذکرشده در گزینه \fB\-F\fR. در صورت تعیین نشدن، از فایل پیکربندی پیش‌فرض استفاده می‌شود (یعنی فایلی در \fIpathetc\fR که همنام با نوع ارائه‌شده در \fB\-F\fR باشد). \fIfile\fR باید یک فایل پیکربندی معتبر از آن نوع باشد و دقیقاً مانند همان نوع تجزیه خواهد شد. .IP "\fB\-F\fR \fIfiletype\fR" 4 .IX Item "-F filetype" مقدار \fIfiletype\fR باید \f(CW\*(C`inn.conf\*(C'\fR (پیش‌فرض) یا \f(CW\*(C`inn\-secrets.conf\*(C'\fR باشد. این گزینه نوع فایل پیکربندی را برای تجزیه مشخص می‌کند. .Sp به عنوان مثال، برای دریافت مقدار \fIcanlockuser\fR از فایل \fIinn\-secrets.conf\fR، دستور \f(CW\*(C`innconfval \-F inn\-secrets.conf canlockuser\*(C'\fR را اجرا کنید. .Sp مسیر پیش‌فرض فایل پیکربندی نوع درخواست‌شده استفاده خواهد شد، مگر اینکه \fB\-f\fR داده شود (یا یک فایل پیکربندی مبدأ مشخص برای \fIinn.conf\fR توسط \fB\-i\fR تعیین شده باشد که مکان \fIpathetc\fR دیگری را تعریف کند). .IP "\fB\-i\fR \fIinnconffile\fR" 4 .IX Item "-i innconffile" استفاده از \fIinnconffile\fR به عنوان فایل پیکربندی مبدأ برای \fIinn.conf\fR به جای \fIinn.conf\fR موجود در \fIpathetc\fR. فایل \fIinnconffile\fR باید یک فایل معتبر \fIinn.conf\fR باشد و همانند \fIinn.conf\fR تجزیه خواهد شد. .IP \fB\-p\fR 4 .IX Item "-p" چاپ پارامترها در قالب دستورهای انتساب Perl. نام متغیر مشابه نام پارامتر پیکربندی خواهد بود و مقادیر رشته‌ای در نقل‌قول تکی همراه با گریزدهی مناسب قرار می‌گیرند. مقادیر بولی به رشته‌های \f(CW\*(C`true\*(C'\fR یا \f(CW\*(C`false\*(C'\fR نگاشت می‌شوند. مقادیر فهرستی به آرایه‌ای از رشته‌ها تبدیل خواهند شد. مقادیر NULL با مقدار \f(CW\*(C`undef\*(C'\fR چاپ می‌شوند. .Sp در اینجا یک مثال آورده شده است: .Sp .Vb 5 \& $enableoverview = \*(Aqtrue\*(Aq; \& @extraoverviewadvertised = ( \*(AqNewsgroups\*(Aq, \*(AqInjection\-Info\*(Aq ); \& @extraoverviewhidden = undef; \& $organization = \*(AqLet\e\*(Aqs try nasty "quotes"\*(Aq; \& $maxforks = 10; .Ve .Sp اگر \fBinnconfval\fR از طریق ماژول Perl با نام \f(CW\*(C`INN::Config\*(C'\fR فراخوانی شود، تمام این متغیرها به درستی صادر (export) می‌شوند. .IP \fB\-s\fR 4 .IX Item "-s" چاپ پارامترها در قالب دستورهای انتساب Bourne shell. نام متغیر، همان نام پارامتر پیکربندی با حروف تماماً بزرگ خواهد بود و در صورتی که مقدار آن NULL نباشد، صادر (export) خواهد شد. مقادیر رشته‌ای در نقل‌قول تکی همراه با گریزدهی مناسب قرار می‌گیرند و مقادیر بولی به \f(CW\*(C`true\*(C'\fR یا \f(CW\*(C`false\*(C'\fR نگاشت می‌شوند. مقادیر فهرستی به یک رشته جداشده با فاصله که نمایانگر آرایه‌ای از رشته‌ها است نگاشت خواهند شد (از آنجا که Bourne shell بر خلاف چندین پوسته دیگر آرایه‌ها را نمی‌شناسد، به دلایل سازگاری نمی‌توان آرایه‌ای را بازگرداند). .Sp در اینجا یک مثال آورده شده است: .Sp .Vb 5 \& ENABLEOVERVIEW=true; export ENABLEOVERVIEW; \& EXTRAOVERVIEWADVERTISED=\*(Aq"Newsgroups" "Injection\-Info"\*(Aq; \& export EXTRAOVERVIEWADVERTISED; \& ORGANIZATION=\*(AqLet\*(Aq\e\*(Aq\*(Aqs try nasty "quotes"\*(Aq; export ORGANIZATION; \& MAXFORKS=10; export MAXFORKS; .Ve .IP \fB\-t\fR 4 .IX Item "-t" چاپ پارامترها در قالب دستورهای انتساب Tcl. نام متغیر مشابه نام پارامتر پیکربندی خواهد بود، اما پیشوند \f(CW\*(C`inn_\*(C'\fR به آن اضافه می‌شود و متغیرهای رشته‌ای به‌طور مناسب گریزدهی می‌شوند. مقادیر بولی به رشته‌های \f(CW\*(C`true\*(C'\fR یا \f(CW\*(C`false\*(C'\fR نگاشت می‌شوند. مقادیر فهرستی به آرایه‌ای از رشته‌ها تبدیل خواهند شد. مقادیر NULL چاپ نمی‌شوند. .Sp در اینجا یک مثال آورده شده است: .Sp .Vb 4 \& set inn_enableoverview "true" \& set inn_extraoverviewadvertised { "Newsgroups" "Injection\-Info" } \& set inn_organization "Let\*(Aqs try nasty \e"quotes\e"" \& set inn_maxforks 10 .Ve .IP \fB\-v\fR 4 .IX Item "-v" چاپ نسخه INN و خروج. این گزینه معادل دستور \f(CW\*(C`innconfval version\*(C'\fR است. .SH "تاریخچه (HISTORY)" .IX Header "HISTORY" نوشته‌شده توسط Rich $alz برای InterNetNews. .SH "همچنین ببینید (SEE ALSO)" .IX Header "SEE ALSO" inn.conf(5), inn\-secrets.conf(5), INN::Config(3pm).