CARDDAV-QUERY(1) General Commands Manual CARDDAV-QUERY(1)

carddav-query - پرس‌وجو از یک سرور CardDAV برای یافتن نام‌ها و ایمیل‌های مخاطبان.

carddav-query [-h] [-l <limit>] [-v] [-c <file>] [-s <section>] [-k <key_source>] [-C <key_cred_cmd>] [-s <server_url>] [-u <username>] [-p <password>] <term> [<term> ...]

این ابزار برای استفاده به عنوان address-book-cmd در aerc-config(5) طراحی شده است.

-h, --help

نمایش این پیام راهنما و خروج.

-v, --verbose

چاپ اطلاعات اشکال‌زدایی در خروجی خطای استاندارد (stderr).

-l <limit>, --limit <limit>

حداکثر تعداد نتایج بازگردانده‌شده توسط سرور. اگر سرور از محدودسازی پشتیبانی نکند، این گزینه نادیده گرفته می‌شود.

پیش‌فرض: 10

-c <file>, --config-file <file>

پرونده پیکربندی INI که نشانی URL سرور CardDAV از آن خوانده می‌شود.

پیش‌فرض: ~/.config/aerc/accounts.conf

-S <section>, --config-section <section>

بخش پیکربندی INI که <key_source> و <key_cred_cmd> در آن قرار دارند. به‌طور پیش‌فرض اولین بخشی که <key_source> در آن یافت شود استفاده خواهد شد.

-k <key_source>, --config-key-source <key_source>

کلید پیکربندی INI برای جستجو در <section> از <file>. مقدار باید از قالب زیر پیروی کند:
https?://<username>[:<password>]@<hostname>/<path/to/addressbook>

هر دو مورد <username> و <password> باید درصد‌کدگذاری (percent-encoded) شده باشند. اگر <password> حذف شود، می‌تواند از طریق --config-key-cred-cmd یا --password ارائه گردد.

پیش‌فرض: carddav-source

-C <key_cred_cmd>, --config-key-cred-cmd <key_cred_cmd>

کلید پیکربندی INI برای جستجو در <section> از <file>. مقدار دستوری است که با sh -c اجرا می‌شود تا اگر <password> در <key_source> موجود نبود، آن را تعیین کند.

پیش‌فرض: carddav-source-cred-cmd

-s <server_url>, --server-url <server_url>

نشانی اینترنتی سرور CardDAV. تنظیمات پرونده پیکربندی را لغو می‌کند.

-u <username>, --username <username>

نام کاربری برای احراز هویت در سرور. تنظیمات پرونده پیکربندی را لغو می‌کند.

-p <password>, --password <password>

گذرواژه کاربر مشخص‌شده. تنظیمات پرونده پیکربندی را لغو می‌کند.

<term>

عبارت جستجو. برای جستجوی مخاطبان بر اساس فیلدهای FN (نام قالب‌بندی‌شده)، EMAIL، NICKNAME، ORG (شرکت) و TITLE استفاده خواهد شد.

این‌ها بخش‌هایی از پرونده ~/.config/aerc/accounts.conf هستند.

[fastmail]
carddav-source = https://janedoe%40fastmail.com@carddav.fastmail.com/dav/addressbooks/user/janedoe@fastmail.com/Default
carddav-source-cred-cmd = pass fastmail.com/janedoe
address-book-cmd = carddav-query -S fastmail %s

[gmail]
carddav-source = https://johndoe%40gmail.com@www.googleapis.com/carddav/v1/principals/johndoe@gmail.com/lists/default
carddav-source-cred-cmd = pass gmail.com/johndoe
address-book-cmd = carddav-query -S gmail %s

aerc-config(5)

در ابتدا توسط Drew DeVault ایجاد شد و توسط Robin Jarry با کمک سایر مشارکت‌کنندگان متن‌باز نگهداری می‌شود. برای اطلاعات بیشتر درباره توسعه aerc به https://sr.ht/~rjarry/aerc مراجعه فرمایید.

2025-08-29