.\" -*- mode: troff; coding: utf-8 -*-
.\" Automatically generated by Pod::Man v6.0.2 (Pod::Simple 3.45)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
.ie n \{\
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{\
.    if \nF \{\
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{\
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\"
.\" Required to disable full justification in groff 1.23.0.
.if n .ds AD l
.\" ========================================================================
.\"
.IX Title "PRIVOXY-LOG-PARSER 1"
.TH PRIVOXY-LOG-PARSER 1 2026-04-09 "perl v5.42.2" "User Contributed Perl Documentation"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH "نام (NAME)"
privoxy\-log\-parser \- یک تجزیه‌گر و برجسته‌ساز نحو برای پیام‌های لاگ Privoxy
.SH "خلاصه دستور (SYNOPSIS)"
.IX Header "SYNOPSIS"
\&\fBprivoxy\-log\-parser\fR [\fB\-\-detect\-inactivity\fR] [\fB\-\-inactivity\-threshold msecs\fR]
[\fB\-\-html\-output\fR]
[\fB\-\-no\-msecs\fR] [\fB\-\-no\-syntax\-higlighting\fR] [\fB\-\-statistics\fR]
[\fB\-\-shorten\-thread\-ids\fR] [\fB\-\-show\-ineffective\-filters\fR]
[\fB\-\-url\-statistics\-threshold\fR] [\fB\-\-version\fR]
.SH "توضیحات (DESCRIPTION)"
.IX Header "DESCRIPTION"
دستور \&\fBprivoxy\-log\-parser\fR پیام‌های لاگ Privoxy را می‌خواند و:
.PP
\&\- خطوط شناخته‌شده را برجسته‌سازی نحوی می‌کند،
.PP
\&\- برخی از آن‌ها را برای درک آسان‌تر قالب‌بندی مجدد می‌کند،
.PP
\&\- پیام‌های با فایده کمتر را فیلتر می‌کند، و
.PP
\&\- (در برخی موارد) اطلاعات اضافی، مانند نسبت فشرده‌سازی یا نحوه تأثیر یک فیلتر بر اندازه محتوا را محاسبه می‌کند.
.PP
با \fBprivoxy\-log\-parser\fR باید بتوانید سطح لاگ Privoxy را بدون سردرگمی ناشی از حجم بالای خروجی افزایش دهید. به عنوان مثال برای "debug 64"، دستور \fBprivoxy\-log\-parser\fR (به‌طور پیش‌فرض) فقط پیام‌هایی را نشان می‌دهد که بر محتوا تأثیر می‌گذارند. اگر فیلتری به هیچ تطابقی منجر نشود، \fBprivoxy\-log\-parser\fR پیام "filter foo caused 0 hits" را پنهان می‌کند.
.SH "گزینه‌ها (OPTIONS)"
.IX Header "OPTIONS"
[\fB\-\-detect\-inactivity\fR] به‌جای برجسته‌سازی نحوی، دوره‌های عدم فعالیت لاگ را که بیش از مقدار میلی‌ثانیه‌های مشخص‌شده با گزینه \fB\-\-inactivity\-threshold\fR است تشخیص می‌دهد. عمدتاً برای اشکال‌زدایی مفید است.
.PP
[\fB\-\-host\-statistics\-threshold\fR] فقط در صورتی تعداد درخواست‌های یک میزبان را نشان می‌دهد که بیشتر یا مساوی آستانه داده‌شده باشد. اگر آستانه 0 باشد، آمار میزبان غیرفعال می‌شود.
.PP
[\fB\-\-html\-output\fR] هنگام برجسته‌سازی نحوی از HTML و CSS استفاده می‌کند. اگر این گزینه حذف شود، از توالی‌های گریز ANSI استفاده می‌شود مگر اینکه \fB\-\-no\-syntax\-highlighting\fR فعال باشد. این گزینه فقط برای آسان‌تر کردن قرار دادن بخش‌هایی از لاگ در صفحات وب در نظر گرفته شده است. این گزینه هیچ ورودی‌ای را escape نمی‌کند!
.PP
[\fB\-\-inactivity\-threshold msecs\fR] تعداد میلی‌ثانیه‌های بین پیام‌های لاگ را مشخص می‌کند تا هنگام اجرا در حالت [\fB\-\-detect\-inactivity\fR] به عنوان دوره عدم فعالیت در نظر گرفته شود.
.PP
[\fB\-\-keep\-date\fR] تاریخ را هنگام چاپ پیام‌های لاگِ برجسته‌شده حذف نمی‌کند. هنگام تجزیه هم‌زمان چندین فایل لاگ مفید است.
.PP
[\fB\-\-no\-msecs\fR] تفکیک‌پذیری میلی‌ثانیه‌ای را انتظار ندارد.
.PP
[\fB\-\-no\-syntax\-highlighting\fR] برجسته‌سازی نحوی را غیرفعال می‌کند. زمانی مفید است که خروجی فیلترشده از طریق لوله به less فرستاده می‌شود و در این حالت کدهای کنترلی ANSI کار نمی‌کنند، یا زمانی که خود ترمینال از این کدهای کنترلی پشتیبانی نمی‌کند.
.PP
[\fB\-\-passed\-request\-statistics\-threshold\fR] تعداد درخواست‌ها را برای درخواست‌های عبور داده‌شده تنها در صورتی نشان می‌دهد که بیشتر یا مساوی آستانه داده‌شده باشد. اگر آستانه 0 باشد، آمار درخواست‌های عبور داده‌شده غیرفعال می‌شود.
.PP
[\fB\-\-shorten\-thread\-ids\fR] شناسه‌های thread را به یک عدد ده‌دهی سه‌رقمی کوتاه می‌کند. توجه داشته باشید که نگاشت شناسه‌های thread به شناسه‌های کوتاه‌شده در زمان اجرا ایجاد می‌شود و بنابراین با توجه به ورودی تغییر می‌کند.
.PP
[\fB\-\-show\-ineffective\-filters\fR] خطوط لاگ مربوط به فیلترهایی را که محتوا را تغییر نداده‌اند پنهان نمی‌کند.
.PP
[\fB\-\-show\-complete\-request\-distribution\fR] توزیع کامل درخواست‌های کلاینت را در خروجی \fB\-\-statistics\fR نشان می‌دهد. بدون این گزینه فقط ده مورد از رایج‌ترین مقادیر نمایش داده می‌شوند.
.PP
[\fB\-\-statistics\fR] به‌جای برجسته‌سازی نحوی پیام‌های لاگ، آمارهای مختلفی را جمع‌آوری می‌کند. این یک ویژگی آزمایشی است؛ اگر نتایج نادرست به نظر برسند، احتمالاً واقعاً چنین است. همچنین توجه داشته باشید که اگر Privoxy و Privoxy\-Log\-Parser با یکدیگر هماهنگ نباشند، نتایج تقریباً به‌طور قطع نادرست خواهند بود.
.PP
[\fB\-\-strict\-checks\fR] هنگام تولید آمار، داده‌های ورودی را با دقت بیشتری بررسی کرده و در صورت غیرمنتظره بودن داده‌ها، حتی اگر بر نتایج بی‌تأثیر باشد، عملیات را متوقف می‌کند. این گزینه سرعت تجزیه را به‌طور چشمگیری کاهش می‌دهد و انتظار نمی‌رود مشکلات بااهمیتی را شناسایی کند.
هنگام برجسته‌سازی، در صورت وجود پیام‌های ناشناخته‌ای که نمی‌توان آن‌ها را به‌درستی برجسته کرد، هشدار چاپ می‌کند.
.PP
[\fB\-\-unbreak\-lines\-only\fR] تلاش می‌کند خطوطی را که به دلیل یک کلاینت ایمیل معیوب یا پیکربندی عجیب خراب شده و در نتیجه دیگر به‌درستی تشخیص داده نمی‌شوند، اصلاح کند. تنها برخی از خرابی‌ها را رفع می‌کند، اما ممکن است به اندازه کافی خوب یا حداقل بهتر از هیچ باشد. کار دیگری انجام نمی‌دهد، بنابراین احتمالاً می‌خواهید دوباره خروجی را به \&\fBprivoxy\-log\-parser\fR بفرستید.
.PP
[\fB\-\-url\-statistics\-threshold\fR] تعداد درخواست‌های یک منبع را تنها در صورتی نشان می‌دهد که بیشتر یا مساوی آستانه داده‌شده باشد. اگر آستانه 0 باشد، آمار URL غیرفعال می‌شود.
.PP
[\fB\-\-version\fR] نسخه را چاپ کرده و خارج می‌شود.
.SH "مثال‌ها (EXAMPLES)"
.IX Header "EXAMPLES"
برای پایش یک فایل لاگ:
.PP
tail \-F /usr/jails/privoxy\-jail/var/log/privoxy/privoxy.log | \fBprivoxy\-log\-parser\fR
.PP
اگر پیاده‌سازی tail شما فاقد پشتیبانی از \*(Aq\-F\*(Aq است یا اگر لاگ به هر حال چرخش (rotate) نمی‌شود، \*(Aq\-f\*(Aq را جایگزین \*(Aq\-F\*(Aq کنید. مکان فایل لاگ به سیستم شما بستگی دارد!
.PP
برای پایش Privoxy بدون نیاز به نوشتن آن در یک فایل لاگ:
.PP
privoxy \-\-no\-daemon /usr/jails/privoxy\-jail/usr/local/etc/privoxy/config 2>&1 | \fBprivoxy\-log\-parser\fR
.PP
مجدداً، مکان فایل پیکربندی به سیستم شما بستگی دارد. تغییر مسیر خروجی به شل شما وابسته است؛ دستور بالا با شل‌های مبتنی بر bourne کار می‌کند.
.PP
برای خواندن یک فایل لاگ پردازش‌شده Privoxy از ابتدا تا انتها، با سرعتی کمی بیشتر از آنچه بتوانید بخوانید:
.PP
\&\fBprivoxy\-log\-parser\fR < /usr/jails/privoxy\-jail/var/log/privoxy/privoxy.log
.PP
این دستور احتمالاً فقط برای پر کردن نمایشگرها در پس‌زمینه فیلم‌های هکری مفید است.
.SH "هشدارها (CAVEATS)"
.IX Header "CAVEATS"
برجسته‌سازی نحوی با توالی‌های گریز ANSI در صورتی که رنگ پس‌زمینه شما سیاه نباشد عجیب به نظر خواهد رسید.
.PP
برخی پیام‌ها هنوز شناسایی نشده‌اند و به‌طور کامل برجسته نخواهند شد.
.PP
دستور \&\fBprivoxy\-log\-parser\fR با در نظر گرفتن Privoxy 3.0.7 یا بالاتر توسعه یافته است؛ استفاده از نسخه‌های قدیمی‌تر Privoxy احتمالاً منجر به افزایش خطوط لاگ ناشناخته خواهد شد.
.PP
فایل‌های لاگ Privoxy معمولاً حجیم هستند. اگر از برجسته‌سازی HTML استفاده کنید، برخی از مرورگرها نمی‌توانند آن‌ها را مدیریت کنند، دچار اختلال شده و در نهایت به دلیل خطاهای segmentation fault یا استثناهای غیرمنتظره کرش می‌کنند. این مشکل از جانب مرورگر است و خطای \fBprivoxy\-log\-parser\fR نیست.
.SH "گزارش باگ‌ها (BUGS)"
.IX Header "BUGS"
هنوز بسیاری از تنظیمات را نمی‌توان از طریق گزینه‌های خط فرمان کنترل کرد.
.SH "همچنین ببینید (SEE ALSO)"
.IX Header "SEE ALSO"
\&\fBprivoxy\fR\|(8)
.SH "نویسندگان (AUTHORS)"
.IX Header "AUTHOR"
Fabian Keil <fk@fabiankeil.de>