نام (NAME)

lockfile-progs - برنامه‌های خط فرمان برای قفل و باز کردن امن فایل‌ها و صندوق‌های پستی (از طریق liblockfile)

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

mail-lock [--use-pid] [--retry retry-count]
mail-unlock
mail-touchlock [--oneshot]
lockfile-create [--use-pid] [--retry retry-count] [--lock-name] filename
lockfile-remove [--lock-name] filename
lockfile-touch [--oneshot] [--lock-name] filename
lockfile-check [--use-pid] [--lock-name] filename

توضیحات (DESCRIPTION)

مجموعه lockfile-progs شامل برنامه‌هایی است که می‌توانند برای قفل کردن و باز کردن امن صندوق‌های پستی و فایل‌ها (از طریق liblockfile) استفاده شوند:

mail-lock - قفل کردن صندوق پستی کاربر جاری
mail-unlock - باز کردن قفل صندوق پستی کاربر جاری
mail-touchlock - تمدید (touch) قفل صندوق پستی کاربر جاری
lockfile-create - قفل کردن یک فایل مشخص
lockfile-remove - حذف قفل یک فایل مشخص
lockfile-touch - تمدید (touch) قفل یک فایل مشخص
lockfile-check - بررسی وضعیت قفل یک فایل مشخص

به‌طور پیش‌فرض، آرگومان filename به نام فایلی اشاره دارد که باید قفل شود و نام فایل قفل نیز به‌صورت filename.lock خواهد بود. با این حال، اگر گزینه --lock-name مشخص شود، در آن صورت filename به‌عنوان نام خود فایل قفل در نظر گرفته می‌شود.

هر یک از دستورات قفل‌گذاری صندوق پستی تلاش می‌کنند مسیر /var/spool/mail/<user> را قفل کنند، که در آن <user> نام مرتبط با شناسه کاربری مؤثر (effective user ID) است و از طریق geteuid(2) تعیین می‌شود.

هنگامی که یک فایل قفل شد، قفل باید حداقل هر پنج دقیقه یک‌بار تمدید (touch) شود، در غیر این صورت قفل کهنه (stale) تلقی شده و تلاش‌های بعدی برای قفل‌گذاری موفق خواهند بود. همچنین گزینه --use-pid و صفحه راهنمای lockfile_create(3) را ببینید.

دستور lockfile-check بررسی می‌کند که آیا یک قفل معتبر از قبل وجود دارد یا خیر.

گزینه‌ها (OPTIONS)

--version

-q, --quiet

-v, --verbose

-l, --lock-name

-p, --use-pid

-o, --oneshot

-r retry-count, --retry retry-count

مثال‌ها (EXAMPLES)

قفل کردن یک فایل در طول یک فرآیند طولانی:

lockfile-create /some/file
lockfile-touch /some/file &
# ذخیره PID فرآیند lockfile-touch
BADGER="$!"
do-something-important-with /some/file
kill "${BADGER}"
lockfile-remove /some/file

وضعیت خروج (EXIT STATUS)

0

غیر از 0

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

maillock(3)
touchlock(3)
mailunlock(3)
lockfile_create(3)
lockfile_remove(3)
lockfile_touch(3)
lockfile_check(3)

نویسنده (AUTHOR)

نوشته‌شده توسط Rob Browning <rlb@defaultvalue.org>