'\"macro stdmacro
.\"
.\" Copyright (c) 2000 Silicon Graphics, Inc.  All Rights Reserved.
.\"
.\" 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.
.\"
.\"
.TH INDOMCACHECTL 1 "PCP" "Performance Co-Pilot"
.SH "نام (NAME)"
indomcachectl \- مدیریت فایل‌های حافظه پنهان دامنه نمونه
.SH "خلاصه دستور (SYNOPSIS)"
.B $PCP_BINADM_DIR/indomcachectl
[\fB\-w\fR]
\fB\-l\fR
.I indom
.sp
.B $PCP_BINADM_DIR/indomcachectl
[\fB\-w\fR]
[\fB\-m\fR \fImode\fR]
[\fB\-g\fR \fIgroup\fR]
[\fB\-u\fR \fIuser\fR]
.I indom
.SH "توضیحات (DESCRIPTION)"
.de EX
.in +0.5i
.ie t .ft CB
.el .ft B
.ie t .sp .5v
.el .sp
.ta \\w' 'u*8
.nf
..
.de EE
.fi
.ie t .sp .5v
.el .sp
.ft R
.in
..
دستور
.B indomcachectl
به مدیریت فایل‌های حافظه پنهان دامنه نمونه (Instance Domain) که در
.B $PCP_VAR_DIR/config/pmda
ذخیره می‌شوند، کمک می‌کند.
.PP
پارامتر اجباری
.I indom
از یک قالب ۲-نقطه‌ای برای مشخص کردن فیلدهای
.I domain
و
.I serial
شماره دامنه نمونه استفاده می‌کند.
مقادیر مورد نیاز را می‌توان برای یک معیار خاص با استفاده از گزینه
.B \-d
در
.BR pminfo (1)
گزارش کرد.
.PP
فهرست گزینه‌های موجود را می‌توان با استفاده از گزینه
.BR \-? / \-\-help
دریافت کرد که یک پیام راهنمای نحوه استفاده را نمایش داده و خارج می‌شود.
.PP
اگر گزینه
.BR \-l / \-\-list
مشخص شده باشد، محتویات فایل حافظه پنهان دامنه نمونه در
.I stdout
تخلیه شده و
.I indomcachectl
خارج می‌شود.
.PP
در غیر این صورت یک فایل حافظه پنهان دامنه نمونه خالی ایجاد خواهد شد.
مالکیت کاربری فایل ایجاد شده به uid فراخواننده اختصاص داده می‌شود، اما در صورت مشخص شدن گزینه
.BR \-u / \-\-user
می‌تواند به‌صورت اختیاری به uid کاربر
.I user
از فایل
.BR passwd (5)
اختصاص یابد.
مالکیت گروهی فایل ایجاد شده به gid فراخواننده اختصاص می‌یابد، در غیر این صورت به gid پیش‌فرض کاربر
.I user
در صورت مشخص شدن گزینه
.IR \-u ،
وگرنه به gid گروه
.I group
از فایل
.BR group (5)
در صورت مشخص شدن گزینه
.BR \-g / \-\-group
اختصاص داده خواهد شد.
.PP
فایل حافظه پنهان دامنه نمونه به‌طور پیش‌فرض با حالت دسترسی 0660 ایجاد می‌شود (برخی از PMDAها از مجوز خواندن و نوشتن گروهی برای دسترسی و به‌روزرسانی محتوای فایل استفاده می‌کنند)
\- اگر این حالت مناسب نباشد، گزینه
.BR \-m / \-\-mode
می‌تواند برای تنظیم حالت دسترسی روی مقدار (هشت‌هشتی)
.I mode
استفاده شود.
.PP
از آنجا که فایل‌های حافظه پنهان indom برای PMDA مربوطه ارزشمند هستند،
.I indomcachectl
یک فایل حافظه پنهان indom موجود را بازنویسی نخواهد کرد.
.PP
عملیات معمولاً در سکوت انجام می‌شود، مگر برای خطاها (یا هشدارها در صورت استفاده از گزینه
.BR \-w / \-\-warning ).
وضعیت خروج در صورت موفقیت 0 و در صورت شکست 1 است.
.SH "سایر گزینه‌های مدیریتی (OTHER MANAGEMENT OPTIONS)"
فایل‌های موجود در
.B $PCP_VAR_DIR/config/pmda
همگی فایل‌های متنی هستند (یکی به ازای هر دامنه نمونه ذخیره‌شده در حافظه پنهان)، بنابراین در شرایط حاد می‌توان برای اعمال تغییرات یا حتی حذف فایل‌ها با احتیاط آن‌ها را دستکاری کرد،
.B به شرطی که
PMDA در حال اجرا نباشد.
.PP
در اینجا مثالی برای شماره دامنه نمونه 60.17 که با معیارهای
network.interface.*
مرتبط است آورده شده است:
.EX
$ cat /var/lib/pcp/config/pmda/60.17
2 0 2147483647
0 1712727825 ens33
1 1712727825 virbr0
2 1712727825 lo
.EE
.PP
خط اول یک سرآیند جادویی است؛ آن را تغییر ندهید.
به دنبال آن، به ازای هر نمونه یک خط با شناسه نمونه (یک عدد صحیح) در فیلد اول، مقداری جادویی در فیلد دوم (آن را تغییر ندهید) و نام بیرونی نمونه در فیلد سوم قرار دارد.
.SH "همچنین ببینید (SEE ALSO)"
.BR PCPIntro (1),
.BR chmod (1),
.BR pminfo (1),
.BR PMAPI (3),
.BR PMDA (3),
.BR pmdaCache (3),
.BR group (5)
و
.BR passwd (5).

.\" control lines for scripts/man-spell
.\" +ok+ virbr ens sp {from network interfaces}