LEI-Q(1) public-inbox user manual LEI-Q(1)

lei-q - جستجوی پیام‌های منطبق با عبارت‌ها

lei q [OPTIONS] TERM [TERM...]

lei q [OPTIONS] (--stdin|-)

جستجو برای پیام‌ها در سراسر lei/store و منابع خارجی (externals).

خواندن عبارت‌های جستجو از stdin.
جستجو را برای lei-up(1) ذخیره نکن.
هشدار: این گزینه مقصد خروجی را پاک و بازنویسی می‌کند، مگر اینکه "--augment" مشخص شده باشد.

مقصد برای نتایج (برای نمونه، "/tmp/results-Maildir"، "imaps://user@mail.example.com/INBOX.test"، یا "mboxcl2:/tmp/results-mboxcl2"). پیشوند ممکن است یک پروتکل پشتیبانی‌شده باشد: "imap://" یا "imaps://". نشانی‌های اینترنتی که نیازمند احراز هویت هستند از git-credential(1) برای پر کردن نام کاربری و گذرواژه استفاده می‌کنند.

یک پیشوند می‌تواند قالب خروجی را مشخص کند: "maildir"، "mboxrd"، "mboxcl2"، "mboxcl"، "mboxo". برای شرح قالب‌های ایمیل، lei-mail-formats(5) را ببینید.

"v2:/path/to/inbox" ممکن است برای ایجاد یک صندوق ورودی جدید از public-inbox-v2-format(5) استفاده شود. صندوق ورودی جدید در فایل public-inbox-config(5) پیکربندی نخواهد شد.

"maildir" پیش‌فرض برای یک دایرکتوری موجود یا مسیری ناموجود است.

پیش‌فرض: "-" (stdout)

قالب نتایج به stdout. این گزینه به عنوان روشی راحت برای مشخص کردن قالب مقصد پیش‌فرض stdout وجود دارد. "reply"، "text"، "json"، "jsonl"، یا "concatjson" همگی پشتیبانی می‌شوند، همان‌طور که انواع مختلف mbox که در "--output" شرح داده شده پشتیبانی می‌شوند.

هنگامی که قالبی مشخص نشده باشد، بر اساس پیشوند یا مقصد "--output" انتخاب می‌شود. برای مقصد پیش‌فرض (stdout) از "json" استفاده می‌شود.

استفاده از پیشوند "format:" همراه با مقصد "--output" هنگامی که خروجی روی stdout نوشته نمی‌شود، ترجیح داده می‌شود.

غیرفعال کردن رنگ (برای "-f reply"; و "-f text";).
زیبانویسی (Pretty-print) خروجی "json" یا "concatjson". اگر stdout به یک tty متصل باشد و به عنوان مقصد "--output" استفاده شود، "--pretty" به صورت پیش‌فرض فعال است.
دستوری برای اجرا روی Maildir یا mbox در "--output" (برای نمونه، "mutt -f %f"). برای زیرمجموعه‌ای از MUAها که به پذیرش صندوق پستی از طریق "-f" شناخته می‌شوند، COMMAND می‌تواند به نام برنامه خلاصه شود: "mutt"، "mailx"، "mail"، یا "neomutt".
اجرای "COMMAND" پس از نوشتن در خروجی. ":WINCH" ارسال "SIGWINCH" به فرایند "--mua" را مشخص می‌کند. ":bell" چاپ یک کد زنگ را نشان می‌دهد. هر مقدار دیگری به عنوان دستوری که باید همان‌طور که هست اجرا شود، تفسیر می‌گردد.

این گزینه می‌تواند چندین بار مشخص شود.

پیش‌فرض: ":WINCH,:bell" هنگامی که "--mua" مشخص شده باشد و "--output" به stdout اشاره نکند؛ در غیر این صورت هیچ‌چیز.

افزودن به مقصد خروجی به جای پاک و بازنویسی کردن آن.
پیش از نوشتن در یک مقصد خروجی موجود، پیام‌ها را وارد نکنید. پیش از استفاده از این گزینه مطمئن شوید به داده‌های موجود در خروجی خود نیازی ندارید؛ این گزینه داده‌ها را برای همیشه پاک می‌کند مگر اینکه از "--augment" استفاده شود.
بازگرداندن تمام پیام‌های موجود در رشته‌گفتگوی (thread) یکسان با پیام(های) منطبق واقعی.

استفاده دو بار از این گزینه ("-tt")، نشان "flagged" (یا "important") را روی پیام‌هایی که تطابق واقعی داشته‌اند تنظیم می‌کند. این مورد برای تمایز پیام‌هایی که تطابق مستقیم داشته‌اند از پیام‌هایی که صرفاً بخشی از همان رشته‌گفتگو بوده‌اند مفید است.

نکته در دست انجام (TODO): هشدار: این پرچم ممکن است ماندگار شده و در lei/store ذخیره شود، مگر اینکه یک MUA نشان آن را بردارد! (رفتار نهایی تعیین نشده است)

توجه: "-tt" در حال حاضر تنها روی پیام‌هایی کار می‌کند که به صورت محلی نمایه شده‌اند، و نه روی نقاط انتهایی راه دور (HTTP(S))..IP --thread-id=MSGID 4

تنها پیام‌های موجود در همان رشته گفت‌وگو (thread) مشابه با Message-ID مشخص‌شده را جستجو می‌کند.

برای منابع خارجی (externals) از نوع HTTP(S)، این ویژگی تنها روی نمونه‌هایی کار می‌کند که public-inbox نسخه 2.0+ (UNRELEASED) را اجرا می‌کنند.

تنظیم تعداد فرآیندهای کارگر (worker) پرس‌وجو و نوشتن به منظور موازی‌سازی.

مقدار پیش‌فرض "QUERY_WORKERS" برابر با تعداد پردازنده‌های (CPU) در دسترس است، اما برای هر میزبان دوردست (HTTP/HTTPS) برابر با ۴ می‌باشد.

مقدار پیش‌فرض "WRITE_WORKERS" برابر با ۷۵٪ تعداد پردازنده‌های در دسترس برای مقصدهای Maildir و *mbox است، اما برای هر میزبان IMAP/IMAPS برابر با ۴ می‌باشد.

حذف "QUERY_WORKERS" و باقی گذاشتن کاما (",") این امکان را می‌دهد که تنها "WRITE_WORKERS" تنظیم شود.

راهبرد برای یکتاسازی (حذف تکرار) پیام‌ها: "content"، "oid"، "mid" یا "none".

پیش‌فرض: "content"

--[no-]remote
تعیین اینکه آیا نتایج نیازمند دسترسی به شبکه گنجانده شوند یا خیر. هنگامی که منابع خارجی محلی پیکربندی شده باشند، "--remote" باید به صراحت فرستاده شود تا گزارش نتایج از منابع خارجی دوردست فعال گردد.
محدود کردن عملیات تنها به مواردی که نیازمند دسترسی به شبکه هستند.
نتایج برگرفته از منابع خارجی (externals) گنجانده نشوند.
گنجاندن منبع خارجی مشخص‌شده در جستجو. این گزینه می‌تواند چندین بار مشخص شود.
مستثنی کردن منبع خارجی مشخص‌شده از جستجو. این گزینه می‌تواند چندین بار مشخص شود.
تنها استفاده از منبع خارجی مشخص‌شده برای جستجو. این گزینه می‌تواند چندین بار مشخص شود، که در این حالت جستجو تنها از مجموعه مشخص‌شده استفاده می‌کند.
عدم تطبیق مکان‌ها با استفاده از نویسه‌های عمومی (wildcards) "*?" و بازه‌های "[]". این گزینه روی "--include"، "--exclude"، و "--only" اعمال می‌شود.
غیرفعال کردن رفتار پیش‌فرضِ ذخیره‌سازی موقت (memoizing) پیام‌های دوردست در مخزن محلی (local store).
روش(های) قفل‌گذاری mbox(5) برای استفاده: "dotlock"، "fcntl"، "flock" یا "none".

پیش‌فرض: fcntl,dotlock

محدودسازی تقریبی (Fuzzy-limit) تعداد تطابق‌ها به ازای هر منبع خارجی محلی و lei/store. پیام‌های اضافه‌شده با سوییچ --threads در این محدودیت به حساب نمی‌آیند، و هیچ محدودیتی بر منابع خارجی دوردست اعمال نمی‌شود.

پیش‌فرض: 10000

جابه‌جایی نقطه شروع نتایج جستجو.

پیش‌فرض: 0

معکوس کردن نتایج. توجه داشته باشید که این گزینه پیش از "--limit" اعمال می‌شود.
مرتب‌سازی نتایج بر اساس KEY. کلیدهای معتبر عبارتند از "received"، "relevance"، و "docid".

پیش‌فرض: "received"

ارائه بازخورد بیشتر در stderr.
جلوگیری از نمایش پیام‌های بازخورد.
تعیین اینکه آیا دستورهای git(1) و curl(1) با torsocks(1) کپسوله‌سازی (wrap) شوند یا خیر.

پیش‌فرض: "auto"

دستور "lei q" از همان پیشوندهای جستجویی پشتیبانی می‌کند که نمونه‌های HTTP(S) سامانهٔ public-inbox استفاده می‌کنند:
s:        تطابق در Subject، مانند s:"a quick brown fox"
d:        تطابق با بازهٔ تاریخ-زمان، قالب‌های "approxidate" در git پشتیبانی می‌شوند
          بازه‌های انتهای‌باز مانند `d:last.week..' و
          `d:..2.days.ago' پشتیبانی می‌شوند
b:        تطابق در بدنهٔ پیام، شامل پیوست‌های متنی
nq:       تطابق با متن نقل‌قول‌نشده در بدنهٔ پیام
q:        تطابق با متن نقل‌قول‌شده در بدنهٔ پیام
n:        تطابق با نام فایلِ پیوست(ها)
t:        تطابق در سرآیند To
c:        تطابق در سرآیند Cc
f:        تطابق در سرآیند From
a:        تطابق در سرآیندهای To، Cc و From
tc:       تطابق در سرآیندهای To و Cc
l:        تطابق با محتوای سرآیند List-Id
bs:       تطابق در Subject و بدنهٔ پیام
dfn:      تطابق با نام فایل از diff
dfa:      تطابق با خطوط حذف‌شدهٔ diff (-)
dfb:      تطابق با خطوط اضافه‌شدهٔ diff (+)
dfhh:     تطابق با بافت سرآیند قطعهٔ diff (معمولاً یک نام تابع)
dfctx:    تطابق با خطوط بافت (context) در diff
dfpre:    تطابق با شناسهٔ blob پیش‌تصویر (pre-image) در git
dfpost:   تطابق با شناسهٔ blob پس‌تصویر (post-image) در git
dfblob:   تطابق با هر یک از شناسه‌های blob پیش‌تصویر یا پس‌تصویر در git
patchid:  تطابق با خروجی `git patch-id --stable'
rt:       تطابق با زمان دریافت، مانند `d:' در صورت دقیق بودن ساعت فرستنده

پیشوندهای جستجوی اضافی که تنها بر lei/store محلی اثر می‌گذارند:

L:       تطابق با برچسب (label) مشخص‌شده
kw:      تطابق با کلیدواژه‌های (keywords) مشخص‌شده

برای اطلاعات بیشتر دربارهٔ برچسب‌ها و کلیدواژه‌ها، lei-tag(1) را ببینید.

بیشتر پیشوندها احتمالاتی (probabilistic) هستند، به این معنی که از ریشه‌یابی کلمات (stemming) و نویسه‌های عام ("*") پشتیبانی می‌کنند. بازه‌ها (مانند "d:") و پیشوندهای بولی از ریشه‌یابی کلمات یا نویسه‌های عام پشتیبانی نمی‌کنند. مستندات بالادستی تجزیه‌کنندهٔ پرس‌وجوی Xapian نحو پرس‌وجو را به طور کامل توضیح می‌دهد: https://xapian.org/docs/queryparser.html

گزینهٔ "-f reply"; برای کمک به تبدیل یک معرفی‌نامه (cover letter) به پاسخ در نظر گرفته شده است (چرا که استفاده از "git format-patch --in-reply-to=..." خسته‌کننده است). نتایج (از جمله خطوط "From ") باید پیش از ارسال، در $EDITOR دلخواه شما ویرایش و مرتب شوند.

ارسال بازخورد از طریق رایانامهٔ متن ساده به <mailto:meta@public-inbox.org> مورد استقبال است.

آرشیوهای رایانامه در https://public-inbox.org/meta و http://4uok3hntl7oi7b4uf4rtfwefqeexfzil2w6kgk2jn5z2f764irre7byd.onion/meta میزبانی می‌شوند.

کپی‌رایت متعلق به تمامی مشارکت‌کنندگان است <mailto:meta@public-inbox.org>

مجوز: AGPL-3.0+ https://www.gnu.org/licenses/agpl-3.0.txt

lei-add-external(1)، lei-lcat(1)، lei-up(1)، نحو Xapian::QueryParser https://xapian.org/docs/queryparser.html

1993-10-02 public-inbox.git