.\" $Id$
.\"
.\" Copyright (c) 2006 Nicholas Marriott <nicholas.marriott@gmail.com>
.\"
.\" Permission to use, copy, modify, and distribute this software for any
.\" purpose with or without fee is hereby granted, provided that the above
.\" copyright notice and this permission notice appear in all copies.
.\"
.\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
.\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
.\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
.\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
.\" WHATSOEVER RESULTING FROM LOSS OF MIND, USE, DATA OR PROFITS, WHETHER
.\" IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING
.\" OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
.\"
.Dd December 22, 2008
.Dt FDM 1
.Os
.Sh "نام (NAME)"
.Nm fdm
.Nd "دریافت و تحویل نامه‌های الکترونیکی"
.Sh "خلاصه دستور (SYNOPSIS)"
.Nm fdm
.Bk -words
.Op Fl hklmnqv
.Op Fl a Ar account
.Op Fl D Ar name Ns = Ns Ar value
.Op Fl f Ar conffile
.Op Fl u Ar user
.Op Fl x Ar account
.Op Cm fetch | poll | cache
.Ek
.Sh "توضیحات (DESCRIPTION)"
برنامهٔ
.Nm
نامه‌های الکترونیکی را از یک سرور POP3 یا IMAP یا از
.Dv stdin
دریافت کرده و آن‌ها را بر اساس مجموعه‌قوانین موجود در فایل پیکربندی تحویل می‌دهد.
.Pp
گزینه‌ها به شرح زیر هستند:
.Bl -tag -width Ds
.It Fl a Ar name
تنها حساب مشخص‌شده را پردازش می‌کند.
این گزینه می‌تواند چندین بار تکرار شود.
نام حساب می‌تواند شامل نویسه‌های glob شل برای تطبیق با چندین حساب باشد.
.It Fl D Ar name Ns = Ns Ar value
این گزینه یک ماکرو را برای استفاده هنگام تجزیهٔ فایل پیکربندی تعریف می‌کند.
نام ماکرو باید با پیشوند
.Li $
یا
.Li %
شروع شود تا ماکروی رشته‌ای یا عددی را مشخص کند.
این گزینه می‌تواند چندین بار تکرار شود.
.It Fl f Ar conffile
مکان فایل پیکربندی را مشخص می‌کند.
پیش‌فرض
.Pa ~/.fdm.conf
است، یا اگر آن فایل وجود نداشته باشد،
.Pa /etc/fdm.conf
خواهد بود.
.It Fl h
برای احراز دایرکتوری خانگی کاربر، متغیر محیطی
.Ev HOME
را بررسی می‌کند.
.It Fl k
تمام نامه‌ها را پس از تحویل نگه می‌دارد، صرف‌نظر از اینکه با یک اقدام
.Ic drop
مطابقت داشته باشند یا خیر.
توجه داشته باشید نامه‌هایی که به این شیوه نگهداری می‌شوند، در صورت اجرای دوبارهٔ
.Nm
روی همان حساب، مجدداً دریافت خواهند شد.
.It Fl l
ثبت وقایع را به‌جای ارسال به
.Dv stderr
با استفاده از
.Xr syslog 3
انجام می‌دهد.
.It Fl m
فایل قفل را نادیده گرفته و صرف‌نظر از سایر نمونه‌های در حال اجرای
.Nm
اجرا می‌شود.
.It Fl n
هیچ حسابی را پردازش نمی‌کند؛ فقط صحت نحو فایل پیکربندی را بررسی کرده و خارج می‌شود.
.It Fl q
حالت بی‌صدا. تنها خطاها را چاپ می‌کند.
.It Fl u Ar user
کاربر پیش‌فرض را برای تحویل مشخص می‌کند.
این گزینه بر تنظیم
.Ic default-user
در فایل پیکربندی اولویت دارد و آن را بازنویسی می‌کند.
.It Fl v
درخواست ثبت وقایع با جزئیات بیشتر (verbose).
این گزینه می‌تواند چندین بار مشخص شود.
.Fl vv
اطلاعات مربوط به پیکربندی را چاپ می‌کند (همراه با
.Fl n )
مفید است.
.Fl vvvv
تمام ترافیک ارسالی و دریافتی از سرورهای دوردست را در
.Dv stdout
تکرار می‌کند.
این قابلیت هنگام استفاده از پرچم
.Fl l
غیرفعال می‌شود.
.It Fl x Ar name
حساب نام‌برده را مستثنی می‌کند.
می‌توان چندین گزینهٔ
.Fl x
را مشخص کرد.
مشابه با
.Fl a ،
می‌توان از نویسه‌های glob شل استفاده نمود.
.It Cm fetch | poll | cache
دستور
.Cm fetch
به
.Nm
فرمان می‌دهد که پیام‌ها را دریافت کرده و تحویل دهد.
دستور
.Cm poll
حساب‌های موجود در فایل پیکربندی را بررسی کرده و تعداد پیام‌های هر یک را گزارش می‌دهد.
.Cm cache
امکان دستکاری فایل‌های کَش
.Nm
را فراهم می‌سازد: بخش بعدی را ببینید.
.El
.Sh "دستورهای کَش (CACHE COMMANDS)"
دستورهای دستکاری کَش زیر پشتیبانی می‌شوند:
.Bl -tag -width Ds
.It Ic cache Ic add Ar path Ar string
.It Ic cache Ic remove Ar path Ar string
افزودن یا حذف
.Ar string
به‌عنوان یک کلید در کَشِ واقع در
.Ar path .
.It Ic cache Ic list Op Ar path
فهرست کردن تعداد کلیدها در کَش مشخص‌شده؛ یا در صورتی که
.Ar path
ذکر نشود، در تمام کَش‌های تعریف‌شده در فایل پیکربندی.
.It Ic cache Ic dump Ar path
تخلیهٔ محتویات کَشِ
.Ar path
در
.Dv stdout .
هر کلید چاپ شده و به دنبال آن یک فاصله و برچسب زمانی به صورت زمان یونیکس (Unix time) قرار می‌گیرد.
.It Ic cache Ic clear Ar path
حذف تمام کلیدها از کَشِ واقع در
.Ar path .
.El
.Sh "فایل‌ها (FILES)"
.Bl -tag -width Ds -compact
.It Pa ~/.fdm.conf
فایل پیکربندی پیش‌فرض
.Nm
.It Pa /etc/fdm.conf
فایل پیکربندی پیش‌فرض سراسری سیستم
.It Pa ~/.fdm.lock
فایل قفل پیش‌فرض
.It Pa /var/db/fdm.lock
فایل قفل برای کاربر ریشه (root)
.El
.Sh "همچنین ببینید (SEE ALSO)"
.Xr mail 1 ,
.Xr fdm.conf 5 ,
.Xr sendmail 8
.Sh "نویسندگان (AUTHORS)"
.An Nicholas Marriott Aq Mt nicholas.marriott@gmail.com