.\" Created from Texinfo source by yat2m 1.61-unknown
.TH WATCHGNUPG 1 2025-02-19 "GnuPG 2.4.9" "GNU Privacy Guard 2.4"
.SH "نام (NAME)"
watchgnupg \- ابزار مشاهده و ثبت لاگ سوکتهای سیستم GnuPG
.SH "خلاصه دستور (SYNOPSIS)"
.B  watchgnupg
.RB [ \-\-force ]
.RB [ \-\-verbose ]
.I socketname

.SH "توضیحات (DESCRIPTION)"
بیشتر ابزارهای اصلی در صورت پیکربندی مناسب می‌توانند فایل‌های لاگ خود را در یک سوکت یونیکس (Unix Domain socket) بنویسند.
.B watchgnupg
یک شنونده ساده برای چنین سوکتی است. این ابزار خروجی را با برچسب زمان (timestamp) آراسته می‌کند و اطمینان حاصل می‌نماید که خطوط طولانی با خروجی‌های لاگ سایر ابزارها تداخل پیدا نکنند. این ابزار برای ویندوز در دسترس نیست.
.PP
.B watchgnupg
معمولاً به صورت زیر فراخوانی می‌شود:

.RS 2
.nf
watchgnupg
.fi
.RE

که کوتاه‌نوشتی است برای:

.RS 2
.nf
watchgnupg \-\-force $(gpgconf \-\-list\-dirs socketdir)/S.log
.fi
.RE

برای پایش اجرای GnuPG با یک دایرکتوری خانگی متفاوت، از دستور زیر استفاده کنید:

.RS 2
.nf
watchgnupg \-\-homedir DIR
.fi
.RE

.SH "گزینه‌ها (OPTIONS)"
دستور
.B watchgnupg
گزینه‌های زیر را می‌پذیرد:

.TP
.B  \-\-force
فایل سوکت موجود را حذف می‌کند. در صورتی که هیچ نام سوکتی در خط فرمان مشخص نشده باشد، این گزینه به صورت ضمنی استفاده می‌شود.

.TP
.B  \-\-homedir \fIDIR\fP
اگر هیچ نام سوکتی در خط فرمان ارائه نشود، مقدار
.I DIR
را به
.B gpgconf
پاس می‌دهد تا از سوکت مربوط به نمونه GnuPG که با دایرکتوری خانگی
.I DIR
در حال اجراست استفاده شود. توجه داشته باشید که متغیر محیطی
.B GNUPGHOME
توسط
.B watchgnupg
نادیده گرفته می‌شود.

.TP
.B  \-\-tcp \fIn\fP
به‌جای خواندن از یک سوکت محلی، برای اتصالات روی پورت TCP شماره
.I n
گوش می‌دهد. یک سوکت یونیکس را نیز می‌توان به‌صورت اختیاری به عنوان منبع دوم تعیین کرد. این گزینه از نام سوکت پیش‌فرض استفاده نمی‌کند.

.TP
.B  \-\-time\-only
بخش مربوط به تاریخ را در برچسب زمان چاپ نمی‌کند.

.TP
.B  \-\-verbose
خروجی اطلاعاتی بیشتر و همراه با جزئیات را فعال می‌کند.

.TP
.B  \-\-version
نسخه برنامه را چاپ کرده و خارج می‌شود.

.TP
.B  \-\-help
یک صفحه راهنمای خلاصه را نمایش داده و خارج می‌شود.

.P

.SH "مثال‌ها (EXAMPLES)"

.RS 2
.nf
$ watchgnupg \-\-time\-only
.fi
.RE

این فرمان منتظر برقراری اتصال روی سوکت محلی
(مانند \(oq\fI/var/run/user/1234/gnupg/S.log\fP\(cq)
می‌ماند و تمام مدخل‌های لاگ را نمایش می‌دهد. برای کارکرد این قابلیت، باید گزینه
.B log\-file
در تمام ماژول‌هایی که قرار است لاگ آن‌ها نمایش داده شود، استفاده گردد. ورودی پیشنهادی برای فایل‌های پیکربندی عبارت است از:

.RS 2
.nf
log\-file socket://
.fi
.RE

اگر سوکت پیش‌فرض که در بالا آورده شده و با اجرای
.RB "\[dq]echo $(gpgconf \-\-list\-dirs socketdir)/S.log\[dq]"
برگردانده می‌شود مد نظر نباشد، می‌توان یک نام سوکت دلخواه مشخص کرد، برای نمونه
\(oq\fIsocket:///home/foo/bar/mysocket\fP\(cq.
همچنین برای اهداف اشکال‌زدایی امکان لاگ‌برداری از راه دور نیز وجود دارد. در صورت استفاده از این ویژگی دقت کنید، زیرا اطلاعات به صورت رمزگذاری‌نشده و متنی روی شبکه ارسال می‌شود. از این نحو در فایل‌های پیکربندی استفاده کنید:

.RS 2
.nf
log\-file tcp://192.168.1.1:4711
.fi
.RE

می‌توانید از هر پورتی استفاده کنید و فقط محدود به ۴۷۱۱ همان‌طور که در بالا نشان داده شد نیست؛ تنها آدرس‌های IP (نسخه ۴ و نسخه ۶) پشتیبانی می‌شوند و نام میزبان مجاز نیست. باید
.B watchgnupg
را با گزینه
.B tcp
راه‌اندازی کنید. توجه داشته باشید که در ویندوز ورودی رجیستری
\fIHKCU\[rs]Software\[rs]GNU\[rs]GnuPG:DefaultLogFile\fP
می‌تواند برای تغییر خروجی پیش‌فرض لاگ از
.B stderr
به مقدار تعیین‌شده در آن ورودی استفاده شود. با این حال، تنها ورودی کاربردی یک نشانی TCP برای اشکال‌زدایی از راه دور است.

.SH "همچنین ببینید (SEE ALSO)"
.BR gpg (1),
.BR gpgsm (1),
.BR gpg\-agent (1),
.BR scdaemon (1)

مستندات کامل این ابزار در قالب کتابچه راهنمای Texinfo نگهداری می‌شود. اگر GnuPG و برنامه info به درستی روی سیستم شما نصب شده باشند، اجرای دستور

.RS 2
.nf
info gnupg
.fi
.RE

باید دسترسی شما را به راهنمای کامل شامل ساختار منو و فهرست موضوعی فراهم سازد.