نام (NAME)

watchgnupg - ابزار مشاهده و ثبت لاگ سوکتهای سیستم GnuPG

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

watchgnupg [--force] [--verbose] socketname

توضیحات (DESCRIPTION)

بیشتر ابزارهای اصلی در صورت پیکربندی مناسب می‌توانند فایل‌های لاگ خود را در یک سوکت یونیکس (Unix Domain socket) بنویسند. watchgnupg یک شنونده ساده برای چنین سوکتی است. این ابزار خروجی را با برچسب زمان (timestamp) آراسته می‌کند و اطمینان حاصل می‌نماید که خطوط طولانی با خروجی‌های لاگ سایر ابزارها تداخل پیدا نکنند. این ابزار برای ویندوز در دسترس نیست.

watchgnupg معمولاً به صورت زیر فراخوانی می‌شود:

watchgnupg

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

watchgnupg --force $(gpgconf --list-dirs socketdir)/S.log

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

watchgnupg --homedir DIR

گزینه‌ها (OPTIONS)

دستور watchgnupg گزینه‌های زیر را می‌پذیرد:

--force: فایل سوکت موجود را حذف می‌کند. در صورتی که هیچ نام سوکتی در خط فرمان مشخص نشده باشد، این گزینه به صورت ضمنی استفاده می‌شود.
--homedir DIR: اگر هیچ نام سوکتی در خط فرمان ارائه نشود، مقدار DIR را به gpgconf پاس می‌دهد تا از سوکت مربوط به نمونه GnuPG که با دایرکتوری خانگی DIR در حال اجراست استفاده شود. توجه داشته باشید که متغیر محیطی GNUPGHOME توسط watchgnupg نادیده گرفته می‌شود.
--tcp n: به‌جای خواندن از یک سوکت محلی، برای اتصالات روی پورت TCP شماره n گوش می‌دهد. یک سوکت یونیکس را نیز می‌توان به‌صورت اختیاری به عنوان منبع دوم تعیین کرد. این گزینه از نام سوکت پیش‌فرض استفاده نمی‌کند.
--time-only: بخش مربوط به تاریخ را در برچسب زمان چاپ نمی‌کند.
--verbose: خروجی اطلاعاتی بیشتر و همراه با جزئیات را فعال می‌کند.
--version: نسخه برنامه را چاپ کرده و خارج می‌شود.
--help: یک صفحه راهنمای خلاصه را نمایش داده و خارج می‌شود.

مثال‌ها (EXAMPLES)

$ watchgnupg --time-only

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

log-file socket://

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

log-file tcp://192.168.1.1:4711

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

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

gpg(1), gpgsm(1), gpg-agent(1), scdaemon(1)

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

info gnupg

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