'\"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 MKAF 1 "PCP" "Performance Co-Pilot"
.SH "نام (NAME)"
\f3mkaf\f1 \- ایجاد یک folio از بایگانی‌های Performance Co-Pilot
.SH "خلاصه دستور (SYNOPSIS)"
\f3$PCP_BINADM_DIR/mkaf\f1
[\f3-?\f1]
[\f2findopts\f1]
\f2filename\f1 ...
.SH "توضیحات (DESCRIPTION)"
مجموعه‌ای از یک یا چند بایگانی Performance Co-Pilot (ببینید
.BR PCPIntro (1))
می‌تواند با
.B mkaf
ترکیب شود تا یک folio بایگانی PCP و فایل کنترل مرتبط با آن folio بایگانی ایجاد گردد.
برخی از ابزارهای PCP از
.B mkaf
برای ایجاد folioهای بایگانی استفاده می‌کنند؛ مانند قابلیت «record» در ابزارهای
.BR pmchart (1)
و
.BR pmview (1)،
تا بازپخش با
.BR pmafm (1)
تسهیل شود.
.PP
دستور
.B mkaf
هر آرگومان
.I filename
را پردازش می‌کند، و اگر این فایل یکی از مؤلفه‌های یک بایگانی PCP باشد، آن بایگانی به folio افزوده می‌شود.
.PP
اگر
.I filename
یک دایرکتوری باشد، به صورت بازگشتی با استفاده از
.BR find (1)
جستجو می‌شود.
هر آرگومان
.I filename
که با «\-» آغاز شود، به عنوان یک گزینهٔ خط فرمان
.BR find (1)
فرض می‌شود
.RI ( findopts )؛
در صورتی که هیچ
.I findopts
مشخص نشده باشد، مقدار پیش‌فرض
.B -follow
است.
.PP
نخستین بایگانی نام‌برده در folio، به عنوان میزبان پیش‌فرض برای هر ابزاری که تلاش کند چندین بایگانی را از folio بازپخش کند، در نظر گرفته می‌شود.
.PP
فایل کنترل folio در خروجی استاندارد نوشته می‌شود و دارای ساختار زیر است:
.IP 1. 3n
خط نخست شامل کلمهٔ
.BR PCPFolio
است.
.IP 2.
خط دوم حاوی برچسب
.B Version:
است که پس از آن شماره نسخهٔ ساختار (در حال حاضر 1) می‌آید.
.IP 3.
در خطوط بعدی، خط‌های خالی و خط‌هایی که با «#» آغاز می‌شوند نادیده گرفته می‌شوند.
.IP 4.
خطی که با برچسب
.B Created:
آغاز می‌شود، مشخص می‌کند که folio در چه مکان و چه زمانی ایجاد شده است.
.IP 5.
خطی که با برچسب
.B Creator:
آغاز می‌شود، ابزاری را که folio را ایجاد کرده است مشخص می‌کند (و فرض می‌شود که می‌داند چگونه folio بایگانی را بازپخش کند).
در صورت وجود، آرگومان دوم نام یک فایل پیکربندی است که ابزار سازنده می‌تواند برای بازپخش folio بایگانی از آن استفاده کند؛ برای نمونه با دستور
.B replay
برای
.BR pmafm (1).
در مورد
.B mkaf
(برخلاف
.BR pmchart (1)
یا
.BR pmview (1))
هیچ دانشی دربارهٔ محتوای بایگانی‌ها وجود ندارد، بنابراین «سازنده» نمی‌تواند بایگانی را بازپخش کند؛ با این حال
.BR pmchart (1)
قادر به بازپخش هر بایگانی است، و از این رو این ابزار به عنوان
.B Creator:
برای folioهای بایگانی ساخته‌شده توسط
.BR mkaf (1)
تعیین می‌گردد.
.IP 6.
سپس یک یا چند خط قرار می‌گیرد که با برچسب
.B Archive:
آغاز شده و به دنبال آن نام میزبان و نام پایهٔ (base name) بایگانی می‌آید.
.PP
برای نمونه:
.ti +5n
$ mkaf mydir/gonzo
.br
ممکن است فایل کنترل folio زیر را تولید کند:
.PP
.ft CR
.nf
PCPFolio
Version: 1
# use pmafm(1) to process this PCP archive folio
#
Created: on gonzo at Tue Jul  2 03:35:54 EST 1996
Creator: pmchart
#               Host                    Basename
#
Archive:        gonzo                   mydir/gonzo/960627
Archive:        gonzo                   mydir/gonzo/960628
Archive:        gonzo                   mydir/gonzo/960629
Archive:        gonzo                   mydir/gonzo/960630
Archive:        gonzo                   mydir/gonzo/960701
Archive:        gonzo                   mydir/gonzo/960701.00.10
Archive:        gonzo                   mydir/gonzo/960701.05.25
Archive:        gonzo                   mydir/gonzo/960702.00.10
.ft
.SH "گزینه‌ها (OPTIONS)"
گزینه‌های خط فرمان موجود عبارتند از:
.TP 5
\fB\-?\fR
نمایش پیام راهنمای استفاده و خروج.
.TP
\fI-findopts\fR
گزینه‌هایی که باید به
.BR find (1)
ارسال شوند.
پیش‌فرض
.BR \-follow
است.
.SH "خطاها (DIAGNOSTICS)"
برخی پیام‌های اطلاع‌رسانی، هشدارها و شرایط غیرعادی در خطای استاندارد گزارش می‌شوند.
.SH "محیط PCP (PCP ENVIRONMENT)"
متغیرهای محیطی با پیشوند \fBPCP_\fP برای مقداردهی نام فایل‌ها و دایرکتوری‌های مورد استفاده توسط PCP به کار می‌روند.
در هر نصب، فایل \fI/etc/pcp.conf\fP حاوی مقادیر محلی برای این متغیرها است.
متغیر \fB$PCP_CONF\fP ممکن است برای تعیین یک فایل پیکربندی جایگزین استفاده شود، همان‌طور که در \fBpcp.conf\fP(5) شرح داده شده است.
.SH "همچنین ببینید (SEE ALSO)"
.BR find (1)،
.BR PCPIntro (1)،
.BR pmafm (1)،
.BR pmchart (1)،
.BR pmview (1)،
.BR pcp.conf (5)
و
.BR pcp.env (5).

.\" control lines for scripts/man-spell
.\" +ok+ EST Jul PCPFolio gonzo mydir