.TH DOTLOCKFILE 1 "January 10, 2017" "" "Cistron Utilities"
.SH "نام (NAME)"
dotlockfile \- ابزاری برای مدیریت فایل‌های قفل
.SH "خلاصه دستور (SYNOPSIS)"
.B dotlockfile
.B \-l
.RB [ \-r
.IR retries ]
.RB [ \-i
.IR interval ]
.RB [ \-p ]
.RB [ \-q ]
.RB < \-m \ |
.IR lockfile >
.br
.B dotlockfile
.B \-l
.RB [ \-r
.IR retries ]
.RB [ \-i
.IR interval ]
.RB [ \-p ]
.RB [ \-q ]
.RB < \-m \ |
.IR lockfile >
.RB [ \-P ]
.IR cmd "\ args \&...\&"
.br
.B dotlockfile
.RB \-u \ | \ \-t
.br
.SH "توضیحات (DESCRIPTION)"
دستور
.B dotlockfile
یک ابزار خط فرمانی برای ایجاد، آزمودن و حذف قابل اطمینان فایل‌های قفل (lockfile) است.
این ابزار فایل‌های قفل را
.I به‌طور قابل‌اطمینان
بر روی فایل‌سیستم‌های محلی و NFS ایجاد می‌کند، زیرا مراحل حیاتی بررسی فایل قفل از پیش موجود و ایجاد آن،
.I به‌طور اتمیک
با یک فراخوانی
.I منفرد
به
.IR link (2)
انجام می‌شود.
صفحه راهنمای
.IR lockfile_create (3)
الگوریتم مورد استفاده را شرح می‌دهد.
.PP
دستور
.B dotlockfile
با ویژگی
.BI SETGID \ mail
نصب شده است و بنابراین می‌تواند برای قفل و باز کردن صندوق‌های پستی (mailbox) نیز استفاده شود،
.I حتی
اگر دایرکتوری mailspool تنها توسط گروه mail قابل نوشتن باشد.
.PP
نام
.B dotlockfile
از روش قفل‌گذاری صندوق‌های پستی جهت به‌روزرسانی در بسیاری از سیستم‌های UNIX برگرفته شده است. یک فایل قفل با همان نام فایل صندوق پستی، اما با الحاق رشتهٔ
"\fI.lock\fR"
ایجاد می‌شود.
.PP
نام‌های
.B dotlock
و
.B lockfile
پیش‌تر گرفته شده بودند \(en از این رو نام \fBdotlockfile\fR انتخاب شد \fI:)\fR.
.SH "گزینه‌ها (OPTIONS)"
.IP "\fB\-l\fR"
ایجاد یک فایل قفل در صورتی که فایل قفل معتبر از پیش موجودی یافت نشود؛ در غیر این صورت منتظر مانده و مطابق با گزینهٔ \fB\-r\fR دوباره تلاش می‌کند. فاصلهٔ زمانی بین تلاش‌های مجدد می‌تواند به‌طور صریح با گزینهٔ \fB\-i\fR تنظیم شود.
این گزینه (\fB-l\fR) پیش‌فرض است، بنابراین می‌توان آن را نادیده گرفت.

یک فایل قفل معتبر تلقی می‌شود،
.br
\[bu]\ \ اگر شامل
.I process\-id
یک فرایند در حال اجرا باشد،
.br
\[bu]\ \ یا اگر شامل هیچ
.I process\-id
نباشد و کمتر از ۵\ دقیقه پیش لمس (touch) شده باشد (برچسب زمانی آن جدیدتر از ۵\ دقیقه باشد).
.IP "\fB\-r retries\fR"
تعداد دفعاتی که
.B dotlockfile
در صورت شکست اولیه پیش از تسلیم شدن، برای دستیابی به قفل مجدداً تلاش می‌کند.
مدت زمان خواب اولیه پس از شکست در دستیابی به قفل، ۵\ ثانیه است.
پس از هر تلاش مجدد، فاصلهٔ خواب به‌صورت افزایشی ۵\ ثانیه زیاد می‌شود تا جایی که به حداکثر ۶۰\ ثانیه بین دفعات برسد، مگر آنکه با \fB\-i\fR لغو شود.
تعداد پیش‌فرض تلاش‌های مجدد ۵ است.
برای تنها یک‌بار تلاش، از "\fB\-r 0\fR" استفاده کنید.
برای تلاش نامحدود، از "\fB\-r \-1\fR" استفاده کنید.
.IP "\fB\-i interval\fR"
یک بازهٔ زمانی ثابت برای تلاش مجدد تنظیم می‌کند.
.IP "\fB\-u\fR"
حذف یک فایل قفل.
.IP "\fB\-t\fR"
لمس کردن (touch) یک فایل قفل موجود (به‌روزرسانی برچسب زمانی).
برای فایل‌های قفل روی فایل‌سیستم‌های NFS مفید است.
برای فایل‌های قفل روی فایل‌سیستم‌های محلی، گزینهٔ
.B \-p
ترجیح داده می‌شود.
.IP "\fB\-p\fR"
نوشتن
.I process\-id
فرایند فراخواننده (یا خود dotlockfile در صورتی که دستوری اجرا شود)
درون فایل قفل.
همچنین هنگام آزمودن یک فایل قفل موجود، محتویات آن برای یافتن
.I process\-id
یک فرایند در حال اجرا بررسی می‌شود تا معتبر بودن فایل قفل تأیید گردد.
بدیهی است که این گزینه تنها برای فایل‌های قفل روی فایل‌سیستم‌های محلی مفید است.
.IP "\fB\-m\fR"
قفل یا باز کردن صندوق پستی کاربر فعلی.
مسیر صندوق پستی، دایرکتوری پیش‌فرض mailspool سیستم است (معمولاً
.IR /var/mail )
که نام کاربری به‌دست‌آمده از
.IR getpwuid ()
به انتهای آن افزوده می‌شود.
اگر متغیر محیطی
.I $MAIL
تنظیم شده باشد، به‌جای آن استفاده می‌شود.
سپس رشتهٔ "\fI.lock\fR" اضافه می‌شود تا نام واقعی فایل قفل حاصل شود.
.IP "\fB\-q\fR"
هشدارها یا خطاها را در خروجی خطای استاندارد چاپ نمی‌کند. در داخل توسط liblockfile زمانی که
.B dotlockfile
را به‌عنوان یک برنامهٔ کمکی اجرا می‌کند، استفاده می‌شود.
.IP "\fB\-P\fR"
در صورت موفقیت در «قفل‌گذاری و اجرای دستور»، با وضعیت صفر خارج نشود، بلکه مقدار خروج دستور اجراشده را منتقل کند.
.IP lockfile
فایل قفلی که باید ایجاد یا حذف شود.
در صورت مشخص شدن گزینهٔ \fB\-m\fR نباید تعیین شود.
.IP "\fIcommand\fR argument \&...\&"
ایجاد فایل قفل، اجرای
.I command
، انتظار برای پایان یافتن آن، و سپس حذف فایل قفل.
.SH "مقدار بازگشتی (RETURN VALUE)"
صفر در صورت موفقیت، و غیر صفر در صورت شکست.
هنگام قفل کردن (حالت پیش‌فرض، یا با گزینهٔ \fB\-l\fR)،
.B dotlockfile
همان مقادیر تابع کتابخانه‌ای
.IR lockfile_create (3)
را بازمی‌گرداند.
باز کردن یک فایل قفل ناموجود، خطا به شمار نمی‌آید.
.PP
مگر اینکه گزینهٔ
.B \-P
مشخص شده باشد، هنگام اجرای یک دستور، مقدار بازگشتی با مقدار وضعیت خروج دستوری که اجرا شده است مطابقت ندارد. اگر قفل‌گذاری و باز کردن قفل موفقیت‌آمیز باشد، وضعیت خروج صفر خواهد بود.
.SH "نکات (NOTES)"
فایل قفل دقیقاً با همان نامی که در خط فرمان آمده است ایجاد می‌شود.
پسوند "\fI.lock\fR" به‌طور خودکار افزوده \fIنمی‌شود\fR.
.PP
این ابزار بسیار شبیه به ابزار
.IR lockfile (1)
ارائه‌شده به همراه
.IR procmail
و ابزار
.IR mutt_dotlock (1)
ارائه‌شده به همراه
.IR mutt
است. با این حال آرگومان‌های خط فرمان و همچنین وضعیت بازگشتی آن‌ها تفاوت دارد.
باور بر این است که
.I dotlockfile
انعطاف‌پذیرترین پیاده‌سازی است، چرا که به‌طور خودکار تشخیص می‌دهد چه زمانی برای قفل کردن یک صندوق پستی به امتیازات ویژه نیاز دارد، و این کار را با ایمنی کامل انجام می‌دهد.
.PP
صفحه راهنمای
.IR lockfile_create (3)
که در بالا ذکر شد، در بستهٔ
.I liblockfile\-dev
موجود است.
.SH "گزارش باگ‌ها (BUGS)"
هیچ موردی شناخته نشده است.
.SH "همچنین ببینید (SEE ALSO)"
.IR lockfile_create (3),
.IR maillock (3)
.SH "نویسندگان (AUTHORS)"
Miquel van Smoorenburg