نام (NAME)

pmlogmv - جابه‌جایی (تغییر نام)، کپی یا فهرست کردن فایل‌های بایگانی Performance Co-Pilot

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

pmlogmv [-cfNV?] [-D debug] srcname dstname
pmlogcp [-cfNV?] [-D debug] srcname dstname
pmlogls [-V?] [-D debug] srcname

توضیحات (DESCRIPTION)

یک بایگانی Performance Co-Pilot (PCP) از چندین فایل تشکیل شده است که توسط pmlogger(1) ایجاد می‌شوند. pmlogmv امکان جابه‌جایی یا تغییر نام تمامی فایل‌های یک بایگانی منفرد PCP را به‌صورت گروهی و در قالب یک عملیات واحد فراهم می‌کند. به همین ترتیب pmlogcp تمامی فایل‌های یک بایگانی منفرد PCP را در قالب یک عملیات واحد کپی می‌کند.

pmlogls یک برنامه کاربردی کمکی است که نام تمامی فایل‌های موجود در یک بایگانی PCP را فهرست کرده و سپس خارج می‌شود.

آرگومان srcname بایگانی هدف را مشخص می‌کند، و می‌تواند نام پایه (basename) مشترک بین تمام فایل‌های آن بایگانی یا یکی از فایل‌های خود بایگانی باشد.

برای pmlogmv یا pmlogcp، نام پایه بایگانی جدید dstname خواهد بود، مگر زمانی که dstname یک دایرکتوری موجود باشد، که در این حالت فایل‌ها با همان نام پایه بایگانیِ srcname به درون dstname منتقل یا کپی می‌شوند.

از آنجا که بایگانی‌های PCP سوابق مهمی از فعالیت سیستم هستند، مراقبت ویژه‌ای برای تضمین یکپارچگی فایل‌های یک بایگانی انجام می‌شود. برای مشکلات قابل‌بازیابی که هنگام اجرای pmlogmv یا pmlogcp رخ می‌دهند، تمامی فایل‌های مرتبط با srcname حفظ خواهند شد و هیچ فایل جدیدی با پیشوند dstname ایجاد نخواهد شد. «مشکلات قابل‌بازیابی» شامل سیگنال‌های قابل‌دریافت (مانند SIGHUP، SIGINT، SIGQUIT و SIGTERM)، مسائل مربوط به مجوزها، وجود داشتن فایل‌های جدید از قبل، پر شدن سیستم فایل و غیره است.

پیاده‌سازی pmlogmv تلاش می‌کند از پیوندهای سخت (hard links) در سیستم فایل استفاده کند و بنابراین از محدودیت‌های معنایی ln(2) پیروی می‌کند که در بیشتر سیستم‌ها به این معنی است که دایرکتوری‌های حاوی هر دو فایل بایگانی PCP یعنی srcname و dstname باید درون یک سیستم فایل یکسان قرار داشته باشند. هنگامی که این کار ممکن نباشد، pmlogmv به استفاده از cp(1) برای کپی کردن srcname به dstname روی می‌آورد.

pmlogcp همواره از cp(1) استفاده می‌کند.

گزینه‌ها (OPTIONS)

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

-c, --checksum: حالت بررسی سخت‌گیرانه (Paranoid) زمانی که به cp(1) نیاز باشد و چک‌سام هر فایل برای فایل اصلی و فایل کپی‌شده محاسبه می‌شود؛ این چک‌سام‌ها باید پیش از تایید کپی یکسان باشند. دستور محاسبه چک‌سام با آزمایش موارد زیر به ترتیب انتخاب می‌شود تا زمانی که یکی از آن‌ها قابل اجرا باشد: md5sum(1)، sha256sum(1)، sha1sum(1) و sum(1). اگر هیچ دستور محاسبه چک‌سامِ قابل‌اجرایی یافت نشود، هشداری صادر شده و از بررسی چک‌سام صرف‌نظر می‌شود.
-f, --force: به‌طور معمول pmlogmv و pmlogcp دیدگاهی محافظه‌کارانه نسبت به dstname دارند و اگر dstname شامل هر نویسه‌ای باشد که احتمالاً برای sh(1) مشکل ایجاد کند، ادامه نمی‌دهند. این شامل نویسه‌های عمومی تطبیق الگو (glob) مانند «?»، «*» و «[»، نویسه‌های فراویژه نحوی پوسته مانند «)»، «|»، «;» و «&»، نویسه‌های تغییرمسیر ورودی/خروجی پوسته مانند «<» و «>»، علامت دلار، فاصله و غیره است.

فلگ -f عملیات تغییر نام یا کپی را اجبار می‌کند، حتی اگر dstname شامل هر یک از این نویسه‌های «ناامن» باشد.

-N, --showme: یک اجرای آزمایشی (dry-run) انجام می‌دهد؛ بدون اعمال هرگونه تغییر، مواردی را که قرار است تغییر کنند بررسی و گزارش می‌کند.
-V, --verbose: فعال‌سازی حالت پرگو (verbose).
-?, --help: نمایش پیام نحوه استفاده و خروج.

عیب‌یابی (DIAGNOSTICS)

تمامی پیام‌های خطا و هشدار به گونه‌ای در نظر گرفته شده‌اند که به سادگی قابل فهم باشند و خطاها وضعیت خروج غیرصفر تولید می‌کنند.

گزینه‌های اشکال‌زدایی (DEBUGGING OPTIONS)

گزینه -D یا --debug خروجی عیب‌یابی تکمیلی را در stderr فعال می‌کند تا به ریشه‌یابی مشکلات کمک کند، هرچند این اطلاعات گاهی مبهم بوده و اساساً برای راهنمایی توسعه‌دهندگان به‌جای کاربران نهایی در نظر گرفته شده است. debug یک فهرست جداشده با کاما از گزینه‌های اشکال‌زدایی است؛ از pmdbg(1) به همراه گزینه -l برای به دست آوردن فهرستی از گزینه‌های اشکال‌زدایی موجود و معانی آن‌ها استفاده کنید.

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

cp(1)، ln(1)، md5sum(1)، PCPIntro(1)، pmlogger(1)، sha1sum(1)، sha256sum(1) و LOGARCHIVE(5).