.\" -*- mode: troff; coding: utf-8 -*-
.\" Automatically generated by Pod::Man v6.0.2 (Pod::Simple 3.45)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
.ie n \{\
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{\
.    if \nF \{\
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{\
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\"
.\" Required to disable full justification in groff 1.23.0.
.if n .ds AD l
.\" ========================================================================
.\"
.IX Title "PACLOCK 1"
.TH PACLOCK 1 2025-12-04 pacutils paclock
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH "نام (NAME)"
paclock \- قفل کردن یا باز کردن قفل پایگاه‌داده alpm
.SH "خلاصه دستور (SYNOPSIS)"
.IX Header "SYNOPSIS"
.Vb 2
\& paclock [options]
\& paclock (\-\-help|\-\-version)
.Ve
.SH "توضیحات (DESCRIPTION)"
.IX Header "DESCRIPTION"
قفل کردن و آزادسازی ایمن پایگاه‌داده ALPM با استفاده از کلیدهای شناسایی برای اسکریپت‌ها.
.SH "گزینه‌ها (OPTIONS)"
.IX Header "OPTIONS"
.IP \fB\-\-config\fR=\fIpath\fR 4
.IX Item "--config=path"
تنظیم یک مسیر جایگزین برای فایل پیکربندی.
.IP \fB\-\-lockfile\fR=\fIpath\fR 4
.IX Item "--lockfile=path"
تنظیم یک مسیر جایگزین برای فایل قفل.
.IP \fB\-\-root\fR=\fIpath\fR 4
.IX Item "--root=path"
تنظیم یک ریشه نصب جایگزین.
.IP \fB\-\-sysroot\fR=\fIpath\fR 4
.IX Item "--sysroot=path"
تنظیم یک ریشه سیستم جایگزین. بخش \fBpacutils\-sysroot\fR\|(7) را ببینید.
.IP \fB\-\-lock\fR 4
.IX Item "--lock"
قفل کردن پایگاه‌داده (پیش‌فرض).
.IP \fB\-\-unlock\fR 4
.IX Item "--unlock"
باز کردن قفل پایگاه‌داده.
.IP \fB\-\-run\fR 4
.IX Item "--run"
در نظر گرفتن \f(CW\*(C`argv\*(C'\fR به عنوان دستوری که باید با پایگاه‌داده قفل‌شده اجرا شود. اگر دستور مقداری غیر از صفر بازگرداند، فایل قفل برای نشان دادن خطا در جای خود باقی خواهد ماند مگر اینکه از \fB\-\-fail\-ok\fR استفاده شود.
.IP \fB\-\-fail\-ok\fR 4
.IX Item "--fail-ok"
باز کردن قفل پایگاه‌داده پس از اجرای یک دستور با \fB\-\-run\fR حتی اگر دستور مقداری غیر از صفر بازگرداند. به‌طور کلی، در صورتی که پایگاه‌داده در وضعیتی ناهمگون باشد، باید قفل باقی بماند تا نشان دهد که ممکن است نیاز به تعمیر داشته باشد. این پرچم در درجه اول برای عملیات فقط‌خواندنی در نظر گرفته شده است.
.IP \fB\-\-print\fR 4
.IX Item "--print"
نوشتن مسیر فایل قفل در \fIstdout\fR و خروج بدون تغییر دادن فایل قفل.
.IP \fB\-\-no\-check\-keys\fR 4
.IX Item "--no-check-keys"
صرف‌نظر کردن از بررسی تطابق کلید شناسایی پیش از باز کردن قفل.
.IP \fB\-\-enoent\-ok\fR 4
.IX Item "--enoent-ok"
خطا در نظر نگرفتن عدم وجود فایل قفل هنگام باز کردن قفل.
.IP \fB\-\-key\fR=\fIidentity\fR 4
.IX Item "--key=identity"
شناسه‌ای برای نوشتن در فایل قفل. به‌طور پیش‌فرض، \fB\-\-unlock\fR تنها در صورتی عمل می‌کند که فایل قفل قبلاً با همان کلید قفل شده باشد. مقدار پیش‌فرض شامل hostname و به‌دنبال آن دو‌نقطه و شناسه فرایند (PID) فراخواننده است (برای مثال: \&\f(CW\*(C`localhost:123\*(C'\fR).
.IP \fB\-\-help\fR 4
.IX Item "--help"
نمایش اطلاعات نحوه استفاده و خروج.
.IP \fB\-\-version\fR 4
.IX Item "--version"
نمایش اطلاعات نگارش و خروج.
.SH "مثال‌ها (EXAMPLES)"
.IX Header "EXAMPLES"
پیکربندی سیستمی که \fBpaclock\fR برای ساخت مسیر پیش‌فرض فایل قفل و کلید شناسایی به آن وابسته است ممکن است بین دفعات فراخوانی تغییر کند. برای اطمینان از یکپارچگی، اسکریپت‌ها باید هر بار که \fBpaclock\fR فراخوانی می‌شود، مسیر و کلید مورد استفاده را به‌صراحت مشخص کنند.
.PP
.Vb 6
\& #!/bin/bash
\& lock_file="$(paclock \-\-print)"
\& lock_key="myapp:$(hostname):$$"
\& paclock \-\-lockfile="$lock_file" \-\-key="$lock_key" || exit 1
\& echo "do stuff here"
\& paclock \-\-lockfile="$lock_file" \-\-key="$lock_key" \-\-unlock || exit 1
.Ve
.PP
اجرای دستوری که فاقد پشتیبانی بومی از قفل است:
.PP
.Vb 1
\& paclock \-\-run \-\- paccache \-\-dryrun \-\-verbose
.Ve
.SH "همچنین ببینید (SEE ALSO)"
.IX Header "SEE ALSO"
\&\fBpacconf\fR\|(1)