نام (NAME)

innconfval - دریافت پارامترهای پیکربندی از فایل‌های پیکربندی

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

innconfval [-pstv] [-f file] [-F filetype] [-i innconffile] [parameter ...]

innconfval -C [-i innconffile]

توضیحات (DESCRIPTION)

دستور innconfval به‌طور معمول مقادیر پارامترهای مشخص‌شده در خط فرمان را از inn.conf چاپ می‌کند. به‌طور پیش‌فرض، این دستور تنها مقادیر پارامترها را چاپ می‌کند، اما اگر گزینه‌های -p، -s یا -t داده شوند، در عوض پارامتر و مقدار آن را به ترتیب به شکل انتساب متغیر در Perl، پوسته Bourne shell یا Tcl چاپ می‌کند. اگر هیچ پارامتری به‌طور خاص درخواست نشود، innconfval تمام مقادیر پارامترها را چاپ می‌کند (این حالت کاربرد چندانی ندارد مگر اینکه یکی از گزینه‌های -p، -s یا -t مشخص شده باشد).

تمام پارامترها از inn.conf خوانده می‌شوند، به جز version که همیشه رشته نسخه INN است.

از گزینه‌های -f و -F برای تعیین فایل پیکربندی دیگری جهت چاپ مقادیر پارامترها استفاده کنید.

در صورت استفاده از گزینه -C، دستور innconfval به جای چاپ مقادیر، فایل inn.conf را بررسی کرده و هرگونه مشکل یافت‌شده را در خروجی خطای استاندارد گزارش می‌دهد.

گزینه‌ها (OPTIONS)

-C

بررسی inn.conf به جای چاپ مقادیر پارامترها؛ در صورتی که مشکلی یافت نشود با وضعیت "0" و در غیر این صورت با وضعیت "1" خارج می‌شود.

-f file

استفاده از file به عنوان فایل پیکربندی مبدأ برای نوع ذکرشده در گزینه -F. در صورت تعیین نشدن، از فایل پیکربندی پیش‌فرض استفاده می‌شود (یعنی فایلی در pathetc که همنام با نوع ارائه‌شده در -F باشد). file باید یک فایل پیکربندی معتبر از آن نوع باشد و دقیقاً مانند همان نوع تجزیه خواهد شد.

-F filetype

مقدار filetype باید "inn.conf" (پیش‌فرض) یا "inn-secrets.conf" باشد. این گزینه نوع فایل پیکربندی را برای تجزیه مشخص می‌کند.

به عنوان مثال، برای دریافت مقدار canlockuser از فایل inn-secrets.conf، دستور "innconfval -F inn-secrets.conf canlockuser" را اجرا کنید.

مسیر پیش‌فرض فایل پیکربندی نوع درخواست‌شده استفاده خواهد شد، مگر اینکه -f داده شود (یا یک فایل پیکربندی مبدأ مشخص برای inn.conf توسط -i تعیین شده باشد که مکان pathetc دیگری را تعریف کند).

-i innconffile

استفاده از innconffile به عنوان فایل پیکربندی مبدأ برای inn.conf به جای inn.conf موجود در pathetc. فایل innconffile باید یک فایل معتبر inn.conf باشد و همانند inn.conf تجزیه خواهد شد.

-p

چاپ پارامترها در قالب دستورهای انتساب Perl. نام متغیر مشابه نام پارامتر پیکربندی خواهد بود و مقادیر رشته‌ای در نقل‌قول تکی همراه با گریزدهی مناسب قرار می‌گیرند. مقادیر بولی به رشته‌های "true" یا "false" نگاشت می‌شوند. مقادیر فهرستی به آرایه‌ای از رشته‌ها تبدیل خواهند شد. مقادیر NULL با مقدار "undef" چاپ می‌شوند.

در اینجا یک مثال آورده شده است:

$enableoverview = 'true';
@extraoverviewadvertised = ( 'Newsgroups', 'Injection-Info' );
@extraoverviewhidden = undef;
$organization = 'Let\'s try nasty "quotes"';
$maxforks = 10;

اگر innconfval از طریق ماژول Perl با نام "INN::Config" فراخوانی شود، تمام این متغیرها به درستی صادر (export) می‌شوند.

-s

چاپ پارامترها در قالب دستورهای انتساب Bourne shell. نام متغیر، همان نام پارامتر پیکربندی با حروف تماماً بزرگ خواهد بود و در صورتی که مقدار آن NULL نباشد، صادر (export) خواهد شد. مقادیر رشته‌ای در نقل‌قول تکی همراه با گریزدهی مناسب قرار می‌گیرند و مقادیر بولی به "true" یا "false" نگاشت می‌شوند. مقادیر فهرستی به یک رشته جداشده با فاصله که نمایانگر آرایه‌ای از رشته‌ها است نگاشت خواهند شد (از آنجا که Bourne shell بر خلاف چندین پوسته دیگر آرایه‌ها را نمی‌شناسد، به دلایل سازگاری نمی‌توان آرایه‌ای را بازگرداند).

در اینجا یک مثال آورده شده است:

ENABLEOVERVIEW=true; export ENABLEOVERVIEW;
EXTRAOVERVIEWADVERTISED='"Newsgroups" "Injection-Info"';
    export EXTRAOVERVIEWADVERTISED;
ORGANIZATION='Let'\''s try nasty "quotes"'; export ORGANIZATION;
MAXFORKS=10; export MAXFORKS;

-t

چاپ پارامترها در قالب دستورهای انتساب Tcl. نام متغیر مشابه نام پارامتر پیکربندی خواهد بود، اما پیشوند "inn_" به آن اضافه می‌شود و متغیرهای رشته‌ای به‌طور مناسب گریزدهی می‌شوند. مقادیر بولی به رشته‌های "true" یا "false" نگاشت می‌شوند. مقادیر فهرستی به آرایه‌ای از رشته‌ها تبدیل خواهند شد. مقادیر NULL چاپ نمی‌شوند.

در اینجا یک مثال آورده شده است:

set inn_enableoverview "true"
set inn_extraoverviewadvertised { "Newsgroups" "Injection-Info" }
set inn_organization "Let's try nasty \"quotes\""
set inn_maxforks 10

-v

چاپ نسخه INN و خروج. این گزینه معادل دستور "innconfval version" است.

تاریخچه (HISTORY)

نوشته‌شده توسط Rich $alz <rsalz@uunet.uu.net> برای InterNetNews.

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

inn.conf(5), inn-secrets.conf(5), INN::Config(3pm).