.\" -*- 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_SQL_SESSION_ACL 8"
.TH EXT_SQL_SESSION_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_sql_session_acl \- برنامه کمکی جستجوی نشست در پایگاه‌داده SQL برای Squid
.SH "خلاصه دستور (SYNOPSIS)"
.IX Header "خلاصه دستور (SYNOPSIS)"
\&\fBext_sql_session_acl\fR [گزینه‌ها]
.SH "توضیحات (DESCRIPTION)"
.IX Header "توضیحات (DESCRIPTION)"
مجوز دسترسی درخواست‌های HTTP را با استفاده از یک پایگاه‌داده نشست اعتبارسنجی می‌کند.
.PP
این برنامه با دریافت یک توکن هویتی جهت اعتبارسنجی (به صورتی که توسط قالب external_acl_type تعیین شده است)، یک نام کاربری یا برچسب (tag) مرتبط با توکن هویتی ارسال‌شده را بازمی‌گرداند.
.PP
اشکال متداول شناسه‌ها عبارتند از: نشانی IP، نشانی EUI (یا MAC)، گذرواژه‌ها یا توکن‌های UUID.
.PP
این برنامه از قابلیت هم‌روندی در Squid استفاده می‌کند.
.SH "گزینه‌ها (OPTIONS)"
.IX Header "گزینه‌ها (OPTIONS)"
.IP \fB\-\-dsn\fR 12
.IX Item "--dsn"
نام منبع داده پایگاه‌داده (DSN). پیش‌فرض: "DBI:mysql:database=squid".
.IP \fB\-\-user\fR 12
.IX Item "--user"
کاربر پایگاه‌داده.
.IP \fB\-\-password\fR 12
.IX Item "--password"
گذرواژه پایگاه‌داده.
.IP \fB\-\-table\fR 12
.IX Item "--table"
جدول پایگاه‌داده. پیش‌فرض: "passwd".
.IP \fB\-\-uidcol\fR 12
.IX Item "--uidcol"
ستون شناسه یکتای نشست. پیش‌فرض: "id".
.IP \fB\-\-usercol\fR 12
.IX Item "--usercol"
ستون نتیجه external ACL برای user=.
.IP \fB\-\-tagcol\fR 12
.IX Item "--tagcol"
ستون نتیجه external ACL برای tag=.
.IP \fB\-\-cond\fR 12
.IX Item "--cond"
شرط، با مقدار پیش‌فرض enabled=1. برای بدون شرط بودن، مقدار 1 یا "" را مشخص کنید.
.IP \fB\-\-persist\fR 12
.IX Item "--persist"
باز نگه‌داشتن یک اتصال پایدار به پایگاه‌داده بین پرس‌وجوها.
.IP \fB\-\-debug\fR 12
.IX Item "--debug"
نوشتن اطلاعات اشکال‌زدایی در stderr.
.SH "نویسنده (AUTHOR)"
.IX Header "نویسنده (AUTHOR)"
این برنامه و مستندات آن توسط
\fIAmos Jeffries <amosjeffries@squid\-cache.org\fR>
نوشته شده است.
.PP
بر اساس کار اصلی در DB_auth توسط
Henrik Nordstrom <henrik@henriknordstrom.net>
با همکاری
Nishant Sharma <codemarauder@gmail.com>
.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.
\&
\& Copyright (C) 2012 Amos Jeffries <amosjeffries@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
.PP
این برنامه نرم‌افزار آزاد است؛ شما می‌توانید آن را تحت شرایط «مجوز عمومی همگانی گنو» (GNU GPL) نسخه ۲ یا (به انتخاب خود) هر نسخه بالاتر بازتوزیع کنید.
.SH "پرسش‌ها (QUESTIONS)"
.IX Header "پرسش‌ها (QUESTIONS)"
پرسش‌ها درباره استفاده از این برنامه را می‌توانید به
\fIفهرست پستی کاربران Squid <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
پیشنهاد ایده‌ها برای بهبودهای تازه به:
\fIفهرست پستی توسعه‌دهندگان Squid <squid\-dev@lists.squid\-cache.org\fR>
.SH "همچنین ببینید (SEE ALSO)"
.IX Header "همچنین ببینید (SEE ALSO)"
.BR squid (8),
.BR GPL (7),
.PP
ویکی پرسش‌های متداول Squid:
https://wiki.squid\-cache.org/SquidFaq
.PP
راهنمای پیکربندی Squid:
http://www.squid\-cache.org/Doc/config