.\" XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
.\" DO NOT EDIT! Generated from XML source.
.\" XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
.de Sh \" Subsection
.br
.if t .Sp
.ne 5
.PP
\fB\\$1\fR
.PP
..
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Ip \" List item
.br
.ie \\n(.$>=3 .ne \\$3
.el .ne 3
.IP "\\$1" \\$2
..
.TH "HTCACHECLEAN" 8 "2026-05-08" "Apache HTTP Server" "htcacheclean"

.SH "نام (NAME)"
htcacheclean \- پاک‌سازی و مدیریت حافظه نهان دیسک سرور آپاچی

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

.PP
\fB\fBhtcacheclean\fR [ -\fBD\fR ] [ -\fBv\fR ] [ -\fBt\fR ] [ -\fBr\fR ] [ -\fBn\fR ] [ -\fBR\fR\fIround\fR ] -\fBp\fR\fIpath\fR [ -\fBl\fR\fIlimit\fR ] [ -\fBL\fR\fIlimit\fR ]\fR

.PP
\fB\fBhtcacheclean\fR [ -\fBn\fR ] [ -\fBt\fR ] [ -\fBi\fR ] [ -\fBP\fR\fIpidfile\fR ] [ -\fBR\fR\fIround\fR ] -\fBd\fR\fIinterval\fR -\fBp\fR\fIpath\fR [ -\fBl\fR\fIlimit\fR ] [ -\fBL\fR\fIlimit\fR ]\fR

.PP
\fB\fBhtcacheclean\fR [ -\fBv\fR ] [ -\fBR\fR\fIround\fR ] -\fBp\fR\fIpath\fR [ -\fBa\fR ] [ -\fBA\fR ]\fR

.PP
\fB\fBhtcacheclean\fR [ -\fBD\fR ] [ -\fBv\fR ] [ -\fBt\fR ] [ -\fBR\fR\fIround\fR ] -\fBp\fR\fIpath\fR \fIurl\fR\fR


.SH "توضیحات (DESCRIPTION)"

.PP
دستور \fBhtcacheclean\fR برای نگه‌داشتن اندازه فضای ذخیره‌سازی mod_cache_disk در یک محدوده اندازه مشخص، یا محدودیت تعداد inodeهای در حال استفاده به کار می‌رود\&. این ابزار می‌تواند به صورت دستی یا در حالت دیمن (daemon) اجرا شود\&. هنگام اجرا در حالت دیمن، در پس‌زمینه به حالت خواب می‌رود و دایرکتوری حافظه نهان را در فواصل زمانی منظم برای حذف محتوای ذخیره‌شده بررسی می‌کند\&. می‌توانید دیمن را با ارسال سیگنال TERM یا INT به‌طور تمیز متوقف کنید\&. هنگام اجرای دستی، بررسی یک‌باره دایرکتوری حافظه نهان برای حذف محتوای ذخیره‌شده انجام می‌شود\&. اگر یک یا چند URL مشخص شود، در صورت وجود، هر URL از حافظه نهان حذف خواهد شد\&.


.SH "گزینه‌ها (OPTIONS)"


.TP
\fB-d\fIinterval\fR\fR
تبدیل شدن به دیمن و تکرار پاک‌سازی حافظه نهان در هر \fIinterval\fR دقیقه\&. این گزینه با گزینه‌های \fB-D\fR، \fB-v\fR و \fB-r\fR ناسازگار است\&. برای خاموش کردن تمیز دیمن، کافی است سیگنال \fBSIGTERM\fR یا \fBSIGINT\fR به آن ارسال کنید\&.
.TP
\fB-D\fR
اجرای آزمایشی (dry run) بدون حذف هیچ موردی\&. این گزینه با گزینه \fB-d\fR ناسازگار است\&. هنگام اجرای آزمایشی و حذف دایرکتوری‌ها با \fB-t\fR، تعداد inodeهای گزارش‌شده به عنوان حذف‌شده در آمار نمی‌تواند دایرکتوری‌های حذف‌شده را در نظر بگیرد و به عنوان یک برآورد تخمینی علامت‌گذاری خواهد شد\&.
.TP
\fB-v\fR
حالت پرگو (verbose) و چاپ آمار\&. این گزینه با گزینه \fB-d\fR ناسازگار است\&.
.TP
\fB-r\fR
پاک‌سازی کامل و دقیق\&. این گزینه فرض می‌کند که وب‌سرور آپاچی در حال اجرا نیست (در غیر این صورت ممکن است داده‌های بلااستفاده در حافظه نهان باقی بماند)\&. این گزینه با گزینه \fB-d\fR ناسازگار است و گزینه \fB-t\fR را نیز اعمال می‌کند\&.
.TP
\fB-n\fR
رفتار ملایم (nice)\&. این گزینه باعث پردازش کندتر به نفع سایر فرآیندها می‌شود\&. ابزار \fBhtcacheclean\fR گاه‌به‌گاه به خواب می‌رود تا (الف) ورودی/خروجی (IO) دیسک به تأخیر بیفتد و (ب) هسته بتواند در این فاصله زمانی سایر فرآیندها را زمان‌بندی کند\&.
.TP
\fB-t\fR
حذف تمام دایرکتوری‌های خالی\&. به طور پیش‌فرض فقط پرونده‌های حافظه نهان حذف می‌شوند، با این حال در برخی پیکربندی‌ها، تعداد زیاد دایرکتوری‌های ایجاد شده ممکن است نیاز به رسیدگی داشته باشد\&. اگر پیکربندی شما به تعداد بسیار زیادی دایرکتوری نیاز دارد، تا حدی که اتمام inode یا جدول تخصیص فایل ممکن است به یک مشکل تبدیل شود، استفاده از این گزینه توصیه می‌شود\&.
.TP
\fB-p\fIpath\fR\fR
تعیین \fIpath\fR به عنوان دایرکتوری ریشه حافظه نهان دیسک\&. این مقدار باید همان مقداری باشد که با دستورالعمل CacheRoot مشخص شده است\&.
.TP
\fB-P\fIpidfile\fR\fR
تعیین \fIpidfile\fR به عنوان نام پرونده‌ای که شناسه فرآیند (PID) هنگام تبدیل به دیمن در آن نوشته می‌شود\&.
.TP
\fB-R\fIround\fR\fR
تعیین \fIround\fR به عنوان مقداری برای گرد کردن اندازه‌ها به بالا، جهت جبران اندازه بلوک‌های دیسک\&. مقدار آن را برابر با اندازه بلوک پارتیشن حافظه نهان تنظیم کنید\&.
.TP
\fB-l\fIlimit\fR\fR
تعیین \fIlimit\fR به عنوان حد کل اندازه حافظه نهان دیسک\&. مقدار به طور پیش‌فرض بر حسب بایت بیان می‌شود (یا با افزودن \fBB\fR به عدد)\&. برای کیلوبایت از \fBK\fR، برای مگابایت از \fBM\fR یا برای گیگابایت از \fBG\fR استفاده کنید\&.
.TP
\fB-L\fIlimit\fR\fR
تعیین \fIlimit\fR به عنوان حد کل inodeهای حافظه نهان دیسک\&. پسوندهای \fBK\fR، \fBM\fR یا \fBG\fR نیز قابل استفاده هستند\&.
.TP
\fB-i\fR
اجرای هوشمند و تنها در زمانی که تغییری در حافظه نهان دیسک ایجاد شده باشد\&. این گزینه فقط همراه با گزینه \fB-d\fR امکان‌پذیر است\&.
.TP
\fB-a\fR
فهرست کردن آدرس‌های URL که در حال حاضر در حافظه نهان ذخیره شده‌اند\&. گونه‌های مختلف یک URL یک بار برای هر گونه فهرست می‌شوند\&.
.TP
\fB-A\fR
فهرست کردن آدرس‌های URL که در حال حاضر در حافظه نهان ذخیره شده‌اند، به همراه ویژگی‌های آن‌ها به ترتیب زیر: url، اندازه هدر، اندازه بدنه، وضعیت (status)، نسخه موجودیت (entity version)، تاریخ، انقضا، زمان درخواست، زمان پاسخ، وجود بدنه، درخواست head\&.

.SH "حذف یک URL مشخص (DELETING A SPECIFIC URL)"

.PP
اگر یک یا چند URL به \fBhtcacheclean\fR داده شود، هر URL از حافظه نهان حذف خواهد شد\&. اگر چندین گونه از یک URL وجود داشته باشد، تمام گونه‌ها حذف خواهند شد\&.

.PP
هنگامی که یک URL در پراکسی معکوس (reverse proxy) باید حذف شود، URL مؤثر از هدر \fBHost\fR، درگاه \fBport\fR، مسیر \fBpath\fR و پرسمان \fBquery\fR ساخته می‌شود\&. توجه داشته باشید که علامت '?' در URL باید همیشه صریحاً مشخص شود، چه رشته پرسمان وجود داشته باشد چه نباشد\&. برای نمونه، در تلاش برای حذف مسیر \fB/\fR از سرور \fBlocalhost\fR، آدرس URL مورد نظر برای حذف \fBhttp://localhost:80/?\fR خواهد بود\&.

.SH "فهرست کردن آدرس‌های URL در حافظه نهان (LISTING URLS IN THE CACHE)"

.PP
با دادن گزینه‌های \fB-a\fR یا \fB-A\fR به \fBhtcacheclean\fR، آدرس‌های URL موجود در حافظه نهان به محض پیدا شدن، هر URL در یک خط فهرست می‌شوند\&. گزینه \fB-A\fR مدخل کامل حافظه نهان را پس از URL، با فیلدهایی به ترتیب زیر نمایش می‌دهد:


.TP
url
آدرس URL مدخل\&.
.TP
header size
اندازه هدر بر حسب بایت\&.
.TP
body size
اندازه بدنه بر حسب بایت\&.
.TP
status
وضعیت پاسخ ذخیره‌شده در حافظه نهان\&.
.TP
entity version
تعداد دفعاتی که این مدخل بدون حذف شدن، دوباره اعتبارسنجی شده است\&.
.TP
date
تاریخ پاسخ\&.
.TP
expiry
تاریخ انقضای پاسخ\&.
.TP
request time
زمان آغاز درخواست\&.
.TP
response time
زمان پایان درخواست\&.
.TP
body present
اگر 0 باشد، هیچ بدنه‌ای با این درخواست ذخیره نشده است؛ در غیر این صورت 1\&.
.TP
head request
اگر 1 باشد، مدخل شامل یک درخواست ذخیره‌شده HEAD بدون بدنه است؛ در غیر این صورت 0\&.

.SH "کد خروج (EXIT STATUS)"

.PP
دستور \fBhtcacheclean\fR در صورت موفقیت‌آمیز بودن تمام عملیات‌ها وضعیت صفر ("true") و در غیر این صورت \fB1\fR را برمی‌گرداند\&. اگر یک URL مشخص شده باشد و در حافظه نهان ذخیره شده و با موفقیت حذف شود، مقدار \fB0\fR و در غیر این صورت \fB2\fR برگردانده می‌شود\&. اگر در هنگام حذف URL خطایی رخ دهد، مقدار \fB1\fR برگردانده خواهد شد\&.

.SH "پرونده‌ها (FILES)"

.PP
دایرکتوری ریشه حافظه نهان به عنوان یک آرگومان در خط فرمان مشخص می‌شود و باید با دستورالعمل \fBCacheRoot\fR در پیکربندی سرور مطابقت داشته باشد\&.


.TP
\fIpath\fR
دایرکتوری ریشه حافظه نهان دیسک برای پاک‌سازی\&.