نام (NAME)

sockdebug - ابزاری ساده برای کمک به توسعه‌دهندگان و عیب‌یابی جهت ارتباط با درایور NUT با استفاده از پروتکل سوکت

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

sockdebug socketname

برای نمونه (نسخه‌های کامپایل‌شده برای WIN32 و POSIX):

:; sockdebug.exe dummy-ups-UPS1

برای نمونه (سیستم‌های سازگار با POSIX با استفاده از مسیر وضعیت جایگزین):

:; sockdebug /var/state/ups/dummy-ups-UPS1

توضیحات (DESCRIPTION)

sockdebug ابزاری است که هنگام فعال بودن گزینه --with-dev در configure بسته NUT ساخته می‌شود. همچنین می‌توان آن را با اجرای make sockdebug در ریشه فضای کاری ساخت کامپایل کرد. پرونده‌های منبع واقعی مورد استفاده به پلتفرم مقصد بستگی دارند.

این ابزار برای اتصال به درایور NUT با استفاده از پروتکل سوکت روی یک سوکت یونیکس یا لوله (pipe) ویندوز استفاده می‌شود، مشابه نحوه ارتباط کارساز داده upsd(8) با درایورهای در حال اجرای محلی به منظور نمایش دادن آن‌ها در شبکه از طریق پروتکل مشترک NUT در پروژه Network UPS Tools، یا نحوه ارتباط برنامه‌های درایور با نمونه‌های از قبل در حال اجرای خود برای پیاده‌سازی دستوراتی مانند reload-or-error بی‌درنگ.

این ابزار به توسعه‌دهنده یا عیب‌یاب اجازه می‌دهد به‌روزرسانی‌های همگانی (broadcast) ارسال‌شده توسط درایور را مشاهده کند، و همچنین دستورات تک‌پخشی (unicast) صادر کرده و پاسخ‌ها را دریافت نماید (در طول یک نشست بررسی تعاملی، ممکن است بخواهید ابتدا دستور NOBROADCAST را صادر کنید).

برای جزئیات بیشتر به پرونده docs/sock-protocol.txt در منابع NUT مراجعه کنید.

گزینه‌ها (OPTIONS)

sockdebug گزینه زیر را می‌پذیرد (و به آن نیاز دارد):

socketname

یا یک مسیر کامل (در ساخت‌های POSIX) یا نام پایه سوکت/لوله دستگاه (روی تمام پلتفرم‌ها)، متشکل از یک چندتایی drivername-devicename ، برای نمونه dummy-ups-UPS1 برای نمونه‌ای از درایور dummy-ups که پیکربندی دستگاه UPS1 را مدیریت می‌کند (که به نوبه خود ممکن است در پرونده ups.conf تعریف شده باشد یا با فراخوانی برنامه درایور با گزینه خط فرمان -s TMP به‌طور پویا برای آزمون‌ها ساخته شده باشد).

در سیستم‌های POSIX، اگر این آرگومان فقط یک نام پایه را نشان دهد و مسیر کامل به پرونده سوکت یونیکس نباشد، ابزار ابتدا باید پرونده را در دایرکتوری جاری جستجو کند، و سپس در صورت عدم وجود به مسیر وضعیت پیکربندی‌شده (داخلی) یا مقدار متغیر محیطی NUT_STATEPATH در صورت تنظیم، رجوع کند؛ برای نمونه:

:; NUT_STATEPATH=/tmp ./server/sockdebug dummy-ups-UPS1

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

این صفحه راهنما توسط Jim Klimov <jimklimov+nut@gmail.com> نوشته شده است.

این برنامه در حال حاضر به عنوان دو منبع جداگانه نگهداری می‌شود که بسته به پلتفرم هدف، یکی از آن‌ها برای ساخت استفاده می‌شود:

•server/sockdebug.c (نسخه POSIX) در ابتدا توسط Russell Kroll <rkroll@exploits.org> نوشته شد، و

•server/pipedebug.c (نسخه Windows) در ابتدا توسط Frederic Bohe <fredericbohe@eaton.com> نوشته شد.

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

upsd(8)

منابع اینترنتی (Internet resources)

صفحه اصلی NUT (Network UPS Tools): https://www.networkupstools.org/historic/v2.8.5