نام (NAME)

htcacheclean - پاک‌سازی و مدیریت حافظه نهان دیسک سرور آپاچی

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

htcacheclean [ -D ] [ -v ] [ -t ] [ -r ] [ -n ] [ -Rround ] -ppath [ -llimit ] [ -Llimit ]

htcacheclean [ -n ] [ -t ] [ -i ] [ -Ppidfile ] [ -Rround ] -dinterval -ppath [ -llimit ] [ -Llimit ]

htcacheclean [ -v ] [ -Rround ] -ppath [ -a ] [ -A ]

htcacheclean [ -D ] [ -v ] [ -t ] [ -Rround ] -ppath url

توضیحات (DESCRIPTION)

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

گزینه‌ها (OPTIONS)

-dinterval: تبدیل شدن به دیمن و تکرار پاک‌سازی حافظه نهان در هر interval دقیقه. این گزینه با گزینه‌های -D، -v و -r ناسازگار است. برای خاموش کردن تمیز دیمن، کافی است سیگنال SIGTERM یا SIGINT به آن ارسال کنید.
-D: اجرای آزمایشی (dry run) بدون حذف هیچ موردی. این گزینه با گزینه -d ناسازگار است. هنگام اجرای آزمایشی و حذف دایرکتوری‌ها با -t، تعداد inodeهای گزارش‌شده به عنوان حذف‌شده در آمار نمی‌تواند دایرکتوری‌های حذف‌شده را در نظر بگیرد و به عنوان یک برآورد تخمینی علامت‌گذاری خواهد شد.
-v: حالت پرگو (verbose) و چاپ آمار. این گزینه با گزینه -d ناسازگار است.
-r: پاک‌سازی کامل و دقیق. این گزینه فرض می‌کند که وب‌سرور آپاچی در حال اجرا نیست (در غیر این صورت ممکن است داده‌های بلااستفاده در حافظه نهان باقی بماند). این گزینه با گزینه -d ناسازگار است و گزینه -t را نیز اعمال می‌کند.
-n: رفتار ملایم (nice). این گزینه باعث پردازش کندتر به نفع سایر فرآیندها می‌شود. ابزار htcacheclean گاه‌به‌گاه به خواب می‌رود تا (الف) ورودی/خروجی (IO) دیسک به تأخیر بیفتد و (ب) هسته بتواند در این فاصله زمانی سایر فرآیندها را زمان‌بندی کند.
-t: حذف تمام دایرکتوری‌های خالی. به طور پیش‌فرض فقط پرونده‌های حافظه نهان حذف می‌شوند، با این حال در برخی پیکربندی‌ها، تعداد زیاد دایرکتوری‌های ایجاد شده ممکن است نیاز به رسیدگی داشته باشد. اگر پیکربندی شما به تعداد بسیار زیادی دایرکتوری نیاز دارد، تا حدی که اتمام inode یا جدول تخصیص فایل ممکن است به یک مشکل تبدیل شود، استفاده از این گزینه توصیه می‌شود.
-ppath: تعیین path به عنوان دایرکتوری ریشه حافظه نهان دیسک. این مقدار باید همان مقداری باشد که با دستورالعمل CacheRoot مشخص شده است.
-Ppidfile: تعیین pidfile به عنوان نام پرونده‌ای که شناسه فرآیند (PID) هنگام تبدیل به دیمن در آن نوشته می‌شود.
-Rround: تعیین round به عنوان مقداری برای گرد کردن اندازه‌ها به بالا، جهت جبران اندازه بلوک‌های دیسک. مقدار آن را برابر با اندازه بلوک پارتیشن حافظه نهان تنظیم کنید.
-llimit: تعیین limit به عنوان حد کل اندازه حافظه نهان دیسک. مقدار به طور پیش‌فرض بر حسب بایت بیان می‌شود (یا با افزودن B به عدد). برای کیلوبایت از K، برای مگابایت از M یا برای گیگابایت از G استفاده کنید.
-Llimit: تعیین limit به عنوان حد کل inodeهای حافظه نهان دیسک. پسوندهای K، M یا G نیز قابل استفاده هستند.
-i: اجرای هوشمند و تنها در زمانی که تغییری در حافظه نهان دیسک ایجاد شده باشد. این گزینه فقط همراه با گزینه -d امکان‌پذیر است.
-a: فهرست کردن آدرس‌های URL که در حال حاضر در حافظه نهان ذخیره شده‌اند. گونه‌های مختلف یک URL یک بار برای هر گونه فهرست می‌شوند.
-A: فهرست کردن آدرس‌های URL که در حال حاضر در حافظه نهان ذخیره شده‌اند، به همراه ویژگی‌های آن‌ها به ترتیب زیر: url، اندازه هدر، اندازه بدنه، وضعیت (status)، نسخه موجودیت (entity version)، تاریخ، انقضا، زمان درخواست، زمان پاسخ، وجود بدنه، درخواست head.

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

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

هنگامی که یک URL در پراکسی معکوس (reverse proxy) باید حذف شود، URL مؤثر از هدر Host، درگاه port، مسیر path و پرسمان query ساخته می‌شود. توجه داشته باشید که علامت '?' در URL باید همیشه صریحاً مشخص شود، چه رشته پرسمان وجود داشته باشد چه نباشد. برای نمونه، در تلاش برای حذف مسیر / از سرور localhost، آدرس URL مورد نظر برای حذف http://localhost:80/? خواهد بود.

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

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

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

کد خروج (EXIT STATUS)

دستور htcacheclean در صورت موفقیت‌آمیز بودن تمام عملیات‌ها وضعیت صفر ("true") و در غیر این صورت 1 را برمی‌گرداند. اگر یک URL مشخص شده باشد و در حافظه نهان ذخیره شده و با موفقیت حذف شود، مقدار 0 و در غیر این صورت 2 برگردانده می‌شود. اگر در هنگام حذف URL خطایی رخ دهد، مقدار 1 برگردانده خواهد شد.

پرونده‌ها (FILES)

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

path: دایرکتوری ریشه حافظه نهان دیسک برای پاک‌سازی.