نام (NAME)

indomcachectl - مدیریت فایل‌های حافظه پنهان دامنه نمونه

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

$PCP_BINADM_DIR/indomcachectl [-w] -l indom

$PCP_BINADM_DIR/indomcachectl [-w] [-m mode] [-g group] [-u user] indom

توضیحات (DESCRIPTION)

دستور indomcachectl به مدیریت فایل‌های حافظه پنهان دامنه نمونه (Instance Domain) که در $PCP_VAR_DIR/config/pmda ذخیره می‌شوند، کمک می‌کند.

پارامتر اجباری indom از یک قالب ۲-نقطه‌ای برای مشخص کردن فیلدهای domain و serial شماره دامنه نمونه استفاده می‌کند. مقادیر مورد نیاز را می‌توان برای یک معیار خاص با استفاده از گزینه -d در pminfo(1) گزارش کرد.

فهرست گزینه‌های موجود را می‌توان با استفاده از گزینه -?/--help دریافت کرد که یک پیام راهنمای نحوه استفاده را نمایش داده و خارج می‌شود.

اگر گزینه -l/--list مشخص شده باشد، محتویات فایل حافظه پنهان دامنه نمونه در stdout تخلیه شده و indomcachectl خارج می‌شود.

در غیر این صورت یک فایل حافظه پنهان دامنه نمونه خالی ایجاد خواهد شد. مالکیت کاربری فایل ایجاد شده به uid فراخواننده اختصاص داده می‌شود، اما در صورت مشخص شدن گزینه -u/--user می‌تواند به‌صورت اختیاری به uid کاربر user از فایل passwd(5) اختصاص یابد. مالکیت گروهی فایل ایجاد شده به gid فراخواننده اختصاص می‌یابد، در غیر این صورت به gid پیش‌فرض کاربر user در صورت مشخص شدن گزینه -u، وگرنه به gid گروه group از فایل group(5) در صورت مشخص شدن گزینه -g/--group اختصاص داده خواهد شد.

فایل حافظه پنهان دامنه نمونه به‌طور پیش‌فرض با حالت دسترسی 0660 ایجاد می‌شود (برخی از PMDAها از مجوز خواندن و نوشتن گروهی برای دسترسی و به‌روزرسانی محتوای فایل استفاده می‌کنند) - اگر این حالت مناسب نباشد، گزینه -m/--mode می‌تواند برای تنظیم حالت دسترسی روی مقدار (هشت‌هشتی) mode استفاده شود.

از آنجا که فایل‌های حافظه پنهان indom برای PMDA مربوطه ارزشمند هستند، indomcachectl یک فایل حافظه پنهان indom موجود را بازنویسی نخواهد کرد.

عملیات معمولاً در سکوت انجام می‌شود، مگر برای خطاها (یا هشدارها در صورت استفاده از گزینه -w/--warning). وضعیت خروج در صورت موفقیت 0 و در صورت شکست 1 است.

سایر گزینه‌های مدیریتی (OTHER MANAGEMENT OPTIONS)

فایل‌های موجود در $PCP_VAR_DIR/config/pmda همگی فایل‌های متنی هستند (یکی به ازای هر دامنه نمونه ذخیره‌شده در حافظه پنهان)، بنابراین در شرایط حاد می‌توان برای اعمال تغییرات یا حتی حذف فایل‌ها با احتیاط آن‌ها را دستکاری کرد، به شرطی که PMDA در حال اجرا نباشد.

در اینجا مثالی برای شماره دامنه نمونه 60.17 که با معیارهای network.interface.* مرتبط است آورده شده است:

$ cat /var/lib/pcp/config/pmda/60.17
2 0 2147483647
0 1712727825 ens33
1 1712727825 virbr0
2 1712727825 lo

خط اول یک سرآیند جادویی است؛ آن را تغییر ندهید. به دنبال آن، به ازای هر نمونه یک خط با شناسه نمونه (یک عدد صحیح) در فیلد اول، مقداری جادویی در فیلد دوم (آن را تغییر ندهید) و نام بیرونی نمونه در فیلد سوم قرار دارد.

همچنین ببینید (SEE ALSO)

PCPIntro(1), chmod(1), pminfo(1), PMAPI(3), PMDA(3), pmdaCache(3), group(5) و passwd(5).