'\"macro stdmacro
.\"
.\" Copyright (c) 2014 Ken McDonell.  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 PMLOGMV 1 "PCP" "Performance Co-Pilot"
.SH "نام (NAME)"
pmlogmv \- جابه‌جایی (تغییر نام)، کپی یا فهرست کردن فایل‌های بایگانی Performance Co-Pilot
.SH "خلاصه دستور (SYNOPSIS)"
\f3pmlogmv\f1 [\f3\-cfNV?\f1] [\f3\-D\f1 \f2debug\f1] \f2srcname\f1 \f2dstname\f1
.br
\f3pmlogcp\f1 [\f3\-cfNV?\f1] [\f3\-D\f1 \f2debug\f1] \f2srcname\f1 \f2dstname\f1
.br
\f3pmlogls\f1 [\f3\-V?\f1] [\f3\-D\f1 \f2debug\f1] \f2srcname\f1
.SH "توضیحات (DESCRIPTION)"
یک بایگانی Performance Co-Pilot (PCP) از چندین فایل تشکیل شده است که توسط
.BR pmlogger (1)
ایجاد می‌شوند.
.B pmlogmv
امکان جابه‌جایی یا تغییر نام تمامی فایل‌های یک بایگانی منفرد PCP را به‌صورت گروهی و در قالب یک عملیات واحد فراهم می‌کند.
به همین ترتیب
.B pmlogcp
تمامی فایل‌های یک بایگانی منفرد PCP را در قالب یک عملیات واحد کپی می‌کند.
.PP
.B pmlogls
یک برنامه کاربردی کمکی است که نام تمامی فایل‌های موجود در یک بایگانی PCP را فهرست کرده و سپس خارج می‌شود.
.PP
آرگومان
.I srcname
بایگانی هدف را مشخص می‌کند، و می‌تواند نام پایه (basename) مشترک بین تمام فایل‌های آن بایگانی یا یکی از فایل‌های خود بایگانی باشد.
.PP
برای
.B pmlogmv
یا
.BR pmlogcp ،
نام پایه بایگانی جدید
.IR dstname
خواهد بود، مگر زمانی که
.I dstname
یک دایرکتوری موجود باشد، که در این حالت فایل‌ها با همان نام پایه بایگانیِ
.I srcname
به درون
.I dstname
منتقل یا کپی می‌شوند.
.PP
از آنجا که بایگانی‌های PCP سوابق مهمی از فعالیت سیستم هستند، مراقبت ویژه‌ای برای تضمین یکپارچگی فایل‌های یک بایگانی انجام می‌شود.
برای مشکلات قابل‌بازیابی که هنگام اجرای
.B pmlogmv
یا
.BR pmlogcp
رخ می‌دهند، تمامی فایل‌های مرتبط با
.I srcname
حفظ خواهند شد و هیچ فایل جدیدی با پیشوند
.I dstname
ایجاد نخواهد شد.
«مشکلات قابل‌بازیابی» شامل سیگنال‌های قابل‌دریافت (مانند SIGHUP، SIGINT، SIGQUIT و SIGTERM)، مسائل مربوط به مجوزها، وجود داشتن فایل‌های جدید از قبل، پر شدن سیستم فایل و غیره است.
.PP
پیاده‌سازی
.B pmlogmv
تلاش می‌کند از پیوندهای سخت (hard links) در سیستم فایل استفاده کند و بنابراین از محدودیت‌های معنایی
.IR ln (2)
پیروی می‌کند که در بیشتر سیستم‌ها به این معنی است که دایرکتوری‌های حاوی هر دو فایل بایگانی PCP یعنی
.I srcname
و
.I dstname
باید درون
.B یک
سیستم فایل یکسان قرار داشته باشند.
هنگامی که این کار ممکن نباشد،
.B pmlogmv
به استفاده از
.BR cp (1)
برای کپی کردن
.I srcname
به
.IR dstname
روی می‌آورد.
.PP
.B pmlogcp
همواره از
.BR cp (1)
استفاده می‌کند.
.SH "گزینه‌ها (OPTIONS)"
گزینه‌های موجود در خط فرمان عبارتند از:
.TP 5
\fB\-c\fR, \fB\-\-checksum\fR
حالت بررسی سخت‌گیرانه (Paranoid) زمانی که به
.BR cp (1)
نیاز باشد و چک‌سام هر فایل برای فایل اصلی و فایل کپی‌شده محاسبه می‌شود؛ این چک‌سام‌ها باید پیش از تایید کپی یکسان باشند.
دستور محاسبه چک‌سام با آزمایش موارد زیر به ترتیب انتخاب می‌شود تا زمانی که یکی از آن‌ها قابل اجرا باشد:
.BR md5sum (1)،
.BR sha256sum (1)،
.BR sha1sum (1)
و
.BR sum (1).
اگر هیچ دستور محاسبه چک‌سامِ قابل‌اجرایی یافت نشود، هشداری صادر شده و از بررسی چک‌سام صرف‌نظر می‌شود.
.TP 5
\fB\-f\fR, \fB\-\-force\fR
به‌طور معمول
.B pmlogmv
و
.B pmlogcp
دیدگاهی محافظه‌کارانه نسبت به
.I dstname
دارند و اگر
.I dstname
شامل هر نویسه‌ای باشد که احتمالاً برای
.BR sh (1)
مشکل ایجاد کند، ادامه نمی‌دهند.
این شامل نویسه‌های عمومی تطبیق الگو (glob) مانند «?»، «*» و «[»، نویسه‌های فراویژه نحوی پوسته مانند «)»، «|»، «;» و «&»، نویسه‌های تغییرمسیر ورودی/خروجی پوسته مانند «<» و «>»، علامت دلار، فاصله و غیره است.
.RS
.PP
فلگ
.B \-f
عملیات تغییر نام یا کپی را اجبار می‌کند، حتی اگر
.I dstname
شامل هر یک از این نویسه‌های «ناامن» باشد.
.RE
.TP
\fB\-N\fR, \fB\-\-showme\fR
یک اجرای آزمایشی (dry-run) انجام می‌دهد؛ بدون اعمال هرگونه تغییر، مواردی را که قرار است تغییر کنند بررسی و گزارش می‌کند.
.TP
\fB\-V\fR, \fB\-\-verbose\fR
فعال‌سازی حالت پرگو (verbose).
.TP
\fB\-?\fR, \fB\-\-help\fR
نمایش پیام نحوه استفاده و خروج.
.SH "عیب‌یابی (DIAGNOSTICS)"
تمامی پیام‌های خطا و هشدار به گونه‌ای در نظر گرفته شده‌اند که به سادگی قابل فهم باشند و خطاها وضعیت خروج غیرصفر تولید می‌کنند.
.SH "گزینه‌های اشکال‌زدایی (DEBUGGING OPTIONS)"
گزینه
.B \-D
یا
.B \-\-debug
خروجی عیب‌یابی تکمیلی را در
.I stderr
فعال می‌کند تا به ریشه‌یابی مشکلات کمک کند، هرچند این اطلاعات گاهی مبهم بوده و اساساً برای راهنمایی توسعه‌دهندگان به‌جای کاربران نهایی در نظر گرفته شده است.
.I debug
یک فهرست جداشده با کاما از گزینه‌های اشکال‌زدایی است؛ از
.BR pmdbg (1)
به همراه گزینه
.B \-l
برای به دست آوردن فهرستی از گزینه‌های اشکال‌زدایی موجود و معانی آن‌ها استفاده کنید.
.SH "همچنین ببینید (SEE ALSO)"
.BR cp (1)،
.BR ln (1)،
.BR md5sum (1)،
.BR PCPIntro (1)،
.BR pmlogger (1)،
.BR sha1sum (1)،
.BR sha256sum (1)
و
.BR LOGARCHIVE (5).
.\" control lines for scripts/man-spell
.\" +ok+ md {from md5sum} sha {from sha256sum}