نام (NAME)

apk-query - پرس‌وجو از اطلاعات بسته در پایگاه داده apk

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

apk query [<options>...] query...

apk query [<options>...] --recursive constraints...

توضیحات (DESCRIPTION)

دستور apk query بسته‌های منطبق را در منابع انتخاب‌شده جستجو می‌کند.

در حالت پیش‌فرض، مشخص‌کننده‌های query به این صورت تفسیر می‌شوند:

در حالت --recursive، مقدار constraints فهرستی از وابستگی‌ها را برای برآورده شدن مشخص می‌کند و از الگوریتم حل‌کننده (solver) برای تعیین فهرستی از بسته‌ها که این محدودیت‌ها را برآورده می‌کنند استفاده می‌شود.

پرس‌وجو در مراحل زیر اجرا می‌شود:

1.

هر رشته query به طور مستقل برای انتخاب بسته‌های کاندید اجرا می‌شود

2.

اگر --all-matches مشخص نشده باشد، بهترین کاندید برای عبارت داده‌شده به فهرست بسته‌های نتیجه اضافه می‌شود

3.

فهرست بسته‌های حاصل مرتب‌سازی می‌شود

گزینه‌های پرس‌وجو (QUERY OPTIONS)

اپلت‌هایی که از مشخص‌کننده‌های پرس‌وجو پشتیبانی می‌کنند گزینه‌های زیر را می‌شناسند:

--all-matches

--available

--fields FIELDS[:REVERSE_FIELD]

--format FORMATSPEC

--from FROMSPEC

--installed

--match FIELDS

--recursive

--summarize FIELD[:REVERSE_FIELD]

--upgradable

--world

--orphaned

فیلدها (FIELDS)

نام فیلدها برای گزینه‌های --match و --fields و همچنین برای خروجی قابل پردازش ماشین (json و yaml) همگی با حروف کوچک هستند. برای قالب پیش‌فرض خوانا برای انسان، فیلدها با حروف بزرگ شروع می‌شوند.

فیلدهای متاداده بسته زیر در دسترس هستند: name، version، description، arch، license، origin، maintainer، url، commit، build-time، installed-size، file-size، provider-priority، depends، provides، replaces، install-if، layer، tags، triggers، scripts و replaces-priority. برای شرح این فیلدها بخش‌های package info metadata و package metadata در apk-package(8) را ببینید.

علاوه بر این، فیلدهای زیر نیز در دسترس هستند:

contents

download-url

owner

package

repositories

status

مثال‌ها (EXAMPLES)

# جستجوی تمام بسته‌هایی که با apk شروع می‌شوند
apk query "apk*"

# نمایش بسته مالک فایل اجرایی sensors در قالب json
apk query --format json --match owner /usr/bin/sensors

# نمایش apk-tools و وابستگی‌های آن در قالب yaml
apk query --format yaml --recursive apk-tools

# چاپ بسته‌های منبع برای تمام بسته‌های ارائه‌دهنده cmd:apk
apk query --match name,provides cmd:apk --fields origin

# چاپ بسته‌های منبع با نام وابستگی مشخص
apk query --match depends so:libapk.so.2.14.9 --fields origin