.\" -*- 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 "dpkg 1" .TH dpkg 1 2026-03-06 1.23.7-dirty "dpkg suite" .\" 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)" dpkg \- ابزار مدیریت بسته دبیان .SH "خلاصه دستور (SYNOPSIS)" .IX Header "SYNOPSIS" \&\fBdpkg\fR [\fIoption\fR...] \fIcommand\fR .SH "هشدار (WARNING)" .IX Header "WARNING" این راهنما برای کاربرانی در نظر گرفته شده است که مایل‌اند گزینه‌های خط فرمان و وضعیت‌های بسته در \fBdpkg\fR را با جزئیاتی بیشتر از آنچه توسط \fBdpkg \-\-help\fR ارائه می‌شود درک کنند. .PP این راهنما \fIنباید\fR توسط نگه‌دارندگان بسته که می‌خواهند بدانند \fBdpkg\fR چگونه بسته‌های آن‌ها را نصب می‌کند استفاده شود. توضیحات مربوط به اینکه \fBdpkg\fR هنگام نصب و حذف بسته‌ها چه کاری انجام می‌دهد به‌طور ویژه‌ای ناکافی است. .SH "توضیحات (DESCRIPTION)" .IX Header "DESCRIPTION" ابزار \&\fBdpkg\fR یک ابزار سطح متوسط برای نصب، ساخت، حذف و مدیریت بسته‌های دبیان است. پیشانه (front\-end) اصلی و کاربرپسندتر برای \fBdpkg\fR به عنوان رابط خط فرمان (CLI) ابزار \fBapt\fR\|(8) و به عنوان رابط کاربری ترمینال (TUI) ابزار \fBaptitude\fR\|(8) است. خود \&\fBdpkg\fR به‌طور کامل از طریق پارامترهای خط فرمان کنترل می‌شود، که دقیقاً شامل یک دستور و صفر یا چند گزینه است. پارامتر دستور به \fBdpkg\fR می‌گوید چه کاری انجام دهد و گزینه‌ها رفتار دستور را به نوعی کنترل می‌کنند. .PP همچنین می‌توان از \&\fBdpkg\fR به عنوان یک پیشانه برای \fBdpkg\-deb\fR\|(1) و \&\fBdpkg\-query\fR\|(1) استفاده کرد. فهرست دستورهای پشتیبانی‌شده را می‌توان جلوتر در بخش \fBCOMMANDS\fR یافت. اگر با چنین دستوری مواجه شود، \fBdpkg\fR تنها \fBdpkg\-deb\fR یا \fBdpkg\-query\fR را با پارامترهای ارائه‌شده به آن اجرا می‌کند، اما هیچ گزینه خاصی در حال حاضر به آن‌ها منتقل نمی‌شود؛ برای استفاده از چنین گزینه‌هایی، برنامه‌های پسانه (back\-ends) باید مستقیماً فراخوانی شوند. .SH "اطلاعات درباره بسته‌ها (INFORMATION ABOUT PACKAGES)" .IX Header "INFORMATION ABOUT PACKAGES" ابزار \&\fBdpkg\fR اطلاعات مفیدی را درباره بسته‌های موجود نگه‌داری می‌کند. این اطلاعات به سه دسته تقسیم می‌شوند: \fBstates\fR (وضعیت‌ها)، \&\fBselection states\fR (وضعیت‌های انتخاب) و \fBflags\fR (پرچم‌ها). این مقادیر عمدتاً به منظور تغییر توسط \fBdselect\fR در نظر گرفته شده‌اند. .SS "وضعیت‌های بسته (Package states)" .IX Subsection "Package states" .IP \fBnot\-installed\fR 4 .IX Item "not-installed" بسته روی سیستم شما نصب نیست. .IP \fBconfig\-files\fR 4 .IX Item "config-files" تنها پرونده‌های پیکربندی یا اسکریپت \fBpostrm\fR و داده‌های مورد نیازش برای حذف بسته، بر روی سیستم وجود دارند. .IP \fBhalf\-installed\fR 4 .IX Item "half-installed" نصب بسته شروع شده است، اما بنا به دلایلی کامل نشده است. .IP \fBunpacked\fR 4 .IX Item "unpacked" بسته از حالت فشرده خارج شده است، اما پیکربندی نشده است. .IP \fBhalf\-configured\fR 4 .IX Item "half-configured" بسته از حالت فشرده خارج شده و پیکربندی آن آغاز شده است، اما به دلایلی هنوز کامل نشده است. .IP \fBtriggers\-awaited\fR 4 .IX Item "triggers-awaited" بسته در انتظار پردازش محرک (trigger) توسط بسته‌ای دیگر است. .IP \fBtriggers\-pending\fR 4 .IX Item "triggers-pending" محرک‌های بسته فعال شده‌اند (بسته triggered شده است). .IP \fBinstalled\fR 4 .IX Item "installed" بسته به‌درستی باز شده و پیکربندی شده است. .SS "وضعیت‌های انتخاب بسته (Package selection states)" .IX Subsection "Package selection states" .IP \fBinstall\fR 4 .IX Item "install" بسته برای نصب انتخاب شده است. .IP \fBhold\fR 4 .IX Item "hold" بسته‌ای که به عنوان \fBhold\fR علامت‌گذاری شده باشد، در همان نسخه نگه‌داشته می‌شود، یعنی هیچ نصب، ارتقا یا حذف جدید خودکاری روی آن‌ها انجام نخواهد شد، مگر اینکه این اقدامات به‌طور صریح درخواست شوند، یا اجازه انجام خودکار آن‌ها با گزینه \fB\-\-force\-hold\fR داده شده باشد. .IP \fBdeinstall\fR 4 .IX Item "deinstall" بسته برای حذف انتخاب شده است (یعنی می‌خواهیم همه پرونده‌ها به جز پرونده‌های پیکربندی را حذف کنیم). .IP \fBpurge\fR 4 .IX Item "purge" بسته برای پاک‌سازی کامل انتخاب شده است (یعنی می‌خواهیم همه چیز، حتی پرونده‌های پیکربندی را از دایرکتوری‌های سیستم حذف کنیم). .IP \fBunknown\fR 4 .IX Item "unknown" انتخاب بسته ناشناخته است. بسته‌ای که همچنین در وضعیت \fBnot\-installed\fR باشد و دارای پرچم \&\fBok\fR باشد، در ذخیره بعدی پایگاه داده به فراموشی سپرده خواهد شد (حذف می‌شود). .SS "پرچم‌های بسته (Package flags)" .IX Subsection "Package flags" .IP \fBok\fR 4 .IX Item "ok" بسته‌ای که با \fBok\fR علامت خورده است در یک وضعیت شناخته‌شده قرار دارد، اما ممکن است نیاز به پردازش بیشتری داشته باشد. .IP \fBreinstreq\fR 4 .IX Item "reinstreq" بسته‌ای که با \fBreinstreq\fR علامت خورده است خراب است و نیازمند نصب مجدد است. این بسته‌ها را نمی‌توان حذف کرد، مگر اینکه با گزینه \fB\-\-force\-remove\-reinstreq\fR اجبار شود. .SH "دستورها (COMMANDS)" .IX Header "COMMANDS" .IP "\fB\-i\fR, \fB\-\-install\fR \fIpackage\-file\fR..." 4 .IX Item "-i, --install package-file..." بسته را نصب می‌کند. اگر گزینه \fB\-\-recursive\fR یا \fB\-R\fR مشخص شده باشد، \fIpackage\-file\fR باید در عوض به یک دایرکتوری اشاره کند. .Sp نصب شامل گام‌های زیر است: .RS 4 .IP \fB1.\fR 4 .IX Item "1." استخراج پرونده‌های کنترلی بسته جدید. .IP \fB2.\fR 4 .IX Item "2." اگر نسخه دیگری از همان بسته پیش از نصب جدید نصب شده بود، اسکریپت \fIprerm\fR بسته قدیمی اجرا می‌شود. .IP \fB3.\fR 4 .IX Item "3." اجرای اسکریپت \fIpreinst\fR، در صورتی که توسط بسته ارائه شده باشد. .IP \fB4.\fR 4 .IX Item "4." باز کردن پرونده‌های جدید از حالت فشرده و هم‌زمان پشتیبان‌گیری از پرونده‌های قدیمی، تا در صورت بروز مشکل امکان بازگردانی آن‌ها وجود داشته باشد. .IP \fB5.\fR 4 .IX Item "5." اگر نسخه دیگری از همان بسته پیش از نصب جدید نصب شده بود، اسکریپت \fIpostrm\fR بسته قدیمی اجرا می‌شود. توجه داشته باشید که این اسکریپت پس از اسکریپت \fIpreinst\fR بسته جدید اجرا می‌شود، زیرا پرونده‌های جدید هم‌زمان با حذف پرونده‌های قدیمی نوشته می‌شوند. .IP \fB6.\fR 4 .IX Item "6." پیکربندی بسته. برای اطلاعات دقیق درباره چگونگی انجام این کار، \&\fB\-\-configure\fR را ببینید. .RE .RS 4 .RE .IP "\fB\-\-unpack\fR \fIpackage\-file\fR..." 4 .IX Item "--unpack package-file..." بسته را از حالت فشرده خارج می‌کند، اما آن را پیکربندی نمی‌کند. اگر گزینه \fB\-\-recursive\fR یا \&\fB\-R\fR مشخص شده باشد، \fIpackage\-file\fR باید در عوض به یک دایرکتوری اشاره کند. .Sp محرک‌ها را برای \fBPre\-Depends\fR پردازش خواهد کرد مگر اینکه \fB\-\-no\-triggers\fR مشخص شده باشد. .IP "\fB\-\-configure\fR \fIpackage\fR...|\fB\-a\fR|\fB\-\-pending\fR" 4 .IX Item "--configure package...|-a|--pending" پیکربندی بسته‌ای که از حالت فشرده خارج شده اما هنوز پیکربندی نشده است. اگر به جای \fIpackage\fR گزینه \fB\-a\fR یا \fB\-\-pending\fR داده شود، تمام بسته‌های بازشده اما پیکربندی‌نشده، پیکربندی می‌شوند. .Sp برای پیکربندی مجدد بسته‌ای که پیش‌تر پیکربندی شده است، در عوض دستور \&\fBdpkg\-reconfigure\fR\|(8) را امتحان کنید (که بخشی از پروژه \fBdebconf\fR است). .Sp پیکربندی شامل گام‌های زیر است: .RS 4 .IP \fB1.\fR 4 .IX Item "1." باز کردن conffileها از حالت فشرده و هم‌زمان پشتیبان‌گیری از conffileهای قدیمی، تا در صورت بروز مشکل امکان بازگردانی آن‌ها وجود داشته باشد. .IP \fB2.\fR 4 .IX Item "2." اجرای اسکریپت \fIpostinst\fR، در صورتی که توسط بسته ارائه شده باشد. .RE .RS 4 .Sp محرک‌ها پردازش خواهند شد مگر اینکه \fB\-\-no\-triggers\fR مشخص شده باشد. .RE .IP "\fB\-\-triggers\-only\fR \fIpackage\fR...|\fB\-a\fR|\fB\-\-pending\fR" 4 .IX Item "--triggers-only package...|-a|--pending" فقط محرک‌ها را پردازش می‌کند (از نسخه dpkg 1.14.17). تمام محرک‌های معلق پردازش خواهند شد. اگر نام‌های بسته ارائه شده باشند، فقط محرک‌های همان بسته‌ها پردازش خواهند شد، دقیقاً یک‌بار برای هر کدام در صورت لزوم. استفاده از این گزینه ممکن است بسته‌ها را در وضعیت‌های نامناسب \fBtriggers\-awaited\fR و \fBtriggers\-pending\fR قرار دهد. این مورد را می‌توان بعداً با اجرای این دستور برطرف کرد: \fBdpkg \-\-configure \-\-pending\fR. .IP "\fB\-r\fR, \fB\-\-remove\fR \fIpackage\fR...|\fB\-a\fR|\fB\-\-pending\fR" 4 .IX Item "-r, --remove package...|-a|--pending" حذف یک بسته نصب‌شده. این دستور همه چیز را به جز conffileها و سایر داده‌های پاک‌سازی‌شده توسط اسکریپت \fIpostrm\fR حذف می‌کند؛ این امر ممکن است از لزوم پیکربندی مجدد بسته در صورت نصب مجدد بعدی جلوگیری کند (conffileها پرونده‌های پیکربندی هستند که در پرونده کنترلی \&\fIDEBIAN/conffiles\fR فهرست شده‌اند). اگر نه پرونده کنترلی \fIDEBIAN/conffiles\fR و نه اسکریپت \fIDEBIAN/postrm\fR وجود داشته باشد، این دستور معادل فراخوانی \fB\-\-purge\fR است. اگر به جای نام بسته، گزینه \fB\-a\fR یا \fB\-\-pending\fR داده شود، آن‌گاه همه بسته‌هایی که باز شده‌اند، اما در پرونده \&\fI/var/lib/dpkg/status\fR برای حذف علامت خورده‌اند، حذف می‌شوند. .Sp حذف یک بسته شامل گام‌های زیر است: .RS 4 .IP \fB1.\fR 4 .IX Item "1." اجرای اسکریپت \fIprerm\fR. .IP \fB2.\fR 4 .IX Item "2." حذف پرونده‌های نصب‌شده. .IP \fB3.\fR 4 .IX Item "3." اجرای اسکریپت \fIpostrm\fR. .RE .RS 4 .Sp محرک‌ها پردازش خواهند شد مگر اینکه \fB\-\-no\-triggers\fR مشخص شده باشد. .RE .IP "\fB\-P\fR, \fB\-\-purge\fR \fIpackage\fR...|\fB\-a\fR|\fB\-\-pending\fR" 4 .IX Item "-P, --purge package...|-a|--pending" پاک‌سازی کامل یک بسته نصب‌شده یا از قبل حذف‌شده. این دستور همه چیز را حذف می‌کند، از جمله conffileها و هر چیز دیگری که توسط \fIpostrm\fR پاک‌سازی شده است. اگر به جای نام بسته، گزینه \fB\-a\fR یا \fB\-\-pending\fR داده شود، آن‌گاه همه بسته‌هایی که باز یا حذف شده‌اند، اما در پرونده \&\fI/var/lib/dpkg/status\fR برای پاک‌سازی علامت خورده‌اند، پاک‌سازی می‌شوند. .Sp \&\fBنکته\fR: ممکن است برخی پرونده‌های پیکربندی برای \fBdpkg\fR ناشناخته باشند زیرا به‌طور جداگانه از طریق اسکریپت‌های پیکربندی ایجاد و مدیریت می‌شوند. در آن صورت، \fBdpkg\fR آن‌ها را به خودی خود حذف نخواهد کرد، اما اسکریپت \&\fIpostrm\fR بسته (که توسط \fBdpkg\fR فراخوانی می‌شود)، باید هنگام پاک‌سازی کامل مسئولیت حذف آن‌ها را بر عهده بگیرد. البته این موضوع فقط برای پرونده‌های موجود در دایرکتوری‌های سیستم صدق می‌کند، نه پرونده‌های پیکربندی نوشته‌شده در دایرکتوری‌های خانگی تک‌تک کاربران. .Sp پاک‌سازی کامل یک بسته شامل گام‌های زیر است: .RS 4 .IP \fB1.\fR 4 .IX Item "1." حذف بسته، در صورتی که پیش‌تر حذف نشده باشد. برای اطلاعات دقیق درباره نحوه انجام این کار، \&\fB\-\-remove\fR را ببینید. .IP \fB2.\fR 4 .IX Item "2." اجرای اسکریپت \fIpostrm\fR. .RE .RS 4 .Sp محرک‌ها پردازش خواهند شد مگر اینکه \fB\-\-no\-triggers\fR مشخص شده باشد. .RE .IP "\fB\-V\fR, \fB\-\-verify\fR [\fIpackage\-name\fR...]" 4 .IX Item "-V, --verify [package-name...]" صحت و یکپارچگی \fIpackage\-name\fR یا در صورت عدم ذکر، همه بسته‌ها را با مقایسه اطلاعات پرونده‌های نصب‌شده توسط یک بسته با اطلاعات فراداده پرونده‌های ذخیره‌شده در پایگاه داده \fBdpkg\fR بررسی می‌کند (از نسخه dpkg 1.17.2). منشأ اطلاعات فراداده پرونده‌ها در پایگاه داده، خود بسته‌های باینری هستند. این فراداده در زمان باز کردن بسته در طول فرآیند نصب جمع‌آوری می‌شود. .Sp در حال حاضر تنها بررسی عملکردی انجام‌شده، تأیید md5sum محتوای پرونده در برابر مقدار ذخیره‌شده در پایگاه داده پرونده‌ها است. این مورد تنها زمانی بررسی خواهد شد که پایگاه داده شامل md5sum پرونده باشد. برای بررسی هرگونه فراداده گمشده در پایگاه داده، می‌توان از دستور \fB\-\-audit\fR استفاده کرد. این فقط یک بررسی یکپارچگی است و نباید به عنوان هیچ نوع تأییدیه امنیتی در نظر گرفته شود. .Sp قالب خروجی با گزینه \fB\-\-verify\-format\fR قابل انتخاب است که به‌طور پیش‌فرض از قالب \fBrpm\fR استفاده می‌کند، اما ممکن است در آینده تغییر کند و از این رو، برنامه‌هایی که خروجی این دستور را تجزیه می‌کنند باید قالبی را که انتظار دارند به‌طور صریح مشخص نمایند. .IP "\fB\-C\fR, \fB\-\-audit\fR [\fIpackage\-name\fR...]" 4 .IX Item "-C, --audit [package-name...]" بررسی‌های سلامت و سازگاری پایگاه داده را برای \fIpackage\-name\fR یا در صورت عدم ذکر برای همه بسته‌ها انجام می‌دهد (بررسی به ازای هر بسته از نسخه dpkg 1.17.10). برای نمونه، به دنبال بسته‌هایی می‌گردد که تنها به‌طور ناقص روی سیستم شما نصب شده‌اند یا داده‌ها یا پرونده‌های کنترلی مفقود، نادرست یا منسوخ دارند. ابزار \&\fBdpkg\fR پیشنهاد خواهد کرد که برای برطرف کردن آن‌ها چه باید کرد. .IP "\fB\-\-update\-avail\fR [\fIPackages\-file\fR]" 4 .IX Item "--update-avail [Packages-file]" .PD 0 .IP "\fB\-\-merge\-avail\fR [\fIPackages\-file\fR]" 4 .IX Item "--merge-avail [Packages-file]" .PD اطلاعات \fBdpkg\fR و \fBdselect\fR را درباره اینکه چه بسته‌هایی در دسترس هستند به‌روزرسانی می‌کند. با دستور \fB\-\-merge\-avail\fR، اطلاعات قدیمی با اطلاعات حاصل از \fIPackages\-file\fR ترکیب می‌شوند. با دستور \fB\-\-update\-avail\fR، اطلاعات قدیمی با اطلاعات موجود در \fIPackages\-file\fR جایگزین می‌شوند. پرونده \fIPackages\-file\fR توزیع‌شده به همراه دبیان صرفاً \(Fo\fIPackages\fR\(Fc نامیده می‌شود. اگر آرگومان \fIPackages\-file\fR مشخص نشده باشد یا نام آن \(Fo\fB\-\fR\(Fc باشد، از ورودی استاندارد خوانده خواهد شد (از نسخه dpkg 1.17.7). ابزار \&\fBdpkg\fR سوابق بسته‌های در دسترس را در \fI/var/lib/dpkg/available\fR نگه‌داری می‌کند. .Sp یک دستور تک‌مرحله‌ای ساده‌تر برای دریافت و به‌روزرسانی پرونده \fIavailable\fR، دستور \fBdselect update\fR است. توجه داشته باشید که این پرونده تا حد زیادی بی‌استفاده است اگر از \fBdselect\fR استفاده نمی‌کنید بلکه از یک پیشانه مبتنی بر APT بهره می‌برید: زیرا APT سیستم اختصاصی خود را برای پیگیری بسته‌های در دسترس دارد. .IP "\fB\-A\fR, \fB\-\-record\-avail\fR \fIpackage\-file\fR..." 4 .IX Item "-A, --record-avail package-file..." اطلاعات \fBdpkg\fR و \fBdselect\fR را درباره اینکه چه بسته‌هایی در دسترس هستند با اطلاعات حاصل از بسته \fIpackage\-file\fR به‌روزرسانی می‌کند. اگر گزینه \fB\-\-recursive\fR یا \fB\-R\fR مشخص شده باشد، \fIpackage\-file\fR باید در عوض به یک دایرکتوری اشاره کند. .IP \fB\-\-forget\-old\-unavail\fR 4 .IX Item "--forget-old-unavail" اکنون \fBمنسوخ\fR و بدون عملیات (no\-op) است زیرا \fBdpkg\fR به‌طور خودکار بسته‌های نصب‌نشده و غیرقابل دسترس را فراموش می‌کند (از نسخه dpkg 1.15.4)، اما فقط آن‌هایی را که حاوی اطلاعات کاربری مانند انتخاب‌های بسته نیستند. .IP \fB\-\-clear\-avail\fR 4 .IX Item "--clear-avail" اطلاعات موجود درباره اینکه چه بسته‌هایی در دسترس هستند را پاک می‌کند. .IP "\fB\-\-get\-selections\fR [\fIpackage\-name\-pattern\fR...]" 4 .IX Item "--get-selections [package-name-pattern...]" فهرست گزینش‌های بسته‌ها را دریافت کرده و آن را در خروجی استاندارد (stdout) می‌نویسد. بدون یک الگو، بسته‌های نصب‌نشده (یعنی بسته‌هایی که پیش‌تر به‌طور کامل پاک‌سازی [purged] شده‌اند) نمایش داده نخواهند شد. .IP \fB\-\-set\-selections\fR 4 .IX Item "--set-selections" گزینش‌های بسته‌ها را با استفاده از پرونده خوانده‌شده از ورودی استاندارد (stdin) تنظیم می‌کند. این پرونده باید به قالب \(lq\fIpackage\fR \fIstate\fR\(rq باشد که در آن state یکی از \&\fBinstall\fR، \fBhold\fR، \fBdeinstall\fR یا \fBpurge\fR است. خطوط خالی و خطوط توضیحی که با \(oq\fB#\fR\(cq آغاز می‌شوند نیز مجاز هستند. .Sp برای سودمند بودن این دستور، پرونده \fIavailable\fR باید به‌روز باشد، در غیر این صورت بسته‌های ناشناخته با نمایش یک هشدار نادیده گرفته خواهند شد. برای اطلاعات بیشتر، دستورهای \fB\-\-update\-avail\fR و \fB\-\-merge\-avail\fR را ببینید. .IP \fB\-\-clear\-selections\fR 4 .IX Item "--clear-selections" وضعیت درخواستی هر بسته غیرضروری (non\-essential) را روی deinstall تنظیم می‌کند (از نسخه dpkg 1.13.18 به بعد). این گزینه برای استفاده بلافاصله پیش از \fB\-\-set\-selections\fR در نظر گرفته شده است، تا هر بسته‌ای که در فهرست ارائه‌شده به \fB\-\-set\-selections\fR قرار ندارد، deinstall شود. .IP \fB\-\-yet\-to\-unpack\fR 4 .IX Item "--yet-to-unpack" بسته‌هایی را که برای نصب گزینش شده‌اند، اما بنا به دلایلی هنوز نصب نشده‌اند، جستجو می‌کند. .Sp \&\fBنکته\fR: این دستور هم از پرونده available و هم از گزینش‌های بسته استفاده می‌کند. .IP \fB\-\-predep\-package\fR 4 .IX Item "--predep-package" یک بسته منفرد را چاپ می‌کند که هدف یک یا چند پیش‌وابستگی (pre\-dependency) مرتبط است و خودش هیچ پیش‌وابستگی برآورده‌نشده‌ای ندارد. .Sp اگر چنین بسته‌ای وجود داشته باشد، آن را به‌صورت یک مدخل پرونده Packages خروجی می‌دهد که می‌توان آن را بر حسب نیاز به شکل مناسب تغییر داد. .Sp \&\fBنکته\fR: این دستور هم از پرونده available و هم از گزینش‌های بسته استفاده می‌کند. .Sp در صورت چاپ یک بسته مقدار 0، در صورت نبود بسته مناسب مقدار 1، و در هنگام خطا مقدار 2 را برمی‌گرداند. .IP "\fB\-\-add\-architecture\fR \fIarchitecture\fR" 4 .IX Item "--add-architecture architecture" معماری \fIarchitecture\fR را به فهرست معماری‌هایی که می‌توان بسته‌ها را بدون استفاده از \fB\-\-force\-architecture\fR برای آن‌ها نصب کرد می‌افزاید (از نسخه dpkg 1.16.2 به بعد). معماری‌ای که \&\fBdpkg\fR برای آن ساخته شده است (یعنی خروجی \fB\-\-print\-architecture\fR) همواره بخشی از آن فهرست است. .IP "\fB\-\-remove\-architecture\fR \fIarchitecture\fR" 4 .IX Item "--remove-architecture architecture" معماری \fIarchitecture\fR را از فهرست معماری‌هایی که بسته‌ها می‌توانند بدون استفاده از \fB\-\-force\-architecture\fR برای آن‌ها نصب شوند حذف می‌کند (از نسخه dpkg 1.16.2 به بعد). اگر این معماری در حال حاضر در پایگاه داده مورد استفاده باشد، عملیات رد خواهد شد، مگر این‌که \fB\-\-force\-architecture\fR تعیین شده باشد. معماری‌ای که \fBdpkg\fR برای آن ساخته شده است (یعنی خروجی \&\fB\-\-print\-architecture\fR) هرگز نمی‌تواند از این فهرست حذف شود. .IP \fB\-\-print\-architecture\fR 4 .IX Item "--print-architecture" معماری بسته‌هایی را که \fBdpkg\fR نصب می‌کند چاپ می‌کند (برای نمونه، \(lqi386\(rq). .IP \fB\-\-print\-foreign\-architectures\fR 4 .IX Item "--print-foreign-architectures" فهرستی جداشده با خط جدید از معماری‌های خارجی (اضافی) را که \fBdpkg\fR پیکربندی شده است تا امکان نصب بسته‌ها را برای آن‌ها فراهم کند، چاپ می‌کند (از نسخه dpkg 1.16.2 به بعد). .IP \fB\-\-assert\-help\fR 4 .IX Item "--assert-help" راهنمایی درباره گزینه‌های \fB\-\-assert\-\fR\fIfeature\fR ارائه می‌دهد (از نسخه dpkg 1.21.0 به بعد). .IP \fB\-\-assert\-\fR\fIfeature\fR 4 .IX Item "--assert-feature" پشتیبانی \fBdpkg\fR از ویژگی درخواستی را ادعا و بررسی می‌کند. اگر ویژگی به طور کامل پشتیبانی شود مقدار 0، اگر ویژگی شناخته‌شده باشد اما \&\fBdpkg\fR هنوز قادر به پشتیبانی از آن نباشد مقدار 1، و اگر ویژگی ناشناخته باشد مقدار 2 را برمی‌گرداند. فهرست کنونی ویژگی‌های قابل‌بررسی (assertable) عبارت است از: .RS 4 .IP \fBsupport\-predepends\fR 4 .IX Item "support-predepends" پشتیبانی از فیلد \fBPre\-Depends\fR (از نسخه dpkg 1.1.0 به بعد). .IP \fBworking\-epoch\fR 4 .IX Item "working-epoch" پشتیبانی از epoch در رشته‌های نسخه (از نسخه dpkg 1.4.0.7 به بعد). .IP \fBlong\-filenames\fR 4 .IX Item "long-filenames" پشتیبانی از نام‌های پرونده طولانی در بایگانی‌های \fBdeb\fR\|(5) (از نسخه dpkg 1.4.1.17 به بعد). .IP \fBmulti\-conrep\fR 4 .IX Item "multi-conrep" پشتیبانی از چندین \fBConflicts\fR و \fBReplaces\fR (از نسخه dpkg 1.4.1.19 به بعد). .IP \fBmulti\-arch\fR 4 .IX Item "multi-arch" پشتیبانی از فیلدها و معانی چندمعماری (multi\-arch) (از نسخه dpkg 1.16.2 به بعد). .IP \fBversioned\-provides\fR 4 .IX Item "versioned-provides" پشتیبانی از \fBProvides\fR نسخه‌دار (از نسخه dpkg 1.17.11 به بعد). .IP \fBprotected\-field\fR 4 .IX Item "protected-field" پشتیبانی از فیلد \fBProtected\fR (از نسخه dpkg 1.20.1 به بعد). .RE .RS 4 .RE .IP "\fB\-\-validate\-\fR\fIthing\fR \fIstring\fR" 4 .IX Item "--validate-thing string" درست بودن نحو \fIstring\fR مربوط به \fIthing\fR را اعتبارسنجی می‌کند (از نسخه dpkg 1.18.16 به بعد). اگر \fIstring\fR معتبر باشد 0، اگر \fIstring\fR نامعتبر باشد اما ممکن است در بسترهای منعطف پذیرفته شود 1، و اگر \fIstring\fR نامعتبر باشد 2 را برمی‌گرداند. فهرست کنونی موارد قابل اعتبارسنجی (\fIthing\fRها) عبارت است از: .RS 4 .IP \fBpkgname\fR 4 .IX Item "pkgname" نام بسته داده‌شده را اعتبارسنجی می‌کند (از نسخه dpkg 1.18.16 به بعد). .IP \fBtrigname\fR 4 .IX Item "trigname" نام تریگر داده‌شده را اعتبارسنجی می‌کند (از نسخه dpkg 1.18.16 به بعد). .IP \fBarchname\fR 4 .IX Item "archname" نام معماری داده‌شده را اعتبارسنجی می‌کند (از نسخه dpkg 1.18.16 به بعد). .IP \fBversion\fR 4 .IX Item "version" نسخه داده‌شده را اعتبارسنجی می‌کند (از نسخه dpkg 1.18.16 به بعد). .RE .RS 4 .RE .IP "\fB\-\-compare\-versions\fR \fIver1\fR \fIop\fR \fIver2\fR" 4 .IX Item "--compare-versions ver1 op ver2" شماره‌های نسخه را مقایسه می‌کند، که در آن \fIop\fR یک عملگر باینری (دودویی) است. \&\fBdpkg\fR در صورتی که شرط مشخص‌شده برقرار باشد مقدار درست (\fB0\fR)، و در غیر این صورت مقدار نادرست (\fB1\fR) را بازمی‌گرداند. دو گروه از عملگرها وجود دارند که در نحوه برخورد با خالی بودن \&\fIver1\fR یا \fIver2\fR با یکدیگر تفاوت دارند. این موارد نسخه خالی را قدیمی‌تر از هر نسخه‌ای در نظر می‌گیرند: \&\fBlt le eq ne ge gt\fR. این موارد نسخه خالی را جدیدتر از هر نسخه‌ای در نظر می‌گیرند: \&\fBlt\-nl le\-nl ge\-nl gt\-nl\fR. این موارد صرفاً برای سازگاری با نحو پرونده کنترل ارائه شده‌اند: \fB< << <= = >= >> >\fR. عملگرهای \fB<\fR و \fB>\fR منسوخ شده‌اند و به دلیل معانی گیج‌کننده \fBنباید\fR استفاده شوند. برای نمونه: \fB0.1 < 0.1\fR به درست (true) ارزیابی می‌شود. .IP "\fB\-?\fR, \fB\-\-help\fR" 4 .IX Item "-?, --help" نمایش یک پیام راهنمای کوتاه. .IP \fB\-\-force\-help\fR 4 .IX Item "--force-help" ارائه راهنمایی درباره گزینه‌های \fB\-\-force\-\fR\fIthing\fR. .IP "\fB\-Dh\fR, \fB\-\-debug=help\fR" 4 .IX Item "-Dh, --debug=help" ارائه راهنمایی درباره گزینه‌های اشکال‌زدایی. .IP \fB\-\-version\fR 4 .IX Item "--version" نمایش اطلاعات نسخه \fBdpkg\fR. .Sp هنگام استفاده به همراه \fB\-\-robot\fR، خروجی شماره نسخه برنامه به قالب عددی نقطه‌دار، بدون خط جدید خواهد بود. .IP "\fBdpkg\-deb commands\fR" 4 .IX Item "dpkg-deb commands" برای اطلاعات بیشتر درباره دستورهای زیر و سایر دستورها و گزینه‌هایی که توسط بخش پیشین \fBdpkg\fR در دسترس قرار نگرفته‌اند، \fBdpkg\-deb\fR\|(1) را ببینید. .RS 4 .IP "\fB\-b\fR, \fB\-\-build\fR \fIdirectory\fR [\fIarchive\fR|\fIdirectory\fR]" 4 .IX Item "-b, --build directory [archive|directory]" ساخت یک بسته deb. .IP "\fB\-c\fR, \fB\-\-contents\fR \fIarchive\fR" 4 .IX Item "-c, --contents archive" فهرست کردن محتویات یک بسته deb. .IP "\fB\-e\fR, \fB\-\-control\fR \fIarchive\fR [\fIdirectory\fR]" 4 .IX Item "-e, --control archive [directory]" استخراج اطلاعات کنترلی از یک بسته. .IP "\fB\-x\fR, \fB\-\-extract\fR \fIarchive\fR \fIdirectory\fR" 4 .IX Item "-x, --extract archive directory" استخراج پرونده‌های موجود در بسته. .IP "\fB\-X\fR, \fB\-\-vextract\fR \fIarchive\fR \fIdirectory\fR" 4 .IX Item "-X, --vextract archive directory" استخراج و نمایش نام پرونده‌های موجود در یک بسته. .IP "\fB\-f\fR, \fB\-\-field\fR \fIarchive\fR [\fIcontrol\-field\fR...]" 4 .IX Item "-f, --field archive [control-field...]" نمایش فیلد(های) کنترلی یک بسته. .IP "\fB\-\-ctrl\-tarfile\fR \fIarchive\fR" 4 .IX Item "--ctrl-tarfile archive" خروجی دادن پرونده tar کنترلی موجود در یک بسته دبیان. .IP "\fB\-\-fsys\-tarfile\fR \fIarchive\fR" 4 .IX Item "--fsys-tarfile archive" خروجی دادن پرونده tar سیستم‌پرونده موجود در یک بسته دبیان. .IP "\fB\-I\fR, \fB\-\-info\fR \fIarchive\fR [\fIcontrol\-file\fR...]" 4 .IX Item "-I, --info archive [control-file...]" نمایش اطلاعات درباره یک بسته. .RE .RS 4 .RE .IP "\fBdpkg\-query commands\fR" 4 .IX Item "dpkg-query commands" برای اطلاعات بیشتر درباره دستورهای زیر و سایر دستورها و گزینه‌هایی که توسط بخش پیشین \fBdpkg\fR در دسترس قرار نگرفته‌اند، \fBdpkg\-query\fR\|(1) را ببینید. .RS 4 .IP "\fB\-l\fR, \fB\-\-list\fR \fIpackage\-name\-pattern\fR..." 4 .IX Item "-l, --list package-name-pattern..." فهرست کردن بسته‌های منطبق بر الگوی داده‌شده. .IP "\fB\-s\fR, \fB\-\-status\fR \fIpackage\-name\fR..." 4 .IX Item "-s, --status package-name..." گزارش وضعیت بسته مشخص‌شده. .IP "\fB\-L\fR, \fB\-\-listfiles\fR \fIpackage\-name\fR..." 4 .IX Item "-L, --listfiles package-name..." فهرست کردن پرونده‌های نصب‌شده روی سیستم شما از \fIpackage\-name\fR. .IP "\fB\-S\fR, \fB\-\-search\fR \fIfilename\-search\-pattern\fR..." 4 .IX Item "-S, --search filename-search-pattern..." جستجوی یک نام پرونده در میان بسته‌های نصب‌شده. .IP "\fB\-p\fR, \fB\-\-print\-avail\fR \fIpackage\-name\fR..." 4 .IX Item "-p, --print-avail package-name..." نمایش جزئیات درباره \fIpackage\-name\fR، همان‌طور که در \&\fI/var/lib/dpkg/available\fR یافت می‌شود. کاربران رابط‌های کاربری مبتنی بر APT باید در عوض از \fBapt show\fR \fIpackage\-name\fR استفاده کنند. .RE .RS 4 .RE .SH "گزینه‌ها (OPTIONS)" .IX Header "OPTIONS" تمامی گزینه‌ها را می‌توان هم در خط فرمان و هم در فایل پیکربندی \fBdpkg\fR به نشانی \fI/etc/dpkg/dpkg.cfg\fR یا فایل‌های تکه‌ای (با نام‌هایی مطابق با الگوی شل \*(Aq[0\-9a\-zA\-Z_\-]*\*(Aq) در دایرکتوری پیکربندی \fI/etc/dpkg/dpkg.cfg.d/\fR مشخص کرد. هر خط در فایل پیکربندی یا یک گزینه است (دقیقاً همانند گزینه خط فرمان اما بدون خط‌تیره‌های ابتدایی) یا یک یادداشت/توضیح (اگر با \(oq\fB#\fR\(cq شروع شود). .IP \fB\-\-abort\-after=\fR\fInumber\fR 4 .IX Item "--abort-after=number" تغییر تعداد خطاهایی که پس از آن \fBdpkg\fR متوقف خواهد شد. مقدار پیش‌فرض 50 است. .IP "\fB\-B\fR, \fB\-\-auto\-deconfigure\fR" 4 .IX Item "-B, --auto-deconfigure" هنگامی که بسته‌ای حذف می‌شود، این احتمال وجود دارد که بستهٔ نصب‌شدهٔ دیگری به بستهٔ حذف‌شده وابسته باشد. مشخص کردن این گزینه موجب غیرپیکربندی خودکار بسته‌ای می‌شود که به بستهٔ حذف‌شده وابسته بوده است. .IP "\fB\-D\fR\fIoctal\fR, \fB\-\-debug=\fR\fIoctal\fR" 4 .IX Item "-Doctal, --debug=octal" روشن کردن اشکال‌زدایی. \&\fIoctal\fR با انجام عملیات بیتی OR بر روی مقادیر دلخواه از فهرست زیر تشکیل می‌شود (توجه داشته باشید که این مقادیر ممکن است در نسخه‌های بعدی تغییر کنند). \&\fB\-Dh\fR یا \fB\-\-debug=help\fR این مقادیر اشکال‌زدایی را نمایش می‌دهند. .Sp .Vb 10 \& Number Description \& 1 Generally helpful progress information \& 2 Invocation and status of maintainer scripts \& 10 Output for each file processed \& 100 Lots of output for each file processed \& 20 Output for each configuration file \& 200 Lots of output for each configuration file \& 40 Dependencies and conflicts \& 400 Lots of dependencies/conflicts output \& 10000 Trigger activation and processing \& 20000 Lots of output regarding triggers \& 40000 Silly amounts of output regarding triggers \& 1000 Lots of drivel about for example the dpkg/info dir \& 2000 Insane amounts of drivel .Ve .IP \fB\-\-force\-\fR\fIthings\fR 4 .IX Item "--force-things" .PD 0 .IP "\fB\-\-no\-force\-\fR\fIthings\fR, \fB\-\-refuse\-\fR\fIthings\fR" 4 .IX Item "--no-force-things, --refuse-things" .PD اجبار یا خودداری از (\fBno\-force\fR و \fBrefuse\fR به یک معنا هستند) انجام برخی کارها. \&\fIthings\fR فهرستی از موارد مشخص‌شده در زیر است که با کاما از هم جدا شده‌اند. \&\fB\-\-force\-help\fR پیامی را در شرح آن‌ها نمایش می‌دهد. مواردی که با علامت (*) مشخص شده‌اند، به‌طور پیش‌فرض اجبار می‌شوند. .Sp \&\fBهشدار\fR: این گزینه‌ها عمدتاً تنها برای استفاده متخصصان در نظر گرفته شده‌اند. استفاده از آن‌ها بدون درک کامل اثراتشان ممکن است کل سیستم شما را از کار بیندازد. .RS 4 .IP \fBall\fR: 2 .IX Item "all:" تمامی گزینه‌های اجبار را فعال (یا غیرفعال) می‌کند. .IP \fBdowngrade\fR(*): 2 .IX Item "downgrade(*):" نصب یک بسته، حتی اگر نسخهٔ جدیدتری از آن هم‌اکنون نصب شده باشد. .Sp \&\fBهشدار\fR: در حال حاضر \fBdpkg\fR هیچ‌گونه بررسی وابستگی در زمان پس‌رفت نسخه (downgrade) انجام نمی‌دهد و بنابراین اگر پس‌رفت نسخه وابستگی بسته دیگری را بشکند، به شما هشدار نخواهد داد. این کار می‌تواند اثرات جانبی جدی به همراه داشته باشد؛ تنزل نسخه مؤلفه‌های حیاتی سیستم حتی می‌تواند کل سیستم شما را غیرقابل‌استفاده کند. با احتیاط استفاده کنید. .IP \fBconfigure\-any\fR: 2 .IX Item "configure-any:" پیکربندی هر بستهٔ از بسته‌بندی خارج‌شده اما پیکربندی‌نشده‌ای که بستهٔ فعلی به آن وابسته است. .IP \fBhold\fR: 2 .IX Item "hold:" اجازه دادن به نصب، ارتقا یا حذف خودکار بسته‌ها حتی زمانی که در وضعیت \(lqhold\(rq علامت‌گذاری شده باشند. \&\fBتوجه\fR: هنگامی که این اقدامات به طور صریح درخواست شوند، وضعیت انتخاب بسته در حالت \(lqhold\(rq همواره نادیده گرفته می‌شود. .IP \fBremove\-reinstreq\fR: 2 .IX Item "remove-reinstreq:" حذف یک بسته، حتی اگر شکسته باشد و به عنوان نیازمند نصب مجدد علامت‌گذاری شده باشد. این کار برای مثال ممکن است باعث شود بخش‌هایی از بسته روی سیستم باقی بماند که پس از آن توسط \fBdpkg\fR فراموش خواهد شد. .IP \fBremove\-protected\fR: 2 .IX Item "remove-protected:" حذف بسته، حتی اگر محافظت‌شده تلقی شود (از زمان dpkg 1.20.1). بسته‌های محافظت‌شده عمدتاً شامل زیرساخت‌های مهم راه‌اندازی سیستم هستند یا برای فرا‌بسته‌های سفارشی محلی سیستم (system\-local meta\-packages) استفاده می‌شوند. حذف آن‌ها ممکن است باعث شود کل سیستم قادر به راه‌اندازی (بوت) نباشد یا عملکردهای ضروری برای کارکرد را از دست بدهد، بنابراین با احتیاط استفاده کنید. .IP \fBremove\-essential\fR: 2 .IX Item "remove-essential:" حذف بسته، حتی اگر بسته حیاتی (essential) تلقی شود. بسته‌های حیاتی عمدتاً شامل دستورات بسیار پایه‌ای یونیکس هستند که برای سیستم بسته‌بندی، کارکرد عمومی سیستم یا در حین بوت مورد نیازند (اگرچه مورد آخر باید به بسته‌های محافظت‌شده تبدیل شود). حذف آن‌ها ممکن است باعث از کار افتادن کل سیستم شود، بنابراین با احتیاط استفاده کنید. .IP \fBdepends\fR: 2 .IX Item "depends:" تبدیل تمام مشکلات وابستگی به هشدار. این گزینه بر فیلدهای \fBPre\-Depends\fR و \fBDepends\fR تأثیر می‌گذارد. .IP \fBdepends\-version\fR: 2 .IX Item "depends-version:" صرف‌نظر کردن از نسخه‌ها هنگام بررسی وابستگی‌ها. این گزینه بر فیلدهای \fBPre\-Depends\fR و \fBDepends\fR تأثیر می‌گذارد. .IP \fBbreaks\fR: 2 .IX Item "breaks:" نصب، حتی اگر این کار بستهٔ دیگری را بشکند (از زمان dpkg 1.14.6). این گزینه بر فیلد \fBBreaks\fR تأثیر می‌گذارد. .IP \fBconflicts\fR: 2 .IX Item "conflicts:" نصب، حتی اگر با بسته دیگری تعارض داشته باشد. این کار خطرناک است، زیرا معمولاً باعث بازنویسی برخی از فایل‌ها می‌شود. این گزینه بر فیلد \fBConflicts\fR تأثیر می‌گذارد. .IP \fBconfmiss\fR: 2 .IX Item "confmiss:" نصب همیشگی فایل پیکربندی (conffile) مفقودشده بدون درخواست تأیید. این کار خطرناک است، زیرا به معنای حفظ نکردن تغییر اعمال‌شده روی فایل (حذف آن) است. .IP \fBconfnew\fR: 2 .IX Item "confnew:" اگر یک فایل پیکربندی (conffile) تغییر یافته باشد و نسخهٔ موجود در بسته نیز تغییر کرده باشد، همیشه نسخه جدید را بدون اعلان نصب کند، مگر آن‌که \&\fB\-\-force\-confdef\fR نیز مشخص شده باشد که در این صورت اقدام پیش‌فرض ترجیح داده می‌شود. .IP \fBconfold\fR: 2 .IX Item "confold:" اگر یک فایل پیکربندی (conffile) تغییر یافته باشد و نسخهٔ موجود در بسته نیز تغییر کرده باشد، همیشه نسخه قدیمی را بدون اعلان نگه دارد، مگر آن‌که \&\fB\-\-force\-confdef\fR نیز مشخص شده باشد که در این صورت اقدام پیش‌فرض ترجیح داده می‌شود. .IP \fBconfdef\fR: 2 .IX Item "confdef:" اگر یک فایل پیکربندی (conffile) تغییر یافته باشد و نسخهٔ موجود در بسته نیز تغییر کرده باشد، همیشه اقدام پیش‌فرض را بدون اعلان انتخاب کند. اگر اقدام پیش‌فرضی وجود نداشته باشد، متوقف می‌شود تا از کاربر بپرسد، مگر اینکه \fB\-\-force\-confnew\fR یا \&\fB\-\-force\-confold\fR نیز مشخص شده باشد که در این صورت از آن برای تصمیم‌گیری در مورد اقدام نهایی استفاده خواهد کرد. .IP \fBconfask\fR: 2 .IX Item "confask:" اگر یک فایل پیکربندی (conffile) تغییر یافته باشد، همیشه جایگزینی آن با نسخهٔ موجود در بسته را پیشنهاد دهد، حتی اگر نسخهٔ درون بسته تغییری نکرده باشد (از زمان dpkg 1.15.8). اگر هر یک از گزینه‌های \fB\-\-force\-confnew\fR، \&\fB\-\-force\-confold\fR یا \fB\-\-force\-confdef\fR نیز داده شده باشد، از آن برای تصمیم‌گیری اقدام نهایی استفاده خواهد شد. .IP \fBoverwrite\fR: 2 .IX Item "overwrite:" بازنویسی فایل یک بسته با فایل بسته دیگر. .IP \fBoverwrite\-dir\fR: 2 .IX Item "overwrite-dir:" بازنویسی دایرکتوری یک بسته با فایل بسته دیگر. .IP \fBoverwrite\-diverted\fR: 2 .IX Item "overwrite-diverted:" بازنویسی یک فایل منحرف‌شده (diverted) با یک نسخه منحرف‌نشده. .IP \fBstatoverride\-add\fR: 2 .IX Item "statoverride-add:" بازنویسی یک stat override موجود هنگام افزودن آن (از زمان dpkg 1.19.5). .IP \fBstatoverride\-remove\fR: 2 .IX Item "statoverride-remove:" نادیده گرفتن نبودِ یک stat override هنگام حذف آن (از زمان dpkg 1.19.5). .IP \fBsecurity\-mac\fR(*): 2 .IX Item "security-mac(*):" استفاده از امنیت مبتنی بر کنترل‌های دسترسی اجباری (MAC) ویژه پلتفرم هنگام نصب فایل‌ها در سیستم‌فایل (از زمان dpkg 1.19.5). در سیستم‌های لینوکس، این پیاده‌سازی از SELinux استفاده می‌کند. .IP \fBunsafe\-io\fR: 2 .IX Item "unsafe-io:" عدم انجام عملیات I/O ایمن هنگام باز کردن بسته‌ها (از زمان dpkg 1.15.8.6). در حال حاضر این امر به معنای عدم انجام همگام‌سازی‌های سیستم‌فایل (sync) پیش از تغییر نام فایل‌ها است؛ موضوعی که مشخص شده در برخی سیستم‌های فایل باعث افت محسوس کارایی می‌شود، متأسفانه همان‌هایی که در وهله اول به دلیل رفتار غیرقابل‌اعتمادشان در ایجاد فایل‌های با طول صفر هنگام فروپاشی ناگهانی سیستم، نیازمند I/O ایمن هستند. .Sp \&\fIیادداشت\fR: برای ext4، که مقصر اصلی است، در عوض استفاده از گزینه اتصال \fBnodelalloc\fR را مد نظر قرار دهید؛ این گزینه هم افت کارایی و هم مسائل ایمنی داده‌ها را برطرف می‌کند؛ دومی با جلوگیری از ایجاد فایل‌های با طول صفر توسط سیستم‌فایل در هنگام فروپاشی ناگهانی سیستم توسط هر نرم‌افزاری که پیش از تغییر نام‌های اتمیک عملیات sync را انجام نمی‌دهد. .Sp \&\fBهشدار\fR: استفاده از این گزینه ممکن است کارایی را به قیمت از دست رفتن داده‌ها بهبود بخشد، با احتیاط استفاده کنید. .IP \fBscript\-chrootless\fR: 2 .IX Item "script-chrootless:" اجرای اسکریپت‌های نگه‌دارنده بدون عمل \fBchroot\fR\|(2) در \fBinstdir\fR حتی اگر بسته از این شیوه عملیاتی پشتیبانی نکند (از زمان dpkg 1.18.5). .Sp \&\fBهشدار\fR: این کار می‌تواند سیستم میزبان شما را نابود کند، با احتیاط بسیار بالا استفاده کنید. .IP \fBarchitecture\fR: 2 .IX Item "architecture:" پردازش بسته‌ها حتی با معماری نادرست یا بدون معماری. .IP \fBbad\-version\fR: 2 .IX Item "bad-version:" پردازش بسته‌ها حتی با نسخه‌های نادرست (از زمان dpkg 1.16.1). .IP \fBbad\-path\fR: 2 .IX Item "bad-path:" برنامه‌های مهم در \&\fBPATH\fR مفقود هستند، بنابراین احتمال بروز مشکل زیاد است. .IP \fBnot\-root\fR: 2 .IX Item "not-root:" تلاش برای نصب یا حذف موارد حتی بدون دسترسی ریشه (root). .IP \fBbad\-verify\fR: 2 .IX Item "bad-verify:" نصب یک بسته حتی در صورت مردود شدن در بررسی اصالت‌سنجی. .RE .RS 4 .RE .IP \fB\-\-ignore\-depends\fR=\fIpackage\fR,... 4 .IX Item "--ignore-depends=package,..." صرف‌نظر کردن از بررسی وابستگی‌ها برای بسته‌های مشخص‌شده (در واقع، بررسی انجام می‌شود، اما فقط هشدارهایی پیرامون تعارض‌ها ارائه می‌گردد و نه چیز دیگری). این گزینه بر فیلدهای \fBPre\-Depends\fR، \fBDepends\fR و \fBBreaks\fR تأثیر می‌گذارد. .IP "\fB\-\-no\-act\fR, \fB\-\-dry\-run\fR, \fB\-\-simulate\fR" 4 .IX Item "--no-act, --dry-run, --simulate" تمام کارهایی را که قرار است انجام شوند انجام می‌دهد، اما هیچ تغییری را ثبت نمی‌کند. این گزینه برای مشاهده آنچه با دستور مشخص‌شده رخ خواهد داد، بدون تغییر واقعی هر چیزی، به کار می‌رود. .Sp حتماً \fB\-\-no\-act\fR را پیش از پارامتر دستور قرار دهید، در غیر این صورت ممکن است با نتایج نامطلوبی مواجه شوید (برای نمونه، \fBdpkg \-\-purge foo \-\-no\-act\fR ابتدا بسته \(lqfoo\(rq را پاکسازی می‌کند و سپس تلاش می‌کند بسته \(rq\-\-no\-act\(rq را پاکسازی کند، با وجود اینکه احتمالاً انتظار داشتید در عمل کاری انجام ندهد). .IP "\fB\-R\fR, \fB\-\-recursive\fR" 4 .IX Item "-R, --recursive" به‌طور بازگشتی تمام پرونده‌های عادی منطبق با الگوی \fB*.deb\fR موجود در پوشه‌های مشخص‌شده و همه زیرپوشه‌های آن‌ها را پردازش می‌کند. این گزینه می‌تواند با دستورهای \fB\-i\fR، \fB\-A\fR، \fB\-\-install\fR، \fB\-\-unpack\fR و \&\fB\-\-record\-avail\fR استفاده شود. .IP \fB\-G\fR 4 .IX Item "-G" اگر نسخه جدیدتری از همان بسته قبلاً نصب شده باشد، بسته را نصب نمی‌کند. این یک نام مستعار برای \fB\-\-refuse\-downgrade\fR است. .IP \fB\-\-admindir=\fR\fIdirectory\fR 4 .IX Item "--admindir=directory" پوشه مدیریتی را روی \fIdirectory\fR تنظیم می‌کند. این پوشه شامل پرونده‌های بسیاری است که اطلاعاتی درباره وضعیت بسته‌های نصب‌شده یا حذف‌شده و غیره ارائه می‌دهند. در صورتی که \fBDPKG_ADMINDIR\fR تنظیم نشده باشد، مقدار پیش‌فرض \(Fo\fI/var/lib/dpkg\fR\(Fc است. .IP \fB\-\-instdir=\fR\fIdirectory\fR 4 .IX Item "--instdir=directory" پوشه نصب را تنظیم می‌کند، که اشاره به پوشه‌ای دارد که قرار است بسته‌ها در آن نصب شوند. \&\fBinstdir\fR همچنین پوشه‌ای است که قبل از اجرای اسکریپت‌های نصب بسته به \fBchroot\fR\|(2) داده می‌شود، که بدان معناست که اسکریپت‌ها \fBinstdir\fR را به عنوان پوشه ریشه می‌بینند. در صورتی که \fBDPKG_ROOT\fR تنظیم نشده باشد، مقدار پیش‌فرض \(Fo\fI/\fR\(Fc است (از dpkg 1.21.10). .IP \fB\-\-root=\fR\fIdirectory\fR 4 .IX Item "--root=directory" پوشه ریشه را روی \fBdirectory\fR تنظیم می‌کند، که در صورت تنظیم نبودن \fBDPKG_ROOT\fR، پوشه نصب را روی \(Fo\fIdirectory\fR\(Fc و پوشه مدیریتی را روی \(Fo\fIdirectory\fR\fB/var/lib/dpkg\fR\(Fc قرار می‌دهد (از dpkg 1.21.10). .IP "\fB\-O\fR, \fB\-\-selected\-only\fR" 4 .IX Item "-O, --selected-only" تنها بسته‌هایی را که برای نصب انتخاب شده‌اند پردازش می‌کند. علامت‌گذاری واقعی با \fBdselect\fR یا توسط \fBdpkg\fR هنگام کار با بسته‌ها انجام می‌شود. برای نمونه، هنگامی که بسته‌ای حذف می‌شود، به عنوان انتخاب‌شده برای حذف علامت‌گذاری خواهد شد. .IP "\fB\-E\fR, \fB\-\-skip\-same\-version\fR" 4 .IX Item "-E, --skip-same-version" اگر همان نسخه و معماری از بسته قبلاً نصب شده باشد، بسته را نصب نمی‌کند. .Sp از dpkg 1.21.10 به بعد، معماری نیز در نظر گرفته می‌شود، که امکان تبدیل معماری (cross-grade) بسته‌ها یا نصب نمونه‌های هم‌نصب‌پذیر اضافی با همان نسخه ولی معماری متفاوت را ممکن می‌سازد. .IP \fB\-\-pre\-invoke=\fR\fIcommand\fR 4 .IX Item "--pre-invoke=command" .PD 0 .IP \fB\-\-post\-invoke=\fR\fIcommand\fR 4 .IX Item "--post-invoke=command" .PD یک دستور قلاب فراخوانی \fIcommand\fR را تنظیم می‌کند تا از طریق \(lqsh \-c\(rq قبل یا بعد از اجرای \fBdpkg\fR برای عملیات‌های \fIunpack\fR، \fIconfigure\fR، \fIinstall\fR، \&\fItriggers\-only\fR، \&\fIremove\fR و \&\fIpurge\fR (از dpkg 1.15.4)، و عملیات‌های \&\fIadd\-architecture\fR و \&\fIremove\-architecture\fR (از dpkg 1.17.19) اجرا شود. این گزینه می‌تواند چندین بار مشخص شود. ترتیب مشخص شدن گزینه‌ها حفظ می‌شود و گزینه‌های موجود در پرونده‌های پیکربندی اولویت دارند. متغیر محیطی \fBDPKG_HOOK_ACTION\fR برای قلاب‌ها روی عملیات فعلی \fBdpkg\fR تنظیم می‌شود. .Sp قلاب‌های فراخوانی در صورت مشخص شدن \fB\-\-no\-act\fR، یا هنگام اجرا به عنوان کاربر غیرریشه بدون \fB\-\-force\-not\-root\fR اجرا نمی‌شوند. .Sp \&\fBتوجه\fR: رابط‌های کاربری (Front-ends) ممکن است در هر بار فراخوانی چندین بار \fBdpkg\fR را صدا بزنند، که ممکن است باعث شود قلاب‌ها بیشتر از دفعات مورد انتظار اجرا شوند. .IP \fB\-\-path\-exclude=\fR\fIglob\-pattern\fR 4 .IX Item "--path-exclude=glob-pattern" .PD 0 .IP \fB\-\-path\-include=\fR\fIglob\-pattern\fR 4 .IX Item "--path-include=glob-pattern" .PD الگوی \fIglob\-pattern\fR را به عنوان فیلتر مسیر تنظیم می‌کند، چه با مستثنی کردن یا گنجاندن مجدد مسیرهای قبلاً مستثنی‌شده منطبق با الگوهای مشخص‌شده در طول نصب (از dpkg 1.15.8). .Sp \&\fBهشدار\fR: در نظر داشته باشید که بسته به مسیرهای مستثنی‌شده ممکن است سیستم خود را کاملاً از کار بیندازید، با احتیاط استفاده کنید. .Sp الگوهای glob از همان نویسه‌های عام مورد استفاده در پوسته استفاده می‌کنند، که در آن \(oq*\(cq با هر توالی از نویسه‌ها، شامل رشته خالی و همچنین \(oq/\(cq مطابقت دارد. برای نمونه، \(Fo\fI/usr/*/READ*\fR\(Fc با \(Fo\fI/usr/share/doc/package/README\fR\(Fc مطابقت دارد. طبق معمول، \(oq?\(cq با هر تک‌نویسه (باز هم شامل \(oq/\(cq) مطابقت دارد. و \(oq[\(cq یک رده نویسه‌ای را آغاز می‌کند که می‌تواند شامل فهرستی از نویسه‌ها، محدوده‌ها و متمم‌ها باشد. برای اطلاعات تفصیلی درباره الگوهای globbing، \fBglob\fR\|(7) را ببینید. \&\fBتوجه\fR: پیاده‌سازی فعلی ممکن است پوشه‌ها و پیوندهای نمادین بیشتری را نسبت به آنچه لازم است مجدداً بگنجاند، به‌ویژه هنگامی که یک گنجاندن مجدد خاص‌تر وجود دارد، تا احتیاط رعایت شده و از شکست‌های احتمالی در باز کردن بسته جلوگیری شود؛ کارهای آینده ممکن است این مورد را اصلاح کنند. .Sp این گزینه می‌تواند برای حذف همه مسیرها به جز برخی مسیرهای خاص استفاده شود؛ یک مورد متداول عبارت است از: .Sp .Vb 2 \& \-\-path\-exclude=/usr/share/doc/* \& \-\-path\-include=/usr/share/doc/*/copyright .Ve .Sp برای حذف همه پرونده‌های مستندات به جز پرونده‌های حق نشر (copyright). .Sp این دو گزینه می‌توانند چندین بار مشخص شده و به صورت متناوب با یکدیگر ترکیب شوند. هر دو بر اساس ترتیب داده‌شده پردازش می‌شوند، و آخرین قانونی که با نام پرونده مطابقت داشته باشد تصمیم نهایی را می‌گیرد. .Sp این فیلترها هنگام باز کردن بسته‌های باینری اعمال می‌شوند، و به همین دلیل تنها از نوع شیء در حال فیلتر شدن (برای نمونه یک پرونده عادی یا یک پوشه) آگاهی دارند و هیچ دیدی نسبت به اینکه چه اشیائی در ادامه خواهند آمد ندارند. از آنجا که این فیلترها عوارض جانبی دارند (برخلاف فیلترهای \fBfind\fR\|(1))، مستثنی کردن یک نام مسیر دقیق که از قضا یک شیء پوشه است مانند \fI/usr/share/doc\fR نتیجه مطلوب را به همراه نخواهد داشت، و فقط همان نام مسیر مستثنی خواهد شد (که در صورت تشخیص نیاز توسط کد، ممکن است به طور خودکار مجدداً گنجانده شود). باز کردن هر پرونده بعدی موجود در آن پوشه با شکست مواجه خواهد شد. .Sp \&\fBراهنمایی\fR: اطمینان حاصل کنید که الگوهای glob توسط پوسته شما بسط داده نشوند. .IP "\fB\-\-verify\-format\fR \fIformat\-name\fR" 4 .IX Item "--verify-format format-name" قالب خروجی را برای دستور \fB\-\-verify\fR تنظیم می‌کند (از dpkg 1.17.2). .Sp تنها قالب خروجی که در حال حاضر پشتیبانی می‌شود \fBrpm\fR است، که از یک خط برای هر مسیری که در هر آزمونی شکست خورده تشکیل شده است. این خطوط قالب زیر را دارند: .Sp \fBmissing \fR [\fBc\fR] \fIpathname\fR [\fB(\fR\fIerror\-message\fR\fB)\fR] \fB?M5??????\fR [\fBc\fR] \fIpathname\fR .Sp ۹ نویسه اول برای گزارش نتیجه بررسی‌ها استفاده می‌شوند، چه عبارت لفظی \fBmissing\fR هنگامی که پرونده وجود ندارد یا فرا داده‌های آن قابل واکشی نیستند، یا یکی از نویسه‌های ویژه زیر که نتیجه را برای هر بررسی گزارش می‌کنند: .RS 4 .IP \(oq\fB?\fR\(cq 4 .IX Item "\(oq?\(cq" نشان‌دهنده این است که بررسی امکان‌پذیر نبود (عدم پشتیبانی، مجوزهای پرونده، و غیره). .IP \(oq\fB.\fR\(cq 4 .IX Item "\(oq.\(cq" نشان‌دهنده قبولی در بررسی است. .IP \(oq\fIA\-Za\-z0\-9\fR\(cq 4 .IX Item "\(oqA-Za-z0-9\(cq" نشان‌دهنده شکست یک بررسی خاص است. موقعیت‌ها و نویسه‌های الفبایی‌عددی زیر در حال حاضر پشتیبانی می‌شوند: .RS 4 .IP "1 \(oq\fB?\fR\(cq" 4 .IX Item "1 \(oq?\(cq" این بررسی‌ها در حال حاضر پشتیبانی نمی‌شوند، همیشه \(oq\fB?\fR\(cq خواهند بود. .IP "2 \(oq\fBM\fR\(cq" 4 .IX Item "2 \(oqM\(cq" بررسی حالت پرونده با شکست مواجه شد (از dpkg 1.21.0). از آنجا که فرا داده‌های نام مسیر در حال حاضر رهگیری نمی‌شوند، این بررسی تنها می‌تواند از طریق یک روش اکتشافی بسیار ساده برای نام مسیرهایی که چکیده شناخته‌شده دارند تا حدی شبیه‌سازی شود، که نشان می‌دهد آن‌ها باید پرونده‌های عادی باشند، و در صورتی که نام مسیر یک پرونده عادی روی سیستم پرونده نباشد بررسی شکست خواهد خورد. این بررسی در حال حاضر هرگز موفق نخواهد شد زیرا اطلاعات کافی در دسترس ندارد. .IP "3 \(oq\fB5\fR\(cq" 4 .IX Item "3 \(oq5\(cq" بررسی چکیده (digest) با شکست مواجه شد، که به معنای تغییر محتوای پرونده است. این تنها یک بررسی یکپارچگی است و نباید به عنوان هیچ نوع راستی‌آزمایی امنیتی در نظر گرفته شود. .IP "4\-9 \(oq\fB?\fR\(cq" 4 .IX Item "4-9 \(oq?\(cq" این بررسی‌ها در حال حاضر پشتیبانی نمی‌شوند، همیشه \(oq\fB?\fR\(cq خواهند بود. .RE .RS 4 .RE .RE .RS 4 .Sp پس از این خط یک فاصله و یک نویسه صفت می‌آید. نویسه صفت زیر پشتیبانی می‌شود: .IP \(oq\fBc\fR\(cq 4 .IX Item "\(oqc\(cq" نام مسیر یک conffile است. .RE .RS 4 .Sp در نهایت با یک فاصله دیگر و نام مسیر دنبال می‌شود. .Sp در صورتی که مدخل از نوع \fBmissing\fR باشد، و پرونده در واقعیت روی سیستم پرونده وجود نداشته باشد، پس از خط یک فاصله و پیام خطا درون پرانتز قرار می‌گیرد. .RE .IP "\fB\-\-status\-fd\fR \fIn\fR" 4 .IX Item "--status-fd n" اطلاعات وضعیت بسته و پیشرفت را به شکل ماشین‌خوان به توصیف‌کننده پرونده \fIn\fR ارسال می‌کند. این گزینه می‌تواند چندین بار مشخص شود. اطلاعات عموماً یک رکورد در هر خط است، در یکی از قالب‌های زیر: .RS 4 .IP "\fBstatus:\fR \fIpackage\fR\fB:\fR \fIstatus\fR" 4 .IX Item "status: package: status" وضعیت بسته تغییر کرد؛ \fIstatus\fR همانند مقدار موجود در پرونده وضعیت است. .IP "\fBstatus:\fR \fIpackage\fR \fB: error :\fR \fIextended\-error\-message\fR" 4 .IX Item "status: package : error : extended-error-message" خطایی رخ داد. هرگونه خط جدید احتمالی در \fIextended\-error\-message\fR قبل از خروجی به فاصله تبدیل خواهد شد. .IP "\fBstatus:\fR \fIfile\fR \fB: conffile\-prompt : \*(Aq\fR\fIreal\-old\fR\fB\*(Aq \*(Aq\fR\fIreal\-new\fR\fB\*(Aq\fR \fIuseredited\fR \fIdistedited\fR" 4 .IX Item "status: file : conffile-prompt : 'real-old' 'real-new' useredited distedited" از کاربر یک پرسش conffile پرسیده می‌شود. .IP "\fBprocessing:\fR \fIstage\fR\fB:\fR \fIpackage\fR" 4 .IX Item "processing: stage: package" درست قبل از آغاز یک مرحله پردازش ارسال می‌شود. \&\fIstage\fR یکی از موارد \&\fBupgrade\fR، \fBinstall\fR (هر دو پیش از باز کردن بسته ارسال می‌شوند)، \&\fBconfigure\fR، \fBtrigproc\fR، \fBdisappear\fR، \fBremove\fR، \fBpurge\fR است. .RE .RS 4 .RE .IP \fB\-\-status\-logger\fR=\fIcommand\fR 4 .IX Item "--status-logger=command" اطلاعات وضعیت بسته و پیشرفت را به شکل ماشین‌خوان به ورودی استاندارد دستور پوسته \fIcommand\fR که قرار است از طریق \(lqsh \-c\(rq اجرا شود ارسال می‌کند (از dpkg 1.16.0). این گزینه می‌تواند چندین بار مشخص شود. قالب خروجی استفاده‌شده همانند \fB\-\-status\-fd\fR است. .Sp ثبت‌کننده‌های وضعیت در صورت مشخص شدن \fB\-\-no\-act\fR، یا هنگام اجرا به عنوان کاربر غیرریشه بدون \fB\-\-force\-not\-root\fR اجرا نمی‌شوند. .IP \fB\-\-log=\fR\fIfilename\fR 4 .IX Item "--log=filename" به‌روزرسانی‌های تغییر وضعیت و اقدامات را به جای پرونده پیش‌فرض \fI/var/log/dpkg.log\fR، در \fIfilename\fR ثبت می‌کند. اگر این گزینه چندین بار داده شود، از آخرین نام پرونده استفاده می‌شود. پیام‌های ثبت وقایع به شکل زیر هستند: .RS 4 .IP "YYYY\-MM\-DD HH:MM:SS \fBstartup\fR \fItype\fR \fIcommand\fR" 4 .IX Item "YYYY-MM-DD HH:MM:SS startup type command" برای هر فراخوانی dpkg که در آن \fItype\fR برابر با \fBarchives\fR است (با یک \&\fIcommand\fR از نوع \fBunpack\fR یا \fBinstall\fR) یا \fBpackages\fR (با یک \fIcommand\fR از نوع \fBconfigure\fR، \&\fBtriggers\-only\fR، \&\fBremove\fR یا \fBpurge\fR). .IP "YYYY\-MM\-DD HH:MM:SS \fBstatus\fR \fIstate\fR \fIpkg\fR \fIinstalled\-version\fR" 4 .IX Item "YYYY-MM-DD HH:MM:SS status state pkg installed-version" برای به‌روزرسانی‌های تغییر وضعیت. .IP "YYYY\-MM\-DD HH:MM:SS \fIaction\fR \fIpkg\fR \fIinstalled\-version\fR \fIavailable\-version\fR" 4 .IX Item "YYYY-MM-DD HH:MM:SS action pkg installed-version available-version" برای اقداماتی که در آن‌ها \fIaction\fR یکی از موارد \fBinstall\fR، \fBupgrade\fR، \&\fBconfigure\fR، \fBtrigproc\fR، \fBdisappear\fR، \fBremove\fR یا \fBpurge\fR است. .IP "YYYY\-MM\-DD HH:MM:SS \fBconffile\fR \fIfilename\fR \fIdecision\fR" 4 .IX Item "YYYY-MM-DD HH:MM:SS conffile filename decision" برای تغییرات conffile که در آن \fIdecision\fR یا \fBinstall\fR است یا \&\fBkeep\fR. .RE .RS 4 .RE .IP \fB\-\-robot\fR 4 .IX Item "--robot" از یک قالب خروجی ماشین‌خوان استفاده می‌کند. این گزینه رابطی را برای برنامه‌هایی فراهم می‌کند که نیاز به تجزیه خروجی برخی از دستوراتی دارند که در غیر این صورت قالب خروجی ماشین‌خوان تولید نمی‌کنند. هیچ بومی‌سازی استفاده نخواهد شد، و خروجی برای سهولت در تجزیه اصلاح می‌شود. .Sp تنها دستوری که در حال حاضر پشتیبانی می‌شود \fB\-\-version\fR است. .IP \fB\-\-no\-pager\fR 4 .IX Item "--no-pager" استفاده از هرگونه صفحه‌بند (pager) را هنگام نمایش اطلاعات غیرفعال می‌کند (از dpkg 1.19.2). .IP \fB\-\-no\-debsig\fR 4 .IX Item "--no-debsig" برای بررسی صحت امضاهای بسته تلاشی نمی‌کند. .IP \fB\-\-no\-triggers\fR 4 .IX Item "--no-triggers" هیچ محرکی را در این اجرا فعال نمی‌کند (از dpkg 1.14.17)، اما فعال‌سازی‌ها همچنان ثبت خواهند شد. اگر همراه با \fB\-\-configure\fR \fIpackage\fR یا \&\fB\-\-triggers\-only\fR \fIpackage\fR استفاده شود، اسکریپت postinst بسته نام‌برده همچنان اجرا خواهد شد، حتی اگر تنها اجرای محرک‌ها لازم باشد. استفاده از این گزینه ممکن است بسته‌ها را در وضعیت‌های نامناسب \fBtriggers\-awaited\fR و \&\fBtriggers\-pending\fR باقی بگذارد. این مشکل را می‌توان بعداً با اجرای دستور زیر برطرف کرد: \&\fBdpkg \-\-configure \-\-pending\fR. .IP \fB\-\-triggers\fR 4 .IX Item "--triggers" دستور \fB\-\-no\-triggers\fR قبلی را لغو می‌کند (از dpkg 1.14.17). .SH "وضعیت خروج (EXIT STATUS)" .IX Header "EXIT STATUS" .IP \fB0\fR 4 .IX Item "0" دستور درخواستی با موفقیت انجام شد، یا یک دستور بررسی یا گزاره (assertion) مقدار درست (true) برگرداند. .IP \fB1\fR 4 .IX Item "1" یک دستور بررسی یا گزاره مقدار نادرست (false) برگرداند. .IP \fB2\fR 4 .IX Item "2" خطای مهلک یا غیرقابل‌بازیابی به دلیل استفاده نادرست در خط فرمان، یا تعامل با سامانه، از قبیل دسترسی به پایگاه داده، تخصیص حافظه و غیره. .SH "محیط (ENVIRONMENT)" .IX Header "ENVIRONMENT" .SS "محیط بیرونی (External environment)" .IX Subsection "External environment" .IP \fBPATH\fR 4 .IX Item "PATH" انتظار می‌رود این متغیر در محیط تعریف شده باشد و به مسیرهای سامانه‌ای که چندین برنامه مورد نیاز در آن‌ها قرار دارند اشاره کند. اگر تنظیم نشده باشد یا برنامه‌ها پیدا نشوند، \fBdpkg\fR متوقف خواهد شد. .IP \fBHOME\fR 4 .IX Item "HOME" در صورت تنظیم، \fBdpkg\fR از آن به عنوان شاخه‌ای که فایل پیکربندی مختص کاربر از آن خوانده می‌شود، استفاده خواهد کرد. .IP \fBTMPDIR\fR 4 .IX Item "TMPDIR" در صورت تنظیم، \fBdpkg\fR از آن به عنوان شاخه‌ای برای ایجاد فایل‌ها و شاخه‌های موقت استفاده خواهد کرد. .IP \fBSHELL\fR 4 .IX Item "SHELL" برنامه‌ای که \fBdpkg\fR هنگام راه‌اندازی یک پوسته تعاملی جدید، یا هنگام اجرای یک دستور از طریق پوسته اجرا خواهد کرد. .IP \fBPAGER\fR 4 .IX Item "PAGER" .PD 0 .IP \fBDPKG_PAGER\fR 4 .IX Item "DPKG_PAGER" .PD برنامه‌ای که \fBdpkg\fR هنگام اجرای یک صفحه‌بند اجرا خواهد کرد، که با \(Fo\fR\f(CB$SHELL\fR\fB \-c\fR\(Fc اجرا خواهد شد، برای نمونه هنگام نمایش تفاوت‌های conffile. اگر \fBSHELL\fR تنظیم نشده باشد، در عوض از \(Fo\fBsh\fR\(Fc استفاده خواهد شد. .Sp متغیر \fBDPKG_PAGER\fR متغیر محیطی \fBPAGER\fR را بازنویسی می‌کند (از dpkg 1.19.2 به بعد). اگر هیچ‌یک از برنامه‌های اشاره‌شده توسط \fBDPKG_PAGER\fR یا \fBPAGER\fR موجود نباشند، برنامه‌های زیر به ترتیب امتحان خواهند شد (از dpkg 1.22.12 به بعد): صفحه‌بند پیش‌فرض \fBmore\fR، سپس \fBless\fR\|(1)، \&\fBmore\fR\|(1)، و در نهایت \fBcat\fR\|(1). .IP \fBDPKG_COLORS\fR 4 .IX Item "DPKG_COLORS" حالت رنگی را تنظیم می‌کند (از dpkg 1.18.5 به بعد). مقادیر پذیرفته‌شده کنونی عبارت‌اند از: \fBauto\fR (پیش‌فرض)، \fBalways\fR و \&\fBnever\fR. .IP \fBDPKG_NLS\fR 4 .IX Item "DPKG_NLS" در صورت تنظیم، برای تصمیم‌گیری درباره فعال‌سازی پشتیبانی از زبان بومی (Native Language Support)، که به عنوان پشتیبانی از بین‌المللی‌سازی (یا i18n) نیز شناخته می‌شود، استفاده خواهد شد (از dpkg 1.22.7 به بعد). مقادیر پذیرفته‌شده عبارت‌اند از: \fB0\fR و \fB1\fR (پیش‌فرض). .IP \fBDPKG_DEBUG\fR 4 .IX Item "DPKG_DEBUG" ماسک اشکال‌زدایی را از روی یک مقدار هشت‌هشتی (octal) تعیین می‌کند (از dpkg 1.21.10 به بعد). پرچم‌های پذیرفته‌شده کنونی در گزینه \fB\-\-debug\fR شرح داده شده‌اند. .IP \fBDPKG_FORCE\fR 4 .IX Item "DPKG_FORCE" پرچم‌های اجبار را تنظیم می‌کند (از dpkg 1.19.5 به بعد). هنگامی که این متغیر وجود دارد، هیچ پیش‌فرض اجباری توکاری اعمال نخواهد شد. اگر متغیر وجود داشته باشد اما خالی باشد، همه پرچم‌های اجبار غیرفعال خواهند شد. .IP \fBDPKG_ROOT\fR 4 .IX Item "DPKG_ROOT" اگر تنظیم شده باشد و گزینه‌های \fB\-\-instdir\fR یا \fB\-\-root\fR مشخص نشده باشند، به عنوان شاخه ریشه سامانه فایل استفاده خواهد شد (از dpkg 1.21.10 به بعد). .IP \fBDPKG_ADMINDIR\fR 4 .IX Item "DPKG_ADMINDIR" اگر تنظیم شده باشد و گزینه‌های \fB\-\-admindir\fR یا \fB\-\-root\fR مشخص نشده باشند، به عنوان شاخه مدیریتی \fBdpkg\fR استفاده خواهد شد (از dpkg 1.20.0 به بعد). .IP \fBDPKG_FRONTEND_LOCKED\fR 4 .IX Item "DPKG_FRONTEND_LOCKED" توسط یک پیشانه مدیر بسته تنظیم می‌شود تا به dpkg اطلاع دهد که نباید قفل پیشانه را دریافت کند (از dpkg 1.19.1 به بعد). .IP \fBDPKG_PATH_PASSWD\fR 4 .IX Item "DPKG_PATH_PASSWD" مسیر فایل \fIpasswd\fR سامانه را تعیین می‌کند. این مسیر نسبت به شاخه \fB\-\-root\fR است. پیش‌فرض \fI/etc/passwd\fR است. .Sp از dpkg 1.22.16 به بعد. .IP \fBDPKG_PATH_GROUP\fR 4 .IX Item "DPKG_PATH_GROUP" مسیر فایل \fIgroup\fR سامانه را تعیین می‌کند. این مسیر نسبت به شاخه \fB\-\-root\fR است. پیش‌فرض \fI/etc/group\fR است. .Sp از dpkg 1.22.16 به بعد. .SS "محیط درونی (Internal environment)" .IX Subsection "Internal environment" .IP \fBLESS\fR 4 .IX Item "LESS" توسط \fBdpkg\fR، در صورتی که از پیش تنظیم نشده باشد، هنگام فراخوانی یک صفحه‌بند برابر با \(lq\fB\-FRSXMQ\fR\(rq تعریف می‌شود (از dpkg 1.19.2 به بعد). برای تغییر رفتار پیش‌فرض، این متغیر را می‌توان از پیش روی مقدار دیگری از جمله یک رشته خالی تنظیم کرد، یا متغیرهای \fBPAGER\fR یا \fBDPKG_PAGER\fR را می‌توان برای غیرفعال کردن گزینه‌های خاص با \(Fo\fB\-+\fR\(Fc تنظیم نمود، برای نمونه \fBDPKG_PAGER="less \-+F"\fR. .IP \fBDPKG_ROOT\fR 4 .IX Item "DPKG_ROOT" توسط \fBdpkg\fR در محیط اسکریپت نگه‌دارنده تعریف می‌شود تا مشخص کند کدام نصب باید تحت عمل قرار گیرد (از dpkg 1.18.5 به بعد). هدف این است که این مقدار به ابتدای هر مسیری که اسکریپت‌های نگه‌دارنده روی آن کار می‌کنند افزوده شود. در طول کارکرد عادی، این متغیر خالی است. هنگام نصب بسته‌ها در یک \fBinstdir\fR متفاوت، \fBdpkg\fR معمولاً اسکریپت‌های نگه‌دارنده را با استفاده از \fBchroot\fR\|(2) فراخوانی می‌کند و این متغیر را خالی می‌گذارد، اما اگر \fB\-\-force\-script\-chrootless\fR مشخص شده باشد، فراخوانی \fBchroot\fR\|(2) نادیده گرفته می‌شود و این متغیر روی \fBinstdir\fR تنظیم خواهد شد (که غیرخالی خواهد بود). .IP \fBDPKG_ADMINDIR\fR 4 .IX Item "DPKG_ADMINDIR" توسط \fBdpkg\fR در محیط اسکریپت نگه‌دارنده تعریف می‌شود تا نشان‌دهنده شاخه مدیریتی \fBdpkg\fR مورد استفاده باشد (از dpkg 1.16.0 به بعد). این متغیر همواره برابر با مقدار فعلی \fB\-\-admindir\fR تنظیم می‌شود. .IP \fBDPKG_FORCE\fR 4 .IX Item "DPKG_FORCE" توسط \fBdpkg\fR در محیط زیرفرآیندها برابر با نام تمام گزینه‌های اجبار فعال کنونی که با کاما از هم جدا شده‌اند تعریف می‌شود (از dpkg 1.19.5 به بعد). .IP \fBDPKG_SHELL_REASON\fR 4 .IX Item "DPKG_SHELL_REASON" توسط \fBdpkg\fR روی پوسته‌ای که در اعلان conffile برای بررسی وضعیت ایجاد شده، تعریف می‌شود (از dpkg 1.15.6 به بعد). مقدار معتبر فعلی: \fBconffile\-prompt\fR. .IP \fBDPKG_CONFFILE_OLD\fR 4 .IX Item "DPKG_CONFFILE_OLD" توسط \fBdpkg\fR روی پوسته‌ای که در اعلان conffile برای بررسی وضعیت ایجاد شده، تعریف می‌شود (از dpkg 1.15.6 به بعد). حاوی مسیر conffile قدیمی است. .IP \fBDPKG_CONFFILE_NEW\fR 4 .IX Item "DPKG_CONFFILE_NEW" توسط \fBdpkg\fR روی پوسته‌ای که در اعلان conffile برای بررسی وضعیت ایجاد شده، تعریف می‌شود (از dpkg 1.15.6 به بعد). حاوی مسیر conffile جدید است. .IP \fBDPKG_HOOK_ACTION\fR 4 .IX Item "DPKG_HOOK_ACTION" توسط \fBdpkg\fR روی پوسته‌ای که هنگام اجرای یک اقدام قلاب ایجاد شده تعریف می‌شود (از dpkg 1.15.4 به بعد). حاوی اقدام فعلی \fBdpkg\fR است. .IP \fBDPKG_RUNNING_VERSION\fR 4 .IX Item "DPKG_RUNNING_VERSION" توسط \fBdpkg\fR در محیط اسکریپت نگه‌دارنده برابر با نگارش نمونه در حال اجرای فعلی \fBdpkg\fR تعریف می‌شود (از dpkg 1.14.17 به بعد). .IP \fBDPKG_MAINTSCRIPT_PACKAGE\fR 4 .IX Item "DPKG_MAINTSCRIPT_PACKAGE" توسط \fBdpkg\fR در محیط اسکریپت نگه‌دارنده برابر با نام بسته (بدون مشخصه معماری) در حال پردازش تعریف می‌شود (از dpkg 1.14.17 به بعد). .IP \fBDPKG_MAINTSCRIPT_PACKAGE_REFCOUNT\fR 4 .IX Item "DPKG_MAINTSCRIPT_PACKAGE_REFCOUNT" توسط \fBdpkg\fR در محیط اسکریپت نگه‌دارنده برابر با شمارش مراجع بسته، یعنی تعداد نمونه‌های بسته با وضعیتی بالاتر از \fBnot\-installed\fR تعریف می‌شود (از dpkg 1.17.2 به بعد). .IP \fBDPKG_MAINTSCRIPT_ARCH\fR 4 .IX Item "DPKG_MAINTSCRIPT_ARCH" توسط \fBdpkg\fR در محیط اسکریپت نگه‌دارنده برابر با معماری‌ای که بسته برای آن ساخته شده است تعریف می‌شود (از dpkg 1.15.4 به بعد). .IP \fBDPKG_MAINTSCRIPT_NAME\fR 4 .IX Item "DPKG_MAINTSCRIPT_NAME" توسط \fBdpkg\fR در محیط اسکریپت نگه‌دارنده برابر با نام اسکریپت در حال اجرا، یکی از \fBpreinst\fR، \fBpostinst\fR، \&\fBprerm\fR یا \fBpostrm\fR تعریف می‌شود (از dpkg 1.15.7 به بعد). .IP \fBDPKG_MAINTSCRIPT_DEBUG\fR 4 .IX Item "DPKG_MAINTSCRIPT_DEBUG" توسط \fBdpkg\fR در محیط اسکریپت نگه‌دارنده برابر با مقداری (\(oq\fB0\fR\(cq یا \(oq\fB1\fR\(cq) تعریف می‌شود که نشان می‌دهد آیا اشکال‌زدایی (با گزینه \fB\-\-debug\fR) برای اسکریپت‌های نگه‌دارنده درخواست شده است یا خیر (از dpkg 1.18.4 به بعد). .SH "فایل‌ها (FILES)" .IX Header "FILES" .IP \fI/etc/dpkg/dpkg.cfg.d/[0\-9a\-zA\-Z_\-]*\fR 4 .IX Item "/etc/dpkg/dpkg.cfg.d/[0-9a-zA-Z_-]*" فایل‌های قطعه پیکربندی (از dpkg 1.15.4 به بعد). .IP \fI/etc/dpkg/dpkg.cfg\fR 4 .IX Item "/etc/dpkg/dpkg.cfg" فایل پیکربندی با گزینه‌های پیش‌فرض. .IP \fI/var/log/dpkg.log\fR 4 .IX Item "/var/log/dpkg.log" فایل وقایع پیش‌فرض (به \fI/etc/dpkg/dpkg.cfg\fR و گزینه \&\fB\-\-log\fR مراجعه کنید). .PP سایر فایل‌های فهرست‌شده در زیر در شاخه‌های پیش‌فرض خود قرار دارند؛ به گزینه \&\fB\-\-admindir\fR مراجعه کنید تا نحوه تغییر مکان این فایل‌ها را ببینید. .IP \fI/var/lib/dpkg/available\fR 4 .IX Item "/var/lib/dpkg/available" فهرست بسته‌های موجود. .IP \fI/var/lib/dpkg/status\fR 4 .IX Item "/var/lib/dpkg/status" وضعیت‌های بسته‌های موجود. این فایل حاوی اطلاعاتی است درباره اینکه آیا یک بسته برای حذف نشانه‌گذاری شده یا نه، آیا نصب شده است یا نه، و غیره. برای اطلاعات بیشتر بخش "اطلاعات درباره بسته‌ها (INFORMATION ABOUT PACKAGES)" را ببینید. .Sp از فایل وضعیت به‌طور روزانه در \fI/var/backups\fR پشتیبان گرفته می‌شود. اگر به دلیل مشکلات سامانه فایل گم یا خراب شود، می‌تواند مفید باشد. .PP قالب و محتویات یک بسته باینری در \fBdeb\fR\|(5) توضیح داده شده است. .SS "نام‌های فایل سامانه فایل (Filesystem filenames)" .IX Subsection "Filesystem filenames" در حین بازگشایی و پیکربندی، \fBdpkg\fR از نام‌های فایل مختلفی برای اهداف پشتیبان‌گیری و بازگردانی (rollback) استفاده می‌کند. در ادامه توضیح ساده‌شده‌ای از نحوه استفاده از این نام‌های فایل در حین نصب بسته آمده است. .IP \fI*.dpkg\-new\fR 4 .IX Item "*.dpkg-new" در حین بازگشایی، \fBdpkg\fR اشیاء جدید سامانه فایل را در \&\fIpathname\fR\fB.dpkg\-new\fR استخراج می‌کند (به‌جز شاخه‌های موجود یا پیوندهای نمادین به شاخه‌ها که نادیده گرفته می‌شوند)؛ پس از پایان این کار و پس از انجام پشتیبان‌گیری از اشیاء قدیمی، اشیاء به \fIpathname\fR تغییر نام می‌یابند. .IP \fI*.dpkg\-tmp\fR 4 .IX Item "*.dpkg-tmp" در حین بازگشایی، \fBdpkg\fR پس از استخراج اشیاء جدید، از اشیاء قدیمی سامانه فایل در \&\fIpathname\fR\fB.dpkg\-tmp\fR نسخه پشتیبان تهیه می‌کند. این نسخه‌های پشتیبان یا به‌صورت تغییر نام برای شاخه‌ها (اما تنها در صورتی که نوع فایل را تغییر دهند)، یک نسخه جدید از پیوند نمادین برای پیوندهای نمادین، یا یک پیوند سخت برای هر شیء دیگر سامانه فایل انجام می‌شوند، به‌جز conffileها که نسخه پشتیبان دریافت نمی‌کنند زیرا در مرحله بعدی پردازش می‌شوند. .Sp در صورت نیاز به بازگردانی (rollback)، از این نسخه‌های پشتیبان برای بازیابی محتوای قبلی اشیاء استفاده می‌شود. این فایل‌ها پس از تکمیل نصب به‌طور خودکار حذف می‌شوند. .IP \fI*.dpkg\-old\fR 4 .IX Item "*.dpkg-old" در حین پیکربندی، هنگام نصب یک نگارش جدید، \&\fBdpkg\fR می‌تواند از conffile تغییر‌یافته قبلی در \&\fIpathname\fR\fB.dpkg\-old\fR نسخه پشتیبان تهیه کند. .IP \fI*.dpkg\-dist\fR 4 .IX Item "*.dpkg-dist" در حین پیکربندی، هنگام نگه داشتن نگارش قدیمی، \&\fBdpkg\fR می‌تواند از conffile جدید تغییرنیافته در \&\fIpathname\fR\fB.dpkg\-dist\fR نسخه پشتیبان تهیه کند. .SH "امنیت (SECURITY)" .IX Header "SECURITY" هر عملیاتی که به دسترسی نوشتن روی پایگاه داده یا سامانه فایل نیاز دارد یک عملیات ممتاز تلقی می‌شود که ممکن است اجازه ارتقای دسترسی به ریشه (root escalation) را بدهد. این عملیات‌ها هرگز نباید به یک کاربر غیرقابل اعتماد واگذار شوند یا روی بسته‌های غیرقابل اعتماد انجام شوند، چرا که ممکن است اجازه دسترسی ریشه به سامانه را بدهند. .PP برخی عملیات‌ها (مانند اعتبارسنجی بسته) ممکن است برای دسترسی به فایل‌هایی روی سامانه فایل که در غیر این صورت به دلیل مجوزهای محدود در دسترس نخواهند بود، به امتیازات ریشه نیاز داشته باشند، اما در آن موارد نیز باید به‌طور عادی کار کرده و پیام‌های مناسب تولید نمایند. .PP عملیات‌های پرس‌وجو هرگز نباید به ریشه نیاز داشته باشند، و واگذاری اجرای آن‌ها به کاربران فاقد امتیاز از طریق دستوری برای کسب دسترسی ریشه (gain\-root) می‌تواند پیامدهای امنیتی (مانند ارتقای دسترسی) داشته باشد؛ برای مثال زمانی که یک صفحه‌بند (pager) به‌طور خودکار توسط ابزار فراخوانی می‌شود. .PP همچنین بخش \fBSECURITY\fR از صفحات راهنمای \fBdpkg\-deb\fR\|(1) و \fBdpkg\-split\fR\|(1) را ببینید. .SH "ایرادها (BUGS)" .IX Header "BUGS" گزینه \&\fB\-\-no\-act\fR معمولاً اطلاعات کمتری نسبت به آنچه مفید است ارائه می‌دهد. .SH "مثال‌ها (EXAMPLES)" .IX Header "EXAMPLES" برای فهرست کردن بسته‌های نصب‌شده مربوط به ویرایشگر \fBvi\fR\|(1) (توجه داشته باشید که \&\fBdpkg\-query\fR دیگر فایل \fIavailable\fR را به‌طور پیش‌فرض بارگذاری نمی‌کند، و برای این منظور باید از گزینه \fB\-\-load\-avail\fR در \fBdpkg\-query\fR استفاده شود): .Sp .Vb 1 \& dpkg \-l \*(Aq*vi*\*(Aq .Ve .PP برای مشاهده ورودی‌های دو بسته در \fI/var/lib/dpkg/available\fR: .Sp .Vb 1 \& dpkg \-\-print\-avail vim neovim | less .Ve .PP برای جستجو در فهرست بسته‌ها توسط خودتان: .Sp .Vb 1 \& dpkg \-\-print\-avail | less .Ve .PP برای حذف یک بسته نصب‌شده neovim: .Sp .Vb 1 \& dpkg \-r neovim .Ve .PP برای نصب یک بسته، ابتدا باید آن را در یک بایگانی یا دیسک چندرسانه‌ای پیدا کنید. هنگام استفاده از یک بایگانی مبتنی بر ساختار pool، دانستن ناحیه بایگانی و نام بسته برای استنباط مسیر فایل کافی است: .Sp .Vb 1 \& dpkg \-i /media/bdrom/pool/main/v/vim/vim_9.0.2018\-1_amd64.deb .Ve .PP برای تهیه یک نسخه محلی از وضعیت‌های انتخاب بسته: .Sp .Vb 1 \& dpkg \-\-get\-selections >myselections .Ve .PP می‌توانید این فایل را به رایانه دیگری منتقل کنید، و پس از به‌روزرسانی فایل \fIavailable\fR در آنجا با پیشانه مدیر بسته انتخابی خود (برای جزئیات بیشتر به مراجعه کنید)، برای مثال: .Sp .Vb 1 \& apt\-cache dumpavail | dpkg \-\-merge\-avail .Ve .PP می‌توانید آن را با این دستور نصب کنید: .Sp .Vb 2 \& dpkg \-\-clear\-selections \& dpkg \-\-set\-selections