.\" -*- 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 "EXT_DELAYER_ACL 8"
.TH EXT_DELAYER_ACL 8 2026-08-25 "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)"
ext_delayer_acl \- برنامه کمکی ACL خارجی Squid برای افزودن تاخیر مصنوعی به درخواست‌ها
.SH "خلاصه دستور (SYNOPSIS)"
.IX Header "SYNOPSIS"
.B delayer
[\fB\-\-help\fR] [\fB\-\-debug\fR] [\fB\-\-log\fR \fIfile\fR] [\fB\-\-wait\fR \fImsec\fR]
.SH "توضیحات (DESCRIPTION)"
.IX Header "DESCRIPTION"
برنامه کمکی ACL خارجی Squid؛ باعث می‌شود که Squid در پاسخ‌دهی به درخواست‌های HTTP تاخیر ایجاد کند.
.PP
با طراحی و تنظیم دقیق ACLها در پیکربندی Squid، می‌توان به صورت انتخابی روی درخواست‌های دریافت‌شده توسط پروکسی تاخیر اعمال کرد. پس از سپری شدن مدت زمان پیکربندی‌شده، این برنامه همیشه مقدار "true" را برمی‌گرداند.
.SH "گزینه‌ها (OPTIONS)"
.IX Header "OPTIONS"
.IP "\fB\-\-help\fR یا \fB\-h\fR" 12
.IX Item "--help or -h"
چاپ پیام راهنما در خروجی استاندارد
.IP "\fB\-\-debug\fR یا \fB\-d\fR" 12
.IX Item "--debug or -d"
ارسال خروجی اشکال‌زدایی به STDERR و در نهایت به cache.log
.IP "\fB\-\-log /path/to/file\fR یا \fB\-l /path/to/file\fR" 12
.IX Item "--log /path/to/file or -l /path/to/file"
ارسال خروجی اشکال‌زدایی به فایل مشخص‌شده به‌جای STDERR؛ همچنین حالت اشکال‌زدایی را فعال می‌کند.
.IP "\fB\-\-wait msec\fR یا \fB\-w msec\fR" 12
.IX Item "--wait msec or -w msec"
ایجاد تاخیر در هر درخواست به میزان میلی‌ثانیه مشخص‌شده.
در صورتی که این گزینه مشخص نشود، به‌طور پیش‌فرض هر درخواست ثبت‌شده به مدت نیم ثانیه (۵۰۰ میلی‌ثانیه) با تاخیر مواجه خواهد شد.
.SH "پیکربندی (CONFIGURATION)"
.IX Header "CONFIGURATION"
برای به‌کارگیری آن، می‌توان از این قطعه پیکربندی الگو در squid.conf استفاده کرد:
.PP
.Vb 3
\& external_acl_type delayer concurrency=100000 children\-max=2 children\-startup=1 children\-idle=1 cache=10 %URI /path/to/delayer \-w 200
\& acl delay external delayer
\& http_access allow acl1 acl2 acl3 delay !all
.Ve
.PP
بسیار مهم است که عبارت مربوط به ACL متصل به delayer، بند یکی مانده به آخر در خط http_access باشد. این کار باعث اعمال تاخیر روی تمامی درخواست‌هایی می‌شود که با همه ACLهای قبلی در آن خط مطابقت دارند. عبارت !all در انتهای خط سبب می‌شود که هیچ ترافیکی توسط این ACL مجاز نشود؛ در واقع تنها ارزیابی بند delay موجب تاخیر شده و سپس خطوط بعدی http_access ارزیابی خواهند شد.
همچنین قرار دادن دقیق خط http_access در توالی خطوط http_access_lines اهمیت دارد؛ این خط باید نزدیک به ابتدا باشد، اما مراقب باشید ACLهای کند ناخواسته (به‌ویژه proxy_auth) را پیش از آن وارد نکنید.
.PP
می‌توان نحوه محاسبه تاخیر برای هر درخواست را با ویرایش تابع پرل "calc_delay" در اسکریپت سفارشی کرد؛ مستندات مربوط به این موضوع در توضیحات (کامنت‌های) کد منبع گنجانده شده است.
.SH "نویسنده (AUTHOR)"
.IX Header "AUTHOR"
این نرم‌افزار توسط Francesco Chemolli <kinkie@squid\-cache.org> نوشته شده است.
.SH "حق نشر (COPYRIGHT)"
.IX Header "COPYRIGHT"
.Vb 5
\& * Copyright (C) 1996\-2026 The Squid Software Foundation and contributors
\& *
\& * Squid software is distributed under GPLv2+ license and includes
\& * contributions from numerous individuals and organizations.
\& * Please see the COPYING and CONTRIBUTORS files for details.
\&
\& (C) 2014 Francesco Chemolli <kinkie@squid\-cache.org>
\&
\& This program is free software. You may redistribute copies of it under the
\& terms of the GNU General Public License version 2, or (at your opinion) any
\& later version.
.Ve
.SH "پرسش‌ها (QUESTIONS)"
.IX Header "QUESTIONS"
پرسش‌ها درباره نحوه استفاده از این برنامه را می‌توانید به فهرست ایمیل کاربران Squid ارسال کنید:
\fISquid Users mailing list <squid\-users@lists.squid\-cache.org\fR>
.SH "گزارش باگ‌ها (REPORTING BUGS)"
.IX Header "REPORTING BUGS"
گزارش‌های باگ باید به زبان انگلیسی ارسال شوند.
برای اطلاع از جزئیات مواردی که باید در گزارش باگ خود بگنجانید، به پیوند زیر مراجعه کنید:
https://wiki.squid\-cache.org/SquidFaq/BugReporting
.PP
گزارش اشکالات یا اصلاحات باگ را از طریق پیوند زیر ارسال کنید:
https://bugs.squid\-cache.org
.PP
اشکالات امنیتی مهم را به آدرس زیر گزارش دهید:
\fISquid Bugs <squid\-bugs@lists.squid\-cache.org\fR>
.PP
ایده‌ها و پیشنهادات برای بهبودهای جدید را به فهرست ایمیل توسعه‌دهندگان Squid ارسال نمایید:
\fISquid Developers mailing list <squid\-dev@lists.squid\-cache.org\fR>
.SH "همچنین ببینید (SEE ALSO)"
.IX Header "SEE ALSO"
squid (8), GPL (7),
.PP
ویکی پرسش‌های متداول Squid:
https://wiki.squid\-cache.org/SquidFaq
.PP
راهنمای پیکربندی Squid:
http://www.squid\-cache.org/Doc/config