.\"	$OpenBSD: aliases.5,v 1.17 2021/02/13 07:20:49 jmc Exp $
.\"
.\" Copyright (c) 2012 Gilles Chehade <gilles@poolp.org>
.\"
.\" 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 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 $Mdocdate: February 13 2021 $
.Dt ALIASES 5
.Os
.SH "نام (NAME)"
aliases \- پرونده نام‌های مستعار برای smtpd
.Sh "توضیحات (DESCRIPTION)"
این صفحه راهنما قالب پرونده
.Nm
مورد استفاده توسط
.Xr smtpd 8
را شرح می‌دهد.
یک نام مستعار (alias)، در ساده‌ترین شکل خود، برای اختصاص یک نام دلخواه
به یک نشانی رایانامه یا گروهی از نشانی‌های رایانامه به کار می‌رود.
این کار روشی راحت برای ارسال نامه فراهم می‌کند.
به عنوان مثال یک نام مستعار می‌تواند به تمام کاربران یک گروه ارجاع دهد:
رایانامه ارسالی به آن نام مستعار برای همه اعضای گروه ارسال خواهد شد.
با این حال، می‌توان نام‌های مستعار بسیار پیچیده‌تری را نیز تعریف کرد:
یک نام مستعار می‌تواند به نام‌های مستعار دیگر ارجاع دهد،
برای ارسال نامه به یک پرونده به جای شخص دیگر استفاده شود،
یا دستورات گوناگونی را اجرا کند.
.Pp
درون پرونده،
.Ql #
جداکننده توضیح است؛ هر چیزی که پس از آن قرار گیرد نادیده گرفته می‌شود.
پرونده از نگاشت‌های کلید/مقدار به شکل زیر تشکیل شده است:
.Bd -filled -offset indent
key: value1, value2, value3, ...
.Ed
.Pp
.Em key
همیشه پیش از جستجوی نام‌های مستعار به حروف کوچک تبدیل می‌شود تا اطمینان حاصل شود که
هیچ ابهامی وجود نخواهد داشت.
کلید به مقادیر متناظر گسترش می‌یابد،
که از یک یا چند مورد از موارد زیر تشکیل شده‌اند:
.Bl -tag -width Ds
.It Em user
یک کاربر در رایانه میزبان.
کاربر باید یک مدخل معتبر در پرونده پایگاه داده
.Xr passwd 5
داشته باشد.
.It Ar /path/to/file
افزودن پیام‌ها به انتهای
.Ar file
که با مسیر مطلق آن مشخص شده است.
.It | Ns Ar command
هدایت لوله‌ای (pipe) پیام به ورودی استاندارد
.Ar command .
دستور تحت امتیازات حساب غیرممتاز دیمن اجرا می‌شود.
.It : Ns Ar include : Ns Ar /path/to/file
گنجاندن هرگونه تعریف موجود در
.Ar file
به عنوان مدخل‌های نام مستعار.
قالب این پرونده دقیقاً مشابه همین پرونده است.
.It Ar user-part@domain-part
یک نشانی رایانامه در قالب RFC 5322.
اگر یک پسوند نشانی (extension) به بخش کاربر پیوست شده باشد،
ابتدا برای تطابق دقیق بررسی می‌شود.
سپس حذف می‌شود تا نشانی‌ای مانند user+ext@example.com
تنها از بخشی که پیش از
.Sq +
قرار دارد به عنوان
.Em key
استفاده کند.
.It Ar error : Ns Ar code message
یک کد وضعیت و پیام برای بازگرداندن.
کد باید ۳ رقمی باشد،
و با 4XX (TempFail یا خطای موقت) یا 5XX (PermFail یا خطای دائمی) شروع شود.
پیام باید وجود داشته باشد و می‌توان آن را آزادانه انتخاب کرد.
.El
.Sh "فایل‌ها (FILES)"
.Bl -tag -width "/etc/smtpd/aliasesXXX" -compact
.It Pa /etc/smtpd/aliases
پرونده پیش‌فرض
.Nm .
.El
.Sh "همچنین ببینید (SEE ALSO)"
.Xr smtpd.conf 5 ,
.Xr makemap 8 ,
.Xr newaliases 8 ,
.Xr smtpd 8
.Sh "تاریخچه (HISTORY)"
قالب پرونده
.Nm
در
.Bx 4.0
ظاهر شد.