'\" t .\" Title: pacman .\" Author: [see the "Authors" section] .\" Generator: DocBook XSL Stylesheets vsnapshot .\" Date: 2022-11-21 .\" Manual: راهنمای Pacman .\" Source: Pacman 6.0.2 .\" Language: Persian .\" .TH "PACMAN" "8" "2022\-11\-21" "Pacman 6\&.0\&.2" "راهنمای Pacman" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .\" http://bugs.debian.org/507673 .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" ----------------------------------------------------------------- .\" * set default formatting .\" ----------------------------------------------------------------- .\" disable hyphenation .nh .\" disable justification (adjust text to left margin only) .ad l .\" ----------------------------------------------------------------- .\" * MAIN CONTENT STARTS HERE * .\" ----------------------------------------------------------------- .SH "نام (NAME)" pacman \- ابزار مدیریت بسته‌ها .SH "خلاصه دستور (SYNOPSIS)" .sp \fIpacman\fR [options] [targets] .SH "توضیحات (DESCRIPTION)" .sp پک‌من (Pacman) یک ابزار مدیریت بسته‌ها است که بسته‌های نصب‌شده را روی سیستم لینوکس ردیابی می‌کند\&. این ابزار از وابستگی‌ها، گروه‌های بسته‌ها، اسکریپت‌های نصب و حذف، و قابلیت همگام‌سازی دستگاه محلی شما با یک مخزن راه دور برای ارتقای خودکار بسته‌ها پشتیبانی می‌کند\&. بسته‌های Pacman در قالب tar فشرده‌شده با zip (یا سایر الگوریتم‌های فشرده‌سازی) هستند\&. .sp از نسخه ۳\&.۰\&.۰ به بعد، pacman رابط کاربری خط فرمانی (front\-end) برای \fBlibalpm\fR(3)، کتابخانه \(lqمدیریت بسته‌های آرچ لینوکس\(rq بوده است\&. این کتابخانه اجازه می‌دهد رابط‌های کاربری جایگزین (به عنوان مثال، یک رابط گرافیکی) نوشته شوند\&. .sp اجرای pacman شامل مشخص کردن یک عمل (operation) به همراه هرگونه گزینه و هدف مورد نظر برای اجرا است\&. یک \fItarget\fR معمولاً یک نام بسته، نام فایل، نشانی اینترنتی (URL) یا یک رشته جستجو است\&. هدف‌ها می‌توانند به صورت آرگومان‌های خط فرمان ارائه شوند\&. علاوه بر این، اگر stdin از یک ترمینال نباشد و یک خط تیره منفرد (\-) به عنوان آرگومان داده شود، هدف‌ها از ورودی استاندارد (stdin) خوانده خواهند شد\&. .SH "عملیات‌ها (OPERATIONS)" .PP \fB\-D, \-\-database\fR .RS 4 عملیات روی پایگاه داده بسته‌ها\&. این عمل به شما امکان می‌دهد برخی از ویژگی‌های بسته‌های نصب‌شده را در پایگاه داده pacman تغییر دهید\&. همچنین به شما امکان می‌دهد پایگاه‌های داده را برای سازگاری درونی بررسی کنید\&. بخش گزینه‌های پایگاه داده (Database Options) در زیر را ببینید\&. .RE .PP \fB\-Q, \-\-query\fR .RS 4 پرس‌وجو در پایگاه داده بسته‌ها\&. این عمل به شما امکان می‌دهد بسته‌های نصب‌شده و فایل‌های آن‌ها و همچنین فراداده‌های مربوط به هر بسته (وابستگی‌ها، تداخل‌ها، تاریخ نصب، تاریخ ساخت، اندازه) را مشاهده کنید\&. این عمل می‌تواند روی پایگاه داده محلی بسته‌ها اجرا شود یا روی فایل‌های بسته منفرد استفاده شود\&. در حالت اول، اگر هیچ نام بسته‌ای در خط فرمان ارائه نشود، تمام بسته‌های نصب‌شده مورد پرس‌وجو قرار می‌گیرند\&. علاوه بر این، فیلترهای گوناگونی را می‌توان روی فهرست بسته‌ها اعمال کرد\&. بخش گزینه‌های پرس‌وجو (Query Options) در زیر را ببینید\&. .RE .PP \fB\-R, \-\-remove\fR .RS 4 حذف بسته(ها) از سیستم\&. گروه‌ها نیز می‌توانند برای حذف مشخص شوند، که در این صورت هر بسته درون آن گروه حذف خواهد شد\&. فایل‌های متعلق به بسته مشخص‌شده حذف خواهند شد و پایگاه داده به‌روزرسانی می‌شود\&. بیشتر فایل‌های پیکربندی با پسوند \fI\&.pacsave\fR ذخیره می‌شوند، مگر اینکه از گزینه \fI\-\-nosave\fR استفاده شود\&. بخش گزینه‌های حذف (Remove Options) در زیر را ببینید\&. .RE .PP \fB\-S, \-\-sync\fR .RS 4 همگام‌سازی بسته‌ها\&. بسته‌ها مستقیماً از مخازن راه دور نصب می‌شوند، شامل تمام وابستگی‌های مورد نیاز برای اجرای بسته‌ها\&. برای مثال، \fBpacman \-S qt\fR بسته qt و تمام بسته‌هایی را که به آن‌ها وابسته است دانلود و نصب می‌کند\&. اگر نام یک بسته در بیش از یک مخزن وجود داشته باشد، مخزن را می‌توان به صراحت برای شفاف‌سازی بسته مورد نظر برای نصب مشخص کرد: \fBpacman \-S testing/qt\fR\&. همچنین می‌توانید پیش‌نیازهای نسخه را مشخص کنید: \fBpacman \-S "bash>=3\&.2"\fR\&. استفاده از گیومه لازم است، در غیر این صورت پوسته ">" را به عنوان تغییر مسیر به یک فایل تفسیر می‌کند\&. .sp علاوه بر بسته‌ها، گروه‌ها نیز می‌توانند مشخص شوند\&. برای مثال، اگر gnome یک گروه بسته تعریف‌شده باشد، دستور \fBpacman \-S gnome\fR یک اعلان ارائه می‌دهد که به شما امکان می‌دهد بسته‌های مورد نظر را برای نصب از یک فهرست شماره‌گذاری‌شده انتخاب کنید\&. انتخاب بسته‌ها با استفاده از فهرستی از شماره‌های بسته‌ها که با فاصله و/یا کاما از هم جدا شده‌اند مشخص می‌شود\&. بسته‌های متوالی را می‌توان با مشخص کردن شماره اولین و آخرین بسته که با یک خط تیره (\-) از هم جدا شده‌اند انتخاب کرد\&. مستثنی کردن بسته‌ها با قرار دادن یک کلاهک (^) در ابتدای یک شماره یا محدوده‌ای از شماره‌ها انجام می‌شود\&. .sp بسته‌هایی که بسته‌های دیگر را ارائه (provide) می‌دهند نیز مدیریت می‌شوند\&. برای مثال، \fBpacman \-S foo\fR ابتدا به دنبال یک بسته foo می‌گردد\&. اگر foo پیدا نشود، بسته‌هایی که همان کارایی foo را ارائه می‌دهند جستجو خواهند شد\&. اگر بسته‌ای پیدا شود، نصب خواهد شد\&. در صورتی که چندین بسته ارائه‌دهنده foo یافت شوند، یک اعلان برای انتخاب ارائه می‌شود\&. .sp شما همچنین می‌توانید از \fBpacman \-Su\fR برای ارتقای تمام بسته‌های قدیمی استفاده کنید\&. بخش گزینه‌های همگام‌سازی (Sync Options) در زیر را ببینید\&. هنگام ارتقا، pacman مقایسه نسخه‌ها را برای تعیین اینکه کدام بسته‌ها به ارتقا نیاز دارند انجام می‌دهد\&. این رفتار به صورت زیر عمل می‌کند: .sp .if n \{\ .RS 4 .\} .nf حرفی\-عددی (Alphanumeric): 1\&.0a < 1\&.0b < 1\&.0beta < 1\&.0p < 1\&.0pre < 1\&.0rc < 1\&.0 < 1\&.0\&.a < 1\&.0\&.1 عددی (Numeric): 1 < 1\&.0 < 1\&.1 < 1\&.1\&.1 < 1\&.2 < 2\&.0 < 3\&.0\&.0 .fi .if n \{\ .RE .\} .sp علاوه بر این، رشته‌های نسخه می‌توانند دارای یک مقدار \fIepoch\fR تعریف‌شده باشند که بر هر مقایسه نسخه‌ای اولویت دارد، مگر اینکه مقادیر epoch برابر باشند\&. این مقدار در قالب \fIepoch:version\-rel\fR مشخص می‌شود\&. برای مثال، \fB2:1\&.0\-1\fR همیشه بزرگ‌تر از \fB1:3\&.6\-1\fR است\&. .RE .PP \fB\-T, \-\-deptest\fR .RS 4 بررسی وابستگی‌ها؛ این گزینه در اسکریپت‌هایی مانند makepkg برای بررسی بسته‌های نصب‌شده مفید است\&. این عمل هر وابستگی مشخص‌شده را بررسی می‌کند و فهرستی از وابستگی‌هایی را که در حال حاضر روی سیستم برآورده نشده‌اند بازمی‌گرداند\&. این عمل هیچ گزینه دیگری را نمی‌پذیرد\&. نمونه کاربرد: \fBpacman \-T qt "bash>=3\&.2"\fR\&. .RE .PP \fB\-U, \-\-upgrade\fR .RS 4 ارتقا یا افزودن بسته(ها) به سیستم و نصب وابستگی‌های مورد نیاز از مخازن همگام‌سازی\&. یک نشانی اینترنتی (URL) یا یک مسیر فایل می‌تواند مشخص شود\&. این یک فرایند \(lqحذف و سپس افزودن\(rq است\&. بخش گزینه‌های ارتقا (Upgrade Options) در زیر را ببینید؛ همچنین بخش مدیریت فایل‌های پیکربندی (Handling Config Files) را برای توضیحی درباره نحوه مراقبت pacman از فایل‌های پیکربندی ببینید\&. .RE .PP \fB\-F, \-\-files\fR .RS 4 پرس‌وجو در پایگاه داده فایل‌ها\&. این عمل به شما امکان می‌دهد بسته‌هایی را که مالک فایل‌های خاصی هستند جستجو کنید یا فایل‌های متعلق به بسته‌های خاصی را نمایش دهید\&. فقط بسته‌هایی که بخشی از پایگاه‌های داده همگام‌سازی شما هستند جستجو می‌شوند\&. بخش گزینه‌های فایل (File Options) در زیر را ببینید\&. .RE .PP \fB\-V, \-\-version\fR .RS 4 نمایش نسخه و خروج\&. .RE .PP \fB\-h, \-\-help\fR .RS 4 نمایش ساختار دستوری برای عمل داده‌شده\&. اگر هیچ عملی داده نشود، ساختار دستوری کلی نشان داده می‌شود\&. .RE .SH "گزینه‌ها (OPTIONS)" .PP \fB\-b, \-\-dbpath\fR .RS 4 مشخص کردن یک مکان جایگزین برای پایگاه داده (پیش‌فرض /var/lib/pacman است)\&. این گزینه نباید استفاده شود مگر اینکه بدانید چه کاری انجام می‌دهید\&. \fBنکته\fR: در صورت مشخص شدن، این یک مسیر مطلق است و مسیر ریشه به طور خودکار به ابتدای آن اضافه نمی‌شود\&. .RE .PP \fB\-r, \-\-root\fR .RS 4 مشخص کردن یک ریشه نصب جایگزین (پیش‌فرض / است)\&. این گزینه نباید به عنوان روشی برای نصب نرم‌افزار در /usr/local به جای /usr استفاده شود\&. \fBنکته\fR: اگر مسیر پایگاه داده یا فایل گزارش در خط فرمان یا در \fBpacman.conf\fR(5) مشخص نشده باشند، مکان پیش‌فرض آن‌ها درون این مسیر ریشه خواهد بود\&. \fBنکته\fR: این گزینه برای انجام عملیات روی یک سیستم مهمان سوارشده (mounted) مناسب نیست\&. به جای آن \fI\-\-sysroot\fR را ببینید\&. .RE .PP \fB\-v, \-\-verbose\fR .RS 4 خروجی دادن مسیرهایی مانند ریشه (Root)، فایل پیکربندی (Conf File)، مسیر پایگاه داده (DB Path)، دایرکتوری‌های حافظه نهان (Cache Dirs) و غیره\&. .RE .PP \fB\-\-arch\fR .RS 4 مشخص کردن یک معماری جایگزین\&. .RE .PP \fB\-\-cachedir\fR .RS 4 مشخص کردن یک مکان جایگزین برای حافظه نهان بسته‌ها (پیش‌فرض /var/cache/pacman/pkg است)\&. چندین دایرکتوری حافظه نهان را می‌توان مشخص کرد، و آن‌ها به ترتیبی که به pacman داده شده‌اند امتحان می‌شوند\&. \fBنکته\fR: این یک مسیر مطلق است و مسیر ریشه به طور خودکار به ابتدای آن اضافه نمی‌شود\&. .RE .PP \fB\-\-color\fR .RS 4 مشخص کردن زمان فعال‌سازی رنگ‌آمیزی\&. گزینه‌های معتبر عبارتند از: \fIalways\fR، \fInever\fR، یا \fIauto\fR\&. گزینه \fIalways\fR رنگ‌ها را اجباراً فعال می‌کند؛ \fInever\fR رنگ‌ها را اجباراً غیرفعال می‌کند؛ و \fIauto\fR تنها هنگامی که خروجی به یک tty هدایت شود رنگ‌ها را به طور خودکار فعال می‌سازد\&. .RE .PP \fB\-\-config\fR .RS 4 مشخص کردن یک فایل پیکربندی جایگزین\&. .RE .PP \fB\-\-debug\fR .RS 4 نمایش پیام‌های اشکال‌زدایی (debug)\&. هنگام گزارش باگ‌ها، توصیه می‌شود از این گزینه استفاده شود\&. .RE .PP \fB\-\-gpgdir\fR .RS 4 مشخص کردن دایرکتوری حاوی فایل‌های مورد استفاده GnuPG برای بررسی امضای بسته‌ها (پیش‌فرض /etc/pacman\&.d/gnupg است)\&. این دایرکتوری باید شامل دو فایل باشد: pubring\&.gpg و trustdb\&.gpg\&. فایل pubring\&.gpg کلیدهای عمومی تمام بسته‌سازان را نگه می‌دارد\&. فایل trustdb\&.gpg حاوی پایگاه داده به اصطلاح اعتبار است که مشخص می‌کند کلیدها اصیل و قابل اعتماد هستند\&. \fBنکته\fR: این یک مسیر مطلق است و مسیر ریشه به طور خودکار به ابتدای آن اضافه نمی‌شود\&. .RE .PP \fB\-\-hookdir\fR .RS 4 مشخص کردن یک دایرکتوری جایگزین حاوی فایل‌های قلاب (hook) (پیش‌فرض /etc/pacman\&.d/hooks است)\&. چندین دایرکتوری قلاب را می‌توان مشخص کرد که قلاب‌های موجود در دایرکتوری‌های بعدی نسبت به قلاب‌های دایرکتوری‌های قبلی اولویت خواهند داشت\&. \fBنکته\fR: این یک مسیر مطلق است و مسیر ریشه به طور خودکار به ابتدای آن اضافه نمی‌شود\&. .RE .PP \fB\-\-logfile\fR .RS 4 مشخص کردن یک فایل گزارش (log) جایگزین\&. این یک مسیر مطلق است، صرف نظر از تنظیمات ریشه نصب\&. .RE .PP \fB\-\-noconfirm\fR .RS 4 نادیده گرفتن هرگونه پیام \(lqآیا مطمئن هستید؟\(rq\&. انجام این کار ایده خوبی نیست مگر اینکه بخواهید pacman را از داخل یک اسکریپت اجرا کنید\&. .RE .PP \fB\-\-confirm\fR .RS 4 اثرات گزینه قبلی \fI\-\-noconfirm\fR را لغو می‌کند\&. .RE .PP \fB\-\-disable\-download\-timeout\fR .RS 4 غیرفعال کردن مقادیر پیش‌فرض برای محدودیت حداقل سرعت و زمان انتظار (timeout) در دانلودها\&. اگر در دانلود فایل‌ها از طریق پروکسی و/یا درگاه امنیتی با مشکل مواجه شدید از این گزینه استفاده کنید\&. .RE .PP \fB\-\-sysroot\fR .RS 4 مشخص کردن یک ریشه سیستم جایگزین\&. Pacman قبل از اجرا عملیات chroot و chdir را به ریشه سیستم انجام می‌دهد\&. این امکان را فراهم می‌سازد که سیستم‌های مهمان سوارشده به طور مناسب مورد استفاده قرار گیرند\&. هر مسیر دیگری که ارائه شود به عنوان مسیری نسبی به ریشه سیستم تفسیر خواهد شد\&. نیازمند امتیازات کاربر ریشه (root) است\&. .RE .SH "گزینه‌های تراکنش (TRANSACTION OPTIONS (APPLY TO \fI\-S\fR, \fI\-R\fR AND \fI\-U\fR))" .PP \fB\-d, \-\-nodeps\fR .RS 4 بررسی‌های نسخه وابستگی را نادیده می‌گیرد\&. نام‌های بسته‌ها همچنان بررسی می‌شوند\&. در حالت عادی، pacman همیشه فیلدهای وابستگی بسته را بررسی می‌کند تا مطمئن شود تمام وابستگی‌ها نصب شده‌اند و هیچ تداخل بسته‌ای در سیستم وجود ندارد\&. این گزینه را دوبار مشخص کنید تا تمام بررسی‌های وابستگی نادیده گرفته شوند\&. .RE .PP \fB\-\-assume\-installed\fR .RS 4 افزودن یک بسته مجازی "package" با نسخه "version" به تراکنش برای برآورده کردن وابستگی‌ها\&. این امکان را می‌دهد که بدون تأثیر گذاشتن بر تمام بررسی‌های وابستگی، بررسی‌های وابستگی خاصی را غیرفعال کنید\&. برای غیرفعال کردن تمام بررسی‌های وابستگی، گزینه \fI\-\-nodeps\fR را ببینید\&. .RE .PP \fB\-\-dbonly\fR .RS 4 فقط مدخل پایگاه داده را اضافه/حذف می‌کند و تمام فایل‌ها را در جای خود باقی می‌گذارد\&. .RE .PP \fB\-\-noprogressbar\fR .RS 4 عدم نمایش نوار پیشرفت هنگام دانلود فایل‌ها\&. این می‌تواند برای اسکریپت‌هایی که pacman را فراخوانی کرده و خروجی آن را دریافت می‌کنند مفید باشد\&. .RE .PP \fB\-\-noscriptlet\fR .RS 4 در صورت وجود اسکریپت کوچک نصب (install scriptlet)، آن را اجرا نکن\&. از این گزینه استفاده نکنید مگر اینکه بدانید چه کاری انجام می‌دهید\&. .RE .PP \fB\-p, \-\-print\fR .RS 4 فقط چاپ کردن هدف‌ها به جای انجام عملیات واقعی (همگام‌سازی، حذف یا ارتقا)\&. از گزینه \fI\-\-print\-format\fR برای تعیین نحوه نمایش هدف‌ها استفاده کنید\&. رشته قالب‌بندی پیش‌فرض "%l" است که نشانی‌های URL را با \fI\-S\fR، نام فایل‌ها را با \fI\-U\fR، و pkgname\-pkgver را با \fI\-R\fR نمایش می‌دهد\&. .RE .PP \fB\-\-print\-format\fR .RS 4 مشخص کردن قالبی شبیه به printf برای کنترل خروجی عملیات \fI\-\-print\fR\&. ویژگی‌های ممکن عبارتند از: "%n" برای pkgname، "%v" برای pkgver، "%l" برای مکان، "%r" برای مخزن، و "%s" برای اندازه\&. متضمن گزینه \fI\-\-print\fR است\&. .RE .SH "گزینه‌های ارتقا (UPGRADE OPTIONS (APPLY TO \fI\-S\fR AND \fI\-U\fR))" .PP \fB\-w, \-\-downloadonly\fR .RS 4 دریافت تمام بسته‌ها از سرور، بدون نصب یا ارتقای هیچ چیز\&. .RE .PP \fB\-\-asdeps\fR .RS 4 نصب بسته‌ها به صورت غیرصریح؛ به عبارت دیگر، جعل دلیل نصب آن‌ها به گونه‌ای که به عنوان یک وابستگی نصب شوند\&. این برای makepkg و سایر ابزارهای ساخت از منبع که باید وابستگی‌ها را قبل از ساخت بسته نصب کنند مفید است\&. .RE .PP \fB\-\-asexplicit\fR .RS 4 نصب بسته‌ها به صورت صریح؛ به عبارت دیگر، جعل دلیل نصب آن‌ها به گونه‌ای که به طور صریح نصب شده در نظر گرفته شوند\&. این زمانی مفید است که بخواهید یک وابستگی را به عنوان صریحاً نصب‌شده علامت‌گذاری کنید تا توسط عملیات حذف بازگشتی \fI\-\-recursive\fR حذف نشود\&. .RE .PP \fB\-\-ignore\fR .RS 4 به pacman دستور می‌دهد از ارتقای بسته چشم‌پوشی کند، حتی اگر ارتقایی در دسترس باشد\&. چندین بسته را می‌توان با جدا کردن آن‌ها با کاما مشخص کرد\&. .RE .PP \fB\-\-ignoregroup\fR .RS 4 به pacman دستور می‌دهد از ارتقای تمام بسته‌های موجود در \fIgroup\fR چشم‌پوشی کند، حتی اگر ارتقایی در دسترس باشد\&. چندین گروه را می‌توان با جدا کردن آن‌ها با کاما مشخص کرد\&. .RE .PP \fB\-\-needed\fR .RS 4 نصب نکردن مجدد هدف‌هایی که از قبل به‌روز هستند\&. .RE .PP \fB\-\-overwrite\fR .RS 4 نادیده گرفتن بررسی تداخل فایل‌ها و بازنویسی فایل‌های دارای تداخل\&. اگر بسته‌ای که در شرف نصب است شامل فایل‌هایی باشد که از قبل نصب شده‌اند و با الگوی \fIglob\fR تطابق دارند، این گزینه باعث می‌شود تمام آن فایل‌ها رونویسی شوند\&. استفاده از \fI\-\-overwrite\fR اجازه بازنویسی یک دایرکتوری با یک فایل یا نصب بسته‌هایی با فایل‌ها و دایرکتوری‌های دارای تداخل را نخواهد داد\&. الگوهای چندگانه را می‌توان با جدا کردن آن‌ها با کاما مشخص کرد\&. می‌تواند چندین بار مشخص شود\&. الگوها را می‌توان نفی کرد، به گونه‌ای که فایل‌های منطبق با آن‌ها رونویسی نشوند، با قرار دادن علامت تعجب در ابتدای آن‌ها\&. تطابق‌های بعدی موارد قبلی را لغو خواهند کرد\&. یک علامت تعجب ابتدایی واقعی یا بک‌اسلش باید گریزدهی (escape) شود\&. .RE .SH "گزینه‌های پرس‌وجو (QUERY OPTIONS (APPLY TO \fI\-Q\fR))" .PP \fB\-c, \-\-changelog\fR .RS 4 مشاهده فایل گزارش تغییرات (ChangeLog) یک بسته در صورت وجود\&. .RE .PP \fB\-d, \-\-deps\fR .RS 4 محدود یا فیلتر کردن خروجی به بسته‌هایی که به عنوان وابستگی نصب شده‌اند\&. این گزینه می‌تواند با \fI\-t\fR برای فهرست کردن بسته‌های واقعاً یتیم (orphan) ترکیب شود \- بسته‌هایی که به عنوان وابستگی نصب شده‌اند اما دیگر توسط هیچ بسته نصب‌شده‌ای مورد نیاز نیستند\&. .RE .PP \fB\-e, \-\-explicit\fR .RS 4 محدود یا فیلتر کردن خروجی به بسته‌هایی که صریحاً نصب شده‌اند\&. این گزینه می‌تواند با \fI\-t\fR برای فهرست کردن بسته‌های صریحاً نصب‌شده‌ای که توسط هیچ بسته دیگری مورد نیاز نیستند ترکیب شود\&. .RE .PP \fB\-g, \-\-groups\fR .RS 4 نمایش تمام بسته‌هایی که عضو یک گروه نام‌برده هستند\&. اگر نامی مشخص نشده باشد، تمام بسته‌های گروه‌بندی‌شده را فهرست می‌کند\&. .RE .PP \fB\-i, \-\-info\fR .RS 4 نمایش اطلاعات درباره یک بسته مشخص‌شده\&. اگر به جای پایگاه داده محلی یک فایل بسته را مورد پرس‌وجو قرار می‌دهید، گزینه \fI\-p\fR می‌تواند استفاده شود\&. پاس دادن دو پرچم \fI\-\-info\fR یا \fI\-i\fR همچنین فهرست فایل‌های پشتیبان و وضعیت تغییر آن‌ها را نمایش خواهد داد\&. .RE .PP \fB\-k, \-\-check\fR .RS 4 بررسی اینکه آیا تمام فایل‌های متعلق به بسته(های) مشخص‌شده روی سیستم وجود دارند یا خیر\&. اگر بسته‌ها مشخص نشده باشند یا پرچم‌های فیلتر ارائه نشده باشند، تمام بسته‌های نصب‌شده را بررسی می‌کند\&. مشخص کردن این گزینه به صورت دو بار، بررسی دقیق‌تر فایل‌ها (شامل مجوزها، اندازه فایل‌ها و زمان تغییر) را برای بسته‌هایی که شامل فایل mtree مورد نیاز هستند انجام می‌دهد\&. .RE .PP \fB\-l, \-\-list\fR .RS 4 فهرست کردن تمام فایل‌های متعلق به یک بسته مشخص\&. چندین بسته را می‌توان در خط فرمان مشخص کرد\&. .RE .PP \fB\-m, \-\-foreign\fR .RS 4 محدود یا فیلتر کردن خروجی به بسته‌هایی که در پایگاه(های) داده همگام‌سازی یافت نشدند\&. معمولاً این‌ها بسته‌هایی هستند که به صورت دستی دانلود شده و با \fI\-\-upgrade\fR نصب شده‌اند\&. .RE .PP \fB\-n, \-\-native\fR .RS 4 محدود یا فیلتر کردن خروجی به بسته‌هایی که در پایگاه(های) داده همگام‌سازی یافت می‌شوند\&. این فیلتر معکوس گزینه \fI\-\-foreign\fR است\&. .RE .PP \fB\-o, \-\-owns\fR .RS 4 جستجو برای بسته‌هایی که مالک فایل(های) مشخص‌شده هستند\&. مسیر می‌تواند نسبی یا مطلق باشد، و یک یا چند فایل را می‌توان مشخص کرد\&. .RE .PP \fB\-p, \-\-file\fR .RS 4 نشان می‌دهد که بسته ارائه‌شده در خط فرمان یک فایل است و نه یک مدخل در پایگاه داده\&. فایل از حالت فشرده خارج شده و مورد پرس‌وجو قرار می‌گیرد\&. این گزینه در ترکیب با \fI\-\-info\fR و \fI\-\-list\fR مفید است\&. .RE .PP \fB\-q, \-\-quiet\fR .RS 4 نمایش اطلاعات کمتر برای برخی عملیات‌های پرس‌وجو\&. این زمانی مفید است که خروجی pacman در یک اسکریپت پردازش می‌شود\&. عمل search فقط نام بسته‌ها را نشان می‌دهد و اطلاعات مخزن، نسخه، گروه و توضیحات را حذف می‌کند؛ owns فقط نام بسته‌ها را به جای پیام‌های "فایل متعلق به بسته است" نشان می‌دهد؛ group فقط نام بسته‌ها را نشان داده و نام گروه‌ها را حذف می‌کند؛ list فقط فایل‌ها را نشان داده و نام بسته‌ها را حذف می‌کند؛ check فقط جفت نام بسته و فایل‌های مفقود را نشان می‌دهد؛ یک پرس‌وجوی ساده فقط نام بسته‌ها را به جای نام‌ها و نسخه‌ها نشان می‌دهد\&. .RE .PP \fB\-s, \-\-search\fR .RS 4 جستجوی هر بسته نصب‌شده محلی برای نام‌ها یا توضیحاتی که با regexp تطابق دارند\&. هنگام استفاده از چندین عبارت جستجو، تنها بسته‌هایی بازگردانده می‌شوند که توضیحات آن‌ها با همه آن عبارات تطابق داشته باشد\&. .RE .PP \fB\-t, \-\-unrequired\fR .RS 4 محدود یا فیلتر کردن خروجی برای چاپ بسته‌هایی که نه به صورت مستقیم و نه به صورت اختیاری توسط هیچ بسته نصب‌شده‌ای مورد نیاز نیستند\&. این گزینه را دوبار مشخص کنید تا بسته‌هایی را که به صورت اختیاری، اما نه مستقیماً، توسط بسته دیگری مورد نیاز هستند نیز دربرگیرد\&. .RE .PP \fB\-u, \-\-upgrades\fR .RS 4 محدود یا فیلتر کردن خروجی به بسته‌هایی که روی سیستم محلی قدیمی هستند\&. فقط نسخه‌های بسته‌ها برای یافتن بسته‌های قدیمی استفاده می‌شوند؛ جایگزینی‌ها در اینجا بررسی نمی‌شوند\&. این گزینه زمانی بهترین عملکرد را دارد که پایگاه داده همگام‌سازی با استفاده از \fI\-Sy\fR تازه‌سازی شده باشد\&. .RE .SH "گزینه‌های حذف (REMOVE OPTIONS (APPLY TO \fI\-R\fR))" .PP \fB\-c, \-\-cascade\fR .RS 4 حذف تمام بسته‌های هدف، و همچنین تمام بسته‌هایی که به یک یا چند بسته هدف وابسته هستند\&. این عمل بازگشتی است و باید با احتیاط استفاده شود، زیرا می‌تواند بسته‌های بالقوه مورد نیاز زیادی را حذف کند\&. .RE .PP \fB\-n, \-\-nosave\fR .RS 4 به pacman دستور می‌دهد تعیین‌های پشتیبان‌گیری فایل را نادیده بگیرد\&. به طور معمول، هنگامی که یک فایل از سیستم حذف می‌شود، پایگاه داده بررسی می‌شود تا مشخص گردد آیا فایل باید با پسوند \fI\&.pacsave\fR تغییر نام یابد یا خیر\&. .RE .PP \fB\-s, \-\-recursive\fR .RS 4 حذف هر هدف مشخص‌شده به همراه تمام وابستگی‌های آن‌ها، مشروط بر اینکه (الف) توسط بسته‌های دیگر مورد نیاز نباشند؛ و (ب) توسط کاربر به طور صریح نصب نشده باشند\&. این عمل بازگشتی و مشابه عمل معکوس \fI\-\-sync\fR است، و به تمیز نگه داشتن سیستم بدون بسته‌های یتیم کمک می‌کند\&. اگر می‌خواهید شرط (ب) را حذف کنید، این گزینه را دو بار وارد کنید\&. .RE .PP \fB\-u, \-\-unneeded\fR .RS 4 اهدافی را حذف می‌کند که توسط هیچ بسته دیگری مورد نیاز نیستند\&. این عمدتاً هنگام حذف یک گروه بدون استفاده از گزینه \fI\-c\fR مفید است، تا از شکستن وابستگی‌ها جلوگیری شود\&. .RE .SH "گزینه‌های همگام‌سازی (SYNC OPTIONS (APPLY TO \fI\-S\fR))" .PP \fB\-c, \-\-clean\fR .RS 4 حذف بسته‌هایی که دیگر روی سیستم نصب نیستند از حافظه نهان و همچنین پایگاه‌های داده همگام‌سازی بلااستفاده برای آزادسازی فضای دیسک\&. هنگامی که pacman بسته‌ها را دانلود می‌کند، آن‌ها را در یک دایرکتوری حافظه نهان ذخیره می‌کند\&. علاوه بر این، پایگاه‌های داده برای هر پایگاه داده همگام‌سازی که از آن دانلود می‌کنید ذخیره می‌شوند و حتی اگر از فایل پیکربندی \fBpacman.conf\fR(5) حذف شوند، پاک نمی‌شوند\&. از یک سوئیچ \fI\-\-clean\fR برای حذف فقط بسته‌هایی که دیگر نصب نیستند استفاده کنید؛ از دو سوئیچ برای حذف تمام فایل‌ها از حافظه نهان استفاده کنید\&. در هر دو حالت، یک گزینه بله یا خیر برای حذف بسته‌ها و/یا پایگاه‌های داده دانلودشده بلااستفاده در اختیارتان قرار می‌گیرد\&. .sp اگر از حافظه نهان مشترک شبکه‌ای استفاده می‌کنید، گزینه \fICleanMethod\fR را در \fBpacman.conf\fR(5) ببینید\&. .RE .PP \fB\-g, \-\-groups\fR .RS 4 نمایش تمام اعضا برای هر گروه بسته مشخص‌شده\&. اگر نام گروهی ارائه نشود، تمام گروه‌ها فهرست خواهند شد؛ این پرچم را دوبار وارد کنید تا تمام گروه‌ها و اعضای آن‌ها را مشاهده کنید\&. .RE .PP \fB\-i, \-\-info\fR .RS 4 نمایش اطلاعات درباره یک بسته پایگاه داده همگام‌سازی مشخص\&. وارد کردن دو پرچم \fI\-\-info\fR یا \fI\-i\fR همچنین بسته‌هایی را در تمام مخازن که به این بسته وابسته‌اند نمایش می‌دهد\&. .RE .PP \fB\-l, \-\-list\fR .RS 4 فهرست کردن تمام بسته‌ها در مخازن مشخص‌شده\&. چندین مخزن را می‌توان در خط فرمان مشخص کرد\&. .RE .PP \fB\-q, \-\-quiet\fR .RS 4 نمایش اطلاعات کمتر برای برخی عملیات‌های همگام‌سازی\&. این زمانی مفید است که خروجی pacman در یک اسکریپت پردازش می‌شود\&. عمل Search فقط نام بسته‌ها را نشان می‌دهد و اطلاعات مخزن، نسخه، گروه و توضیحات را حذف می‌کند؛ list فقط نام بسته‌ها را نشان می‌دهد و پایگاه‌های داده و نسخه‌ها را حذف می‌کند؛ group فقط نام بسته‌ها را نشان می‌دهد و نام گروه‌ها را حذف می‌کند\&. .RE .PP \fB\-s, \-\-search\fR .RS 4 این گزینه هر بسته را در پایگاه‌های داده همگام‌سازی برای نام‌ها یا توضیحاتی که با regexp تطابق دارند جستجو می‌کند\&. هنگامی که چندین عبارت جستجو را وارد می‌کنید، تنها بسته‌هایی با توضیحاتی که با همه آن عبارات تطابق دارند بازگردانده خواهند شد\&. .RE .PP \fB\-u, \-\-sysupgrade\fR .RS 4 ارتقای تمام بسته‌های قدیمی\&. هر بسته نصب‌شده فعلی بررسی خواهد شد و در صورت وجود بسته جدیدتر ارتقا می‌یابد\&. گزارشی از تمام بسته‌ها برای ارتقا ارائه خواهد شد و عملیات بدون تأیید کاربر ادامه نخواهد یافت\&. وابستگی‌ها در این سطح به طور خودکار حل می‌شوند و در صورت لزوم نصب/ارتقا خواهند شد\&. .sp این گزینه را دوبار وارد کنید تا تنزل بسته (downgrade) فعال شود؛ در این صورت، pacman بسته‌های همگام‌سازی را انتخاب می‌کند که نسخه‌های آن‌ها با نسخه‌های محلی مطابقت ندارد\&. این می‌تواند زمانی مفید باشد که کاربر از یک مخزن آزمایشی (testing) به یک مخزن پایدار سوئیچ می‌کند\&. .sp اهداف اضافی را نیز می‌توان به صورت دستی مشخص کرد، به طوری که \fI\-Su foo\fR یک ارتقای سیستم را انجام داده و بسته "foo" را در همان عملیات نصب/ارتقا خواهد کرد\&. .RE .PP \fB\-y, \-\-refresh\fR .RS 4 دانلود یک نسخه تازه از پایگاه داده اصلی بسته‌ها از سرور(های) تعریف‌شده در \fBpacman.conf\fR(5)\&. این گزینه معمولاً باید هر بار که از \fI\-\-sysupgrade\fR یا \fI\-u\fR استفاده می‌کنید، به کار رود\&. وارد کردن دو پرچم \fI\-\-refresh\fR یا \fI\-y\fR تازه‌سازی تمام پایگاه‌های داده بسته‌ها را اجبار می‌کند، حتی اگر به‌روز به نظر برسند\&. .RE .SH "گزینه‌های پایگاه داده (DATABASE OPTIONS (APPLY TO \fI\-D\fR))" .PP \fB\-\-asdeps\fR .RS 4 علامت‌گذاری یک بسته به عنوان غیرصریح نصب‌شده؛ به عبارت دیگر، دلیل نصب آن را به عنوان یک وابستگی تنظیم می‌کند\&. .RE .PP \fB\-\-asexplicit\fR .RS 4 علامت‌گذاری یک بسته به عنوان صریحاً نصب‌شده؛ به عبارت دیگر، دلیل نصب آن را به صورت صریحاً نصب‌شده تنظیم می‌کند\&. این زمانی مفید است که بخواهید یک بسته حتی زمانی که در ابتدا به عنوان وابستگی بسته دیگری نصب شده است، روی سیستم باقی بماند\&. .RE .PP \fB\-k, \-\-check\fR .RS 4 بررسی سازگاری درونی پایگاه داده محلی بسته‌ها\&. این گزینه بررسی می‌کند که تمام فایل‌های مورد نیاز وجود دارند و بسته‌های نصب‌شده وابستگی‌های لازم را دارند، تداخلی وجود ندارد و چندین بسته مالک یک فایل مشترک نیستند\&. مشخص کردن این گزینه دو بار، یک بررسی روی پایگاه‌های داده همگام‌سازی انجام می‌دهد تا اطمینان حاصل شود تمام وابستگی‌های مشخص‌شده در دسترس هستند\&. .RE .PP \fB\-q, \-\-quiet\fR .RS 4 فرونشاندن پیام‌ها هنگام اتمام موفقیت‌آمیز عملیات پایگاه داده\&. .RE .SH "گزینه‌های فایل (FILE OPTIONS (APPLY TO \fI\-F\fR))" .PP \fB\-y, \-\-refresh\fR .RS 4 دانلود پایگاه‌های داده تازه بسته‌ها از سرور\&. برای اجبار به تازه‌سازی حتی در صورتی که پایگاه‌های داده به‌روز باشند، دو بار استفاده کنید\&. .RE .PP \fB\-l, \-\-list\fR .RS 4 فهرست کردن فایل‌های متعلق به بسته مورد پرس‌وجو\&. .RE .PP \fB\-x, \-\-regex\fR .RS 4 تفسیر هر پرس‌وجو به عنوان یک عبارت منظم (regular expression)\&. .RE .PP \fB\-q, \-\-quiet\fR .RS 4 نمایش اطلاعات کمتر برای برخی عملیات‌های فایل\&. این زمانی مفید است که خروجی pacman در یک اسکریپت پردازش می‌شود، با این حال، ممکن است بخواهید به جای آن از \fI\-\-machinereadable\fR استفاده کنید\&. .RE .PP \fB\-\-machinereadable\fR .RS 4 چاپ هر تطابق در یک قالب خروجی ماشین‌خوان\&. این قالب به صورت \fIrepository\e0pkgname\e0pkgver\e0path\en\fR است که در آن \fI\e0\fR نویسه تهی (NULL) و \fI\en\fR نویسه خط جدید (linefeed) است\&. .RE .SH "مدیریت فایل‌های پیکربندی (HANDLING CONFIG FILES)" .sp ابزار Pacman از همان منطق \fIrpm\fR برای تعیین اقدام لازم در برابر فایل‌هایی که برای پشتیبان‌گیری تعیین شده‌اند استفاده می‌کند\&. در طول یک ارتقا، سه درهم‌سازی (hash) به روش MD5 برای هر فایل پشتیبان استفاده می‌شود تا اقدام لازم مشخص گردد: یکی برای فایل اصلی نصب‌شده، یکی برای فایل جدیدی که در شرف نصب است، و یکی برای فایل فعلی موجود روی سیستم فایل\&. پس از مقایسه این سه هش، سناریوهای زیر می‌توانند رخ دهند: .PP original=X, current=X, new=X .RS 4 هر سه فایل یکسان هستند، بنابراین رونویسی مشکلی ایجاد نمی‌کند\&. فایل جدید را نصب کن\&. .RE .PP original=X, current=X, new=Y .RS 4 فایل فعلی همان فایل اصلی است، اما فایل جدید متفاوت است\&. از آنجا که کاربر هرگز فایل را تغییر نداده است، و فایل جدید ممکن است حاوی بهبودها یا رفع باگ‌ها باشد، فایل جدید را نصب کن\&. .RE .PP original=X, current=Y, new=X .RS 4 هر دو نسخه بسته دقیقاً شامل فایل یکسانی هستند، اما فایل موجود روی سیستم فایل تغییر یافته است\&. فایل فعلی را در جای خود باقی بگذار\&. .RE .PP original=X, current=Y, new=Y .RS 4 فایل جدید با فایل فعلی یکسان است\&. فایل جدید را نصب کن\&. .RE .PP original=X, current=Y, new=Z .RS 4 هر سه فایل متفاوت هستند، بنابراین فایل جدید را با پسوند \fI\&.pacnew\fR نصب کن و به کاربر هشدار بده\&. سپس کاربر باید به صورت دستی هرگونه تغییرات لازم را در فایل اصلی ادغام کند\&. .RE .PP original=NULL, current=Y, new=Z .RS 4 بسته قبلاً نصب نبوده است و فایل از قبل روی سیستم فایل وجود دارد\&. فایل جدید را با پسوند \fI\&.pacnew\fR نصب کن و به کاربر هشدار بده\&. سپس کاربر باید به صورت دستی هرگونه تغییرات لازم را در فایل اصلی ادغام کند\&. .RE .SH "مثال‌ها (EXAMPLES)" .PP pacman \-Ss ne\&.hack .RS 4 جستجو برای عبارت منظم "ne\&.hack" در پایگاه داده بسته‌ها\&. .RE .PP pacman \-S gpm .RS 4 دانلود و نصب gpm به همراه وابستگی‌ها\&. .RE .PP pacman \-U /home/user/ceofhack\-0\&.6\-1\-x86_64\&.pkg\&.tar\&.gz .RS 4 نصب بسته ceofhack\-0\&.6\-1 از یک فایل محلی\&. .RE .PP pacman \-Syu .RS 4 به‌روزرسانی فهرست بسته‌ها و سپس ارتقای تمام بسته‌ها\&. .RE .PP pacman \-Syu gpm .RS 4 به‌روزرسانی فهرست بسته‌ها، ارتقای تمام بسته‌ها، و سپس نصب gpm در صورتی که قبلاً نصب نشده باشد\&. .RE .SH "پیکربندی (CONFIGURATION)" .sp برای جزئیات بیشتر در مورد پیکربندی pacman با استفاده از فایل \fIpacman\&.conf\fR، به \fBpacman.conf\fR(5) مراجعه کنید\&. .SH "همچنین ببینید (SEE ALSO)" .sp \fBalpm-hooks\fR(5), \fBlibalpm\fR(3), \fBmakepkg\fR(8), \fBpacman.conf\fR(5) .sp برای اطلاعات به‌روز در مورد pacman و ابزارهای مرتبط با آن، به وبگاه pacman در https://archlinux\&.org/pacman/ مراجعه کنید\&. .SH "گزارش باگ‌ها (REPORTING BUGS)" .sp باگ؟ حتماً شوخی می‌کنید؛ هیچ باگی در این نرم‌افزار وجود ندارد\&. اما اگر احیاناً اشتباه کرده باشیم، یک گزارش باگ با بیشترین جزئیات ممکن در بخش Pacman در ردیاب باگ Arch Linux ثبت کنید\&. .SH "نویسنده (AUTHOR)" .sp نگه‌دارندگان فعلی: .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} Allan McRae .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} Andrew Gregory .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} Eli Schwartz .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} Morgan Adamiec .RE .sp مشارکت‌کنندگان عمده پیشین: .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} Judd Vinet .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} Aurelien Foret .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} Aaron Griffin .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} Dan McGee .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} Xavier Chantry .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} Nagy Gabor .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} Dave Reisner .RE .sp برای مشارکت‌کنندگان دیگر، از git shortlog \-s روی مخزن pacman\&.git استفاده کنید\&.