.TH POSTALIAS 1 
.ad
.fi
.SH "نام (NAME)"
postalias \- مدیریت پایگاه‌داده‌های نام مستعار Postfix
.SH "خلاصه دستور (SYNOPSIS)"
.na
.nf
.fi
\fBpostalias\fR [\fB\-Nfijnoprsuvw\fR] [\fB\-c \fIconfig_dir\fR]
[\fB\-d \fIkey\fR] [\fB\-q \fIkey\fR]
        [\fIfile_type\fR:]\fIfile_name\fR ...
.SH "توضیحات (DESCRIPTION)"
.ad
.fi
دستور \fBpostalias\fR(1) یک یا چند پایگاه‌داده نام مستعار (alias) در Postfix را ایجاد یا پرس‌وجو کرده، یا نمونه‌های موجود را به‌روزرسانی می‌کند. انتظار می‌رود قالب‌های فایل ورودی و خروجی با Sendmail نگارش ۸ سازگار باشند و برای استفاده به‌عنوان نگاشت‌های نام مستعار NIS مناسب باشند.

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

در زمان انجام به‌روزرسانی پایگاه‌داده، تحویل سیگنال به تعویق می‌افتد و یک قفل مشورتی (advisory) انحصاری بر روی کل پایگاه‌داده قرار می‌گیرد تا از رفتارهای غیرمنتظره در فرآیندهای ناظر جلوگیری شود.

قالب فایل‌های ورودی نام مستعار Postfix در \fBaliases\fR(5) شرح داده شده است.

به‌طور پیش‌فرض، کلید جستجو برای حساس نبودن به بزرگی و کوچکی حروف به حروف کوچک نگاشت می‌شود؛ از Postfix 2.3 به بعد، این تبدیل اندازه حروف تنها برای جدول‌هایی انجام می‌شود که کلیدهای جستجوی آن‌ها رشته‌هایی با حروف ثابت هستند، مانند btree:، dbm: یا hash:. در نگارش‌های پیشین، کلید جستجو حتی در جدول‌هایی که فیلد جستجو می‌توانست با هر دو نوع حروف کوچک و بزرگ مطابقت داشته باشد (مانند regexp: و pcre:) نیز تبدیل می‌شد. این امر منجر به از دست رفتن اطلاعات در جایگزینی‌های $\fInumber\fR می‌گردید.

گزینه‌ها:
.IP "\fB\-c \fIconfig_dir\fR"
خواندن فایل پیکربندی \fBmain.cf\fR در دایرکتوری مشخص‌شده، به‌جای دایرکتوری پیکربندی پیش‌فرض.
.IP "\fB\-d \fIkey\fR"
جستجوی نگاشت‌های مشخص‌شده برای یافتن \fIkey\fR و حذف یک مدخل از هر نگاشت. در صورتی که اطلاعات درخواستی پیدا شود، وضعیت خروج صفر خواهد بود.

اگر مقدار کلید به‌صورت \fB\-\fR مشخص شود، برنامه مقادیر کلید را از جریان ورودی استاندارد می‌خواند. اگر دست‌کم یکی از کلیدهای درخواستی پیدا شود، وضعیت خروج صفر خواهد بود.
.IP \fB\-f\fR
هنگام ایجاد یا پرس‌وجوی یک جدول، کلید جستجو را به حروف کوچک تبدیل نکن.

در نگارش 2.3 و بالاتر Postfix، این گزینه برای جدول‌های عبارت باقاعده (regular expression) تاثیری ندارد؛ در آنجا تبدیل حروف با افزودن پرچم به الگو کنترل می‌شود.
.IP \fB\-i\fR
حالت افزایشی (Incremental). مدخل‌ها را از ورودی استاندارد بخوان و پایگاه‌داده موجود را کوتاه (truncate) نکن. به‌طور پیش‌فرض، \fBpostalias\fR(1) یک پایگاه‌داده جدید از مدخل‌های موجود در \fIfile_name\fR ایجاد می‌کند.
.IP \fB\-j\fR
خروجی JSON. قالب‌بندی خروجی دستورهای \fB\-q\fR و \fB\-s\fR به‌صورت یک شیء \fB{"\fIkey\fB": "\fIvalue\fB"}\fR در هر خط.
.sp
این ویژگی در نگارش 3.11 و بالاتر Postfix در دسترس است.
.IP \fB\-N\fR
شامل کردن نویسه تهی پایانی (null character) که کلیدها و مقادیر جستجو را خاتمه می‌دهد. به‌طور پیش‌فرض، \fBpostalias\fR(1) مطابق با رفتار پیش‌فرض سیستم‌عامل میزبان عمل می‌کند.
.IP \fB\-n\fR
نویسه تهی پایانی (null character) که کلیدها و مقادیر جستجو را خاتمه می‌دهد لحاظ نشود. به‌طور پیش‌فرض، \fBpostalias\fR(1) مطابق با رفتار پیش‌فرض سیستم‌عامل میزبان عمل می‌کند.
.IP \fB\-o\fR
هنگام پردازش یک فایل ورودی غیر ریشه (non-root)، دسترسی‌های root را رها نکن. به‌طور پیش‌فرض، \fBpostalias\fR(1) دسترسی‌های root را کنار می‌گذارد و با هویت مالک فایل مبدأ اجرا می‌شود.
.IP \fB\-p\fR
هنگام ایجاد فایل جدید، مجوزهای دسترسی فایل از فایل ورودی به ارث برده نشود؛ در عوض، فایل جدید با مجوزهای دسترسی پیش‌فرض (حالت 0644) ایجاد شود.
.IP "\fB\-q \fIkey\fR"
جستجوی نگاشت‌های مشخص‌شده برای یافتن \fIkey\fR و نوشتن نخستین مقدار یافت‌شده در جریان خروجی استاندارد. در صورتی که اطلاعات درخواستی پیدا شود، وضعیت خروج صفر خواهد بود.

نکته: این عمل یک پرس‌وجوی منفرد با کلید مشخص‌شده انجام می‌دهد و مانند آنچه در صفحه راهنمای aliases(5) شرح داده شده است، پرس‌وجوهای تکرارشونده با زیررشته‌های کلید انجام نمی‌دهد.

اگر مقدار کلید به‌صورت \fB\-\fR مشخص شود، برنامه مقادیر کلید را از جریان ورودی استاندارد می‌خواند و به ازای هر کلید یافت‌شده، یک خط خروجی به‌صورت \fIkey: value\fR می‌نویسد. اگر دست‌کم یکی از کلیدهای درخواستی پیدا شود، وضعیت خروج صفر خواهد بود.
.IP \fB\-r\fR
هنگام به‌روزرسانی جدول، در صورت تلاش برای به‌روزرسانی مدخل‌های موجود هشداری نده و آن به‌روزرسانی‌ها را به هر حال اعمال کن.
.IP \fB\-s\fR
بازیابی تمامی عنصرهای پایگاه‌داده و نوشتن یک خط خروجی \fIkey: value\fR برای هر عنصر. عنصرها به ترتیب ذخیره در پایگاه‌داده چاپ می‌شوند که لزوماً با ترتیب ورودی اصلی یکسان نیست.
این ویژگی در نگارش 2.2 و بالاتر Postfix در دسترس است، اما برای همه انواع پایگاه‌داده پشتیبانی نمی‌شود.
.IP \fB\-u\fR
غیرفعال کردن پشتیبانی از UTF\-8. پشتیبانی از UTF\-8 در صورت فعال بودن «smtputf8_enable = yes» به‌طور پیش‌فرض فعال است. این گزینه نیازمند معتبر بودن رشته‌های UTF\-8 برای کلیدها و مقادیر است.
.IP \fB\-v\fR
فعال کردن گزارش‌گیری با جزئیات (verbose) برای مقاصد اشکال‌زدایی. استفاده مکرر از گزینه \fB\-v\fR میزان جزئیات خروجی نرم‌افزار را افزایش می‌دهد.
.IP \fB\-w\fR
هنگام به‌روزرسانی جدول، در صورت تلاش برای به‌روزرسانی مدخل‌های موجود هشداری نده و آن تلاش‌ها را نادیده بگیر.
.PP
آرگومان‌ها:
.IP \fIfile_type\fR
نوع پایگاه‌داده. برای اطلاع از اینکه چه نوع‌هایی پشتیبانی می‌شوند، از دستور «\fBpostconf \-m\fR» استفاده کنید.

هنگامی که هیچ \fIfile_type\fR مشخص نشده باشد، نرم‌افزار از نوع پایگاه‌داده تعیین‌شده در پارامتر پیکربندی \fBdefault_database_type\fR استفاده می‌کند.
مقدار پیش‌فرض این پارامتر به محیط میزبان بستگی دارد.

دستور \fBpostalias\fR(1) می‌تواند هر نوع فایل پشتیبانی‌شده را پرس‌وجو کند، اما تنها قادر به ایجاد انواع فایل زیر است:
.RS
.IP \fBbtree\fR
خروجی یک فایل btree به نام \fIfile_name\fB.db\fR است. این نوع در سیستم‌های دارای پشتیبانی از پایگاه‌داده‌های \fBdb\fR موجود است.
.IP \fBcdb\fR
خروجی یک فایل به نام \fIfile_name\fB.cdb\fR است. این نوع در سیستم‌های دارای پشتیبانی از پایگاه‌داده‌های \fBcdb\fR موجود است.
.IP \fBdbm\fR
خروجی شامل دو فایل به نام‌های \fIfile_name\fB.pag\fR و \fIfile_name\fB.dir\fR است. این نوع در سیستم‌های دارای پشتیبانی از پایگاه‌داده‌های \fBdbm\fR موجود است.
.IP \fBfail\fR
جدولی که به‌طور قطعی تمام درخواست‌ها را با شکست مواجه می‌کند. نام جدول جستجو تنها برای ثبت در گزارش استفاده می‌شود. این جدول جهت تسهیل آزمون‌های خطای Postfix وجود دارد.
.IP \fBhash\fR
خروجی یک فایل درهم‌سازی‌شده (hashed) به نام \fIfile_name\fB.db\fR است. این نوع در سیستم‌های دارای پشتیبانی از پایگاه‌داده‌های \fBdb\fR موجود است.
.IP \fBlmdb\fR
خروجی یک فایل مبتنی بر btree به نام \fIfile_name\fB.lmdb\fR است. برخلاف سایر جدول‌های مبتنی بر فایل پشتیبانی‌شده، \fBlmdb\fR از خواندن و نوشتن هم‌زمان فرآیندهای مختلف پشتیبانی می‌کند. این نوع در سیستم‌های دارای پشتیبانی از پایگاه‌داده‌های \fBlmdb\fR موجود است.
.IP \fBsdbm\fR
خروجی شامل دو فایل به نام‌های \fIfile_name\fB.pag\fR و \fIfile_name\fB.dir\fR است. این نوع در سیستم‌های دارای پشتیبانی از پایگاه‌داده‌های \fBsdbm\fR موجود است.
.RE
.IP \fIfile_name\fR
نام فایل مبدأ پایگاه‌داده نام مستعار هنگام ایجاد یک پایگاه‌داده.
.SH "عیب‌یابی (DIAGNOSTICS)"
.ad
.fi
مشکلات در جریان خطای استاندارد و در \fBsyslogd\fR(8) یا \fBpostlogd\fR(8) ثبت می‌شوند. نداشتن هیچ خروجی به این معنی است که مشکلی شناسایی نشده است. مدخل‌های تکراری نادیده گرفته شده و با یک هشدار مشخص می‌شوند.

دستور \fBpostalias\fR(1) در صورت موفقیت (از جمله موفقیت در جستجوی «\fBpostalias \-q\fR») با وضعیت خروج صفر خاتمه می‌یابد و در صورت بروز خطا با وضعیت خروج غیرصفر به پایان می‌رسد.
.SH "محیط (ENVIRONMENT)"
.na
.nf
.ad
.fi
.IP \fBMAIL_CONFIG\fR
دایرکتوری حاوی فایل‌های پیکربندی Postfix.
.IP \fBMAIL_VERBOSE\fR
فعال کردن گزارش‌گیری با جزئیات برای مقاصد اشکال‌زدایی.
.SH "پارامترهای پیکربندی (CONFIGURATION PARAMETERS)"
.na
.nf
.ad
.fi
پارامترهای \fBmain.cf\fR زیر به‌طور خاص به این برنامه مربوط می‌شوند.

متن زیر تنها خلاصه‌ای از پارامترها را ارائه می‌دهد. برای جزئیات بیشتر شامل مثال‌ها، به \fBpostconf\fR(5) مراجعه کنید.
.IP "\fBalias_database (see 'postconf -d' output)\fR"
پایگاه‌داده‌های نام مستعار برای تحویل \fBlocal\fR(8) که با «\fBnewaliases\fR» یا «\fBsendmail \-bi\fR» به‌روزرسانی می‌شوند.
.IP "\fBconfig_directory (see 'postconf -d' output)\fR"
مکان پیش‌فرض فایل‌های پیکربندی main.cf و master.cf در Postfix.
.IP "\fBberkeley_db_create_buffer_size (16777216)\fR"
اندازه بافر ورودی/خروجی (I/O) به ازای هر جدول برای برنامه‌هایی که جدول‌های Berkeley DB از نوع hash یا btree ایجاد می‌کنند.
.IP "\fBberkeley_db_read_buffer_size (131072)\fR"
اندازه بافر ورودی/خروجی (I/O) به ازای هر جدول برای برنامه‌هایی که جدول‌های Berkeley DB از نوع hash یا btree را می‌خوانند.
.IP "\fBdefault_database_type (see 'postconf -d' output)\fR"
نوع پیش‌فرض پایگاه‌داده برای استفاده در دستورهای \fBnewaliases\fR(1)، \fBpostalias\fR(1) و \fBpostmap\fR(1).
.IP "\fBimport_environment (see 'postconf -d' output)\fR"
فهرست متغیرهای محیطی که یک فرآیند مجاز Postfix از یک فرآیند والد غیر Postfix وارد می‌کند، یا مقادیر بازنویسی محیط به‌صورت name=value.
.IP "\fBsmtputf8_enable (yes)\fR"
فعال کردن پشتیبانی مقدماتی SMTPUTF8 برای پروتکل‌های شرح داده‌شده در RFC 6531، RFC 6532 و RFC 6533.
.IP "\fBsyslog_facility (mail)\fR"
تسهیلات syslog برای ثبت گزارش‌های Postfix.
.IP "\fBsyslog_name (see 'postconf -d' output)\fR"
پیشوندی که در رکوردهای syslog به نام فرآیند اضافه می‌شود؛ بنابراین، برای مثال «smtpd» تبدیل به «prefix/smtpd» می‌شود.
.PP
موجود در Postfix 2.11 و بالاتر:
.IP "\fBlmdb_map_size (16777216)\fR"
محدودیت اولیه اندازه پایگاه‌داده OpenLDAP LMDB بر حسب بایت.
.SH "استانداردها (STANDARDS)"
.na
.nf
RFC 822 (ARPA Internet Text Messages)
.SH "همچنین ببینید (SEE ALSO)"
.na
.nf
aliases(5)، قالب فایل ورودی پایگاه‌داده نام مستعار.
local(8)، عامل تحویل محلی Postfix.
postconf(1)، نوع‌های پایگاه‌داده پشتیبانی‌شده
postconf(5)، پارامترهای پیکربندی
postmap(1)، ایجاد/به‌روزرسانی/پرس‌وجوی جدول‌های جستجو
newaliases(1)، رابط سازگاری Sendmail.
postlogd(8)، ثبت وقایع Postfix
syslogd(8)، ثبت وقایع سیستم
.SH "فایل‌های راهنما (README FILES)"
.na
.nf
.ad
.fi
از «\fBpostconf readme_directory\fR» یا «\fBpostconf html_directory\fR» برای یافتن محل این اطلاعات استفاده کنید.
.na
.nf
DATABASE_README، نمای کلی جدول جستجوی Postfix
.SH "مجوز (LICENSE)"
.na
.nf
.ad
.fi
مجوز نرم‌افزاری Secure Mailer باید همراه با این نرم‌افزار توزیع شود.
.SH "نویسندگان (AUTHORS)"
.na
.nf
Wietse Venema
IBM T.J. Watson Research
P.O. Box 704
Yorktown Heights, NY 10598, USA

Wietse Venema
Google, Inc.
111 8th Avenue
New York, NY 10011, USA