.\" -*- 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 "PACTRANS 1" .TH PACTRANS 1 2025-12-04 pacutils pactrans .\" 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)" pactrans, pacinstall, pacremove \- نصب و حذف بسته‌های alpm .SH "خلاصه دستور (SYNOPSIS)" .IX Header "SYNOPSIS" .Vb 4 \& pactrans [options] ... \& pacinstall [options] ... \& pacremove [options] ... \& pactrans (\-\-help|\-\-version) .Ve .SH "توضیحات (DESCRIPTION)" .IX Header "DESCRIPTION" نصب یا حذف بسته‌های alpm. نام‌های مستعار \fBpacinstall\fR و \fBpacremove\fR برای سهولت کار ارائه شده‌اند و تنها تفاوت آن‌ها در تفسیر پیش‌فرض \fItargets\fR است. در غیر این صورت، این دستورها کاملاً یکسان عمل می‌کنند. .PP اگر \fIstdin\fR به یک ترمینال متصل نباشد، \fIpkgspec\fRها برای نصب یا حذف از \fIstdin\fR خوانده خواهند شد..SH "گزینه‌ها (OPTIONS)" .IX Header "OPTIONS" .SS "عملیات‌ها (Operations)" .IX Subsection "Operations" گزینه‌های عملیات بر تفسیر تمام هدف‌های پس از خود تا زمانی که گزینهٔ عملیات دیگری مشخص شود، اثر می‌گذارند. .IP "\fB\-\-spec\fR (پیش‌فرض \fBpactrans\fR)" 4 .IX Item "--spec (pactrans default)" تفسیر هدف‌های پس از این به عنوان \fIpkgspec\fR. اگر یک \fIpkgspec\fR نشان‌دهندهٔ یک فایل بسته یا یک بستهٔ مخزن باشد، نصب خواهد شد. اگر نشان‌دهندهٔ یک بسته در پایگاه‌دادهٔ محلی باشد، حذف خواهد شد. برای جزئیات مربوط به قالب به PKGSPEC مراجعه کنید. .IP "\fB\-\-install\fR (پیش‌فرض \fBpacinstall\fR)" 4 .IX Item "--install (pacinstall default)" تفسیر هدف‌های پس از این به عنوان بسته‌هایی که باید از یک مخزن نصب شوند. اگر فقط نام بسته مشخص شود، مخازن به همان ترتیبی که اعلان شده‌اند جستجو خواهند شد. .IP "\fB\-\-remove\fR (پیش‌فرض \fBpacremove\fR)" 4 .IX Item "--remove (pacremove default)" تفسیر هدف‌های پس از این به عنوان نام بسته‌هایی که باید حذف شوند. .IP \fB\-\-file\fR 4 .IX Item "--file" تفسیر هدف‌های پس از این به عنوان مسیرهای فایل‌های بسته جهت نصب. .IP \fB\-\-sysupgrade\fR 4 .IX Item "--sysupgrade" ارتقای بسته‌های نصب‌شده. .SS "گزینه‌های پیکربندی (Configuration Options)" .IX Subsection "Configuration Options" .IP \fB\-\-cachedir\fR=\fIpath\fR 4 .IX Item "--cachedir=path" تنظیم مسیر دایرکتوری حافظهٔ موقت (کَش) جایگزین. .IP \fB\-\-config\fR=\fIpath\fR 4 .IX Item "--config=path" تنظیم مسیر فایل پیکربندی جایگزین. .IP \fB\-\-dbext\fR=\fIextension\fR 4 .IX Item "--dbext=extension" تنظیم پسوند پایگاه‌دادهٔ همگام‌سازی جایگزین. .IP \fB\-\-dbpath\fR=\fIpath\fR 4 .IX Item "--dbpath=path" تنظیم مسیر پایگاه‌دادهٔ جایگزین. .IP \fB\-\-logfile\fR=\fIpath\fR 4 .IX Item "--logfile=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\-\-null\fR[=\fIsep\fR] 4 .IX Item "--null[=sep]" تنظیم جداکنندهٔ جایگزین برای مقادیر پردازش‌شده از \fIstdin\fR. به‌طور پیش‌فرض از خط جدید \f(CW\*(C`\en\*(C'\fR به عنوان جداکننده استفاده می‌شود. اگر \fB\-\-null\fR بدون مشخص کردن \fIsep\fR به کار رود، از \f(CW\*(C`NUL\*(C'\fR استفاده خواهد شد. .IP \fB\-\-debug\fR 4 .IX Item "--debug" نمایش اطلاعات اشکال‌زدایی بیشتر. .IP \fB\-\-print\-only\fR 4 .IX Item "--print-only" نمایش کارهایی که تراکنش انجام خواهد داد و خروج. .IP \fB\-\-no\-confirm\fR 4 .IX Item "--no-confirm" در نظر گرفتن پاسخ‌های پیش‌فرض برای همهٔ اعلان‌ها. .IP \fB\-\-no\-timeout\fR 4 .IX Item "--no-timeout" غیرفعال کردن مهلت زمانی سرعت پایین برای بارگیری‌ها. .IP \fB\-\-help\fR 4 .IX Item "--help" نمایش اطلاعات استفاده و خروج. .IP \fB\-\-version\fR 4 .IX Item "--version" نمایش اطلاعات نسخه و خروج. .SS "گزینه‌های تراکنش (Transaction Options)" .IX Subsection "Transaction Options" .IP \fB\-\-dbsync\fR 4 .IX Item "--dbsync" به‌روزرسانی پایگاه‌های دادهٔ همگام‌سازی پیش از انجام تراکنش. .IP \fB\-\-dbonly\fR 4 .IX Item "--dbonly" اعمال تغییرات در پایگاه‌داده بدون استخراج یا حذف واقعی بسته‌ها. .IP \fB\-\-nodeps\fR 4 .IX Item "--nodeps" نادیده گرفتن نسخهٔ وابستگی‌ها. برای نادیده گرفتن کامل بررسی‌های وابستگی، این گزینه را دو بار ارسال کنید. .IP \fB\-\-no\-scriptlet\fR 4 .IX Item "--no-scriptlet" اجرا نکردن اسکریپت‌های نصب بسته. .IP \fB\-\-no\-hooks\fR 4 .IX Item "--no-hooks" اجرا نکردن قلاب‌های (hook) تراکنش. .IP \fB\-\-assume\-installed\fR=\fIpackage\fR[=\fIversion\fR] 4 .IX Item "--assume-installed=package[=version]" رفتار به گونه‌ای که گویی \fIpackage\fR نصب شده است..SS "گزینه‌های ارتقای سیستم (Sysupgrade Options)" .IX Subsection "Sysupgrade Options" .IP \fB\-\-ignore\-pkg\fR=\fIpackage\fR 4 .IX Item "--ignore-pkg=package" نادیده گرفتن ارتقاها برای بستهٔ \fIpackage\fR. مقدار \fIpackage\fR می‌تواند یک الگوی سراسری به سبک پوسته (shell\-style glob pattern) باشد. .IP \fB\-\-ignore\-group\fR=\fIgroup\fR 4 .IX Item "--ignore-group=group" نادیده گرفتن ارتقاها برای تمام بسته‌های موجود در گروه \fIgroup\fR. مقدار \fIgroup\fR می‌تواند یک الگوی سراسری به سبک پوسته باشد. .SS "گزینه‌های \fB\-\-install\fP/\fB\-\-file\fP" .IX Subsection "--install/--file Options" .IP \fB\-\-as\-deps\fR 4 .IX Item "--as-deps" علامت‌گذاری تمام بسته‌های نصب‌شده به‌عنوان وابستگی. .IP \fB\-\-as\-explicit\fR 4 .IX Item "--as-explicit" علامت‌گذاری تمام بسته‌های نصب‌شده به‌عنوان صریحاً نصب‌شده. .IP \fB\-\-download\-only\fR 4 .IX Item "--download-only" بارگیری بسته‌ها بدون نصب واقعی آن‌ها. .SS "گزینه‌های \fB\-\-remove\fP" .IX Subsection "--remove Options" .IP \fB\-\-cascade\fR 4 .IX Item "--cascade" حذف نصب تمام بسته‌های نصب‌شده‌ای که به بسته‌ای که در حال حذف است وابسته‌اند. .IP \fB\-\-no\-backup\fR 4 .IX Item "--no-backup" ذخیره نکردن پشتیبان‌های \fI.pacsave\fR. .IP \fB\-\-recursive\fR 4 .IX Item "--recursive" حذف نصب هرگونه وابستگی بسته‌های در حال حذف که مورد نیاز هیچ بستهٔ دیگری نیستند. .IP \fB\-\-unneeded\fR 4 .IX Item "--unneeded" عدم حذف نصب هر بسته‌ای که توسط یک بستهٔ نصب‌شدهٔ دیگر مورد نیاز است. .SS "گزینه‌های رفتار اعلان‌ها (Prompt Disposition Options)" .IX Subsection "Prompt Disposition Options" .IP \fB\-\-resolve\-conflicts\fR=\fImethod\fR 4 .IX Item "--resolve-conflicts=method" انتخاب یک روش برای حل ناسازگاری‌ها و تداخل‌ها. مقادیر ممکن برای \fImethod\fR عبارت‌اند از: .RS 4 .ie n .IP """prompt""" 4 .el .IP \f(CWprompt\fR 4 .IX Item "prompt" اعلان به کاربر برای حذف بستهٔ ناسازگار نصب‌شده. .ie n .IP """none""" 4 .el .IP \f(CWnone\fR 4 .IX Item "none" عدم حذف هیچ‌کدام از بسته‌های ناسازگار. .ie n .IP """all""" 4 .el .IP \f(CWall\fR 4 .IX Item "all" حذف تمام بسته‌های ناسازگار. .ie n .IP """provided""" 4 .el .IP \f(CWprovided\fR 4 .IX Item "provided" حذف یک بستهٔ ناسازگار در صورتی که بستهٔ جدید آن را ارائه دهد (provide کند). .ie n .IP """depends""" 4 .el .IP \f(CWdepends\fR 4 .IX Item "depends" حذف یک بستهٔ ناسازگار در صورتی که به‌عنوان یک وابستگی نصب شده باشد. .ie n .IP """provided\-depends""" 4 .el .IP \f(CWprovided\-depends\fR 4 .IX Item "provided-depends" حذف یک بستهٔ ناسازگار در صورتی که به‌عنوان یک وابستگی نصب شده باشد و بستهٔ جدید آن را ارائه دهد. .RE .RS 4 .RE .IP \fB\-\-resolve\-replacements\fR=\fImethod\fR 4 .IX Item "--resolve-replacements=method" انتخاب یک روش برای مدیریت جایگزین‌ها. مقادیر ممکن برای \&\fImethod\fR عبارت‌اند از: .RS 4 .ie n .IP """prompt""" 4 .el .IP \f(CWprompt\fR 4 .IX Item "prompt" اعلان به کاربر برای جایگزینی بسته. .ie n .IP """none""" 4 .el .IP \f(CWnone\fR 4 .IX Item "none" عدم جایگزینی بسته‌ها. .ie n .IP """all""" 4 .el .IP \f(CWall\fR 4 .IX Item "all" انجام تمامی جایگزینی‌های موجود برای بسته‌ها. .ie n .IP """provided""" 4 .el .IP \f(CWprovided\fR 4 .IX Item "provided" انجام جایگزینی‌ها در مواردی که بستهٔ جدید، بستهٔ قدیمی را ارائه می‌دهد. .ie n .IP """depends""" 4 .el .IP \f(CWdepends\fR 4 .IX Item "depends" انجام جایگزینی‌ها در مواردی که بستهٔ قدیمی به‌عنوان وابستگی نصب شده باشد. .ie n .IP """provided\-depends""" 4 .el .IP \f(CWprovided\-depends\fR 4 .IX Item "provided-depends" انجام جایگزینی‌ها در مواردی که بستهٔ قدیمی به‌عنوان وابستگی نصب شده باشد و بستهٔ جدید بستهٔ قدیمی را ارائه دهد. .RE .RS 4 .RE .IP \fB\-\-install\-ignored\-packages\fR=\fIprompt|yes|no\fR 4 .IX Item "--install-ignored-packages=prompt|yes|no" تعیین رفتار در برابر اعلان‌های نصب بسته‌های نادیده‌گرفته‌شده. .IP \fB\-\-delete\-corrupt\-files\fR=\fIprompt|yes|no\fR 4 .IX Item "--delete-corrupt-files=prompt|yes|no" تعیین رفتار در برابر اعلان‌های حذف بسته‌های خراب. .IP \fB\-\-use\-first\-provider\fR=\fIprompt|yes|no\fR 4 .IX Item "--use-first-provider=prompt|yes|no" تعیین رفتار در برابر اعلان‌های انتخاب یک ارائه‌دهنده (provider). در صورت تنظیم روی \f(CW\*(C`yes\*(C'\fR، اولین ارائه‌دهندهٔ موجود انتخاب خواهد شد. .IP \fB\-\-skip\-unresolvable\fR=\fIprompt|yes|no\fR 4 .IX Item "--skip-unresolvable=prompt|yes|no" تعیین رفتار در برابر اعلان‌های صرف‌نظر از بسته‌های دارای وابستگی‌های غیرقابل‌حل. .IP \fB\-\-import\-pgp\-keys\fR=\fIprompt|yes|no\fR 4 .IX Item "--import-pgp-keys=prompt|yes|no" تعیین رفتار در برابر اعلان‌های وارد کردن (import) کلیدهای PGP مفقود. .IP \fB\-\-yolo\fR 4 .IX Item "--yolo" تنظیم تمام گزینه‌های رفتار اعلان روی مقدار \f(CW\*(C`all\*(C'\fR یا \f(CW\*(C`yes\*(C'\fR و فعال‌سازی \&\fB\-\-no\-confirm\fR. .PP نکته: صرف‌نظر از گزینه‌های رفتار اعلانِ انتخاب‌شده، برای موفقیت تراکنش تمام وابستگی‌ها همچنان باید برآورده شوند، مگر اینکه از \fB\-\-nodeps\fR نیز استفاده شده باشد..SH "مشخصه بسته (PKGSPEC)" .IX Header "PKGSPEC" یک \fIpkgspec\fR رشته‌ای است که می‌تواند یک بستهٔ مشخص را شناسایی کند. قالب‌های پذیرفته‌شده عبارت‌اند از: .IP / 4 .IX Item "/" .Vb 2 \& core/pacman \& local/pacman .Ve .IP :// 4 .IX Item "://" .Vb 1 \& file:///var/cache/pacman/pkg/pacman\-4.1.0\-1\-x86_64.pkg.tar.xz .Ve .SH "مثال‌ها (EXAMPLES)" .IX Header "EXAMPLES" .IP "جایگزینی \fIfoo\fR با \fIbar\fR" 4 .IX Item "Replace foo with bar" .Vb 1 \& pactrans local/foo baz/bar .Ve .Sp یا، در صورتی که مخزن \fIbar\fR نامشخص باشد: .Sp .Vb 1 \& pacinstall bar \-\-remove foo .Ve .IP "نصب \fIfoo\fR و \fIbar\fR:" 4 .IX Item "Install foo and bar:" .Vb 1 \& pactrans \-\-install foo bar .Ve .SH "هشدارها (CAVEATS)" .IX Header "CAVEATS" دستور \&\fBpactrans\fR با یک بررسی ساده از طریق \fBisatty\fR\|(3) تعیین می‌کند که آیا \&\fIpkgspec\fRها را از \fIstdin\fR بخواند یا خیر. اگر \fBpactrans\fR در محیطی مانند یک تابع پوسته یا اسکریپتی که در خط لوله (pipe) قرار دارد فراخوانی شود که در آن \&\fIstdin\fR به ترمینال متصل نیست اما حاوی \fIpkgspec\fRی برای نصب یا حذف نمی‌باشد، \&\fBpactrans\fR باید با \fIstdin\fR بسته فراخوانی شود. برای پوسته‌های سازگار با POSIX، این کار را می‌توان با \f(CW\*(C`<&\-\*(C'\fR انجام داد.