BIND9_QUERY2DLF.IN(1) LogReport's Lire Documentation BIND9_QUERY2DLF.IN(1) نام (NAME) bind9_query2dlf - تبدیل گزارش‌های پرسمان BIND9 به قالب dlf خلاصه دستور (SYNOPSIS) bind9_query2dlf توضیحات (DESCRIPTION) دستور bind9_query2dlf فایل‌های لاگ پرسمان (query log) نسخه BIND 9 را از ورودی استاندارد (stdin) دریافت می‌کند. اگر در فایل named.conf خود پیکربندی زیر را داشته باشید: channel query_logging { file "/var/log/named_querylog" versions 3 size 100M; print-time yes; // timestamp log entries }; فایل‌های لاگ تولیدشده پشتیبانی می‌شوند. همچنین در صورت تمایل می‌توانید خطوط زیر را به این کانال اضافه کنید: print-category yes; // print category name print-severity yes; // print severity level لاگ‌های پرسمان تولیدشده توسط BIND وصله‌شده (پچ‌شده - بخش «نکات» در زیر را ببینید) نیز پشتیبانی می‌شوند. همچنین لاگ‌های Bind 9.3 که از قالب تاریخ جدید (15-Jul-2002) به جای قالب قدیمی syslog استفاده می‌کنند، پشتیبانی می‌شوند. نمونه لاگ‌ها (LOG EXAMPLES) در صورت فعال بودن گزینه‌های print-time، print-category و print-severity: Feb 25 11:09:43.651 queries: info: client 10.0.0.3#1035: query: 3.example.com.nl IN A Feb 25 11:09:48.739 queries: info: client 10.0.0.3#1035: query: 3.example.com.nl IN A Feb 25 12:50:32.476 queries: info: client 10.0.0.3#1035: query: 21.example.com.co.uk IN A Feb 25 12:50:34.110 queries: info: client 10.0.0.3#1035: query: 22.example.com IN A Feb 25 12:50:34.525 lame-servers: info: lame server on '22.example.com' (in '23.example.com'?): 10.0.0.4#53 Feb 25 12:50:34.715 queries: info: client 10.0.0.3#1035: query: 24.example.com IN A Feb 26 07:30:08.211 queries: info: client 10.0.0.1#1050: query: 1.0.0.10.in-addr.arpa IN PTR Feb 26 12:26:55.455 queries: info: client 10.0.0.1#1051: query: 28.example.com.nl IN MX Feb 04 04:02:00.932 general: info: loading configuration from '/etc/336.example.com' Feb 18 04:02:01.023 security: warning: zone '337.example.com.nl' allows updates by IP address, which is insecure Feb 18 04:02:01.049 config: warning: option 'use-id-pool' is obsolete Feb 18 04:02:01.049 config: warning: option 'check-names' is not implemented Feb 18 04:02:01.049 config: warning: option 'statistics-interval' is not yet implemented Feb 18 04:02:01.049 network: info: no IPv6 interfaces found Feb 04 16:47:18.289 security: info: client 10.0.0.201#137: query denied Feb 20 07:26:53.731 general: info: running Feb 13 08:01:56.138 general: info: shutting down Feb 13 08:01:56.140 network: info: no longer listening on 10.0.0.3#53 Feb 14 08:02:13.983 general: info: refresh_callback: zone 384.example.com/IN: failure for 10.0.0.204#53: timed out فقط با تنظیم بودن گزینه print-time: Aug 27 04:07:13.361 client 127.0.0.1#3123: query: foo.com IN ANY Aug 27 04:07:13.438 client 127.0.0.1#3123: query: fu.bar.nl IN AAAA Aug 27 04:07:13.443 client 127.0.0.1#3123: query: fu.bar.nl IN A مثال‌ها (EXAMPLES) برای پردازش یک لاگ تولیدشده توسط bind9: $ bind9_query2dlf < dns-query دستور bind9_query2dlf به‌ندرت به‌تنهایی استفاده می‌شود و بیشتر توسط lr_log2report فراخوانی می‌گردد: $ lr_log2report bind9_query < /var/log/dns-query نکات (NOTES) نسخه‌های BIND 9 قبل از 9.3 مشخص نمی‌کردند که آیا پرسمان بازگشتی (recursive) بوده است یا خیر، بنابراین آخرین فیلد dlf یعنی (DLF_RESOLVER) مقدار '-' خواهد بود. با این حال، با اعمال وصله زیر ارائه‌شده توسط Wytze van der Raay: # patch bin/named/query.c to log recursive/non-recursive query indication SRC=bin/named/query.c if [ -f ${SRC}.org ] then echo "Patched ${SRC} already in place" else echo "Patch ${SRC} for recursive/non-recursive query indication" cp -p ${SRC} ${SRC}.org patch -p0 ${SRC} <<\! --- bin/named/query.c.org Mon Sep 24 22:57:48 2001 +++ bin/named/query.c Tue Sep 25 09:55:21 2001 @@ -3272,7 +3272,8 @@ dns_rdatatype_format(rdataset->type, typename, sizeof(typename)); ns_client_log(client, NS_LOGCATEGORY_QUERIES, NS_LOGMODULE_QUERY, - level, "query: %s %s %s", namebuf, classname, typename); + level, "query: %s %s %s%s", namebuf, classname, typename, + WANTRECURSION(client) ? "+" : "-"); } void ! fi خطوط لاگی مشابه نمونه زیر تولید خواهند شد: Nov 11 12:06:42.829 queries: info: client 10.0.0.1#3664: query: 6.example.com.nl IN A+ علامت '+' نشان‌دهنده پرسمان بازگشتی (recursive) و علامت - نشان‌دهنده پرسمان غیربازگشتی است؛ عدم وجود + یا - نشان‌دهنده نسخه وصله‌نشده پیش از 9.3 در bind9 است. به پیام Wytze در تاریخ جمعه ۲۸ دسامبر ۲۰۰۱ در bind9-workers@isc.org که در نشانی آرشیو شده است مراجعه نمایید. این نوع فایل‌های لاگ توسط این اسکریپت شناسایی و پشتیبانی می‌شوند. نسخه BIND 9.3 یا بالاتر پشتیبانی کاملی از این قابلیت لاگ‌گیری ارائه می‌دهد. علاوه بر این، اطلاعات view، امضاکننده (signer) و EDNS را نیز ثبت می‌کند که همگی در این نسخه از اسکریپت نادیده گرفته می‌شوند. در یک گفتگوی خصوصی در تاریخ پنجشنبه ۱۸ ژوئیه ۲۰۰۲، Wytze نوشت: This contains the "ISC-compatible" version of the patch for getting a recursive/non-recursive request logged. ISC decided there should be a space between the type and the recursion indicator in the logfile, so be it. اگر مایلید BIND 9.2.1 شما به سبک سازگار با ISC در نسخه 9.3 لاگ‌گیری کند، این وصله را روی سورس‌های BIND خود اعمال کنید: --- bin/named/query.c.org Thu Mar 28 06:10:09 2002 +++ bin/named/query.c Wed Jul 17 08:14:41 2002 @@ -3279,7 +3279,8 @@ dns_rdatatype_format(rdataset->type, typename, sizeof(typename)); ns_client_log(client, NS_LOGCATEGORY_QUERIES, NS_LOGMODULE_QUERY, - level, "query: %s %s %s", namebuf, classname, typename); + level, "query: %s %s %s %s", namebuf, classname, typename, + WANTRECURSION(client) ? "+" : "-"); } void این اسکریپت هر دو سبک نشانگر بازگشتی Wytze و ISC را به خوبی درک و پشتیبانی می‌کند. سپاسگزاری (THANKS) با تشکر از Wytze van der Raay برای ارائه پچ لاگ پرسمان BIND 9. همچنین ببینید (SEE ALSO) bind8_query2dlf(1)، مستندات آنلاین bind9 که همراه با BIND توزیع شده است (البته در نشانی در دسترس نیست، اما مستندات در نشانی می‌تواند مفید باشد). نسخه (VERSION) $Id: bind9_query2dlf.in,v 1.7 2006/07/23 13:16:33 vanbaal Exp $ حق نشر (COPYRIGHT) کپی‌رایت (C) 2001 Joost Bekkers ، کپی‌رایت (C) 2000, 2001, 2002 Stichting LogReport Foundation LogReport@LogReport.org این برنامه یک نرم‌افزار آزاد است؛ شما می‌توانید آن را تحت شرایط «پروانه عمومی همگانی گنو» (GNU GPL) منتشرشده توسط بنیاد نرم‌افزارهای آزاد (نسخه ۲ یا به انتخاب خود هر نسخه بالاتر) بازتوزیع کرده یا تغییر دهید. این برنامه با این امید توزیع شده است که مفید واقع شود، اما بدون هرگونه ضمانت؛ حتی بدون ضمانت ضمنی تجاری بودن یا مناسب بودن برای یک هدف خاص. برای جزئیات بیشتر به پروانه عمومی همگانی گنو مراجعه کنید. شما باید همراه با این برنامه یک نسخه از پروانه عمومی همگانی گنو را دریافت کرده باشید (فایل COPYING را ببینید)؛ در غیر این صورت به نشانی مراجعه نمایید. نویسنده (AUTHOR) Joost Bekkers بر پایه کارهای Edwin Groothuis و Joost van Baal، و در حال حاضر توسط تیم LogReport نگهداری می‌شود. Lire 2.1.1 2025-09-28 BIND9_QUERY2DLF.IN(1)