.\" -*- 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-query 1"
.TH dpkg-query 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\-query \- ابزار پرس‌وجوی پایگاه‌داده بسته‌های دبیان
.SH "خلاصه دستور (SYNOPSIS)"
.IX Header "خلاصه دستور (SYNOPSIS)"
\&\fBdpkg\-query\fR
[\fIگزینه\fR...] \fIدستور\fR
.SH "توضیحات (DESCRIPTION)"
.IX Header "توضیحات (DESCRIPTION)"
دستور
\&\fBdpkg\-query\fR
ابزاری برای نمایش اطلاعات درباره بسته‌های فهرست‌شده در پایگاه‌داده
\&\fBdpkg\fR
است.
.SH "دستورها (COMMANDS)"
.IX Header "دستورها (COMMANDS)"
.IP "\fB\-l\fR, \fB\-\-list\fR [\fIpackage\-name\-pattern\fR...]" 4
.IX Item "-l, --list [package-name-pattern...]"
فهرست کردن تمام بسته‌های شناخته‌شده که با یک یا چند الگو مطابقت دارند، بدون در نظر گرفتن وضعیت آن‌ها، که شامل هر بسته واقعی یا مجازی ارجاع داده‌شده در هر فیلد رابطه وابستگی (مانند
\&\fBBreaks\fR،
\&\fBEnhances\fR
و غیره) می‌شود.
اگر هیچ
\fIpackage\-name\-pattern\fR
مشخص نشده باشد، تمام بسته‌ها در
\&\fI/var/lib/dpkg/status\fR
فهرست می‌شوند، به استثنای مواردی که با عنوان نصب‌نشده (not\-installed) علامت‌گذاری شده‌اند (یعنی آن‌هایی که پیش‌تر پاک‌سازی/purge شده‌اند).
نویسه‌های عام (wildcard) معمول پوسته در
\fIpackage\-name\-pattern\fR
مجاز هستند.
لطفاً توجه داشته باشید که برای جلوگیری از بسط نام فایل توسط پوسته، احتمالاً باید
\fIpackage\-name\-pattern\fR
را در نقل‌قول قرار دهید.
به عنوان مثال، دستور زیر تمامی نام بسته‌هایی که با \(lqlibc6\(rq شروع می‌شوند را فهرست می‌کند:
.RS 4
.Sp
.Vb 1
\& dpkg\-query \-l \*(Aqlibc6*\*(Aq
.Ve
.RE
.RS 4
.Sp
سه ستون اول خروجی به ترتیب اقدام مورد نظر، وضعیت بسته و خطاها را نشان می‌دهند.
.Sp
اقدام مورد نظر (Desired action):
.IP "u = Unknown (نامشخص)" 4
.IX Item "u = Unknown"
.PD 0
.IP "i = Install (نصب)" 4
.IX Item "i = Install"
.IP "h = Hold (نگه‌داشتن)" 4
.IX Item "h = Hold"
.IP "r = Remove (حذف)" 4
.IX Item "r = Remove"
.IP "p = Purge (پاک‌سازی)" 4
.IX Item "p = Purge"
.PD
.RE
.RS 4
.Sp
وضعیت بسته (Package status):
.IP "n = Not\-installed (نصب‌نشده)" 4
.IX Item "n = Not-installed"
.PD 0
.IP "c = Config\-files (فایل‌های پیکربندی)" 4
.IX Item "c = Config-files"
.IP "H = Half\-installed (نیمه‌نصب)" 4
.IX Item "H = Half-installed"
.IP "U = Unpacked (از حالت بسته خارج‌شده)" 4
.IX Item "U = Unpacked"
.IP "F = Half\-configured (نیمه‌پیکربندی‌شده)" 4
.IX Item "F = Half-configured"
.IP "W = Triggers\-awaiting (در انتظار تریگر)" 4
.IX Item "W = Triggers-awaiting"
.IP "t = Triggers\-pending (تریگرهای معلق)" 4
.IX Item "t = Triggers-pending"
.IP "i = Installed (نصب‌شده)" 4
.IX Item "i = Installed"
.PD
.RE
.RS 4
.Sp
پرچم‌های خطا (Error flags):
.IP "<empty> = (none) (خالی = هیچ‌کدام)" 4
.IX Item "<empty> = (none)"
.PD 0
.IP "R = Reinst\-required (نیاز به نصب مجدد)" 4
.IX Item "R = Reinst-required"
.PD
.RE
.RS 4
.Sp
یک حرف بزرگ وضعیت یا خطا نشان می‌دهد که بسته احتمالاً مشکلات شدیدی ایجاد خواهد کرد.
لطفاً برای دریافت اطلاعات بیشتر درباره وضعیت‌ها و پرچم‌های فوق به
\&\fBdpkg\fR\|(1)
مراجعه کنید.
.Sp
قالب خروجی این گزینه قابل پیکربندی نیست، اما به طور خودکار با پهنای ترمینال تنظیم می‌شود.
این قالب برای خوانندگان انسانی در نظر گرفته شده است و به آسانی توسط ماشین قابل‌خواندن نیست.
برای روشی جهت پیکربندی قالب خروجی، گزینه‌های
\&\fB\-W\fR
(\fB\-\-show\fR)
و
\&\fB\-\-showformat\fR
را ببینید.
.RE
.IP "\fB\-W\fR, \fB\-\-show\fR [\fIpackage\-name\-pattern\fR...]" 4
.IX Item "-W, --show [package-name-pattern...]"
درست مانند گزینه
\&\fB\-\-list\fR،
این گزینه تمام بسته‌های منطبق با الگوهای داده‌شده را فهرست می‌کند.
با این حال، خروجی را می‌توان با استفاده از گزینه
\&\fB\-\-showformat\fR
سفارشی‌سازی کرد.
.Sp
قالب خروجی پیش‌فرض، یک سطر به ازای هر بسته منطبق ارائه می‌دهد که هر سطر شامل نام بسته و نسخه نصب‌شده آن است که با یک تب (tab) از هم جدا شده‌اند.
نام بسته برای بسته‌هایی با فیلد
\&\fBMulti\-Arch\fR
با مقدار
\&\fBsame\fR
یا دارای یک معماری خارجی (معماری‌ای که نه معماری بومی است و نه
\&\fBall\fR)،
همراه با مشخصه معماری خواهد بود.
.IP "\fB\-s\fR, \fB\-\-status\fR [\fIpackage\-name\fR...]" 4
.IX Item "-s, --status [package-name...]"
وضعیت بسته‌های مشخص‌شده را گزارش می‌دهد.
این دستور صرفاً مدخل موجود در پایگاه‌داده وضعیت بسته‌های نصب‌شده را نمایش می‌دهد.
اگر هیچ
\fIpackage\-name\fR
مشخص نشده باشد، تمامی مدخل‌های بسته در پایگاه‌داده وضعیت نمایش داده خواهند شد (از نسخه dpkg 1.19.1).
هنگامی که چندین مدخل
\fIpackage\-name\fR
فهرست شده باشند، مدخل‌های وضعیت درخواستی با یک خط خالی از هم جدا می‌شوند و به همان ترتیبی هستند که در فهرست آرگومان‌ها مشخص شده‌اند.
.IP "\fB\-L\fR, \fB\-\-listfiles\fR \fIpackage\-name\fR..." 4
.IX Item "-L, --listfiles package-name..."
فهرست فایل‌های نصب‌شده روی سیستم شما از
\fIpackage\-name\fR
را نمایش می‌دهد.
هنگامی که چندین
\fIpackage\-name\fR
فهرست شده باشند، فهرست فایل‌های درخواستی با یک خط خالی از یکدیگر جدا می‌شوند و ترتیبی یکسان با فهرست آرگومان‌ها خواهند داشت.
.Sp
هر دایورژن (تغییر مسیر) فایل پس از فایل منحرف‌شده مربوط به خود در سطری جداگانه چاپ می‌شود و یکی از رشته‌های محلی‌شده زیر در ابتدای آن قرار می‌گیرد:
.Sp
.Vb 3
\&  locally diverted to: diverted\-to
\&  package diverts others to: diverted\-to
\&  diverted by pkg to: diverted\-to
.Ve
.Sp
\&\fBنکته\fR: هنگام تجزیه خروجی توسط ماشین، مرسوم است که برای دریافت نتایج تکرارپذیر، لوکال روی
\&\fBC.UTF\-8\fR
تنظیم شود.
در برخی سیستم‌ها اگر متغیر محیطی
\&\fBLANGUAGE\fR
از پیش تنظیم شده باشد، ممکن است نیاز به تطبیق مناسب آن نیز باشد (به
\&\fBlocale\fR\|(7)
مراجعه کنید).
.Sp
این دستور فایل‌های اضافی ایجادشده توسط اسکریپت‌های نگه‌دارنده یا جایگزین‌ها (alternatives) را فهرست نمی‌کند.
.IP "\fB\-\-control\-list\fR \fIpackage\-name\fR" 4
.IX Item "--control-list package-name"
فهرست فایل‌های کنترلی نصب‌شده روی سیستم شما از
\fIpackage\-name\fR
را نمایش می‌دهد (از نسخه dpkg 1.16.5).
این فایل‌ها می‌توانند به عنوان آرگومان ورودی برای
\&\fB\-\-control\-show\fR
استفاده شوند.
.IP "\fB\-\-control\-show\fR \fIpackage\-name\fR \fIcontrol\-file\fR" 4
.IX Item "--control-show package-name control-file"
محتوای
\fIcontrol\-file\fR
نصب‌شده روی سیستم شما از
\fIpackage\-name\fR
را در خروجی استاندارد چاپ می‌کند (از نسخه dpkg 1.16.5).
.IP "\fB\-c\fR, \fB\-\-control\-path\fR \fIpackage\-name\fR [\fIcontrol\-file\fR]" 4
.IX Item "-c, --control-path package-name [control-file]"
مسیرهای فایل‌های کنترلی نصب‌شده روی سیستم شما از
\fIpackage\-name\fR
را فهرست می‌کند (از نسخه dpkg 1.15.4).
اگر
\fIcontrol\-file\fR
مشخص شده باشد، در صورت وجود فقط مسیر همان فایل کنترلی را فهرست می‌کند.
.Sp
\&\fBهشدار\fR: این دستور منسوخ شده است زیرا دسترسی مستقیم به پایگاه‌داده داخلی dpkg فراهم می‌کند؛ لطفاً برای تمامی مواردی که ممکن است همان نتیجه پایانی را ارائه دهند، به جای آن از
\&\fB\-\-control\-list\fR
و
\&\fB\-\-control\-show\fR
استفاده کنید.
با این حال، تا زمانی که دست‌کم یک مورد وجود داشته باشد که این دستور در آن مورد نیاز است (یعنی زمانی که لازم است یک اسکریپت نگه‌دارنده مخرب postrm حذف شود) و مادامی که راهکار مناسبی برای آن وجود ندارد، این دستور حذف نخواهد شد.
.IP "\fB\-S\fR, \fB\-\-search\fR \fIfilename\-search\-pattern\fR..." 4
.IX Item "-S, --search filename-search-pattern..."
جستجوی بسته‌هایی که مالک فایل‌های مطابق با الگوهای مشخص‌شده هستند.
نویسه‌های عام معمول پوسته می‌توانند در الگو استفاده شوند، که در آن ستاره (\fB*\fR) و علامت سؤال (\fB?\fR) با یک اسلش تطبیق داده می‌شوند و بک‌اسلش (\fB\e\fR) به عنوان نویسه گریز (escape) به کار می‌رود.
.Sp
اگر نخستین نویسه در
\fIfilename\-search\-pattern\fR
هیچ‌یک از
\(oq\fB*[?/\fR\(cq
نباشد، آن‌گاه تطبیق زیررشته در نظر گرفته می‌شود و به‌طور ضمنی توسط
\(oq\fB*\fR\(cq
احاطه می‌گردد (مانند
\&\fB*\fR\fIfilename\-search\-pattern\fR\fB*\fR).
اگر رشته پسین حاوی هر یک از
\(oq\fB*[?\e\fR\(cq
باشد، با آن مانند یک الگوی glob رفتار خواهد شد؛ در غیر این صورت هرگونه
\(oq\fB/\fR\(cq
یا
\(oq\fB/.\fR\(cq
پایانی حذف شده و جستجوی دقیق مسیر انجام می‌گیرد.
.Sp
این دستور فایل‌های اضافی ایجادشده توسط اسکریپت‌های نگه‌دارنده و همچنین جایگزین‌ها (alternatives) را فهرست نمی‌کند.
.Sp
قالب خروجی شامل یک سطر به ازای هر الگوی منطبق است، همراه با فهرستی از بسته‌های مالک نام مسیر که با یک کاما (U+002C \(oq\fB,\fR\(cq) و یک فاصله (U+0020 \(oq\fB \fR\(cq) از هم جدا شده‌اند، و به دنبال آن یک دو نقطه (U+003A \(oq\fB:\fR\(cq) و یک فاصله، و سپس نام مسیر می‌آید.
مانند:
.Sp
.Vb 2
\&  pkgname1, pkgname2: pathname1
\&  pkgname3: pathname2
.Ve
.Sp
تغییر مسیرهای فایل (diversions) با رشته‌های محلی‌شده زیر چاپ می‌شوند:
.Sp
.Vb 2
\&  diversion by pkgname from: diverted\-from
\&  diversion by pkgname to: diverted\-to
.Ve
.Sp
یا برای تغییر مسیرهای محلی:
.Sp
.Vb 2
\&  local diversion from: diverted\-from
\&  local diversion to: diverted\-to
.Ve
.Sp
\&\fBنکته\fR: هنگام تجزیه خروجی توسط ماشین، مرسوم است که برای دریافت نتایج تکرارپذیر، لوکال روی
\&\fBC.UTF\-8\fR
تنظیم شود.
.IP "\fB\-p\fR, \fB\-\-print\-avail\fR [\fIpackage\-name\fR...]" 4
.IX Item "-p, --print-avail [package-name...]"
نمایش جزئیات درباره بسته‌ها، آن‌گونه که در
\&\fI/var/lib/dpkg/available\fR
یافت می‌شود.
اگر هیچ
\fIpackage\-name\fR
مشخص نشده باشد، تمامی مدخل‌های بسته در پایگاه‌داده
\fIavailable\fR
نمایش داده خواهند شد (از نسخه dpkg 1.19.1).
هنگامی که چندین
\fIpackage\-name\fR
فهرست شده باشند، مدخل‌های
\fIavailable\fR
درخواستی با یک خط خالی از هم جدا می‌شوند و ترتیبی یکسان با فهرست آرگومان‌ها خواهند داشت.
.Sp
کاربران پیشانه‌های مبتنی بر APT باید به جای این دستور از
\&\fBapt show\fR \fIpackage\-name\fR
استفاده کنند، چرا که فایل
\fIavailable\fR
تنها زمانی که از
\&\fBdselect\fR
استفاده شود به‌روز نگه داشته می‌شود.
.IP "\fB\-?\fR, \fB\-\-help\fR" 4
.IX Item "-?, --help"
نمایش پیام راهنمای نحوه استفاده و خروج.
.IP \fB\-\-version\fR 4
.IX Item "--version"
نمایش نسخه برنامه و خروج.
.SH "گزینه‌ها (OPTIONS)"
.IX Header "گزینه‌ها (OPTIONS)"
.IP \fB\-\-admindir=\fR\fIdir\fR 4
.IX Item "--admindir=dir"
تغییر مکان پایگاه‌داده
\&\fBdpkg\fR.
مکان پیش‌فرض
\&\fI/var/lib/dpkg\fR
است.
.IP \fB\-\-root=\fR\fIdirectory\fR 4
.IX Item "--root=directory"
دایرکتوری ریشه را روی
\fIdirectory\fR
تنظیم می‌کند، که موجب می‌شود دایرکتوری مدیریتی روی
\(Fo\fIdirectory\fR/var/lib/dpkg\(Fc
قرار گیرد (از نسخه dpkg 1.21.0).
.IP \fB\-\-load\-avail\fR 4
.IX Item "--load-avail"
همچنین هنگام استفاده از دستورهای
\&\fB\-\-show\fR
و
\&\fB\-\-list\fR،
فایل available را نیز بارگذاری می‌کند، که در حال حاضر به طور پیش‌فرض فقط فایل وضعیت (status) را پرس‌وجو می‌کنند (از نسخه dpkg 1.16.2).
.IP \fB\-\-no\-pager\fR 4
.IX Item "--no-pager"
استفاده از هرگونه صفحه‌بندی‌کننده (pager) را هنگام نمایش اطلاعات غیرفعال می‌کند (از نسخه dpkg 1.19.2).
.IP "\fB\-f\fR, \fB\-\-showformat=\fR\fIformat\fR" 4
.IX Item "-f, --showformat=format"
این گزینه برای تعیین قالب خروجی تولیدشده توسط
\&\fB\-\-show\fR
به کار می‌رود (گزینه کوتاه از نسخه dpkg 1.13.1).
قالب، رشته‌ای است که به ازای هر بسته فهرست‌شده در خروجی چاپ خواهد شد.
.Sp
در رشته قالب، \(lq\fB\e\fR\(rq نویسه‌های گریز (escapes) را معرفی می‌کند:
.RS 4
.IP "\fB\en\fR سطر جدید (newline)" 4
.IX Item "n newline"
.PD 0
.IP "\fB\er\fR بازگشت به ابتدای سطر (carriage return)" 4
.IX Item "r carriage return"
.IP "\fB\et\fR جهش (tab)" 4
.IX Item "t tab"
.PD
.RE
.RS 4
.Sp
نویسه \(lq\fB\e\fR\(rq قبل از هر نویسه دیگر، هرگونه معنای ویژه نویسه بعدی را خنثی می‌کند که برای \(lq\fB\e\fR\(rq و \(lq\fB$\fR\(rq سودمند است.
.Sp
اطلاعات بسته را می‌توان با درج ارجاعات متغیر به فیلدهای بسته با نحو
\(lq\fB${\fR\fIfield\fR[\fB;\fR\fIwidth\fR]\fB}\fR\(rq
شامل کرد.
فیلدها راست‌چین چاپ می‌شوند مگر اینکه پهنا (width) منفی باشد که در این صورت چپ‌چین خواهند شد.
فیلدهای زیر شناسایی می‌شوند، اما لزوماً در فایل وضعیت موجود نیستند (تنها فیلدهای داخلی یا فیلدهای ذخیره‌شده در بسته باینری در آن قرار می‌گیرند):
.IP \fBArchitecture\fR 4
.IX Item "Architecture"
.PD 0
.IP \fBBugs\fR 4
.IX Item "Bugs"
.IP "\fBConffiles\fR (داخلی)" 4
.IX Item "Conffiles (internal)"
.IP "\fBConfig\-Version\fR (داخلی)" 4
.IX Item "Config-Version (internal)"
.IP \fBConflicts\fR 4
.IX Item "Conflicts"
.IP \fBBreaks\fR 4
.IX Item "Breaks"
.IP \fBDepends\fR 4
.IX Item "Depends"
.IP \fBDescription\fR 4
.IX Item "Description"
.IP "\fBDescription\-md5\fR (داخلی، مرتبط با پیشانه)" 4
.IX Item "Description-md5 (internal, front-end related)"
.IP \fBEnhances\fR 4
.IX Item "Enhances"
.IP \fBProtected\fR 4
.IX Item "Protected"
.IP \fBEssential\fR 4
.IX Item "Essential"
.IP "\fBFilename\fR (داخلی، مرتبط با پیشانه)" 4
.IX Item "Filename (internal, front-end related)"
.IP \fBHomepage\fR 4
.IX Item "Homepage"
.IP \fBInstalled\-Size\fR 4
.IX Item "Installed-Size"
.IP "\fBMD5sum\fR (داخلی، مرتبط با پیشانه)" 4
.IX Item "MD5sum (internal, front-end related)"
.IP \fBMaintainer\fR 4
.IX Item "Maintainer"
.IP \fBMulti\-Arch\fR 4
.IX Item "Multi-Arch"
.IP \fBOrigin\fR 4
.IX Item "Origin"
.IP \fBPackage\fR 4
.IX Item "Package"
.IP \fBPre\-Depends\fR 4
.IX Item "Pre-Depends"
.IP \fBPriority\fR 4
.IX Item "Priority"
.IP \fBProvides\fR 4
.IX Item "Provides"
.IP \fBRecommends\fR 4
.IX Item "Recommends"
.IP \fBReplaces\fR 4
.IX Item "Replaces"
.IP "\fBRevision\fR (منسوخ‌شده)" 4
.IX Item "Revision (obsolete)"
.IP \fBSection\fR 4
.IX Item "Section"
.IP "\fBSHA1\fR (داخلی، مرتبط با پیشانه)" 4
.IX Item "SHA1 (internal, front-end related)"
.IP "\fBSHA256\fR (داخلی، مرتبط با پیشانه)" 4
.IX Item "SHA256 (internal, front-end related)"
.IP "\fBSHA512\fR (داخلی، مرتبط با پیشانه)" 4
.IX Item "SHA512 (internal, front-end related)"
.IP "\fBSize\fR (داخلی، مرتبط با پیشانه)" 4
.IX Item "Size (internal, front-end related)"
.IP \fBSource\fR 4
.IX Item "Source"
.IP "\fBStatus\fR (داخلی)" 4
.IX Item "Status (internal)"
.IP \fBSuggests\fR 4
.IX Item "Suggests"
.IP "\fBTag\fR (معمولاً در deb. نیست، بلکه در فایل‌های Packages مخزن است)" 4
.IX Item "Tag (usually not in .deb but in repository Packages files)"
.IP "\fBTriggers\-Awaited\fR (داخلی)" 4
.IX Item "Triggers-Awaited (internal)"
.IP "\fBTriggers\-Pending\fR (داخلی)" 4
.IX Item "Triggers-Pending (internal)"
.IP \fBVersion\fR 4
.IX Item "Version"
.PD
.RE
.RS 4
.Sp
موارد زیر فیلدهای مجازی هستند که توسط
\&\fBdpkg\-query\fR
از مقادیر سایر فیلدها تولید می‌شوند (توجه داشته باشید که این‌ها از نام‌های معتبر برای فیلدها در فایل‌های کنترل استفاده نمی‌کنند):
.IP \fBbinary:Package\fR 4
.IX Item "binary:Package"
شامل نام بسته باینری همراه با یک مشخصه احتمالی معماری مانند
\(lqlibc6:amd64\(rq
است (از نسخه dpkg 1.16.2).
یک مشخصه معماری برای بسته‌هایی با فیلد
\&\fBMulti\-Arch\fR
با مقدار
\&\fBsame\fR
یا با یک معماری خارجی (معماری‌ای که نه معماری بومی است و نه
\&\fBall\fR)
وجود خواهد داشت تا نام بسته بدون ابهام باشد.
.IP \fBbinary:Synopsis\fR 4
.IX Item "binary:Synopsis"
شامل شرح کوتاه بسته است (از نسخه dpkg 1.19.1).
.IP \fBbinary:Summary\fR 4
.IX Item "binary:Summary"
این یک نام مستعار برای
\&\fBbinary:Synopsis\fR
است (از نسخه dpkg 1.16.2).
.IP \fBdb:Status\-Abbrev\fR 4
.IX Item "db:Status-Abbrev"
شامل وضعیت اختصاری بسته (به صورت سه نویسه) مانند
\(lqii \(rq
یا
\(lqiHR\(rq
است (از نسخه dpkg 1.16.2).
برای جزئیات بیشتر به شرح دستور
\&\fB\-\-list\fR
مراجعه کنید.
.IP \fBdb:Status\-Want\fR 4
.IX Item "db:Status-Want"
شامل وضعیت مورد نظر بسته، بخشی از فیلد Status است (از نسخه dpkg 1.17.11).
.IP \fBdb:Status\-Status\fR 4
.IX Item "db:Status-Status"
شامل واژه وضعیت بسته، بخشی از فیلد Status است (از نسخه dpkg 1.17.11).
.IP \fBdb:Status\-Eflag\fR 4
.IX Item "db:Status-Eflag"
شامل پرچم خطای وضعیت بسته، بخشی از فیلد Status است (از نسخه dpkg 1.17.11).
.IP \fBdb\-fsys:Files\fR 4
.IX Item "db-fsys:Files"
شامل فهرست مدخل‌های سیستم‌فایل بسته است که با خطوط جدید از هم جدا شده‌اند (از نسخه dpkg 1.19.3).
.IP \fBdb\-fsys:Last\-Modified\fR 4
.IX Item "db-fsys:Last-Modified"
شامل برچسب زمانی بر حسب ثانیه از آخرین باری است که مدخل‌های سیستم‌فایل بسته تغییر یافته‌اند (از نسخه dpkg 1.19.3).
.IP \fBsource:Package\fR 4
.IX Item "source:Package"
شامل نام بسته سورس برای این بسته باینری است (از نسخه dpkg 1.16.2).
.IP \fBsource:Version\fR 4
.IX Item "source:Version"
شامل نسخه بسته سورس برای این بسته باینری است (از نسخه dpkg 1.16.2).
.IP \fBsource:Upstream\-Version\fR 4
.IX Item "source:Upstream-Version"
شامل نسخه بالادستی بسته سورس برای این بسته باینری است (از نسخه dpkg 1.18.16).
.RE
.RS 4
.Sp
رشته قالب پیش‌فرض
\(lq\fB${binary:Package}\et${Version}\en\fR\(rq
است.
در عمل، تمام فیلدهای دیگر موجود در فایل وضعیت (یعنی فیلدهای تعریف‌شده توسط کاربر) نیز می‌توانند درخواست شوند.
البته آن‌ها همان‌گونه که هستند چاپ خواهند شد و هیچ تبدیلی یا بررسی خطایی روی آن‌ها انجام نمی‌گیرد.
برای به دست آوردن نام نگه‌دارنده
\&\fBdpkg\fR
و نسخه نصب‌شده، می‌توانید دستور زیر را اجرا کنید:
.Sp
.Vb 2
\& dpkg\-query \-f=\*(Aq${binary:Package} ${Version}\et${Maintainer}\en\*(Aq \e
\&  \-W dpkg
.Ve
.RE
.RS 4
.RE
.SH "وضعیت خروج (EXIT STATUS)"
.IX Header "وضعیت خروج (EXIT STATUS)"
.IP \fB0\fR 4
.IX Item "0"
پرس‌وجوی درخواستی با موفقیت انجام شد.
.IP \fB1\fR 4
.IX Item "1"
پرس‌وجوی درخواستی به دلیل پیدا نشدن هیچ فایل یا بسته‌ای، به‌طور کامل یا جزئی با شکست مواجه شد (به جز در موارد
\&\fB\-\-control\-path\fR،
\&\fB\-\-control\-list\fR
و
\&\fB\-\-control\-show\fR
که در آن‌ها چنین خطاهایی مهلک هستند).
.IP \fB2\fR 4
.IX Item "2"
خطای مهلک یا غیرقابل‌بازگشت به دلیل استفاده نامعتبر از خط فرمان، یا برهم‌کنش‌ها با سیستم، مانند دسترسی به پایگاه‌داده، تخصیص حافظه و غیره.
.SH "محیط (ENVIRONMENT)"
.IX Header "محیط (ENVIRONMENT)"
.SS "محیط خارجی (External environment)"
.IX Subsection "محیط خارجی (External environment)"
.IP \fBSHELL\fR 4
.IX Item "SHELL"
برنامه‌ای را برای اجرا تعیین می‌کند زمانی که یک دستور از طریق یک پوسته فراخوانی می‌شود (از نسخه dpkg 1.19.2).
.IP \fBPAGER\fR 4
.IX Item "PAGER"
.PD 0
.IP \fBDPKG_PAGER\fR 4
.IX Item "DPKG_PAGER"
.PD
دستور صفحه‌بندی‌کننده (pager) مورد استفاده را تعیین می‌کند (از نسخه dpkg 1.19.1)، که با
\(Fo\fR\f(CB$SHELL\fR\fB \-c\fR\(Fc
اجرا خواهد شد.
اگر
\&\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_ROOT\fR 4
.IX Item "DPKG_ROOT"
اگر تنظیم شده باشد و گزینه
\&\fB\-\-root\fR
مشخص نشده باشد، به عنوان دایرکتوری ریشه سیستم‌فایل استفاده می‌شود (از نسخه dpkg 1.21.0).
.IP \fBDPKG_ADMINDIR\fR 4
.IX Item "DPKG_ADMINDIR"
اگر تنظیم شده باشد و گزینه
\&\fB\-\-admindir\fR
مشخص نشده باشد، به عنوان دایرکتوری داده‌های
\&\fBdpkg\fR
استفاده می‌شود.
.IP \fBDPKG_DEBUG\fR 4
.IX Item "DPKG_DEBUG"
ماسک اشکال‌زدایی را از یک مقدار هشت‌هشتی (octal) تنظیم می‌کند (از نسخه dpkg 1.21.10).
پرچم‌های پذیرفته‌شده فعلی در گزینه
\&\fBdpkg \-\-debug\fR
شرح داده شده‌اند، اما ممکن است همه این پرچم‌ها روی این برنامه تأثیرگذار نباشند.
.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
(پیش‌فرض).
.SS "محیط داخلی (Internal environment)"
.IX Subsection "محیط داخلی (Internal environment)"
.IP \fBLESS\fR 4
.IX Item "LESS"
توسط
\&\fBdpkg\-query\fR
هنگام فراخوانی صفحه‌بندی‌کننده روی
\(lq\fB\-FRSXMQ\fR\(rq
تعریف می‌شود، اگر از پیش تنظیم نشده باشد (از نسخه dpkg 1.19.2).
برای تغییر رفتار پیش‌فرض، این متغیر را می‌توان از پیش روی مقدار دیگری از جمله یک رشته خالی تنظیم کرد، یا می‌توان متغیرهای
\&\fBPAGER\fR
یا
\&\fBDPKG_PAGER\fR
را برای غیرفعال کردن گزینه‌های خاص با
\(Fo\fB\-+\fR\(Fc
تنظیم نمود، برای مثال
\&\fBDPKG_PAGER="less \-+F"\fR.
.SH "امنیت (SECURITY)"
.IX Header "امنیت (SECURITY)"
عملیات پرس‌وجو هرگز نباید نیازمند دسترسی کاربر ریشه (root) باشد، و واگذاری اجرای آن‌ها به کاربران بدون امتیاز از طریق دستورات ارتقای امتیاز (مانند sudo) می‌تواند پیامدهای امنیتی به همراه داشته باشد (مانند ارتقای غیرمجاز دسترسی)، به عنوان مثال زمانی که یک صفحه‌بندی‌کننده به طور خودکار توسط این ابزار فراخوانی می‌شود.
.SH "همچنین ببینید (SEE ALSO)"
.IX Header "همچنین ببینید (SEE ALSO)"
\&\fBdpkg\fR\|(1).