نام (NAME)

raddebug - نمایش خروجی اشکال‌زدایی از سرور در حال اجرای FreeRADIUS

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

raddebug [-c condition] [-d config_directory] [-D dictionary_directory] [-n name] [-i ipv4-address] [-I ipv6-address] [-f socket_file] [-t timeout] [-u user-name]

توضیحات (DESCRIPTION)

برنامه raddebug یک پوسته اسکریپت پیرامون radmin است که فرآیند دریافت خروجی اشکال‌زدایی از یک سرور در حال اجرا را خودکار می‌کند. این کار را برخلاف استفاده از radiusd -X بدون تأثیر گذاشتن بر در دسترس بودن سرویس انجام می‌دهد. برای عملکرد صحیح آن پیش‌نیازهایی لازم است:

* دستور radmin باید در PATH در دسترس باشد.
* کاربری که raddebug را اجرا می‌کند باید مجوز اتصال به سوکت کنترل سرور را داشته باشد.
* سوکت کنترل باید پیکربندی شده باشد. برای دستورالعمل‌ها، به raddb/sites-available/control-socket مراجعه کنید.
* سوکت کنترل باید با مقدار "mode = rw" مشخص شده باشد.
* کاربری که raddebug را اجرا می‌کند باید مجوز خواندن و نوشتن فایل‌ها را در دایرکتوری "logdir" داشته باشد. این مسیر معمولاً /var/log/radiusd است.

به دلایل متعددی، خروجی اشکال‌زدایی به‌جای ارسال مستقیم به خروجی استاندارد، در یک فایل میانی قرار می‌گیرد. به منظور جلوگیری از رشد بیش از حد این فایل، برنامه raddebug پس از ۱۰ ثانیه به‌طور خودکار خاتمه می‌یابد. این زمان انتظار را می‌توان با پارامتر -t تغییر داد.

هنگامی که اسکریپت خارج می‌شود، حالت اشکال‌زدایی در سرور غیرفعال شده و فایل میانی حذف می‌گردد.

خروجی اشکال‌زدایی از یک سرور فعال تنها می‌تواند به یک مکان هدایت شود. اگر نمونه دومی از raddebug در حالی که نمونه اول هنوز در حال اجراست آغاز شود، نمونه جدیدتر جایگزین نمونه اول خواهد شد و خروجی نمونه اول متوقف می‌شود.

گزینه‌ها (OPTIONS)

-c condition

تنظیم یک شرط اشکال‌زدایی خاص. قالب شرط همان‌گونه است که در بخش CONDITIONS صفحه راهنمای unlang مشخص شده است.

-f socket_file

مسیر سوکت کنترل. برای توضیحات بیشتر درباره این گزینه، به صفحه راهنمای radmin مراجعه کنید.

-i ipv4-address

نمایش خروجی اشکال‌زدایی برای کلاینتی با آدرس IPv4 داده‌شده. این گزینه معادل استفاده از دستور زیر است:

-c '(Packet-Src-IP-Address == ipv4-address)'

-d config directory

دایرکتوری پیکربندی radius، معمولاً /etc/raddb. برای توضیحات بیشتر درباره این گزینه، به صفحه راهنمای radmin مراجعه کنید.

-D dictionary directory

تنظیم دایرکتوری اصلی دیکشنری. مقدار پیش‌فرض /usr/share/freeradius است.

-n mname

خواندن raddb/name.conf به‌جای raddb/radiusd.conf.

-I ipv6-address

نمایش خروجی اشکال‌زدایی برای کلاینتی با آدرس IPv6 داده‌شده. این گزینه معادل استفاده از دستور زیر است:

-c '(Packet-Src-IPv6-Address == ipv6-address)'

-t timeout

توقف چاپ خروجی اشکال‌زدایی پس از "timeout" ثانیه. زمان انتظار پیش‌فرض ۶۰ ثانیه است. از "-t 0"; برای چاپ خروجی اشکال‌زدایی به صورت نامحدود یا تا زمان خروج اسکریپت استفاده کنید.

-u name

نمایش خروجی اشکال‌زدایی برای کاربران با نام داده‌شده. این گزینه معادل استفاده از دستور زیر است:

-c '(User-Name == name)'

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

radmin(8), raddb/sites-available/control-socket, unlang(5), radiusd.conf(5)

نویسندگان (AUTHORS)

Alan DeKok <aland@freeradius.org>