.\" -*- 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 "STOREID_FILE_REWRITE 8"
.TH STOREID_FILE_REWRITE 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)"
storeid_file_rewrite \- ابزار کمکی مبتنی بر پرونده بازنویسی Store\-ID برای اسکوئید (Squid)
.SH "خلاصه دستور (SYNOPSIS)"
.IX Header "SYNOPSIS"
.B storeid_file_rewrite
.I filepath
.SH "توضیحات (DESCRIPTION)"
.IX Header "DESCRIPTION"
این برنامه به عنوان یک ابزار کمکی store_id عمل می‌کند و نشانی‌های وب (URL) ارائه‌شده توسط اسکوئید (Squid) را به شناسه‌های ذخیره‌سازی (storage\-ids) بازنویسی می‌کند؛ این شناسه‌ها می‌توانند برای دستیابی به ذخیره‌سازی بهتر در حافظه نهان (caching) برای وب‌سایت‌هایی که از URLهای متفاوتی برای محتوای یکسان استفاده می‌کنند، به کار روند.
.PP
این برنامه یک پرونده متنی حاوی دو ستون جداشده با تب (tab) را دریافت می‌کند:
.PP
ستون ۱: عبارت منظم (Regex) برای تطبیق در برابر URL
.PP
ستون ۲: قانون بازنویسی برای تولید یک Store\-ID
.PP
به‌عنوان مثال:
.PP
.nf
^http:\e/\e/[^\e.]+\e.dl\e.sourceforge\e.net\e/(.*)    http://dl.sourceforge.net.squid.internal/$1
.fi
.PP
قوانین بازنویسی به همان ترتیبی که در پرونده قوانین ظاهر می‌شوند تطبیق داده می‌شوند؛ بنابراین برای بهترین کارایی، آن‌ها را بر اساس فراوانی وقوع مرتب کنید.
.PP
این برنامه به‌طور خودکار وجود شناسه کانال همزمانی (concurrency channel\-ID) را تشخیص داده و رفتار خود را به‌طور مناسب تنظیم می‌کند. این برنامه می‌تواند با هر مقداری برابر ۰ یا بالاتر برای پارامتر store_id_children concurrency= استفاده شود.
.SH "گزینه‌ها (OPTIONS)"
.IX Header "OPTIONS"
تنها پارامتر خط فرمانی که این ابزار کمکی دریافت می‌کند، نام پرونده قوانین عبارت منظم است.
.SH "نویسنده (AUTHOR)"
.IX Header "AUTHOR"
این برنامه و مستندات آن توسط \fIAlan Mizrahi <alan@mizrahi.com.ve\fR> نوشته شده است.
.PP
بر اساس کارهای پیشین توسط \fIEliezer Croitoru <eliezer@ngtech.co.il\fR>.
.SH "حق نشر (COPYRIGHT)"
.IX Header "COPYRIGHT"
.Vb 5
\& * Copyright (C) 1996\-2026 The Squid Software Foundation and contributors
\& *
\& * نرم‌افزار اسکوئید تحت مجوز +GPLv2 توزیع می‌شود و شامل
\& * مشارکت‌های افراد و سازمان‌های متعددی است.
\& * لطفاً برای جزئیات پرونده‌های COPYING و CONTRIBUTORS را ببینید.
\&
\& Copyright (C) 2013 Alan Mizrahi <alan@mizrahi.com.ve>
\& Based on code from Eliezer Croitoru <eliezer@ngtech.co.il>
\&
\& This program is free software; you can redistribute it and/or modify
\& it under the terms of the GNU General Public License as published by
\& the Free Software Foundation; either version 2 of the License, or
\& (at your option) any later version.
\&
\& This program is distributed in the hope that it will be useful,
\& but WITHOUT ANY WARRANTY; without even the implied warranty of
\& MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
\& GNU General Public License for more details.
\&
\& You should have received a copy of the GNU General Public License
\& along with this program; if not, write to the Free Software
\& Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111\-1307, USA.
.Ve
.SH "پرسش‌ها (QUESTIONS)"
.IX Header "QUESTIONS"
پرسش‌ها درباره نحوه استفاده از این برنامه را می‌توانید به \fIفهرست پستی کاربران اسکوئید <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\-dev@lists.squid\-cache.org\fR>
.SH "همچنین ببینید (SEE ALSO)"
.IX Header "SEE ALSO"
squid (8), GPL (7),
.PP
ویکی اسکوئید: https://wiki.squid\-cache.org/Features/StoreID
.PP
راهنمای پیکربندی اسکوئید: http://www.squid\-cache.org/Doc/config