'\" t
.\"     Title: sockdebug
.\"    Author: [see the "AUTHORS" section]
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net>
.\"      Date: 06/21/2026
.\"    Manual: NUT Manual
.\"    Source: Network UPS Tools 2.8.5
.\"  Language: Persian
.\"
.TH "SOCKDEBUG" "8" "06/21/2026" "Network UPS Tools 2\&.8\&.5" "NUT Manual"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "نام (NAME)"
sockdebug \- ابزاری ساده برای کمک به توسعه‌دهندگان و عیب‌یابی جهت ارتباط با درایور NUT با استفاده از پروتکل سوکت
.SH "خلاصه دستور (SYNOPSIS)"
.sp
\fBsockdebug\fR socketname
.sp
برای نمونه (نسخه‌های کامپایل‌شده برای WIN32 و POSIX):
.sp
.nf
:; sockdebug\&.exe dummy\-ups\-UPS1
.fi
.sp
برای نمونه (سیستم‌های سازگار با POSIX با استفاده از مسیر وضعیت جایگزین):
.sp
.nf
:; sockdebug /var/state/ups/dummy\-ups\-UPS1
.fi
.SH "توضیحات (DESCRIPTION)"
.sp
\fBsockdebug\fR ابزاری است که هنگام فعال بودن گزینه \-\-with\-dev در configure بسته NUT ساخته می‌شود\&. همچنین می‌توان آن را با اجرای make sockdebug در ریشه فضای کاری ساخت کامپایل کرد\&. پرونده‌های منبع واقعی مورد استفاده به پلتفرم مقصد بستگی دارند\&.
.sp
این ابزار برای اتصال به درایور NUT با استفاده از پروتکل سوکت روی یک سوکت یونیکس یا لوله (pipe) ویندوز استفاده می‌شود، مشابه نحوه ارتباط کارساز داده \fBupsd\fR(8) با درایورهای در حال اجرای محلی به منظور نمایش دادن آن‌ها در شبکه از طریق پروتکل مشترک NUT در پروژه Network UPS Tools، یا نحوه ارتباط برنامه‌های درایور با نمونه‌های از قبل در حال اجرای خود برای پیاده‌سازی دستوراتی مانند reload\-or\-error بی‌درنگ\&.
.sp
این ابزار به توسعه‌دهنده یا عیب‌یاب اجازه می‌دهد به‌روزرسانی‌های همگانی (broadcast) ارسال‌شده توسط درایور را مشاهده کند، و همچنین دستورات تک‌پخشی (unicast) صادر کرده و پاسخ‌ها را دریافت نماید (در طول یک نشست بررسی تعاملی، ممکن است بخواهید ابتدا دستور NOBROADCAST را صادر کنید)\&.
.sp
برای جزئیات بیشتر به پرونده docs/sock\-protocol\&.txt در منابع NUT مراجعه کنید\&.
.SH "گزینه‌ها (OPTIONS)"
.sp
\fBsockdebug\fR گزینه زیر را می‌پذیرد (و به آن نیاز دارد):
.PP
\fBsocketname\fR
.RS 4
یا یک مسیر کامل (در ساخت‌های POSIX) یا نام پایه سوکت/لوله دستگاه (روی تمام پلتفرم‌ها)، متشکل از یک چندتایی
drivername\-devicename
، برای نمونه
dummy\-ups\-UPS1
برای نمونه‌ای از درایور
dummy\-ups
که پیکربندی دستگاه
UPS1
را مدیریت می‌کند (که به نوبه خود ممکن است در پرونده
ups\&.conf
تعریف شده باشد یا با فراخوانی برنامه درایور با گزینه خط فرمان
\-s TMP
به‌طور پویا برای آزمون‌ها ساخته شده باشد)\&.
.sp
در سیستم‌های POSIX، اگر این آرگومان فقط یک نام پایه را نشان دهد و مسیر کامل به پرونده سوکت یونیکس نباشد، ابزار ابتدا باید پرونده را در دایرکتوری جاری جستجو کند، و سپس در صورت عدم وجود به مسیر وضعیت پیکربندی‌شده (داخلی) یا مقدار متغیر محیطی
NUT_STATEPATH
در صورت تنظیم، رجوع کند؛ برای نمونه:
.sp
.if n \{\
.RS 4
.\}
.nf
:; NUT_STATEPATH=/tmp \&./server/sockdebug dummy\-ups\-UPS1
.fi
.if n \{\
.RE
.\}
.RE
.SH "نویسندگان (AUTHORS)"
.sp
این صفحه راهنما توسط Jim Klimov <jimklimov+nut@gmail\&.com> نوشته شده است\&.
.sp
این برنامه در حال حاضر به عنوان دو منبع جداگانه نگهداری می‌شود که بسته به پلتفرم هدف، یکی از آن‌ها برای ساخت استفاده می‌شود:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
server/sockdebug\&.c
(نسخه POSIX) در ابتدا توسط Russell Kroll <rkroll@exploits\&.org> نوشته شد، و
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
server/pipedebug\&.c
(نسخه Windows) در ابتدا توسط Frederic Bohe <fredericbohe@eaton\&.com> نوشته شد\&.
.RE
.SH "همچنین ببینید (SEE ALSO)"
.sp
\fBupsd\fR(8)
.SS "منابع اینترنتی (Internet resources)"
.sp
صفحه اصلی NUT (Network UPS Tools): https://www\&.networkupstools\&.org/historic/v2\&.8\&.5