'\"macro stdmacro
.\"
.\" Copyright (c) 2013 Red Hat.
.\" Copyright (c) 2000-2004 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 PMPOST 1 "PCP" "Performance Co-Pilot"
.SH "نام (NAME)"
\f3pmpost\f1 \- افزودن پیام‌ها به تابلوی اعلانات Performance Co-Pilot
.SH "خلاصه دستور (SYNOPSIS)"
.B $PCP_BINADM_DIR/pmpost
[\f3\-D\f1 \f2debug\f1]
.I message
.SH "توضیحات (DESCRIPTION)"
دستور
.B pmpost
متن
.I message
را به انتهای فایل تابلوی اعلانات Performance Co-Pilot (PCP) (\c
.BR $PCP_LOG_DIR/NOTICES )
به‌صورت اتمیک (atomic) الصاق می‌کند، به‌گونه‌ای که از خرابی فایل تابلوی اعلانات در اثر فراخوانی‌های هم‌روند
.B pmpost
محافظت شود.
.PP
تابلوی اعلانات PCP به عنوان یک ذخیره‌ساز پایدار و مرکز تبادل پیام‌های مهم مربوط به عملکرد PCP و اعلان هشدارهای کارایی از سوی
.BR pmie (1)
در نظر گرفته شده است، به‌ویژه هنگامی که سایر گزینه‌های اطلاع‌رسانی در دسترس نبوده یا مناسب نباشند.
.PP
پیام‌ها پیش از نوشته‌شدن، با زمان جاری پیشوندگذاری می‌شوند، و هرگاه روز جاری با آخرین باری که فایل تابلوی اعلانات نوشته شده متفاوت باشد،
.B pmpost
تاریخ کامل را در ابتدای پیام درج خواهد کرد.
.PP
اگر فایل تابلوی اعلانات وجود نداشته باشد،
.B pmpost
آن را ایجاد خواهد کرد.
.B pmpost
معمولاً توسط دیمن‌های با اجرای طولانی‌مدت PCP که تحت حساب‌های کاربری (معمولاً بدون دسترسی ویژه)
.B $PCP_USER
و
.B $PCP_GROUP
اجرا می‌شوند، فراخوانی می‌شود.
مالکیت این فایل باید متعلق به کاربر
.B $PCP_USER
بوده و برای او قابل نوشتن، و برای سایرین قابل خواندن باشد.
.SH "فایل‌ها (FILES)"
.TP 5
.I $PCP_LOG_DIR/NOTICES
فایل تابلوی اعلانات PCP
.SH "محیط PCP (PCP ENVIRONMENT)"
فایل
.B /etc/pcp.conf
شامل مقادیر محلی برای متغیرهای _PCP است.
.SH "همچنین ببینید در یونیکس (UNIX SEE ALSO)"
.BR logger (1).
.SH "همچنین ببینید در ویندوز (WINDOWS SEE ALSO)"
.BR pcp-eventlog (1).
.SH "گزینه‌های اشکال‌زدایی (DEBUGGING OPTIONS)"
گزینه
.B \-D
یا
.B \-\-debug
خروجی پیام‌های تشخیصی بیشتری را روی
.I stderr
فعال می‌کند تا به تریاژ و اولویت‌بندی مشکلات کمک کند، اگرچه این اطلاعات گاهی مبهم است و در درجه اول برای راهنمایی توسعه‌دهندگان طراحی شده است تا کاربران نهایی.
.I debug
یک فهرست جداشده با کاما از گزینه‌های اشکال‌زدایی است؛ از
.BR pmdbg (1)
به همراه گزینه
.B \-l
برای به‌دست آوردن فهرستی از گزینه‌های اشکال‌زدایی موجود و معانی آن‌ها استفاده کنید.
.SH "همچنین ببینید (SEE ALSO)"
.BR pmie (1)،
.BR pcp.conf (5)
و
.BR pcp.env (5).