'\" t
.\"     Title: initdb
.\"    Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net>
.\"      Date: 2026
.\"    Manual: PostgreSQL 18.6 Documentation
.\"    Source: PostgreSQL 18.6
.\"  Language: Persian
.\"
.TH "INITDB" "1" "2026" "PostgreSQL 18.6" "PostgreSQL 18.6 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "نام (NAME)"
initdb \- ایجاد یک کلاستر جدید پایگاه‌داده PostgreSQL
.SH "خلاصه دستور (SYNOPSIS)"
.HP \w'\fBinitdb\fR\ 'u
\fBinitdb\fR [\fIگزینه\fR...] [\fB\-\-pgdata\fR | \fB\-D\fR]\fI دایرکتوری\fR
.SH "توضیحات (DESCRIPTION)"
.PP
دستور
\fBinitdb\fR
یک کلاستر جدید پایگاه‌داده
PostgreSQL
ایجاد می‌کند\&.
.PP
ایجاد یک کلاستر پایگاه‌داده شامل ایجاد دایرکتوری‌هایی است که داده‌های کلاستر در آن‌ها قرار می‌گیرد، تولید جدول‌های کاتالوگ مشترک (جدول‌هایی که به کل کلاستر تعلق دارند و نه به یک پایگاه‌داده خاص)، و ساخت پایگاه‌های داده
postgres،
template1
و
template0
است\&. پایگاه‌داده
postgres
یک پایگاه‌داده پیش‌فرض است که برای استفاده کاربران، ابزارها و برنامه‌های ثالث در نظر گرفته شده است\&. پایگاه‌های داده
template1
و
template0
به عنوان پایگاه‌های داده منبع در نظر گرفته شده‌اند تا توسط دستورات بعدی
\fBCREATE DATABASE\fR
کپی شوند\&. پایگاه‌داده
template0
هرگز نباید تغییر داده شود، اما می‌توانید اشیایی را به
template1
اضافه کنید، که به‌طور پیش‌فرض در پایگاه‌های داده‌ای که بعداً ایجاد می‌شوند کپی خواهند شد\&. برای جزئیات بیشتر به
بخش\ \&22.3
مراجعه کنید\&.
.PP
اگرچه
\fBinitdb\fR
تلاش خواهد کرد تا دایرکتوری داده تعیین‌شده را ایجاد کند، اما اگر دایرکتوری والدِ آن متعلق به کاربر ریشه (root) باشد، ممکن است مجوز لازم را نداشته باشد\&. برای مقداردهی اولیه در چنین ساختاری، ابتدا یک دایرکتوری داده خالی با دسترسی ریشه ایجاد کنید، سپس از
\fBchown\fR
برای واگذاری مالکیت آن دایرکتوری به حساب کاربری پایگاه‌داده استفاده کنید، و در نهایت با
\fBsu\fR
به کاربر پایگاه‌داده تغییر وضعیت داده و
\fBinitdb\fR
را اجرا نمایید\&.
.PP
دستور
\fBinitdb\fR
باید توسط کاربری اجرا شود که مالک فرآیند سرور خواهد بود، زیرا سرور باید به فایل‌ها و دایرکتوری‌هایی که
\fBinitdb\fR
ایجاد می‌کند دسترسی داشته باشد\&. از آنجا که سرور نمی‌تواند با دسترسی ریشه (root) اجرا شود، شما نیز نباید
\fBinitdb\fR
را به عنوان کاربر ریشه اجرا کنید\&. (در واقع برنامه از انجام این کار خودداری خواهد کرد\&.)
.PP
به دلایل امنیتی، کلاستر جدید ایجاد شده توسط
\fBinitdb\fR
به‌طور پیش‌فرض تنها برای مالک کلاستر قابل دسترسی خواهد بود\&. گزینه
\fB\-\-allow\-group\-access\fR
به هر کاربری در همان گروه کاربریِ مالک کلاستر اجازه می‌دهد فایل‌های موجود در کلاستر را بخواند\&. این قابلیت برای گرفتن نسخه پشتیبان توسط یک کاربر غیرممتاز مفید است\&.
.PP
دستور
\fBinitdb\fR
تنظیمات محلی (locale) و کدگذاری مجموعه نویسه‌ها (character set encoding) پیش‌فرض کلاستر پایگاه‌داده را مقداردهی اولیه می‌کند\&. همچنین می‌توان این موارد را هنگام ساخت هر پایگاه‌داده به‌طور جداگانه تعیین کرد\&. دستور
\fBinitdb\fR
این تنظیمات را برای پایگاه‌های داده الگو (template) مشخص می‌کند، که به عنوان پیش‌فرض برای تمامی پایگاه‌های داده دیگر عمل خواهند کرد\&.
.PP
به‌طور پیش‌فرض،
\fBinitdb\fR
از ارائه‌دهنده تنظیمات محلی
libc
استفاده می‌کند (به
بخش\ \&23.1.4
مراجعه کنید)\&. ارائه‌دهنده تنظیمات محلی
libc
این تنظیمات را از محیط سیستم دریافت کرده و کدگذاری را بر اساس تنظیمات محلی تعیین می‌کند\&.
.PP
برای انتخاب یک تنظیم محلی متفاوت برای کلاستر، از گزینه
\fB\-\-locale\fR
استفاده کنید\&. همچنین گزینه‌های مجزای
\fB\-\-lc\-*\fR
و
\fB\-\-icu\-locale\fR
(پایین‌تر را ببینید) برای تعیین مقادیر دسته‌بندی‌های مختلف محلی‌سازی وجود دارند\&. توجه داشته باشید که تنظیمات ناسازگار برای دسته‌بندی‌های مختلف محلی‌سازی می‌تواند نتایج نامفهومی ایجاد کند، بنابراین این گزینه‌ها باید با احتیاط به کار گرفته شوند\&.
.PP
به عنوان روشی جایگزین،
\fBinitdb\fR
می‌تواند با تعیین
\-\-locale\-provider=icu
از کتابخانه ICU برای ارائه خدمات تنظیمات محلی استفاده کند\&. سرور باید همراه با پشتیبانی از ICU ساخته شده باشد\&. برای انتخاب شناسه محلی خاص ICU جهت اعمال، از گزینه
\fB\-\-icu\-locale\fR
استفاده کنید\&. توجه داشته باشید که به دلایل پیاده‌سازی و برای پشتیبانی از کدهای قدیمی،
\fBinitdb\fR
حتی در صورت استفاده از ارائه‌دهنده محلی ICU نیز تنظیمات محلی libc را انتخاب و مقداردهی خواهد کرد\&.
.PP
هنگامی که
\fBinitdb\fR
اجرا می‌شود، تنظیمات محلی انتخاب‌شده را چاپ می‌کند\&. اگر نیازمندی‌های پیچیده‌ای دارید یا گزینه‌های متعددی را تعیین کرده‌اید، توصیه می‌شود بررسی کنید که آیا نتیجه با آنچه مد نظر بوده مطابقت دارد یا خیر\&.
.PP
جزئیات بیشتر درباره تنظیمات محلی را می‌توان در
بخش\ \&23.1
یافت\&.
.PP
برای تغییر کدگذاری پیش‌فرض، از گزینه
\fB\-\-encoding\fR
استفاده کنید\&. جزئیات بیشتر در
بخش\ \&23.3
در دسترس است\&..SH "گزینه‌ها (OPTIONS)"
.PP
.PP
\fB\-A \fR\fB\fIauthmethod\fR\fR
.br
\fB\-\-auth=\fR\fB\fIauthmethod\fR\fR
.RS 4
این گزینه روش احراز هویت پیش‌فرض را برای کاربران محلی مورد استفاده در
pg_hba\&.conf
(خطوط
host
و
local)
مشخص می‌کند\&. برای مشاهده نمایی کلی از مقادیر معتبر به
Section\ \&20.1
مراجعه کنید\&.
.sp
دستور
\fBinitdb\fR
مدخل‌های
pg_hba\&.conf
را با استفاده از روش احراز هویت تعیین‌شده هم برای اتصالات تکثیر (replication) و هم غیرتکثیر از پیش مقداردهی خواهد کرد\&.
.sp
از
trust
استفاده نکنید مگر اینکه به تمام کاربران محلی روی سیستم خود اعتماد داشته باشید\&. گزینه
trust
برای سهولت در نصب، پیش‌فرض است\&.
.RE
.PP
\fB\-\-auth\-host=\fR\fB\fIauthmethod\fR\fR
.RS 4
این گزینه روش احراز هویت را برای کاربران محلی از طریق اتصالات TCP/IP مورد استفاده در
pg_hba\&.conf
(خطوط
host)
مشخص می‌کند\&.
.RE
.PP
\fB\-\-auth\-local=\fR\fB\fIauthmethod\fR\fR
.RS 4
این گزینه روش احراز هویت را برای کاربران محلی از طریق اتصالات سوکت یونیکس (Unix\-domain socket) مورد استفاده در
pg_hba\&.conf
(خطوط
local)
مشخص می‌کند\&.
.RE
.PP
\fB\-D \fR\fB\fIdirectory\fR\fR
.br
\fB\-\-pgdata=\fR\fB\fIdirectory\fR\fR
.RS 4
این گزینه دایرکتوری محل ذخیره‌سازی کلاستر پایگاه‌داده را مشخص می‌کند\&. این تنها اطلاعات مورد نیاز
\fBinitdb\fR
است، اما می‌توانید با تنظیم متغیر محیطی
\fBPGDATA\fR
از نوشتن آن خودداری کنید؛ این کار می‌تواند راحت‌تر باشد زیرا سرور پایگاه‌داده (\fBpostgres\fR) می‌تواند بعداً از طریق همین متغیر، دایرکتوری داده را پیدا کند\&.
.RE
.PP
\fB\-E \fR\fB\fIencoding\fR\fR
.br
\fB\-\-encoding=\fR\fB\fIencoding\fR\fR
.RS 4
کدگذاری پایگاه‌های داده الگو را انتخاب می‌کند\&. این همچنین کدگذاری پیش‌فرض هر پایگاه‌داده‌ای خواهد بود که بعداً ایجاد می‌کنید، مگر اینکه در زمان ساخت آن را تغییر دهید\&. مجموعه‌نویسه‌های پشتیبانی‌شده توسط سرور
PostgreSQL
در
Section\ \&23.3.1
شرح داده شده‌اند\&.
.sp
به طور پیش‌فرض، کدگذاری پایگاه‌داده الگو از لوکال (locale) مشتق می‌شود\&. اگر
\fB\-\-no\-locale\fR
مشخص شده باشد (یا به طور معادل، اگر لوکال
C
یا
POSIX
باشد)، پیش‌فرض برای ارائه‌دهنده ICU برابر با
UTF8
و برای ارائه‌دهنده
libc
برابر با
SQL_ASCII
خواهد بود\&.
.RE
.PP
\fB\-g\fR
.br
\fB\-\-allow\-group\-access\fR
.RS 4
به کاربرانی که در همان گروه مالک کلاستر هستند اجازه می‌دهد تمام فایل‌های کلاستر ایجادشده توسط
\fBinitdb\fR
را بخوانند\&. این گزینه در
Windows
نادیده گرفته می‌شود زیرا از مجوزهای گروهی به سبک POSIX پشتیبانی نمی‌کند\&.
.RE
.PP
\fB\-\-icu\-locale=\fR\fB\fIlocale\fR\fR
.RS 4
در صورت استفاده از ارائه‌دهنده ICU، لوکال ICU را مشخص می‌کند\&. پشتیبانی از لوکال در
Section\ \&23.1
شرح داده شده است\&.
.RE
.PP
\fB\-\-icu\-rules=\fR\fB\fIrules\fR\fR
.RS 4
قواعد تطبیق (collation rules) اضافی را برای سفارشی‌سازی رفتار تطبیق پیش‌فرض مشخص می‌کند\&. این ویژگی تنها برای ICU پشتیبانی می‌شود\&.
.RE
.PP
\fB\-k\fR
.br
\fB\-\-data\-checksums\fR
.RS 4
از چکسام‌ها روی صفحات داده برای کمک به تشخیص خرابی‌های سیستم I/O که در غیر این صورت پنهان می‌مانند، استفاده می‌کند\&. این گزینه به طور پیش‌فرض فعال است؛ از
\fB\-\-no\-data\-checksums\fR
برای غیرفعال کردن چکسام‌ها استفاده کنید\&.
.sp
فعال کردن چکسام‌ها ممکن است جریمه عملکردی اندکی به همراه داشته باشد\&. در صورت تنظیم، چکسام‌ها برای تمام اشیاء، در تمام پایگاه‌های داده محاسبه می‌شوند\&. تمام موارد خرابی چکسام در نمای
pg_stat_database
گزارش خواهند شد\&. برای جزئیات به
Section\ \&28.2
مراجعه کنید\&.
.RE
.PP
\fB\-\-locale=\fR\fB\fIlocale\fR\fR
.RS 4
لوکال پیش‌فرض را برای کلاستر پایگاه‌داده تنظیم می‌کند\&. اگر این گزینه مشخص نشود، لوکال از محیطی که
\fBinitdb\fR
در آن اجرا می‌شود به ارث برده خواهد شد\&. پشتیبانی از لوکال در
Section\ \&23.1
شرح داده شده است\&.
.sp
اگر
\fB\-\-locale\-provider\fR
برابر با
builtin
باشد، گزینه
\fB\-\-locale\fR
یا
\fB\-\-builtin\-locale\fR
باید مشخص شده و روی
C،
C\&.UTF\-8
یا
PG_UNICODE_FAST
تنظیم شود\&.
.RE
.PP
\fB\-\-lc\-collate=\fR\fB\fIlocale\fR\fR
.br
\fB\-\-lc\-ctype=\fR\fB\fIlocale\fR\fR
.br
\fB\-\-lc\-messages=\fR\fB\fIlocale\fR\fR
.br
\fB\-\-lc\-monetary=\fR\fB\fIlocale\fR\fR
.br
\fB\-\-lc\-numeric=\fR\fB\fIlocale\fR\fR
.br
\fB\-\-lc\-time=\fR\fB\fIlocale\fR\fR
.RS 4
مانند
\fB\-\-locale\fR،
اما لوکال را فقط در دسته‌بندی مشخص‌شده تنظیم می‌کند\&.
.RE
.PP
\fB\-\-no\-locale\fR
.RS 4
معادل
\fB\-\-locale=C\fR\&.
.RE
.PP
\fB\-\-builtin\-locale=\fR\fB\fIlocale\fR\fR
.RS 4
در صورت استفاده از ارائه‌دهنده builtin، نام لوکال را مشخص می‌کند\&. پشتیبانی از لوکال در
Section\ \&23.1
شرح داده شده است\&.
.RE
.PP
\fB\-\-locale\-provider={\fR\fBbuiltin\fR\fB|\fR\fBlibc\fR\fB|\fR\fBicu\fR\fB}\fR
.RS 4
این گزینه ارائه‌دهنده لوکال را برای پایگاه‌های داده ایجادشده در کلاستر جدید تعیین می‌کند\&. هنگامی که پایگاه‌های داده جدید بعداً ایجاد شوند، می‌توان این مقدار را در دستور
\fBCREATE DATABASE\fR
لغو و بازنویسی کرد\&. مقدار پیش‌فرض
libc
است (به
Section\ \&23.1.4
مراجعه کنید)\&.
.RE
.PP
\fB\-\-no\-data\-checksums\fR
.RS 4
چکسام‌های داده را فعال نمی‌کند\&.
.RE
.PP
\fB\-\-pwfile=\fR\fB\fIfilename\fR\fR
.RS 4
باعث می‌شود
\fBinitdb\fR
گذرواژه ابرکاربر راه‌انداز (bootstrap superuser) را از یک فایل بخواند\&. اولین خط این فایل به عنوان گذرواژه در نظر گرفته می‌شود\&.
.RE
.PP
\fB\-T \fR\fB\fIconfig\fR\fR
.br
\fB\-\-text\-search\-config=\fR\fB\fIconfig\fR\fR
.RS 4
پیکربندی جستجوی متنی پیش‌فرض را تنظیم می‌کند\&. برای اطلاعات بیشتر به
default_text_search_config
مراجعه کنید\&.
.RE
.PP
\fB\-U \fR\fB\fIusername\fR\fR
.br
\fB\-\-username=\fR\fB\fIusername\fR\fR
.RS 4
نام کاربری ابرکاربر راه‌انداز (bootstrap superuser) را تنظیم می‌کند\&. این مقدار به طور پیش‌فرض نام کاربری کاربر سیستم‌عاملی است که
\fBinitdb\fR
را اجرا می‌کند\&.
.RE.PP
\fB\-W\fR
.br
\fB\-\-pwprompt\fR
.RS 4
باعث می‌شود
\fBinitdb\fR
برای تعیین گذرواژه برای ابرکاربر اولیه (bootstrap superuser) اعلان درخواست نمایش دهد\&. اگر قصد استفاده از احراز هویت با گذرواژه را ندارید، این مورد اهمیتی ندارد\&. در غیر این صورت تا زمانی که گذرواژه‌ای تعیین نکنید، قادر به استفاده از احراز هویت با گذرواژه نخواهید بود\&.
.RE
.PP
\fB\-X \fR\fB\fIdirectory\fR\fR
.br
\fB\-\-waldir=\fR\fB\fIdirectory\fR\fR
.RS 4
این گزینه دایرکتوری محل ذخیره‌سازی لاگ پیش‌نویس (write\-ahead log) را مشخص می‌کند\&.
.RE
.PP
\fB\-\-wal\-segsize=\fR\fB\fIsize\fR\fR
.RS 4
اندازه قطعه (segment) لاگ WAL را بر حسب مگابایت تنظیم می‌کند\&. این مقدار اندازه هر فایل مجزا در لاگ WAL است\&. اندازه پیش‌فرض ۱۶ مگابایت است\&. مقدار باید توانی از ۲ بین ۱ و ۱۰۲۴ (مگابایت) باشد\&. این گزینه تنها در زمان راه‌اندازی اولیه قابل تنظیم است و پس از آن نمی‌توان آن را تغییر داد\&.
.sp
تنظیم این اندازه ممکن است برای کنترل دانه‌بندی (granularity) ارسال یا بایگانی لاگ WAL مفید باشد\&. همچنین در پایگاه‌های داده با حجم بالایی از WAL، تعداد زیاد فایل‌های WAL در هر دایرکتوری می‌تواند به یک معضل کارایی و مدیریتی تبدیل شود\&. افزایش اندازه فایل WAL تعداد فایل‌های WAL را کاهش خواهد داد\&.
.RE
.PP
سایر گزینه‌های کم‌کاربردتر نیز در دسترس هستند:
.PP
\fB\-c \fR\fB\fIname\fR\fR\fB=\fR\fB\fIvalue\fR\fR
.br
\fB\-\-set \fR\fB\fIname\fR\fR\fB=\fR\fB\fIvalue\fR\fR
.RS 4
پارامتر سرور
\fIname\fR
را در طول اجرای
\fBinitdb\fR
به‌اجبار برابر با
\fIvalue\fR
قرار می‌دهد و همچنین این تنظیم را در فایل ایجادشده
postgresql\&.conf
قرار می‌دهد تا در اجراهای آینده سرور اعمال شود\&. این گزینه را می‌توان بیش از یک بار برای تنظیم چندین پارامتر به کار برد\&. این گزینه عمدتاً زمانی مفید است که شرایط محیطی به گونه‌ای باشد که سرور با استفاده از پارامترهای پیش‌فرض اصلاً راه‌اندازی نشود\&.
.RE
.PP
\fB\-d\fR
.br
\fB\-\-debug\fR
.RS 4
خروجی اشکال‌زدایی را از بک‌اند bootstrap و چند پیام دیگر که برای عموم کاربران اهمیت کمتری دارند چاپ می‌کند\&. بک‌اند bootstrap برنامه‌ای است که
\fBinitdb\fR
برای ایجاد جدول‌های کاتالوگ از آن استفاده می‌کند\&. این گزینه حجم عظیمی از خروجی‌های بسیار خسته‌کننده تولید می‌کند\&.
.RE
.PP
\fB\-\-discard\-caches\fR
.RS 4
بک‌اند bootstrap را با گزینه
debug_discard_caches=1
اجرا می‌کند\&. این کار زمان بسیار زیادی می‌برد و تنها برای اشکال‌زدایی عمیق کاربرد دارد\&.
.RE
.PP
\fB\-L \fR\fB\fIdirectory\fR\fR
.RS 4
مشخص می‌کند که
\fBinitdb\fR
باید فایل‌های ورودی خود را برای راه‌اندازی اولیه خوشه پایگاه داده از کجا پیدا کند\&. این کار در حالت عادی ضروری نیست\&. در صورت نیاز به تعیین صریح موقعیت آنها، به شما اطلاع داده خواهد شد\&.
.RE
.PP
\fB\-n\fR
.br
\fB\-\-no\-clean\fR
.RS 4
به‌طور پیش‌فرض، زمانی که
\fBinitdb\fR
تشخیص دهد خطایی مانع از ایجاد کامل خوشه پایگاه داده شده است، هر فایلی را که پیش از پی بردن به عدم امکان اتمام کار ایجاد کرده باشد حذف می‌کند\&. این گزینه مانع از پاک‌سازی می‌شود و بنابراین برای اشکال‌زدایی مفید است\&.
.RE
.PP
\fB\-N\fR
.br
\fB\-\-no\-sync\fR
.RS 4
به‌طور پیش‌فرض،
\fBinitdb\fR
منتظر می‌ماند تا تمام فایل‌ها به‌طور ایمن روی دیسک نوشته شوند\&. این گزینه باعث می‌شود
\fBinitdb\fR
بدون انتظار بازگردد، که سریع‌تر است اما به این معنی است که خرابی (crash) بعدی سیستم‌عامل می‌تواند دایرکتوری داده را خراب (corrupt) باقی بگذارد\&. به‌طور کلی، این گزینه برای آزمایش مفید است اما نباید هنگام ایجاد یک نصب عملیاتی استفاده شود\&.
.RE
.PP
\fB\-\-no\-sync\-data\-files\fR
.RS 4
به‌طور پیش‌فرض،
\fBinitdb\fR
تمام فایل‌های پایگاه داده را با ایمنی روی دیسک می‌نویسد\&. این گزینه به
\fBinitdb\fR
دستور می‌دهد تا از همگام‌سازی تمام فایل‌های موجود در دایرکتوری‌های پایگاه‌های داده مجزا، خود دایرکتوری‌های پایگاه داده، و دایرکتوری‌های tablespace صرف‌نظر کند؛ یعنی همه‌چیز در زیردایرکتوری
base
و هر دایرکتوری tablespace دیگر\&. سایر فایل‌ها، مانند موارد موجود در
pg_wal
و
pg_xact،
همچنان همگام‌سازی خواهند شد مگر اینکه گزینه
\fB\-\-no\-sync\fR
نیز مشخص شده باشد\&.
.sp
توجه داشته باشید که اگر
\fB\-\-no\-sync\-data\-files\fR
همراه با
\fB\-\-sync\-method=syncfs\fR
استفاده شود، برخی یا تمام فایل‌ها و دایرکتوری‌های ذکرشده همگام‌سازی خواهند شد زیرا
syncfs
کل سیستم‌های فایل را پردازش می‌کند\&.
.sp
این گزینه در درجه اول برای استفاده داخلی توسط ابزارهایی در نظر گرفته شده است که جداگانه اطمینان حاصل می‌کنند فایل‌های نادیده‌گرفته‌شده روی دیسک همگام‌سازی شده‌اند\&.
.RE
.PP
\fB\-\-no\-instructions\fR
.RS 4
به‌طور پیش‌فرض،
\fBinitdb\fR
در انتهای خروجی خود دستورالعمل‌هایی را برای نحوه راه‌اندازی خوشه می‌نویسد\&. این گزینه باعث می‌شود آن دستورالعمل‌ها حذف شوند\&. این گزینه در درجه اول برای استفاده ابزارهایی در نظر گرفته شده است که
\fBinitdb\fR
را در عملکردهای مختص به یک پلتفرم خاص می‌پوشانند، جایی که این دستورالعمل‌ها احتمالاً نادرست خواهند بود\&.
.RE
.PP
\fB\-s\fR
.br
\fB\-\-show\fR
.RS 4
تنظیمات داخلی را نمایش می‌دهد و بدون انجام هیچ کار دیگری خارج می‌شود\&. این گزینه می‌تواند برای اشکال‌زدایی نصب
initdb
مورد استفاده قرار گیرد\&.
.RE
.PP
\fB\-\-sync\-method=\fR\fB\fImethod\fR\fR
.RS 4
هنگامی که روی
fsync
تنظیم شود (که حالت پیش‌فرض است)،
\fBinitdb\fR
تمام فایل‌های موجود در دایرکتوری داده را به‌صورت بازگشتی باز کرده و همگام‌سازی می‌کند\&. جستجوی فایل‌ها، پیوندهای نمادین را برای دایرکتوری WAL و هر tablespace پیکربندی‌شده دنبال خواهد کرد\&.
.sp
در Linux، می‌توان به‌جای آن از
syncfs
استفاده کرد تا از سیستم‌عامل خواسته شود کل سیستم‌های فایلی را که شامل دایرکتوری داده، فایل‌های WAL و هر tablespace هستند همگام‌سازی کند\&. برای اطلاعات بیشتر درباره هشدارهایی که باید هنگام استفاده از
syncfs
در نظر داشته باشید، به
recovery_init_sync_method
مراجعه کنید\&.
.sp
این گزینه در صورت استفاده از
\fB\-\-no\-sync\fR
هیچ تأثیری ندارد\&.
.RE
.PP
\fB\-S\fR
.br
\fB\-\-sync\-only\fR
.RS 4
تمام فایل‌های پایگاه داده را به‌طور ایمن روی دیسک نوشته و خارج می‌شود\&. این کار هیچ‌یک از عملیات‌های معمولی
initdb
را انجام نمی‌دهد\&. به‌طور کلی، این گزینه برای اطمینان از بازیابی مطمئن پس از تغییر
fsync
از
off
به
on
مفید است\&.
.RE
.PP
سایر گزینه‌ها:
.PP
\fB\-V\fR
.br
\fB\-\-version\fR
.RS 4
نسخه
initdb
را چاپ کرده و خارج می‌شود\&.
.RE
.PP
\fB\-?\fR
.br
\fB\-\-help\fR
.RS 4
راهنما درباره آرگومان‌های خط فرمان
initdb
را نمایش داده و خارج می‌شود\&.
.RE.SH "محیط (ENVIRONMENT)"
.PP
\fBPGDATA\fR
.RS 4
دایرکتوری محل ذخیره‌سازی کلاستر پایگاه‌داده را مشخص می‌کند؛ این مقدار می‌تواند با استفاده از گزینهٔ
\fB\-D\fR
بازنویسی شود\&.
.RE
.PP
\fBPG_COLOR\fR
.RS 4
مشخص می‌کند که آیا در پیام‌های عیب‌یابی از رنگ استفاده شود یا خیر\&. مقادیر ممکن عبارتند از
always،
auto
و
never\&.
.RE
.PP
\fBTZ\fR
.RS 4
منطقه زمانی پیش‌فرض کلاستر پایگاه‌دادهٔ ایجادشده را مشخص می‌کند\&. این مقدار باید نام کامل یک منطقه زمانی باشد (ببینید
بخش\ \&8.5.3)\&.
.RE
.SH "نکات (NOTES)"
.PP
\fBinitdb\fR
را می‌توان از طریق
\fBpg_ctl initdb\fR
نیز فراخوانی کرد\&.
.SH "همچنین ببینید (SEE ALSO)"
\fBpg_ctl\fR(1)، \fBpostgres\fR(1)، بخش\ \&20.1