.\" -*- mode: troff; coding: utf-8 -*- .\" Automatically generated by Pod::Man v6.0.2 (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 .\" .\" Required to disable full justification in groff 1.23.0. .if n .ds AD l .\" ======================================================================== .\" .IX Title "GDNSD-PLUGIN-EXTFILE 8" .TH GDNSD-PLUGIN-EXTFILE 8 2026-04-04 "gdnsd 3.8.3" gdnsd .\" 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)" gdnsd\-plugin\-extfile \- افزونه gdnsd برای وارد کردن داده‌های پایش از طریق فایل .SH "خلاصه دستور (SYNOPSIS)" .IX Header "خلاصه دستور (SYNOPSIS)" نمونه پیکربندی service_types: .PP .Vb 10 \& service_types => { \& ext1 => { \& plugin => "extfile", \& file => "/var/tmp/ext1data", # required \& direct => true, # default false \& def_down => false, # default false \& def_ttl => 600, # default max (limited by zonefile RRs) \& } \& ext2 => { \& plugin => "extfile", \& file => "ext2data", # def dir: //lib/gdnsd/extfile/ \& }, \& } .Ve .PP نمونه پیکربندی افزونه با استفاده از این service_typesها: .PP .Vb 10 \& plugins => { \& multifo => { \& www1 => { \& service_types => ext2, \& lb01 => 192.0.2.200, \& lb02 => 192.0.2.201, \& lb03 => 192.0.2.202, \& } \& www2 => { \& service_types => [ ext1, http_status ], \& lb01 => 192.0.2.203, \& lb02 => 192.0.2.204, \& lb03 => 192.0.2.205, \& } \& }, \& weighted => { \& wwwcn => { \& service_types => ext1, \& lb01 = [ lb01.example.com., 99 ], \& lb02 = [ lb02.example.com., 15 ], \& lb03 = [ lb03, 1 ], \& } \& wwwz => { \& service_types => ext1, \& lb01 => [ 192.0.2.203, 10 ], \& lb02 => [ 192.0.2.204, 15 ], \& lb03 => [ 192.0.2.205, 20 ], \& } \& } \& } .Ve .PP نمونه داده‌های extfile که منابع و service_types مشخص‌شده در بالا را تعریف می‌کنند: .PP .Vb 7 \& /var/tmp/ext1data: \& 192.0.2.203 => UP/300 \& 192.0.2.204 => DOWN/242 \& 192.0.2.205 => DOWN/102 \& lb01.example.com. => UP/60 \& lb02.example.com. => UP/30 \& lb03 => UP/45 \& \& //lib/gdnsd/extfile/ext2data: \& 192.0.2.200 => DOWN \& 192.0.2.201 => UP \& 192.0.2.202 => UP .Ve .SH "توضیحات (DESCRIPTION)" .IX Header "توضیحات (DESCRIPTION)" افزونه \&\fBgdnsd\-plugin\-extfile\fR یک افزونه پایش است که نتایج پایش را از یک فایل خارجی (که احتمالاً توسط یک اسکریپت یا ابزاری از سایر نرم‌افزارهای پایش مقداردهی می‌شود) وارد می‌کند. .SH "حالت‌ها (MODES)" .IX Header "حالت‌ها (MODES)" یک service_type مربوط به extfile می‌تواند در یکی از دو حالت پایه‌ای زیر عمل کند: .IP "حالت پایش (Monitor Mode - پیش‌فرض)" 4 .IX Item "حالت پایش (Monitor Mode - پیش‌فرض)" در حالت پایش، پارامتر استاندارد \f(CW\*(C`interval\*(C'\fR به عنوان یک تایمر تکرارشونده استفاده می‌شود. در هر بازه زمانی، فایل برای دریافت به‌روزرسانی‌های وضعیت بارگیری می‌شود (اما هرگونه مقدار مستقیم TTL درون فایل نادیده گرفته می‌شود). .Sp به‌روزرسانی‌های حاصل از فایل، با سازوکارهایی مشابه افزونه‌های پایش معمولی (مانند http_status) به سیستم اصلی پایش فرستاده می‌شوند. این بدان معناست که این اطلاعات قبل از تأثیرگذاری بر وضعیت نهایی قابل مشاهده توسط افزونه‌های تفکیک (resolution plugins)، از طریق پارامترهای آستانه استاندارد (\f(CW\*(C`up_thresh\*(C'\fR، \f(CW\*(C`down_thresh\*(C'\fR، \f(CW\*(C`ok_thresh\*(C'\fR) مشمول تدابیر استاندارد ضد تغییر وضعیت پیاپی (anti\-flap) خواهند شد. .Sp این حالت در صورتی مناسب است که به‌روزرسانی‌های در حال پردازش، نتایج نسبتاً خام حاصل از بررسی‌های جداگانه پایش باشند. .IP "حالت مستقیم (Direct Mode)" 4 .IX Item "حالت مستقیم (Direct Mode)" در حالت مستقیم، پارامتر استاندارد \f(CW\*(C`interval\*(C'\fR تنها به عنوان یک \fBراهنما (hint)\fR برای کد پایش سیستم فایل به کار می‌رود تا بررسی به‌روزرسانی‌ها در فواصل زمانی طولانی‌تر از بازه مشخص‌شده انجام نشود. با این حال در بسیاری از موارد (به‌ویژه در لینوکس با پشتیبانی از \f(CWinotify()\fR) به‌روزرسانی‌های فایل ممکن است بسیار زودتر و تقریباً در همان لحظه دریافت شوند. .Sp پس از تشخیص هر به‌روزرسانی، یک تاخیر کوتاه تثبیت (~۱ ثانیه) وجود خواهد داشت تا به‌روزرسانی‌های سریع و پیاپی در قالب یک تراکنش واحد تجمیع شوند. .Sp نتایج موجود در فایل (وضعیت و/یا TTL برای هر منبع) مستقیماً به عنوان نتایج نهایی پایش اعمال می‌شوند و بلافاصله برای تصمیم‌گیری در اختیار افزونه‌های تفکیک قرار می‌گیرند. .Sp این حالت در صورتی مناسب است که به‌روزرسانی‌ها از نتایج پایش پردازش‌شده‌ای باشند که قبلاً (پیش از رسیدن به gdnsd) تدابیری مانند ضد تغییر وضعیت پیاپی (anti\-flap) روی آن‌ها اعمال شده است. .SH "قالب فایل (FILE FORMAT)" .IX Header "قالب فایل (FILE FORMAT)" این فایل با استفاده از همان زبان \f(CW\*(C`vscf\*(C'\fR قالب‌بندی می‌شود که برای فایل پیکربندی اصلی و پایگاه‌های داده شبکه‌های geoip استفاده می‌شود. قالب داده مورد انتظار یک هش کلید\-مقدار ساده در سطح بالاست، به طوری که کلیدها همان آدرس‌های IP پایش‌شده یا مقادیر CNAME از افزونه‌های پایش هستند و مقادیر به صورت \f(CW\*(C`state[/ttl]\*(C'\fR می‌باشند؛ که در آن state برابر با \f(CW\*(C`UP\*(C'\fR یا \f(CW\*(C`DOWN\*(C'\fR بوده و ttl اختیاری یک مقدار عددی صحیح TTL است. مقادیر TTL تنها برای service_typeهای در حالت \f(CW\*(C`direct\*(C'\fR استفاده می‌شوند؛ برای حالت \f(CW\*(C`monitor\*(C'\fR مقدار TTL به روش معمول و بر اساس بازه‌ها و آستانه‌ها محاسبه می‌گردد. .SH "پیکربندی \- برای هر نوع سرویس (CONFIGURATION \- PER\-SERVICE\-TYPE)" .IX Header "پیکربندی - برای هر نوع سرویس (CONFIGURATION - PER-SERVICE-TYPE)" پارامترهای عمومی و خنثی نسبت به افزونه service_type همگی در کاربرد معمول خود صدق می‌کنند: \f(CW\*(C`up_thresh\*(C'\fR، \f(CW\*(C`ok_thresh\*(C'\fR، \f(CW\*(C`down_thresh\*(C'\fR و \f(CW\*(C`interval\*(C'\fR (با در نظر داشتن نکات فوق در مورد نحوه استفاده هر حالت از \f(CW\*(C`interval\*(C'\fR). پارامتر \f(CW\*(C`timeout\*(C'\fR نادیده گرفته می‌شود. پارامترهای اختصاصی extfile: .IP \fBdirect\fR 4 .IX Item "direct" بولی (Boolean)، پیش‌فرض false. در صورت true، حالت پایش را به \&\f(CW\*(C`direct\*(C'\fR تنظیم می‌کند، در غیر این صورت حالت به صورت پیش‌فرض روی \f(CW\*(C`monitor\*(C'\fR قرار می‌گیرد. .IP \fBfile\fR 4 .IX Item "file" رشته نام فایل، الزامی است. این گزینه نام فایلی را تعیین می‌کند که نتایج از آن بارگیری می‌شوند. اگر مسیر فایل مطلق نباشد، به عنوان مسیری نسبی نسبت به \fI//lib/gdnsd/extfile/\fR در نظر گرفته خواهد شد. .IP \fBdef_ttl\fR 4 .IX Item "def_ttl" مقدار عددی صحیح TTL، پیش‌فرض حداکثر است (که توسط مقادیر TTL رکوردهای منابع یا RR در فایل منطقه محدود خواهد شد). در حالت \f(CW\*(C`direct\*(C'\fR، اگر برای یک منبع معین هیچ TTL اختیاری در داده‌های فایل ارائه نشده باشد، این مقدار به عنوان TTL پایش‌شده تنظیم خواهد شد. در حالت \f(CW\*(C`monitor\*(C'\fR این پارامتر نادیده گرفته می‌شود. .IP \fBdef_down\fR 4 .IX Item "def_down" بولی (Boolean)، پیش‌فرض false. این گزینه وضعیت پیش‌فرض منابع پیکربندی‌شده‌ای را تعیین می‌کند که در داده‌های فایل وجود ندارند (که هشدارهایی ایجاد خواهد کرد). اگر true باشد، این منابع طوری عمل می‌کنند که گویی داده‌های فایل آن‌ها را به عنوان \f(CW\*(C`DOWN\*(C'\fR علامت‌گذاری کرده است، در غیر این صورت به طور پیش‌فرض روی \f(CW\*(C`UP\*(C'\fR قرار می‌گیرند. .SH "همچنین ببینید (SEE ALSO)" .IX Header "همچنین ببینید (SEE ALSO)" \&\fBgdnsd.config\fR\|(5), \fBgdnsd\fR\|(8) .PP راهنمای gdnsd. .SH "حق نشر و مجوز (COPYRIGHT AND LICENSE)" .IX Header "حق نشر و مجوز (COPYRIGHT AND LICENSE)" حق نشر (c) ۲۰۱۲ Brandon L Black .PP این فایل بخشی از gdnsd است. .PP نرم‌افزار gdnsd یک نرم‌افزار آزاد است: شما می‌توانید آن را تحت شرایط مجوز عمومی همگانی گنو (GNU GPL) که توسط بنیاد نرم‌افزارهای آزاد منتشر شده است، چه نسخه ۳ مجوز و چه (به انتخاب خودتان) هر نسخه بعدی آن، بازتوزیع کرده یا تغییر دهید. .PP نرم‌افزار gdnsd به این امید توزیع شده است که مفید واقع شود، اما بدون هرگونه ضمانت؛ حتی بدون ضمانت ضمنی قابلیت فروش یا تناسب با یک هدف خاص. برای جزئیات بیشتر به مجوز عمومی همگانی گنو مراجعه کنید. .PP شما باید یک نسخه از مجوز عمومی همگانی گنو را به همراه gdnsd دریافت کرده باشید. در غیر این صورت، ببینید: .