.\" Generated by scdoc 1.11.3
.\" Complete documentation for this program is not available as a GNU info page
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.nh
.ad l
.TH "CARDDAV-QUERY" "1" "2025-08-29"
.PP
.SH "نام (NAME)"
.PP
carddav-query \- پرس‌وجو از یک سرور CardDAV برای یافتن نام‌ها و ایمیل‌های مخاطبان.\&
.PP
.SH "خلاصه دستور (SYNOPSIS)"
.PP
\fBcarddav-query\fR [\fB-h\fR] [\fB-l\fR \fI<limit>\fR] [\fB-v\fR] [\fB-c\fR \fI<file>\fR]
[\fB-s\fR \fI<section>\fR] [\fB-k\fR \fI<key_source>\fR] [\fB-C\fR \fI<key_cred_cmd>\fR]
[\fB-s\fR \fI<server_url>\fR] [\fB-u\fR \fI<username>\fR] [\fB-p\fR \fI<password>\fR] \fI<term>\fR [\fI<term>\fR .\&.\&.\&]
.PP
این ابزار برای استفاده به عنوان \fBaddress-book-cmd\fR در \fBaerc-config\fR(5) طراحی شده است.\&
.PP
.SH "گزینه‌ها (OPTIONS)"
.PP
\fB-h\fR, \fB--help\fR
.RS 4
نمایش این پیام راهنما و خروج.
.PP
.RE
\fB-v\fR, \fB--verbose\fR
.RS 4
چاپ اطلاعات اشکال‌زدایی در خروجی خطای استاندارد (stderr).\&
.PP
.RE
\fB-l\fR \fI<limit>\fR, \fB--limit\fR \fI<limit>\fR
.RS 4
حداکثر تعداد نتایج بازگردانده‌شده توسط سرور.\& اگر سرور از محدودسازی پشتیبانی نکند، این گزینه نادیده گرفته می‌شود.\&
.PP
پیش‌فرض: \fI10\fR
.PP
.RE
\fB-c\fR \fI<file>\fR, \fB--config-file\fR \fI<file>\fR
.RS 4
پرونده پیکربندی INI که نشانی URL سرور CardDAV از آن خوانده می‌شود.\&
.PP
پیش‌فرض: \fI~/.\&config/aerc/accounts.\&conf\fR
.PP
.RE
\fB-S\fR \fI<section>\fR, \fB--config-section\fR \fI<section>\fR
.RS 4
بخش پیکربندی INI که \fI<key_source>\fR و \fI<key_cred_cmd>\fR در آن قرار دارند.\& به‌طور پیش‌فرض اولین بخشی که \fI<key_source>\fR در آن یافت شود استفاده خواهد شد.\&
.PP
.RE
\fB-k\fR \fI<key_source>\fR, \fB--config-key-source\fR \fI<key_source>\fR
.RS 4
کلید پیکربندی INI برای جستجو در \fI<section>\fR از \fI<file>\fR.\& مقدار باید از قالب زیر پیروی کند:
.PP
.RS 4
https?\&://\fI<username>\fR[:\fI<password>\fR]@\fI<hostname>\fR/\fI<path/to/addressbook>\fR
.PP
.RE
هر دو مورد \fI<username>\fR و \fI<password>\fR باید درصد‌کدگذاری (percent-encoded) شده باشند.\& اگر \fI<password>\fR حذف شود، می‌تواند از طریق \fB--config-key-cred-cmd\fR یا \fB--password\fR ارائه گردد.\&
.PP
پیش‌فرض: \fIcarddav-source\fR
.PP
.RE
\fB-C\fR \fI<key_cred_cmd>\fR, \fB--config-key-cred-cmd\fR \fI<key_cred_cmd>\fR
.RS 4
کلید پیکربندی INI برای جستجو در \fI<section>\fR از \fI<file>\fR.\& مقدار دستوری است که با \fBsh -c\fR اجرا می‌شود تا اگر \fI<password>\fR در \fI<key_source>\fR موجود نبود، آن را تعیین کند.\&
.PP
پیش‌فرض: \fIcarddav-source-cred-cmd\fR
.PP
.RE
\fB-s\fR \fI<server_url>\fR, \fB--server-url\fR \fI<server_url>\fR
.RS 4
نشانی اینترنتی سرور CardDAV.\& تنظیمات پرونده پیکربندی را لغو می‌کند.\&
.PP
.RE
\fB-u\fR \fI<username>\fR, \fB--username\fR \fI<username>\fR
.RS 4
نام کاربری برای احراز هویت در سرور.\& تنظیمات پرونده پیکربندی را لغو می‌کند.\&
.PP
.RE
\fB-p\fR \fI<password>\fR, \fB--password\fR \fI<password>\fR
.RS 4
گذرواژه کاربر مشخص‌شده.\& تنظیمات پرونده پیکربندی را لغو می‌کند.\&
.PP
.RE
.SH "آرگومان‌های موضعی (POSITIONAL ARGUMENTS)"
.PP
\fI<term>\fR
.RS 4
عبارت جستجو.\& برای جستجوی مخاطبان بر اساس فیلدهای FN (نام قالب‌بندی‌شده)، EMAIL، NICKNAME، ORG (شرکت) و TITLE استفاده خواهد شد.\&
.PP
.RE
.SH "مثال‌ها (EXAMPLES)"
.PP
این‌ها بخش‌هایی از پرونده \fI~/.\&config/aerc/accounts.\&conf\fR هستند.\&
.PP
.SS Fastmail
.PP
.nf
.RS 4
[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
.fi
.RE
.PP
.SS Gmail
.PP
.nf
.RS 4
[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
.fi
.RE
.PP
.SH "همچنین ببینید (SEE ALSO)"
.PP
\fBaerc-config\fR(5)
.PP
.SH "نویسندگان (AUTHORS)"
.PP
در ابتدا توسط Drew DeVault ایجاد شد و توسط Robin Jarry با کمک سایر مشارکت‌کنندگان متن‌باز نگهداری می‌شود.\& برای اطلاعات بیشتر درباره توسعه aerc به \fIhttps://sr.\&ht/~rjarry/aerc\fR مراجعه فرمایید.\&