نام (NAME)

mkaf - ایجاد یک folio از بایگانی‌های Performance Co-Pilot

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

$PCP_BINADM_DIR/mkaf [-?] [findopts] filename ...

توضیحات (DESCRIPTION)

مجموعه‌ای از یک یا چند بایگانی Performance Co-Pilot (ببینید PCPIntro(1)) می‌تواند با mkaf ترکیب شود تا یک folio بایگانی PCP و فایل کنترل مرتبط با آن folio بایگانی ایجاد گردد. برخی از ابزارهای PCP از mkaf برای ایجاد folioهای بایگانی استفاده می‌کنند؛ مانند قابلیت «record» در ابزارهای pmchart(1) و pmview(1)، تا بازپخش با pmafm(1) تسهیل شود.

دستور mkaf هر آرگومان filename را پردازش می‌کند، و اگر این فایل یکی از مؤلفه‌های یک بایگانی PCP باشد، آن بایگانی به folio افزوده می‌شود.

اگر filename یک دایرکتوری باشد، به صورت بازگشتی با استفاده از find(1) جستجو می‌شود. هر آرگومان filename که با «-» آغاز شود، به عنوان یک گزینهٔ خط فرمان find(1) فرض می‌شود (findopts)؛ در صورتی که هیچ findopts مشخص نشده باشد، مقدار پیش‌فرض -follow است.

نخستین بایگانی نام‌برده در folio، به عنوان میزبان پیش‌فرض برای هر ابزاری که تلاش کند چندین بایگانی را از folio بازپخش کند، در نظر گرفته می‌شود.

فایل کنترل folio در خروجی استاندارد نوشته می‌شود و دارای ساختار زیر است:

1.

خط نخست شامل کلمهٔ PCPFolio است.

2.

خط دوم حاوی برچسب Version: است که پس از آن شماره نسخهٔ ساختار (در حال حاضر 1) می‌آید.

3.

در خطوط بعدی، خط‌های خالی و خط‌هایی که با «#» آغاز می‌شوند نادیده گرفته می‌شوند.

4.

خطی که با برچسب Created: آغاز می‌شود، مشخص می‌کند که folio در چه مکان و چه زمانی ایجاد شده است.

5.

خطی که با برچسب Creator: آغاز می‌شود، ابزاری را که folio را ایجاد کرده است مشخص می‌کند (و فرض می‌شود که می‌داند چگونه folio بایگانی را بازپخش کند). در صورت وجود، آرگومان دوم نام یک فایل پیکربندی است که ابزار سازنده می‌تواند برای بازپخش folio بایگانی از آن استفاده کند؛ برای نمونه با دستور replay برای pmafm(1). در مورد mkaf (برخلاف pmchart(1) یا pmview(1)) هیچ دانشی دربارهٔ محتوای بایگانی‌ها وجود ندارد، بنابراین «سازنده» نمی‌تواند بایگانی را بازپخش کند؛ با این حال pmchart(1) قادر به بازپخش هر بایگانی است، و از این رو این ابزار به عنوان Creator: برای folioهای بایگانی ساخته‌شده توسط mkaf(1) تعیین می‌گردد.

6.

سپس یک یا چند خط قرار می‌گیرد که با برچسب Archive: آغاز شده و به دنبال آن نام میزبان و نام پایهٔ (base name) بایگانی می‌آید.

برای نمونه: $ mkaf mydir/gonzo
ممکن است فایل کنترل folio زیر را تولید کند:

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

گزینه‌ها (OPTIONS)

گزینه‌های خط فرمان موجود عبارتند از:

-?

نمایش پیام راهنمای استفاده و خروج.

-findopts

گزینه‌هایی که باید به find(1) ارسال شوند. پیش‌فرض -follow است.

خطاها (DIAGNOSTICS)

برخی پیام‌های اطلاع‌رسانی، هشدارها و شرایط غیرعادی در خطای استاندارد گزارش می‌شوند.

محیط PCP (PCP ENVIRONMENT)

متغیرهای محیطی با پیشوند PCP_ برای مقداردهی نام فایل‌ها و دایرکتوری‌های مورد استفاده توسط PCP به کار می‌روند. در هر نصب، فایل /etc/pcp.conf حاوی مقادیر محلی برای این متغیرها است. متغیر $PCP_CONF ممکن است برای تعیین یک فایل پیکربندی جایگزین استفاده شود، همان‌طور که در pcp.conf(5) شرح داده شده است.

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

find(1)، PCPIntro(1)، pmafm(1)، pmchart(1)، pmview(1)، pcp.conf(5) و pcp.env(5).