.TH SNMP_CONFIG 5 "08 Mar 2010" V5.9.5.2 "Net-SNMP"
.SH "نام (NAME)"
snmp_config \- قالب و ساختار فایل‌های پیکربندی ابزارهای Net-SNMP
.SH "توضیحات (DESCRIPTION)"
بسته Net-SNMP از فایل‌های پیکربندی گوناگونی برای پیکربندی برنامه‌های خود استفاده می‌کند. این صفحه راهنما صرفاً ماهیت کلی آن‌ها را شرح می‌دهد تا نیازی به تکرار آن در سایر صفحات راهنما نباشد.
.SH "دایرکتوری‌های مورد جستجو (DIRECTORIES SEARCHED)"
در وهله اول، مکان‌های متعددی وجود دارند که فایل‌های پیکربندی می‌توانند در آن‌ها یافت و خوانده شوند. به‌طور پیش‌فرض، برنامه‌ها به ترتیب در ۴ دایرکتوری زیر به دنبال فایل‌های پیکربندی می‌گردند:
.BR /etc/snmp ،
.BR /usr/share/snmp ،
.B /usr/lib/snmp
و
.BR $HOME/.snmp .
در هر یک از این دایرکتوری‌ها، برنامه به دنبال فایل‌های
.BR snmp.conf ،
.B snmpd.conf
و/یا
.BR snmptrapd.conf ،
و همچنین
.BR snmp.local.conf ،
.B snmpd.local.conf
و/یا
.B snmptrapd.local.conf
می‌گردد. فایل‌های
.B *.local.conf
همیشه در آخر خوانده می‌شوند. بدین ترتیب، برای هر نوع فایل پیکربندی مشخص، ۸ مکان پیش‌فرض وجود دارد که می‌تواند در آن‌ها قرار داشته باشد.
.PP
علاوه بر این، مسیر جستجوی پیش‌فرض بالا را می‌توان با مقداردهی متغیر محیطی
.B SNMPCONFPATH
به فهرستی از دایرکتوری‌ها برای جستجو که با دونقطه (:) از هم جدا شده‌اند، بازنویسی کرد. هنگام اجرای برنامه‌هایی که از حافظه ذخیره‌سازی پایدار استفاده می‌کنند، مانند
.BR snmpd ،
باید مسیر مربوط به داده‌های پایدار نیز لحاظ شود.
.PP
برنامه‌ها فایل‌های پیکربندی پایدار را با ترتیب اولویت زیر می‌خوانند:
.RS
.PP
فایل مشخص‌شده در متغیر محیطی
.B SNMP_PERSISTENT_FILE
.br
دایرکتوری‌های مشخص‌شده در متغیر محیطی
.B SNMPCONFPATH
.br
دایرکتوری تعریف‌شده توسط متغیر
.B persistentDir
در
.B snmp.conf
.br
دایرکتوری مشخص‌شده در متغیر محیطی
.B SNMP_PERSISTENT_DIR
.br
دایرکتوری پیش‌فرض
.B /var/net-snmp
.RE
.PP
در نهایت، برنامه‌ها فایل‌های پیکربندی پایدار را با ترتیب اولویت زیر می‌نویسند:
.RS
.PP
فایل مشخص‌شده در متغیر محیطی
.B SNMP_PERSISTENT_FILE
.br
دایرکتوری تعریف‌شده توسط متغیر
.B persistentDir
در
.B snmp.conf
.br
دایرکتوری مشخص‌شده در متغیر محیطی
.B SNMP_PERSISTENT_DIR
.br
دایرکتوری پیش‌فرض
.B /var/net-snmp
.RE
.PP
نکته: هنگام استفاده از
.BR SNMP_PERSISTENT_FILE ،
نام فایل باید با نام برنامه مطابقت داشته باشد؛ به عنوان مثال:
.BR /var/net-snmp/snmpd.conf .
.SH "انواع فایل‌های پیکربندی (CONFIGURATION FILE TYPES)"
هر برنامه ممکن است از چندین فایل پیکربندی استفاده کند که جنبه‌های مختلف برنامه را پیکربندی می‌کنند. به عنوان مثال، عامل SNMP
.RB ( snmpd )
نحوه درک دستورالعمل‌های پیکربندی را هم در فایل‌های
.B snmpd.conf
و هم در فایل‌های
.B snmp.conf
می‌داند. در واقع، بیشتر برنامه‌ها نحوه خواندن محتویات فایل‌های
.B snmp.conf
را می‌فهمند. با این حال، توجه داشته باشید که دستورالعمل‌های پیکربندی که در یک فایل پشتیبانی می‌شوند ممکن است در فایل دیگری شناخته نشوند. برای کسب اطلاعات بیشتر، صفحه راهنمای مربوط به هر نوع فایل پیکربندی را مطالعه کنید.
همچنین، بیشتر برنامه‌ها از گزینه
.B \-H
در خط فرمان پشتیبانی می‌کنند که فهرستی از فایل‌های پیکربندی مورد جستجو و دستورالعمل‌های پشتیبانی‌شده در هر یک را ارائه می‌دهد.
.PP
فایل پیکربندی
.B snmp.conf
به عنوان یک فایل پیکربندی در سطح کل مجموعه برنامه‌ها در نظر گرفته شده است که از دستورالعمل‌های سودمند برای کنترل ماهیت بنیادین تمام برنامه‌های SNMP پشتیبانی می‌کند؛ مانند نحوه کار و تجزیه فایل‌های متنی MIB در SNMP.
.SH "تغییر نوع پیکربندی در میانه فایل (SWITCHING CONFIGURATION TYPES IN MID-FILE)"
این امکان وجود دارد که در میانه یک فایل، نوع پیکربندی را که تجزیه‌کننده قرار است بخواند تغییر دهید. از آنجا که این عبارت ممکن است چندان واضح نباشد، اجازه دهید مثالی بزنیم: فرض کنید می‌خواهید خروجی دامپ بسته‌ها را به‌طور پیش‌فرض برای عامل فعال کنید، اما مایل نیستید این کار برای سایر برنامه‌ها (مانند snmpget، snmpwalk و...) انجام شود.
به‌طور معمول برای فعال‌سازی دامپ بسته‌ها در فایل پیکربندی باید خطی مانند:
.PP
.RS
.nf
dumpPacket true
.fi
.RE
.PP
را درون فایل
.B snmp.conf
قرار دهید. اما این کار آن را برای تمام برنامه‌ها فعال می‌کند. بنابراین، در عوض می‌توانید همان خط را در فایل
.B snmpd.conf
قرار دهید تا فقط بر دیمن
.B snmpd
اعمال شود. با این حال، باید به تجزیه‌کننده اطلاع دهید که انتظار چنین خطی را داشته باشد. این کار با قرار دادن یک نشانه ویژه تعیین نوع در داخل یک جفت براکت [] انجام می‌شود. به عبارت دیگر، در داخل فایل
.B snmpd.conf
خود می‌توانید دستورالعمل
.B snmp.conf
فوق را با افزودن خطی به این شکل درج کنید:
.PP
.RS
.nf
[snmp] dumpPacket true
.fi
.RE
.PP
این به تجزیه‌کننده می‌گوید که خط بالا را به گونه‌ای پردازش کند که گویی درون یک فایل
.B snmp.conf
قرار دارد، نه یک فایل
.BR snmpd.conf .
اگر می‌خواهید به جای فقط یک خط، چندین خط را پردازش کنید، می‌توانید با قرار دادن نشانه ویژه در یک خط مستقل، تغییر زمینه را بر ادامه فایل یا تا دستورالعمل تغییر زمینه بعدی اعمال کنید:
.PP
.RS
.nf
# make this file handle snmp.conf tokens:
[snmp]
dumpPacket true
logTimestamp true
# return to our original snmpd.conf tokens:
[snmpd]
rocommunity mypublic
.fi
.RE
.PP
از همین روش می‌توان برای تنظیم دستورالعمل‌های پیکربندی برای یک برنامه کلاینت خاص (یا گروهی از برنامه‌ها) استفاده کرد. به عنوان مثال، هر برنامه‌ای که از فراخوانی
.B 'snmp_parse_args()'
برای مدیریت آرگومان‌های خط فرمان استفاده می‌کند (از جمله ابزارهای استاندارد خط فرمان که به عنوان بخشی از توزیع‌های Net-SNMP ارائه می‌شوند)، فایل پیکربندی
.B 'snmpapp.conf'
را به‌طور خودکار خواهد خواند.
برای اعمال تنظیمات سطح کتابخانه برای این برنامه‌ها (و نه سایر ابزارهای خاص‌تر)، از پیکربندی‌هایی مانند نمونه زیر استفاده کنید:
.PP
.RS
.nf
[snmp] defCommunity myCommunity
.fi
.RE
.PP
برای یک دستورالعمل منفرد، یا:
.PP
.RS
.nf
# make this file handle snmp.conf tokens:
[snmp]
defCommunity myCommunity
defVersion   2c
# return to our original snmpapp.conf tokens:
[snmpapp]
.fi
.RE
.PP
برای چندین تنظیم مختلف.
به همین ترتیب برای هر نشانه برنامه دیگر (همان‌طور که به ()init_snmp ارسال می‌شود) نیز صدق می‌کند.
.SH "کامنت‌ها (COMMENTS)"
.PP
هر خطی در فایل‌های پیکربندی که با نویسه '#' آغاز شود، به عنوان کامنت در نظر گرفته شده و پردازش نمی‌شود.
.SH "فراخوانی سایر فایل‌های پیکربندی (INCLUDING OTHER CONFIGURATION FILES)"
امکان فراخوانی سایر فایل‌های پیکربندی برای پردازش در حین پردازش عادی فایل پیکربندی وجود دارد:
.PP
.RS
.nf
# include site specific config
includeFile site.conf
.fi
.RE
.PP
این دستور فایل پیکربندی مشخص‌شده را بارگذاری می‌کند. مسیر فایل باید مطلق (شروع با '/') یا نسبی باشد. مسیر نسبی نسبت به دایرکتوری‌ای سنجیده می‌شود که فایل والد حاوی دستورالعمل
.B 'includeFile'
در آن قرار دارد.
.PP
نیازی نیست نام فایل فراخوانی‌شده پسوند
.B '.conf'
داشته باشد.
.PP
.RS
.nf
# include a all *.conf files in a directory
includeDir /etc/snmp/config.d
.fi
.RE
.PP
این دستور دایرکتوری مشخص‌شده را برای تمام فایل‌های دارای پسوند
.B '.conf'
جستجو کرده و آن‌ها را به گونه‌ای پردازش می‌کند که گویی با استفاده از دستورالعمل
.B includeFile
فراخوانی شده‌اند. فایل‌های پیکربندی به هیچ ترتیب خاصی پردازش نمی‌شوند.
.PP
دایرکتوری مشخص‌شده باید یک مسیر دایرکتوری مطلق باشد.
.SH "رابط برنامه‌نویسی (API INTERFACE)"
.PP
اطلاعات مربوط به نوشتن کد C که از این سیستم در ماژول‌های MIB عامل یا در برنامه‌ها استفاده می‌کند را می‌توانید در صفحه راهنمای
.I netsnmp_config_api(3)
بیابید.
.SH "همچنین ببینید (SEE ALSO)"
.BR snmpconf (1),
.BR netsnmp_config_api (3),
.BR snmp.conf (5),
.BR snmpd.conf (5)
.\" Local Variables:
.\"  mode: nroff
.\" End: