'\" t
.\"     Title: pg_config
.\"    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 "PG_CONFIG" "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)"
pg_config \- دریافت اطلاعات درباره نسخه نصب‌شده PostgreSQL
.SH "خلاصه دستور (SYNOPSIS)"
.HP \w'\fBpg_config\fR\ 'u
\fBpg_config\fR [\fIگزینه\fR...]
.SH "توضیحات (DESCRIPTION)"
.PP
ابزار
pg_config
پارامترهای پیکربندی نسخهٔ فعلی نصب‌شده از
PostgreSQL
را چاپ می‌کند\&. به عنوان مثال، این ابزار برای استفاده توسط بسته‌های نرم‌افزاری که می‌خواهند با
PostgreSQL
تعامل داشته باشند در نظر گرفته شده است تا یافتن فایل‌های سرآیند (header) و کتابخانه‌های مورد نیاز تسهیل شود\&.
.SH "گزینه‌ها (OPTIONS)"
.PP
برای استفاده از
pg_config،
یک یا چند مورد از گزینه‌های زیر را مشخص کنید:
.PP
\fB\-\-bindir\fR
.RS 4
مکان فایل‌های اجرایی کاربر را چاپ می‌کند\&. برای نمونه از این گزینه برای یافتن برنامهٔ
\fBpsql\fR
استفاده کنید\&. این معمولاً همان مکانی است که برنامهٔ
pg_config
نیز در آن قرار دارد\&.
.RE
.PP
\fB\-\-docdir\fR
.RS 4
مکان فایل‌های مستندات را چاپ می‌کند\&.
.RE
.PP
\fB\-\-htmldir\fR
.RS 4
مکان فایل‌های مستندات HTML را چاپ می‌کند\&.
.RE
.PP
\fB\-\-includedir\fR
.RS 4
مکان فایل‌های سرآیند C برای رابط‌های کلاینت را چاپ می‌کند\&.
.RE
.PP
\fB\-\-pkgincludedir\fR
.RS 4
مکان سایر فایل‌های سرآیند C را چاپ می‌کند\&.
.RE
.PP
\fB\-\-includedir\-server\fR
.RS 4
مکان فایل‌های سرآیند C را برای برنامه‌نویسی سمت سرور چاپ می‌کند\&.
.RE
.PP
\fB\-\-libdir\fR
.RS 4
مکان کتابخانه‌های کد شیء (object code) را چاپ می‌کند\&.
.RE
.PP
\fB\-\-pkglibdir\fR
.RS 4
مکان ماژول‌های با بارگذاری پویا، یا محلی که سرور در آن به جستجوی آن‌ها می‌پردازد را چاپ می‌کند\&. (سایر فایل‌های داده وابسته به معماری نیز ممکن است در این دایرکتوری نصب شده باشند\&.)
.RE
.PP
\fB\-\-localedir\fR
.RS 4
مکان فایل‌های پشتیبانی محلی‌سازی (locale) را چاپ می‌کند\&. (اگر هنگام ساخت
PostgreSQL
پشتیبانی از locale پیکربندی نشده باشد، این مقدار یک رشته خالی خواهد بود\&.)
.RE
.PP
\fB\-\-mandir\fR
.RS 4
مکان صفحات راهنما (manual pages) را چاپ می‌کند\&.
.RE
.PP
\fB\-\-sharedir\fR
.RS 4
مکان فایل‌های پشتیبانی مستقل از معماری را چاپ می‌کند\&.
.RE
.PP
\fB\-\-sysconfdir\fR
.RS 4
مکان فایل‌های پیکربندی سراسری سیستم را چاپ می‌کند\&.
.RE
.PP
\fB\-\-pgxs\fR
.RS 4
مکان makefileهای افزونه را چاپ می‌کند\&.
.RE
.PP
\fB\-\-configure\fR
.RS 4
گزینه‌هایی را که هنگام پیکربندی
PostgreSQL
برای ساخت، به اسکریپت
configure
داده شده بودند چاپ می‌کند\&. این گزینه می‌تواند برای بازتولید پیکربندی یکسان، یا فهمیدن اینکه یک بسته باینری با چه گزینه‌هایی ساخته شده است استفاده شود\&. (با این حال توجه داشته باشید که بسته‌های باینری اغلب حاوی وصله‌های سفارشی مخصوص توزیع‌کننده هستند\&.) همچنین مثال‌های زیر را ببینید\&.
.RE
.PP
\fB\-\-cc\fR
.RS 4
مقدار متغیر
\fICC\fR
را که برای ساخت
PostgreSQL
استفاده شده است چاپ می‌کند\&. این گزینه کامپایلر C استفاده‌شده را نشان می‌دهد\&.
.RE
.PP
\fB\-\-cppflags\fR
.RS 4
مقدار متغیر
\fICPPFLAGS\fR
را که برای ساخت
PostgreSQL
استفاده شده است چاپ می‌کند\&. این گزینه سوئیچ‌های کامپایلر C مورد نیاز در زمان پیش‌پردازش (معمولاً سوئیچ‌های
\-I)
را نشان می‌دهد\&.
.RE
.PP
\fB\-\-cflags\fR
.RS 4
مقدار متغیر
\fICFLAGS\fR
را که برای ساخت
PostgreSQL
استفاده شده است چاپ می‌کند\&. این گزینه سوئیچ‌های کامپایلر C را نشان می‌دهد\&.
.RE
.PP
\fB\-\-cflags_sl\fR
.RS 4
مقدار متغیر
\fICFLAGS_SL\fR
را که برای ساخت
PostgreSQL
استفاده شده است چاپ می‌کند\&. این گزینه سوئیچ‌های اضافی کامپایلر C را که برای ساخت کتابخانه‌های اشتراکی استفاده شده‌اند نشان می‌دهد\&.
.RE
.PP
\fB\-\-ldflags\fR
.RS 4
مقدار متغیر
\fILDFLAGS\fR
را که برای ساخت
PostgreSQL
استفاده شده است چاپ می‌کند\&. این گزینه سوئیچ‌های پیونددهنده را نشان می‌دهد\&.
.RE
.PP
\fB\-\-ldflags_ex\fR
.RS 4
مقدار متغیر
\fILDFLAGS_EX\fR
را که برای ساخت
PostgreSQL
استفاده شده است چاپ می‌کند\&. این گزینه سوئیچ‌های پیونددهنده را که فقط برای ساخت فایل‌های اجرایی استفاده شده‌اند نشان می‌دهد\&.
.RE
.PP
\fB\-\-ldflags_sl\fR
.RS 4
مقدار متغیر
\fILDFLAGS_SL\fR
را که برای ساخت
PostgreSQL
استفاده شده است چاپ می‌کند\&. این گزینه سوئیچ‌های پیونددهنده را که فقط برای ساخت کتابخانه‌های اشتراکی استفاده شده‌اند نشان می‌دهد\&.
.RE
.PP
\fB\-\-libs\fR
.RS 4
مقدار متغیر
\fILIBS\fR
را که برای ساخت
PostgreSQL
استفاده شده است چاپ می‌کند\&. این متغیر معمولاً شامل سوئیچ‌های
\-l
برای کتابخانه‌های خارجی پیوندشده به
PostgreSQL
است\&.
.RE
.PP
\fB\-\-version\fR
.RS 4
نسخهٔ
PostgreSQL
را چاپ می‌کند\&.
.RE
.PP
\fB\-?\fR
.br
\fB\-\-help\fR
.RS 4
راهنمایی درباره آرگومان‌های خط فرمان
pg_config
را نمایش داده و خارج می‌شود\&.
.RE
اگر بیش از یک گزینه مشخص شود، اطلاعات به همان ترتیب و در هر سطر یک مورد چاپ می‌شود\&. اگر هیچ گزینه‌ای داده نشود، تمامی اطلاعات موجود به همراه برچسب‌هایشان چاپ می‌شوند\&.
.SH "نکات (NOTES)"
.PP
گزینه‌های
\fB\-\-docdir\fR،
\fB\-\-pkgincludedir\fR،
\fB\-\-localedir\fR،
\fB\-\-mandir\fR،
\fB\-\-sharedir\fR،
\fB\-\-sysconfdir\fR،
\fB\-\-cc\fR،
\fB\-\-cppflags\fR،
\fB\-\-cflags\fR،
\fB\-\-cflags_sl\fR،
\fB\-\-ldflags\fR،
\fB\-\-ldflags_sl\fR
و
\fB\-\-libs\fR
در
PostgreSQL
8\&.1
اضافه شدند\&. گزینه
\fB\-\-htmldir\fR
در
PostgreSQL
8\&.4
اضافه شد\&. گزینه
\fB\-\-ldflags_ex\fR
در
PostgreSQL
9\&.0
اضافه شد\&.
.SH "مثال‌ها (EXAMPLES)"
.PP
برای بازتولید پیکربندی ساختِ نصب فعلی PostgreSQL، دستور زیر را اجرا کنید:
.sp
.if n \{\
.RS 4
.\}
.nf
eval \&./configure `pg_config \-\-configure`
.fi
.if n \{\
.RE
.\}
.sp
خروجی
pg_config \-\-configure
حاوی علامت‌های نقل‌قول شل است تا آرگومان‌های دارای فاصله به درستی مشخص شوند\&. بنابراین، استفاده از
eval
برای دستیابی به نتایج صحیح الزامی است\&.