.\"	$OpenBSD: mail.local.8,v 1.31 2014/09/16 21:28:51 jmc Exp $
.\" Copyright (c) 1990 The Regents of the University of California.
.\" All rights reserved.
.\"
.\" Redistribution and use in source and binary forms, with or without
.\" modification, are permitted provided that the following conditions
.\" are met:
.\" 1. Redistributions of source code must retain the above copyright
.\"    notice, this list of conditions and the following disclaimer.
.\" 2. Redistributions in binary form must reproduce the above copyright
.\"    notice, this list of conditions and the following disclaimer in the
.\"    documentation and/or other materials provided with the distribution.
.\" 3. Neither the name of the University nor the names of its contributors
.\"    may be used to endorse or promote products derived from this software
.\"    without specific prior written permission.
.\"
.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
.\"	from: @(#)mail.local.8	6.8 (Berkeley) 4/27/91
.\"
.Dd $Mdocdate: September 16 2014 $
.Dt MAIL.LOCAL 8
.Os
.SH "نام (NAME)"
mail.local \- ذخیره ایمیل در صندوق پستی
.Sh "خلاصه دستور (SYNOPSIS)"
.Nm mail.local
.Op Fl Ll
.Op Fl f Ar from
.Ar user ...
.Sh "توضیحات (DESCRIPTION)"
.Nm
ورودی استاندارد را تا انتهای فایل (EOF) می‌خواند و آن را به فایل
.Pa mail
هر
.Ar user
الحاق می‌کند.
.Ar user
باید یک نام کاربری معتبر باشد.
.Pp
گزینه‌ها به شرح زیر هستند:
.Bl -tag -width Ds
.It Fl f Ar from
مشخص کردن نام فرستنده.
.It Fl L
هنگام قفل کردن spool، فایل
.Pa username.lock
ایجاد نشود.
.It Fl l
برای سازگاری، درخواست می‌کند که فایل‌های با نام
.Pa username.lock
برای قفل کردن استفاده شوند.
(این رفتار پیش‌فرض است.)
.El
.Pp
پیام‌های ایمیل جداگانه در صندوق پستی با یک خط خالی و به دنبال آن خطی که با رشته
.Dq "From\&\ "
آغاز می‌شود، از یکدیگر جدا می‌شوند.
یک خط حاوی رشته
.Dq "From\&\ " ،
نام فرستنده و یک برچسب زمان به ابتدای هر پیام ایمیل تحویل داده شده اضافه می‌شود.
یک خط خالی به انتهای هر پیام الحاق می‌شود.
یک نویسه بزرگتر از
.Pq Ql >
به ابتدای هر خطی از پیام که ممکن است با یک خط جداکننده
.Dq "From\&\ "
اشتباه گرفته شود، اضافه می‌شود.
.Pp
تلاش‌های زیادی انجام شده است تا اطمینان حاصل شود که
.Nm
در صورتی که مجوزهای دایرکتوری spool برابر 1777 یا 755 باشد، تا حد امکان امن عمل کند.
حالت پیش‌فرض 755 امن‌تر است، اما کلاینت‌های ایمیل را از استفاده از قفل‌گذاری به سبک
.Pa username.lock
بازمی‌دارد.
استفاده از 1777 در محیط spool مشترک NFS انعطاف‌پذیرتر است،
بنابراین بسیاری از سایت‌ها از آن استفاده می‌کنند.
با این حال خطراتی به همراه دارد، مانند پر کردن دیسک spool توسط مهاجمان.
برخی از این مشکلات را می‌توان با تبدیل spool به یک سیستم‌فایل جداگانه و قرار دادن سهمیه (quota) روی آن کاهش داد.
استفاده از هر مجوزی غیر از 1777 و 755 برای دایرکتوری spool توصیه نمی‌شود اما ممکن است به درستی کار کند.
.Pp
صندوق پستی همیشه در حین الحاق ایمیل با استفاده از
.Xr flock 2
قفل می‌شود.
مگر اینکه فلگ
.Fl L
مشخص شده باشد، یک فایل
.Pa username.lock
نیز استفاده می‌شود.
.Pp
اگر سرویس
.Xr biff 1
توسط
.Xr getservbyname 3
بازگردانده شود، سرور biff از تحویل ایمیل مطلع می‌شود.
.Sh "محیط (ENVIRONMENT)"
.Bl -tag -width indent
.It Ev TZ
برای تنظیم منطقه زمانی مناسب روی برچسب زمان استفاده می‌شود.
.El
.Sh "فایل‌ها (FILES)"
.Bl -tag -width /tmp/local.XXXXXXXXXX -compact
.It Pa /tmp/local.XXXXXXXXXX
فایل‌های موقت
.It Pa /var/mail/user
دایرکتوری صندوق پستی کاربر
.El
.Sh "وضعیت خروج (EXIT STATUS)"
.Ex -std mail.local
.Sh "همچنین ببینید (SEE ALSO)"
.Xr biff 1 ,
.Xr mail 1 ,
.Xr flock 2 ,
.Xr getservbyname 3 ,
.Xr comsat 8 ,
.Xr smtpd 8
.Sh "تاریخچه (HISTORY)"
یک فرامجموعه (superset) از
.Nm
(که خواندن صندوق پستی و همچنین تحویل ایمیل را انجام می‌داد) در
.At v7
به عنوان برنامه
.Xr mail 1
ظاهر شد.
.Sh "اشکالات (BUGS)"
استفاده از سهمیه‌بندی در
.Pa /var/mail
در صورت استفاده از
.Xr sendmail 8
به عنوان یک MTA می‌تواند مشکل‌ساز باشد،
زیرا از
.Nm
می‌خواهد در صورت امکان پیامی را به چندین گیرنده تحویل دهد.
این امر در محیط دارای سهمیه باعث ایجاد مشکلاتی می‌شود چرا که ممکن است به دلیل سهمیه دیسک، پیام به برخی کاربران تحویل داده شود اما به برخی دیگر نه.
حتی با وجود اینکه پیام به برخی از گیرندگان تحویل داده شده است،
.Nm
با کد خروج بزرگتر از ۰ خارج می‌شود و باعث می‌شود
.Xr sendmail 8
بعداً مجدداً تلاش برای تحویل کند.
این بدان معناست که برخی کاربران هر بار که
.Xr sendmail 8
صف خود را اجرا می‌کند، همان پیام را دوباره دریافت خواهند کرد.
این مشکل برای کاربران
.Xr smtpd 8
وجود ندارد.
.Pp
اگر در حال اجرای
.Xr sendmail 8
هستید و سهمیه دیسک روی
.Pa /var/mail
دارید، ضروری است که فلگ ایمیل‌رسان (mailer flag)
.Dq m
را برای ایمیل‌رسان
.Sq local
غیرفعال (unset) کنید.
برای انجام این کار، خطی را که با
.Dq Mlocal
در
.Pa /etc/mail/sendmail.cf
شروع می‌شود پیدا کرده و
.Dq m
را از بخش فلگ‌ها که با
.Dq F=
مشخص شده است حذف کنید.
همچنین، می‌توانید فلگ‌های پیش‌فرض mailer را با افزودن این خط لغو (override) کنید:
.Pp
.Dl define(`LOCAL_MAILER_FLAGS', `rn9S')dnl
.Pp
به فایل
.Dq \.mc
خود (این فایل منبعی است که برای تولید
.Pa /etc/mail/sendmail.cf )
استفاده می‌شود.