نام (NAME)

pactrans, pacinstall, pacremove - نصب و حذف بسته‌های alpm

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

pactrans   [options] <target>...
pacinstall [options] <target>...
pacremove  [options] <target>...
pactrans   (--help|--version)

توضیحات (DESCRIPTION)

نصب یا حذف بسته‌های alpm. نام‌های مستعار pacinstall و pacremove برای سهولت کار ارائه شده‌اند و تنها تفاوت آن‌ها در تفسیر پیش‌فرض targets است. در غیر این صورت، این دستورها کاملاً یکسان عمل می‌کنند.

اگر stdin به یک ترمینال متصل نباشد، pkgspecها برای نصب یا حذف از stdin خوانده خواهند شد..SH "گزینه‌ها (OPTIONS)"

عملیات‌ها (Operations)

گزینه‌های عملیات بر تفسیر تمام هدف‌های پس از خود تا زمانی که گزینهٔ عملیات دیگری مشخص شود، اثر می‌گذارند.

--spec (پیش‌فرض pactrans): تفسیر هدف‌های پس از این به عنوان pkgspec. اگر یک pkgspec نشان‌دهندهٔ یک فایل بسته یا یک بستهٔ مخزن باشد، نصب خواهد شد. اگر نشان‌دهندهٔ یک بسته در پایگاه‌دادهٔ محلی باشد، حذف خواهد شد. برای جزئیات مربوط به قالب به PKGSPEC مراجعه کنید.
--install (پیش‌فرض pacinstall): تفسیر هدف‌های پس از این به عنوان بسته‌هایی که باید از یک مخزن نصب شوند. اگر فقط نام بسته مشخص شود، مخازن به همان ترتیبی که اعلان شده‌اند جستجو خواهند شد.
--remove (پیش‌فرض pacremove): تفسیر هدف‌های پس از این به عنوان نام بسته‌هایی که باید حذف شوند.
--file: تفسیر هدف‌های پس از این به عنوان مسیرهای فایل‌های بسته جهت نصب.
--sysupgrade: ارتقای بسته‌های نصب‌شده.

گزینه‌های پیکربندی (Configuration Options)

--cachedir=path: تنظیم مسیر دایرکتوری حافظهٔ موقت (کَش) جایگزین.
--config=path: تنظیم مسیر فایل پیکربندی جایگزین.
--dbext=extension: تنظیم پسوند پایگاه‌دادهٔ همگام‌سازی جایگزین.
--dbpath=path: تنظیم مسیر پایگاه‌دادهٔ جایگزین.
--logfile=path: تنظیم مسیر فایل گزارش (لاگ) جایگزین.
--root=path: تنظیم ریشهٔ نصب جایگزین.
--sysroot=path: تنظیم ریشهٔ سیستم جایگزین. pacutils-sysroot(7) را ببینید.
--null[=sep]: تنظیم جداکنندهٔ جایگزین برای مقادیر پردازش‌شده از stdin. به‌طور پیش‌فرض از خط جدید "\n" به عنوان جداکننده استفاده می‌شود. اگر --null بدون مشخص کردن sep به کار رود، از "NUL" استفاده خواهد شد.
--debug: نمایش اطلاعات اشکال‌زدایی بیشتر.
--print-only: نمایش کارهایی که تراکنش انجام خواهد داد و خروج.
--no-confirm: در نظر گرفتن پاسخ‌های پیش‌فرض برای همهٔ اعلان‌ها.
--no-timeout: غیرفعال کردن مهلت زمانی سرعت پایین برای بارگیری‌ها.
--help: نمایش اطلاعات استفاده و خروج.
--version: نمایش اطلاعات نسخه و خروج.

گزینه‌های تراکنش (Transaction Options)

--dbsync: به‌روزرسانی پایگاه‌های دادهٔ همگام‌سازی پیش از انجام تراکنش.
--dbonly: اعمال تغییرات در پایگاه‌داده بدون استخراج یا حذف واقعی بسته‌ها.
--nodeps: نادیده گرفتن نسخهٔ وابستگی‌ها. برای نادیده گرفتن کامل بررسی‌های وابستگی، این گزینه را دو بار ارسال کنید.
--no-scriptlet: اجرا نکردن اسکریپت‌های نصب بسته.
--no-hooks: اجرا نکردن قلاب‌های (hook) تراکنش.
--assume-installed=package[=version]: رفتار به گونه‌ای که گویی package نصب شده است..SS "گزینه‌های ارتقای سیستم (Sysupgrade Options)"
--ignore-pkg=package: نادیده گرفتن ارتقاها برای بستهٔ package. مقدار package می‌تواند یک الگوی سراسری به سبک پوسته (shell-style glob pattern) باشد.
--ignore-group=group: نادیده گرفتن ارتقاها برای تمام بسته‌های موجود در گروه group. مقدار group می‌تواند یک الگوی سراسری به سبک پوسته باشد.

گزینه‌های --install/--file

--as-deps: علامت‌گذاری تمام بسته‌های نصب‌شده به‌عنوان وابستگی.
--as-explicit: علامت‌گذاری تمام بسته‌های نصب‌شده به‌عنوان صریحاً نصب‌شده.
--download-only: بارگیری بسته‌ها بدون نصب واقعی آن‌ها.

گزینه‌های --remove

--cascade: حذف نصب تمام بسته‌های نصب‌شده‌ای که به بسته‌ای که در حال حذف است وابسته‌اند.
--no-backup: ذخیره نکردن پشتیبان‌های .pacsave.
--recursive: حذف نصب هرگونه وابستگی بسته‌های در حال حذف که مورد نیاز هیچ بستهٔ دیگری نیستند.
--unneeded: عدم حذف نصب هر بسته‌ای که توسط یک بستهٔ نصب‌شدهٔ دیگر مورد نیاز است.

گزینه‌های رفتار اعلان‌ها (Prompt Disposition Options)

--resolve-conflicts=method: انتخاب یک روش برای حل ناسازگاری‌ها و تداخل‌ها. مقادیر ممکن برای method عبارت‌اند از:

"prompt": اعلان به کاربر برای حذف بستهٔ ناسازگار نصب‌شده.
"none": عدم حذف هیچ‌کدام از بسته‌های ناسازگار.
"all": حذف تمام بسته‌های ناسازگار.
"provided": حذف یک بستهٔ ناسازگار در صورتی که بستهٔ جدید آن را ارائه دهد (provide کند).
"depends": حذف یک بستهٔ ناسازگار در صورتی که به‌عنوان یک وابستگی نصب شده باشد.
"provided-depends": حذف یک بستهٔ ناسازگار در صورتی که به‌عنوان یک وابستگی نصب شده باشد و بستهٔ جدید آن را ارائه دهد.

--resolve-replacements=method: انتخاب یک روش برای مدیریت جایگزین‌ها. مقادیر ممکن برای method عبارت‌اند از:

"prompt": اعلان به کاربر برای جایگزینی بسته.
"none": عدم جایگزینی بسته‌ها.
"all": انجام تمامی جایگزینی‌های موجود برای بسته‌ها.
"provided": انجام جایگزینی‌ها در مواردی که بستهٔ جدید، بستهٔ قدیمی را ارائه می‌دهد.
"depends": انجام جایگزینی‌ها در مواردی که بستهٔ قدیمی به‌عنوان وابستگی نصب شده باشد.
"provided-depends": انجام جایگزینی‌ها در مواردی که بستهٔ قدیمی به‌عنوان وابستگی نصب شده باشد و بستهٔ جدید بستهٔ قدیمی را ارائه دهد.

--install-ignored-packages=prompt|yes|no: تعیین رفتار در برابر اعلان‌های نصب بسته‌های نادیده‌گرفته‌شده.
--delete-corrupt-files=prompt|yes|no: تعیین رفتار در برابر اعلان‌های حذف بسته‌های خراب.
--use-first-provider=prompt|yes|no: تعیین رفتار در برابر اعلان‌های انتخاب یک ارائه‌دهنده (provider). در صورت تنظیم روی "yes"، اولین ارائه‌دهندهٔ موجود انتخاب خواهد شد.
--skip-unresolvable=prompt|yes|no: تعیین رفتار در برابر اعلان‌های صرف‌نظر از بسته‌های دارای وابستگی‌های غیرقابل‌حل.
--import-pgp-keys=prompt|yes|no: تعیین رفتار در برابر اعلان‌های وارد کردن (import) کلیدهای PGP مفقود.
--yolo: تنظیم تمام گزینه‌های رفتار اعلان روی مقدار "all" یا "yes" و فعال‌سازی --no-confirm.

نکته: صرف‌نظر از گزینه‌های رفتار اعلانِ انتخاب‌شده، برای موفقیت تراکنش تمام وابستگی‌ها همچنان باید برآورده شوند، مگر اینکه از --nodeps نیز استفاده شده باشد..SH "مشخصه بسته (PKGSPEC)" یک pkgspec رشته‌ای است که می‌تواند یک بستهٔ مشخص را شناسایی کند. قالب‌های پذیرفته‌شده عبارت‌اند از:

<repository>/<package>

core/pacman
local/pacman

<proto>://<path/to/package/file>

file:///var/cache/pacman/pkg/pacman-4.1.0-1-x86_64.pkg.tar.xz

مثال‌ها (EXAMPLES)

جایگزینی foo با bar

pactrans local/foo baz/bar

یا، در صورتی که مخزن bar نامشخص باشد:

pacinstall bar --remove foo

نصب foo و bar:

pactrans --install foo bar

هشدارها (CAVEATS)

دستور pactrans با یک بررسی ساده از طریق isatty(3) تعیین می‌کند که آیا pkgspecها را از stdin بخواند یا خیر. اگر pactrans در محیطی مانند یک تابع پوسته یا اسکریپتی که در خط لوله (pipe) قرار دارد فراخوانی شود که در آن stdin به ترمینال متصل نیست اما حاوی pkgspecی برای نصب یا حذف نمی‌باشد، pactrans باید با stdin بسته فراخوانی شود. برای پوسته‌های سازگار با POSIX، این کار را می‌توان با "<&-" انجام داد.

2025-12-04

pacutils