MUTT(1) راهنمای کاربر MUTT(1) نام (NAME) mutt - کارگزار کاربری ایمیل مات (The Mutt Mail User Agent) خلاصه دستور (SYNOPSIS) mutt [-nRyzZ] [-e command] [-F rcfile] [-m type] [-f mailbox] mutt [-Enx] [-e command] [-F rcfile] [-H draft] [-i include] [-b bcc-addr] [-c cc-addr] [-s subject] [-a file ... --] to-addr ... mutt [-nx] [-e command] [-F rcfile] [-b bcc-addr] [-c cc-addr] [-s subject] [-a file ... --] to-addr ... < message mutt [-n] [-e command] [-F rcfile] -p mutt [-n] [-e command] [-F rcfile] -A alias mutt [-n] [-e command] [-F rcfile] -Q variable mutt -v[v] mutt -D توضیحات (DESCRIPTION) برنامهٔ Mutt یک ابزار کوچک اما بسیار قدرتمند مبتنی بر متن برای خواندن و ارسال رایانامه (ایمیل) در سیستم‌عامل‌های یونیکس است که از پایانه‌های رنگی، MIME، OpenPGP و حالت مرتب‌سازی موضوعی (threaded) پشتیبانی می‌کند. نکته: این صفحهٔ راهنما مرور مختصری از گزینه‌های خط فرمان برنامهٔ اجرایی mutt ارائه می‌دهد. نسخه‌ای از راهنمای کامل در مسیر /usr/share/doc/mutt در قالب متنی، HTML و/یا PDF قرار دارد. لطفاً برای یادگیری نحوهٔ استفاده و پیکربندی Mutt به راهنمای آن مراجعه کنید. گزینه‌ها (OPTIONS) -A alias چاپ نسخه گسترش‌یافته از alias مشخص‌شده و خروج. -a file ... پیوست کردن یک file با استفاده از MIME. جداسازی شناسه‌های file و to-addr با “--” الزامی است. برای مثال: mutt -a image.jpg -- to-addr mutt -a img.jpg *.png -- to-addr-1 to-addr-2 گزینهٔ -a باید در انتهای گزینه‌های خط فرمان قرار گیرد. -b bcc-addr مشخص کردن یک نشانی رونوشت پنهان (BCC). -c cc-addr مشخص کردن یک نشانی رونوشت (CC). -d level اگر Mutt با +DEBUG کامپایل شده باشد، خروجی اشکال‌زدایی را در ~/.muttdebug0 ثبت می‌کند. level می‌تواند بین -5 تا 5 باشد و بر میزان جزئیات تأثیر می‌گذارد. مقدار صفر اشکال‌زدایی را غیرفعال می‌کند. مقدار کمتر از صفر چرخش خودکار فایل گزارش را غیرفعال می‌کند؛ در این حالت سطح گزارش برابر با مقدار مطلق آن خواهد بود. مقدار 2 (-2) برای اکثر موارد عیب‌یابی پیشنهاد می‌شود. -D چاپ مقدار تمام گزینه‌های پیکربندی در خروجی استاندارد (stdout). -E ویرایش فایل پیش‌نویس (draft) مشخص‌شده با -H یا فایل ضمیمه‌شده (include) مشخص‌شده با -i در هنگام نوشتن پیام. -e command مشخص کردن یک دستور پیکربندی (command) برای اجرا پس از پردازش فایل‌های مقداردهی اولیه. -f mailbox مشخص کردن صندوق پستی (mailbox) برای بارگذاری. -F rcfile استفاده از rcfile به جای فایل پیکربندی کاربر. -h نمایش خلاصهٔ کوتاهی از گزینه‌ها و خروج. -H draft مشخص کردن یک فایل پیش‌نویس (draft) شامل سرایند و بدنه برای ارسال پیام. اگر draft برابر با “-” باشد، داده‌ها از ورودی استاندارد (stdin) خوانده می‌شوند. انتظار می‌رود فایل پیش‌نویس صرفاً شامل یک ایمیل مطابق با RFC822 — سرایندها و بدنه — باشد. اگرچه این یک فایل mbox نیست، اما اگر خط «From » قالب mbox وجود داشته باشد، بدون خطا نادیده گرفته می‌شود. فایل‌های پیش‌نویس در هر دو حالت تعاملی و دسته‌ای یکسان پردازش می‌شوند؛ آنها دست‌نخورده عبور داده نمی‌شوند. به عنوان مثال، فایل‌های پیش‌نویس رمزگذاری‌شده، رمزگشایی خواهند شد. -i include مشخص کردن یک فایل الحاقی (include) برای درج در بدنهٔ پیام. در صورت تنظیم بودن -H نادیده گرفته می‌شود. اگر include برابر با “-” باشد، داده‌ها از ورودی استاندارد خوانده می‌شوند. -m type مشخص کردن نوع (type) پیش‌فرض صندوق پستی برای پوشه‌های تازه ایجادشده. می‌تواند یکی از موارد زیر باشد: mbox، MMDF، MH یا Maildir. همچنین بخش $mbox_type را در راهنما ببینید. -n فایل پیکربندی سراسری سیستم (Muttrc) خوانده نشود. -p ادامه دادن ویرایش یک پیام به تعویق افتاده (postponed). در صورت عدم وجود پیام به تعویق افتاده، فوراً خارج می‌شود. -Q variable پرس‌وجوی یک متغیر پیکربندی (variable). این پرس‌وجو پس از تجزیه تمام فایل‌های پیکربندی و اجرای هرگونه دستور (commands) ارائه‌شده در خط فرمان انجام می‌شود. -R باز کردن صندوق پستی در حالت فقط‌خواندنی. -s subject مشخص کردن موضوع (subject) پیام. در صورت داشتن فاصله، باید درون نقل‌قول قرار گیرد. -v نمایش شماره نسخه Mutt و تعاریف زمان کامپایل. -vv نمایش اطلاعات مجوز و حق نشر. -x شبیه‌سازی حالت نگارش mailx(1). -y اجرای Mutt همراه با فهرستی از تمام صندوق‌های پستی مشخص‌شده توسط دستور پیکربندی mailboxes. -z خروج فوری با کد 1 در صورتی که صندوق پستی (mailbox) مشخص‌شده با -f هیچ پیامی نداشته باشد. -Z باز کردن نخستین صندوق پستی مشخص‌شده در دستور پیکربندی mailboxes که شامل نامهٔ جدید باشد. در صورتی که در هیچ‌کدام نامه جدیدی نباشد، فوراً با کد 1 خارج می‌شود. -- برخورد با شناسه‌های باقی‌مانده به عنوان to-addr حتی اگر با خط تیره آغاز شوند. همچنین گزینهٔ -a در بالا را ببینید. نشانی to-addr می‌تواند یک نشانی ایمیل محلی یا شبکه‌ای و یا یک URL از نوع :mailto باشد. محیط (ENVIRONMENT) EDITOR, VISUAL ویرایشگر مورد استفاده هنگام نگارش پیام‌ها را مشخص می‌کند. اگر هر دو متغیر EDITOR و VISUAL تنظیم شده باشند، VISUAL اولویت دارد. اگر هیچ‌کدام تنظیم نشده باشند، پیش‌فرض vi(1) است. EGDSOCKET, RANDFILE مسیرهای مورد استفاده برای مقداردهی اولیه موتور تصادفی کتابخانهٔ SSL. EMAIL نشانی ایمیل کاربر. HOME مسیر کامل دایرکتوری خانگی کاربر. MAIL مسیر کامل صندوق پستی مخزن (spool) کاربر. MAILDIR مسیر کامل صندوق پستی مخزن کاربر در صورت تنظیم نبودن MAIL. معمولاً زمانی استفاده می‌شود که صندوق پستی مخزن یک پوشهٔ maildir(5) باشد. MAILCAPS مسیر جستجوی فایل‌های mailcap. MM_NOASK در صورت تنظیم بودن این متغیر، mailcap همیشه بدون درخواست تأیید اولیه استفاده می‌شود. PGPPATH دایرکتوری حاوی دسته‌کلید عمومی PGP کاربر. هنگام استفاده با برنامهٔ اصلی PGP، برنامهٔ mutt و mutt_pgpring(1) به تنظیم بودن این متغیر وابسته هستند. REPLYTO نشانی پیش‌فرض پاسخ‌به (Reply-To). TMPDIR دایرکتوری ایجاد فایل‌های موقت. در صورت تنظیم نبودن، /tmp برای tmpdir$ و /var/tmp برای tmpdraftdir$ استفاده می‌شود. متغیرهای پیکربندی tmpdir$ و tmpdraftdir$ را نیز در راهنما ببینید. LC_ALL, LC_CTYPE, LANG برای تعیین مجموعه نویسه‌ها (charset) و محلی‌سازی (locale) مورد استفاده قرار می‌گیرند. TEXTDOMAINDIR دایرکتوری حاوی فایل‌های ترجمه. در صورت تنظیم، این مسیر جایگزین دایرکتوری نصب Mutt می‌شود. برای آزمایش تغییرات ترجمه استفاده می‌شود. فایل‌ها (FILES) ~/.muttrc ~/.mutt/muttrc $XDG_CONFIG_HOME/mutt/muttrc فایل‌های پیکربندی کاربر. /etc/mutt/Muttrc or /usr/share/mutt/Muttrc فایل پیکربندی سراسری سیستم. /tmp/muttXXXXXX فایل‌های موقت ایجادشده توسط Mutt. ~/.muttdebug0 فایل حاوی خروجی اشکال‌زدایی. فایل‌های گزارش به‌طور خودکار توسط mutt با تغییر شماره در انتهای نام چرخانده می‌شوند. گزینهٔ -d در بالا را ببینید. ~/.mailcap تعریف‌های کاربر برای مدیریت انواع غیر متنی MIME. /etc/mutt/mailcap تعریف‌های سیستمی برای مدیریت انواع غیر متنی MIME. ~/.mime.types نگاشت شخصی کاربر بین انواع MIME و پسوند فایل‌ها. /etc/mutt/mime.types نگاشت سیستمی بین انواع MIME و پسوند فایل‌ها. /usr/bin/mutt_dotlock برنامهٔ ممتاز قفل‌گذاری با نقطه (dotlocking). /usr/share/doc/mutt/manual.txt راهنمای Mutt. اشکالات (BUGS) هیچ مشکلی وجود ندارد. سگ‌های دورگه (Mutts) کک دارند، نه حشره (bug)! کک‌ها (FLEAS) تعلیق/ازسرگیری (Suspend/resume) هنگام ویرایش یک فایل با یک ویرایشگر خارجی در SunOS 4.x در صورت استفاده از کتابخانه curses در /usr/5lib کار نمی‌کند. هرچند با کتابخانه S-Lang کار می‌کند. تغییر اندازه صفحه هنگام استفاده از یک صفحه‌بند (pager) خارجی در برخی سیستم‌ها باعث به هم ریختن رفتار Mutt می‌شود. تعلیق/ازسرگیری در Ultrix کار نمی‌کند. اگر کلیدهای میانبر یکی از توابع فهرست‌شده را هنگام اجرای Mutt تغییر دهید، خط راهنما برای منوی نمایه (index menu) به‌روزرسانی نمی‌شود. برای دریافت فهرست به‌روزتری از اشکالات یا همان کک‌ها، لطفاً به سامانه ردیابی اشکالات پروژه mutt در آدرس https://gitlab.com/muttmua/mutt/issues مراجعه کنید. نکته: سامانه ردیابی اشکالات برای درخواست ویژگی‌های جدید نیست. این درخواست‌ها باید به فهرست پستی mutt-dev ارسال شوند؛ برای جزئیات بیشتر به بخش 1.2 راهنما با عنوان فهرست‌های پستی (Mailing Lists) مراجعه کنید. بدون ضمانت (NO WARRANTIES) این برنامه با این امید توزیع شده است که مفید باشد، اما بدون هرگونه ضمانت؛ حتی بدون ضمانت ضمنی قابلیت فروش یا تناسب برای یک هدف خاص. برای جزئیات بیشتر مجوز عمومی همگانی گنو (GNU General Public License) را مطالعه کنید. همچنین ببینید (SEE ALSO) mutt_dotlock(1), mutt_pgpring(1), pgpewrap(1), sendmail(1), smail(1), smime_keys(1), curses(3), ncurses(3), mailcap(5), maildir(5), mbox(5), mmdf(5), muttrc(5) صفحه خانگی Mutt: http://www.mutt.org راهنمای Mutt RFC5322 — قالب پیام اینترنتی: https://tools.ietf.org/rfcmarkup/5322 (جایگزین RFC2822 و RFC822) نویسنده (AUTHOR) مایکل الکینز (Michael Elkins) و دیگران. برای برقراری ارتباط با توسعه‌دهندگان از استفاده کنید. Unix July 24, 2020 MUTT(1)