نمایه‌سازی (Indexing)

mairix [ -v|--verbose ] [ -p|--purge ] [ -f|--rcfile mairixrc ] [ -F|--fast-index ] [ --force-hash-key-new-database hash ]

جستجو (Searching)

mairix [ -v|--verbose ] [ -f|--rcfile mairixrc ] [ -r|--raw-output ] [ -x|--excerpt-output ] [ -H|--force-hardlinks ] [ -o|--mfolder mfolder ] [ -a|--augment ] [ -t|--threads ] search-patterns

سایر موارد (Other)

mairix [ -h|--help ]

mairix [ -V|--version ]

mairix [ -d|--dump ]

حالت‌های ویژه (Special modes)

-h, --help

نمایش خلاصهٔ نحوهٔ استفاده و خروج.

-V, --version

نمایش نسخهٔ برنامه و خروج.

-d

تخلیهٔ محتویات پایگاه‌داده به صورت خوانا برای انسان در خروجی استاندارد (stdout).

گزینه‌های عمومی (General options)

-f mairixrc

--rcfile mairixrc

مشخص کردن یک فایل پیکربندی جایگزین برای استفاده. فایل پیکربندی پیش‌فرض ~/.mairixrc است.

-v, --verbose

افزایش جزئیات خروجی (حالت پرگویی).

-Q, --no-integrity-checks

به‌طور معمول mairix برخی بررسی‌های یکپارچگی داخلی را روی پایگاه‌داده انجام می‌دهد. گزینهٔ -Q این بررسی‌ها را حذف می‌کند و باعث می‌شود mairix سریع‌تر اجرا شود، اما در صورت بروز هرگونه باگ، احتمال شناسایی مشکلات داخلی کمتر خواهد بود.

دستورالعمل nochecks در فایل rc نیز اثر مشابهی دارد.

--unlock

برنامهٔ mairix فایل پایگاه‌دادهٔ خود را در حین هرگونه عملیات نمایه‌سازی یا جستجو قفل می‌کند تا از تداخل چند اجرای نمایه‌سازی با یکدیگر، یا تداخل یک اجرای نمایه‌سازی با اجراهای جستجو جلوگیری کند. گزینهٔ --unlock فایل قفل (lockfile) را پیش از انجام عملیات نمایه‌سازی یا جستجوی درخواستی پاک می‌کند. این روش مناسبی برای پاک‌سازی فایل قفلِ برجامانده در صورتی است که اجرای پیشین به هر دلیلی از کار افتاده یا متوقف شده باشد.

گزینه‌های نمایه‌سازی (Indexing options)

-p, --purge

باعث پاک‌سازی پیام‌های کهنه (حذف‌شده/مرده) از پایگاه‌داده در حین اجرای نمایه‌سازی می‌شود. (به‌طور معمول، پیام‌های کهنه به دلیل هزینهٔ سربار اضافیِ فشرده‌سازی فضای ذخیره‌سازی، در پایگاه‌داده باقی می‌مانند.)

-F, --fast-index

هنگام پردازش پوشه‌های maildir و MH، برنامهٔ mairix به‌طور معمول mtime (زمان اصلاح) و اندازهٔ هر پیام را با مقادیر ذخیره‌شده در پایگاه‌داده مقایسه می‌کند. اگر تغییر کرده باشند، پیام دوباره بررسی (اسکن) می‌شود. این بررسی نیازمند اجرای stat روی فایل هر پیام است. برای تعداد زیادی از پیام‌ها در این نوع پوشه‌ها، این کار می‌تواند سربار قابل‌توجهی ایجاد کند.

این گزینه به mairix اعلام می‌کند فرض را بر این بگذارد که وقتی پیامی روی دیسک نامی مطابق با پیامی در پایگاه‌داده دارد، پیام بدون تغییر مانده است.

اجرای بعدی نمایه‌سازی بدون این گزینه، هرگونه اسکن مجددی را که به دلیل استفاده از آن نادیده گرفته شده بود برطرف خواهد کرد.

--force-hash-key-new-database hash

این گزینه فقط باید برای اشکال‌زدایی استفاده شود.
اگر پایگاه‌دادهٔ جدیدی ایجاد شود، مقدار hash به‌جای یک هش تصادفی، به عنوان کلید هش استفاده می‌شود.

گزینه‌های جستجو (Search options)

-a, --augment

افزودن پیام‌های تطبیق‌یافتهٔ جدید به mfolder فعلی به‌جای ایجاد mfolder از ابتدا.

-t, --threads

علاوه بر بازگرداندن پیام‌های تطبیق‌یافته، تمام پیام‌های موجود در رشتهٔ گفتگو (thread) یکسان با یکی از تطابق‌های واقعی را نیز بازمی‌گرداند.

-r, --raw-output

به‌جای ایجاد یک mfolder حاوی پیام‌های تطبیق‌یافته، صرفاً مسیرهای آن‌ها را در خروجی استاندارد نمایش می‌دهد.

-x, --excerpt-output

به‌جای ایجاد یک mfolder حاوی پیام‌های تطبیق‌یافته، گزیده‌ای از هدرهای آن‌ها را در خروجی استاندارد نمایش می‌دهد. این گزیده هدرهای To، Cc، From، Subject و Date را نشان می‌دهد. با پوشه‌های منبع IMAP، این کار نیازمند بارگیری هر پیام تطبیق‌یافته از کارساز IMAP است.

-H, --force-hardlinks

به‌جای ایجاد پیوندهای نمادین، استفاده از پیوندهای سخت (hardlinks) را اجباری می‌کند. این کار به برنامه‌های نامه‌رسان مانند alpine کمک می‌کند تا متوجه شوند نامه‌های جدیدی در پوشهٔ جستجو وجود دارد.

-o mfolder

--mfolder mfolder

مشخص کردن یک مسیر موقت جایگزین برای استفاده توسط mfolder، که دستورالعمل mfolder در فایل rc را بازنویسی می‌کند.

mairix از نوشتن نتایج جستجو در هر پوشه‌ای که به نظر برسد جزو پوشه‌های نمایه‌شده است خودداری می‌کند. این کار برای جلوگیری از حذف تصادفی رایانامه‌ها است.

الگوهای جستجو (Search patterns)

t:word

تطبیق word در هدر To:.

c:word

تطبیق word در هدر Cc:.

f:word

تطبیق word در هدر From:.

s:word

تطبیق word در هدر Subject:.

m:word

تطبیق word در هدر Message-ID:.

b:word

تطبیق word در بدنهٔ پیام.

بدنهٔ پیام (Message body) به معنای هر بخش از بدنه با نوع text/plain یا text/html در نظر گرفته می‌شود. برای text/html، متن‌های درون تگ‌های متا نادیده گرفته می‌شوند. به‌ویژه، نشانی‌های وب درون تگ‌های <A HREF="..."> در حال حاضر نمایه نمی‌شوند. پیوست‌های غیرمتنی نادیده گرفته می‌شوند. اگر پیوستی از نوع message/rfc822 وجود داشته باشد، این پیوست تجزیه شده و تطبیق روی این زیرپیام نیز انجام می‌شود. در صورت وقوع تطابق، با پیام دربرگیرنده به‌گونه‌ای رفتار می‌شود که گویی تطابق داشته است.

d:[start-datespec]-[end-datespec]

تطبیق پیام‌هایی با هدر Date: که در محدودهٔ مشخص‌شده قرار دارند.

z:[low-size]-[high-size]

تطبیق پیام‌هایی که اندازهٔ آن‌ها در محدودهٔ مشخص‌شده قرار دارد. اگر آرگومان low-size حذف شود، مقدار پیش‌فرض آن صفر خواهد بود. اگر آرگومان high-size حذف شود، مقدار پیش‌فرض آن بی‌نهایت در نظر گرفته می‌شود.

برای نمونه، جهت تطبیق پیام‌هایی با اندازه بین ۱۰ کیلوبایت و ۲۰ کیلوبایت، می‌توان از عبارت جستجوی زیر استفاده کرد:

mairix z:10k-20k

پسوند 'k' پس از یک عدد به معنای ضرب در ۱۰۲۴، و پسوند 'M' پس از یک عدد به معنای ضرب در ۱۰۲۴*۱۰۲۴ است.

n:word

تطبیق word که به عنوان نام یک پیوست در پیام آمده است. از آنجا که نام‌های پیوست معمولاً طولانی هستند، این گزینه معمولاً به صورت زیررشته (substring) استفاده می‌شود. بنابراین:

mairix n:mairix=

تمام پیام‌هایی را تطبیق می‌دهد که پیوست‌هایی با نام‌های حاوی زیررشتهٔ mairix دارند.

نام پیوست به‌ترتیب از مشخصه‌های name=xxx یا filename=xxx در هدرهای Content-Type: و Content-Disposition: تعیین می‌شود.

F:flags

تطبیق پیام‌ها با پرچم‌های (flags) خاص. پرچم‌های موجود عبارتند از 's' به معنای دیده‌شده (seen)، 'r' به معنای پاسخ‌داده‌شده (replied)، و 'f' به معنای پرچم‌گذاری‌شده (flagged). پرچم‌ها به بزرگی و کوچکی حروف حساس نیستند. می‌توان پیش از حرف پرچم یک '-' برای معکوس کردن مفهوم آن قرار داد. بدین ترتیب:

mairix F:-s d:1w-

هر پیام خوانده‌نشده با قدمت کمتر از یک هفته را تطبیق می‌دهد، و

mairix F:f-r d:-1m

هر پیام پرچم‌گذاری‌شده با قدمت بیش از یک ماه را که هنوز به آن پاسخ نداده‌اید تطبیق خواهد داد.

توجه داشته باشید که نویسه‌های پرچم و معانی آن‌ها با نویسه‌های پسوند مورد استفاده در نام فایل‌های پیام در پوشه‌های maildir مطابقت دارند.

جستجوی تطابق در بیش از یک بخش از پیام (Searching for a match amongst more than one part of a message)

در صورتی که تطابق در هر یک از بخش‌های پیام مد نظر باشد، می‌توان چندین بخش را با یکدیگر گروه‌بندی کرد. مثال‌های رایج در ادامه آمده است:

tc:word

تطبیق word در هدر To: یا Cc: (یا هر دو).

bs:word

تطبیق word در هدر Subject: یا بدنهٔ پیام (یا هر دو).

الگوی جستجوی a: کوته‌نوشتی برای tcf: است؛ یعنی تطبیق کلمه در هدرهای To:، Cc: یا From:. (در این مورد "a" مخفف "address" است.)

کلمات تطبیق (Match words)

آرگومان word در رشته‌های جستجو می‌تواند شکل‌های گوناگونی داشته باشد:

~word

تطبیق پیام‌هایی که شامل این کلمه نیستند (نفی کلمه).

word1,word2

اگر هر دو کلمه در بخش مشخص‌شده از پیام تطبیق یابند، نتیجه مثبت است (عملگر AND).

word1/word2

اگر هر یک از کلمه‌ها در بخش مشخص‌شده از پیام تطبیق یابند، نتیجه مثبت است (عملگر OR).

substring=

تطبیق هر کلمه‌ای که حاوی substring به عنوان یک زیررشته باشد.

substring=N

تطبیق هر کلمه‌ای که حاوی substring باشد، با اجازهٔ حداکثر N خطا در تطبیق. برای نمونه، اگر N برابر با ۱ باشد، یک خطای منفرد مجاز است؛ که در آن خطا می‌تواند یکی از موارد زیر باشد:

• یک حرف جاافتاده
• یک حرف اضافی
• یک حرف متفاوت

^substring=

تطبیق هر کلمه‌ای که حاوی substring به عنوان زیررشته باشد، با این شرط که substring در ابتدای کلمهٔ تطبیق‌یافته قرار داشته باشد.

ترتیب تقدم و اولویت (Precedence matters)

ترتیب پیوند و اولویت ساختارها به شرح زیر است:

1.

آرگومان‌های جداگانهٔ خط فرمان، شرایط مستقلی را تعریف می‌کنند که با یکدیگر AND منطقی می‌شوند.

2.

درون یک آرگومان منفرد، حروف پیش از دونقطه مشخص می‌کنند که عبارت روی کدام بخش‌های پیام اعمال شود. اگر دونقطه‌ای وجود نداشته باشد، عبارت روی تمام هدرهای ذکرشده در بالا و بدنه اعمال می‌گردد.

3.

پس از دونقطه، اسلش‌ها گزاره‌های فصلی (disjuncts) جداگانه را تفکیک می‌کنند که با یکدیگر OR منطقی می‌شوند.

4.

هر جزء فصلی می‌تواند شامل اجزای عطفی (conjuncts) جداگانه باشد که با کاما از هم جدا می‌شوند. این شرایط با یکدیگر AND منطقی می‌شوند.

5.

هر جزء عطفی می‌تواند با یک مدک (tilde) برای نفی شروع شود، و می‌تواند یک اسلش برای تعیین تطبیق زیررشته داشته باشد که در صورت تمایل با یک عدد صحیح برای مشخص کردن حداکثر خطاهای مجاز دنبال می‌شود.

تعیین تاریخ (Date specification)

این بخش ساختار نگارشی مورد استفاده برای تعیین تاریخ‌ها هنگام جستجو با گزینهٔ `d:' را شرح می‌دهد.

تاریخ‌ها به صورت یک بازه (محدوده) مشخص می‌شوند. نقطهٔ شروع و پایان بازه هر دو می‌توانند تعیین شوند. از طرف دیگر، اگر شروع بازه حذف شود، ابتدای زمان در نظر گرفته می‌شود. اگر پایان بازه حذف شود، زمان جاری در نظر گرفته می‌شود.

چهار قالب اصلی وجود دارد:

d:start-end

تعیین صریح هر دو نقطهٔ شروع و پایان

d:start-

تعیین شروع، نقطهٔ پایان زمان جاری است

d:-end

تعیین پایان، نقطهٔ شروع «مدت‌ها پیش» است (یعنی به اندازهٔ کافی در گذشته تا شامل هر پیامی بشود).

d:period

تعیین تلویحی شروع و پایان به صورت آغاز و انجام دورهٔ داده‌شده.

شروع و پایان می‌توانند به صورت مطلق یا نسبی مشخص شوند. یک نقطهٔ پایانی نسبی به صورت یک عدد و به دنبال آن یک حرف برای تعیین مقیاس زمان داده می‌شود:

به این منظور، ماه‌ها همواره ۳۰ روز و سال‌ها ۳۶۵ روز در نظر گرفته می‌شوند.

زمان‌های مطلق را می‌توان به شکل‌های گوناگونی تعیین کرد. برخی از قالب‌ها هنگامی که تاریخ شروع را تعریف می‌کنند معنایی متفاوت از زمانی دارند که تاریخ پایان را تعریف می‌کنند. در جایی که یک عبارت منفرد هم شروع و هم پایان را مشخص می‌کند (یعنی آرگومان d: حاوی '-' نیست)، معمولاً در این دو حالت تفسیرهای متفاوتی خواهد داشت.

در مثال‌های زیر فرض کنید تاریخ جاری یکشنبه ۱۸ مه ۲۰۰۳ است (زمانی که نوشتن این مطالب آغاز شد).

اصول عملکرد جدول فوق به صورت زیر است:

• هنگامی که عبارت یک دورهٔ بیش از یک روز را مشخص می‌کند (مثلاً اگر یک ماه یا سال تعیین شود)، در تعریف تاریخ شروع، نخستین روز آن دوره و در تعریف تاریخ پایان، آخرین روز آن دوره در نظر گرفته می‌شود.
• تاریخ پایان همواره روی تاریخ جاری یا پیش از آن در نظر گرفته می‌شود.
• تاریخ شروع همواره روی تاریخ پایان یا پیش از آن در نظر گرفته می‌شود.