.\" Generated by scdoc 1.11.4
.\" Complete documentation for this program is not available as a GNU info page
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.nh
.ad l
.\" Begin generated content:
.TH "RPM-CONFIG" "5" "2026-03-06" "RPM 6.0.1"
.PP
.SH "نام (NAME)"
rpm-config \- پیکربندی ماکروهای زمان اجرای rpm
.PP
.SH "خلاصه دستور (SYNOPSIS)"
\fINAME\fR \fIVALUE\fR
.PP
.SH "فایل‌ها (FILES)"
\fI/usr/lib/rpm/macros\fR
.br
\fI/usr/lib/rpm/macros.\&d/macros.\&*\fR
.br
\fI/usr/lib/rpm/platform/%{_target}/macros\fR
.br
\fI/usr/lib/rpm/fileattrs/*.\&attr\fR
.br
\fI/usr/lib/rpm/<vendor>/macros\fR
.br
\fI/etc/rpm/macros.\&*\fR
.br
\fI/etc/rpm/macros\fR
.br
\fI/etc/rpm/%{_target}/macros\fR
.br
\fI\(ti/.\&config/rpm/macros\fR
.PP
.SH "توضیحات (DESCRIPTION)"
سازوکار اصلی پیکربندی در
.B rpm
صفحه
.BR rpm-macros (7)
است.\& در زمان راه‌اندازی،
.B rpm
مجموعه‌ای از فایل‌های
.BR rpm-macrofile (5)
را که توسط
.I مسیر ماکرو (macro path)
تعیین می‌شوند می‌خواند.\&
.PP
هر فایل یا الگوی
.BR glob (7)
در
.I macro path
(جداشده با دو‌نقطه) به صورت ترتیبی توسط
.B rpm
برای تعاریف ماکرو خوانده می‌شود.\& عبارت
.B %{_target}
به بستر شناسایی‌شده <arch>-<os> گسترش می‌یابد.\& علامت‌های مدک (تکواژ ~) به مقدار متغیر محیطی
.B HOME
بسط داده می‌شوند.\&
.PP
اگر ماکرویی چندین بار تعریف شود، آخرین ورودی اعمال خواهد شد.\&
.I macro path
پیش‌فرض از این سازوکار برای دستیابی به سلسله‌مراتب تنظیمات زیر استفاده می‌کند:
.PD 0
.IP 1. 4
پیش‌فرض‌های عمومی کارخانه‌ای
.B rpm
.IP 2. 4
پیش‌فرض‌های کارخانه‌ای
.B rpm
مخصوص هر بستر (platform)
.IP 3. 4
تنظیمات ویژه توزیع یا سازنده (vendor)
.IP 4. 4
تنظیمات اختصاصی میزبان (host)
.IP 5. 4
تنظیمات اختصاصی کاربر
.IP 6. 4
تنظیمات بازنویسی از خط فرمان
.PD
.PP
مسیر پیش‌فرض
.I macro path
را می‌توان با دستور
.B rpm --showrc|grep \(haMacro
مشاهده کرد.\&
.PP
در نسخه‌های قدیمی‌تر rpm، مسیر ماکروهای هر کاربر
.I \(ti/.\&rpmmacros
بود.\& اگر این فایل وجود داشته باشد و دایرکتوری پیکربندی جدید وجود نداشته باشد، همچنان پردازش می‌شود.\&
.PP
.SH "پیکربندی (CONFIGURATION)"
موارد پیکربندی زیر برای بخش‌های زمان اجرای
.B rpm
(برخلاف بخش‌های صرفاً مربوط به ساخت بسته) پشتیبانی می‌شوند:
.PP
\fB%_color_output\fR \fIMODE\fR
.RS 4
حالت رنگ‌آمیزی خروجی.\& مقادیر معتبر عبارتند از
.B never
و
.BR auto .\&
.PP
.RE
\fB%_db_backend\fR \fIBACKEND\fR
.RS 4
بک‌اند پایگاه داده مورد استفاده.\& مقادیر ممکن برای
.I BACKEND
عبارتند از:
.PD 0
.IP \(bu 4
\fBdummy\fR: بک‌اند ساختگی (بدون عملکرد واقعی)
.IP \(bu 4
\fBbdb_ro\fR: پایگاه داده Berkeley DB (فقط خواندنی)
.IP \(bu 4
\fBndb\fR: پایگاه داده بومی (بدون وابستگی‌های خارجی)
.IP \(bu 4
\fBsqlite\fR: پایگاه داده Sqlite
.PD
.PP
.RE
\fB%_dbpath\fR \fIDIRECTORY\fR
.RS 4
محل فایل(های) پایگاه داده rpm.\&
.PP
.RE
\fB%_excludedocs\fR \fIVALUE\fR
.RS 4
مقدار بولی (یعنی 1 == "yes"، 0 == "no") که تعیین می‌کند آیا فایل‌های علامت‌گذاری‌شده به عنوان %doc باید نصب شوند یا خیر.\&
.PP
.RE
\fB%_flush_io\fR \fIVALUE\fR
.RS 4
تخلیه بافر ورودی/خروجی (flush IO) فایل‌ها حین تراکنش‌ها (با کاهش شدید کارایی برای دیسک‌های چرخشی/مکانیکی).\& مقادیر ممکن 1 برای فعال‌سازی و 0 برای غیرفعال‌سازی هستند.\&
.PP
.RE
\fB%_group_path\fR \fIPATH\fR
.RS 4
محل فایل‌های
.BR group (5)
به صورت فهرستی جداشده با دو‌نقطه (:)
.PP
.RE
\fB%_httpport\fR \fIPORT\fR
.RS 4
پورت پراکسی HTTP (مورد استفاده برای FTP/HTTP).\&
.PP
.RE
\fB%_httpproxy\fR \fIHOSTNAME\fR
.RS 4
نام میزبان پراکسی HTTP (مورد استفاده برای FTP/HTTP).\&
.PP
.RE
\fB%_install_langs\fR \fILOCALES\fR
.RS 4
فهرستی جداشده با دو‌نقطه از زبان‌ها و محلی‌سازی‌های (locales) دلخواه برای نصب؛ مقدار
.B all
به معنای نصب تمام فایل‌های مربوط به تمام محلی‌سازی‌ها است.\&
.PP
.RE
\fB%_install_script_path\fR \fIPATH\fR
.RS 4
مقدار PATH که قبل از اجرای اسکریپت‌های %pre/%post و غیره در متغیرهای محیطی قرار می‌گیرد.\&
.PP
.RE
\fB%_keyring\fR \fIBACKEND\fR
.RS 4
نوع دسته کلید (keyring) مورد استفاده.\& مقادیر ممکن برای
.I BACKEND
عبارتند از:
.PD 0
.IP \(bu 4
\fBfs\fR: فایل‌های متنی اسکی (ASCII) ساده در یک دایرکتوری
.IP \(bu 4
\fBopenpgp\fR: دایرکتوری گواهی مشترک OpenPGP
.IP \(bu 4
\fBrpmdb\fR: بسته‌های ساختگی (pseudo-packages) در پایگاه داده rpmdb
.PD
.PP
.RE
\fB%_keyringpath\fR \fIDIRECTORY\fR
.RS 4
مسیر دسته کلید برای انواع غیر از rpmdb.\&
.PP
.RE
\fB%_minimize_writes\fR \fIVALUE\fR
.RS 4
به حداقل رساندن عملیات نوشتن در طول تراکنش‌ها (به بهای خواندن بیشتر) برای محافظت از دیسک‌های SSD مثلاً (آزمایشی).\& مقادیر ممکن عبارتند از:
.PD 0
.IP \(bu 4
\fB0\fR: غیرفعال
.IP \(bu 4
\fB1\fR: فعال
.IP \(bu 4
\fB-1\fR: (یا تعریف‌نشده) تشخیص خودکار روی بسترهایی که پشتیبانی می‌شوند، در غیر این صورت به طور پیش‌فرض غیرفعال است
.PD
.PP
.RE
\fB%_netsharedpath\fR \fIPATH\fR
.RS 4
فهرستی جداشده با دو‌نقطه از مسیرهایی که فایل‌ها \fBنباید\fR در آن‌ها نصب شوند.\& معمولاً این مسیرها نقاط اتصال سیستم‌فایل‌های شبکه‌ای هستند.\&
.PP
.RE
\fB%_passwd_path\fR \fIPATH\fR
.RS 4
محل فایل‌های
.BR passwd (5)
به صورت فهرستی جداشده با دو‌نقطه (:)
.PP
.RE
\fB%_pkgverify_digests\fR \fIHASHALGOS\fR
.RS 4
فهرستی جداشده با دو‌نقطه از الگوریتم‌های درهم‌سازی برای محاسبه چکیده‌ها (digests) روی کل فایل‌های بسته در طول اعتبارسنجی.\& چکیده‌های محاسبه‌شده در تگ
.B Packagedigests
بسته‌ها در rpmdb، و الگوریتم‌های متناظر در تگ
.B Packagedigestalgos
ذخیره می‌شوند.\& اگر حین نصب بسته از گزینه
.B --noverify
استفاده شود، هیچ چکیده‌ای برای بسته محاسبه یا ذخیره نخواهد شد.\&
.PP
.RE
\fB%_pkgverify_flags\fR \fIVSFLAGS\fR
.RS 4
فلگ‌های اعتبارسنجی بسته در تراکنش، که برای کنترل دقیق عملکرد
.B %_pkgverify_level
استفاده می‌شوند.\& برای سازگاری کامل با بسته‌های نسخه ۴ (v4) روی 0x0 تنظیم کنید.\&
.PP
.RE
\fB%_pkgverify_level\fR \fIMODE\fR
.RS 4
حالت اجباری اعتبارسنجی بسته در تراکنش‌ها، که در آن
.I MODE
یکی از موارد زیر است:
.PD 0
.IP \(bu 4
\fBall\fR: نیازمند چکیده(ها) و امضا(های) معتبر
.IP \(bu 4
\fBsignature\fR: نیازمند امضا(های) معتبر
.IP \(bu 4
\fBdigest\fR: نیازمند چکیده(های) معتبر
.IP \(bu 4
\fBnone\fR: رفتار سنتی rpm، هیچ چیزی الزامی نیست
.PD
.PP
.RE
\fB%_prefer_color\fR \fIVALUE\fR
.RS 4
حل تعارض بسته‌ها در تراکنش‌های دو معماری (bi-arch).\& همچنین ببینید
.BR %_transaction_color .\&
مقادیر ممکن عبارتند از:
.PD 0
.IP \(bu 4
\fB0\fR: غیرفعال
.IP \(bu 4
\fB1\fR: ترجیح بسته‌های ۳۲ بیتی
.IP \(bu 4
\fB2\fR: ترجیح بسته‌های ۶۴ بیتی
.PD
.PP
.RE
\fB%__plugindir\fR \fIDIRECTORY\fR
.RS 4
دایرکتوری افزونه‌های تراکنش.\&
.PP
.RE
\fB%_query_all_fmt\fR \fIFORMAT\fR
.RS 4
قالب خروجی پیش‌فرض برای عملیات جستجوی
.BR rpm (8)،
همان‌طور که در
.BR rpm-queryformat (7)
شرح داده شده است.\& علامت‌های درصد باید اسکیپ شوند، برای نمونه
.BR %%{nevra} .\&
.PP
.RE
\fB%_rpmlock_path\fR \fIFILE\fR
.RS 4
مسیر فایلی که برای قفل fcntl تراکنش استفاده می‌شود.\&
.PP
.RE
\fB%_tmppath\fR \fIPATH\fR
.RS 4
دایرکتوری که فایل‌های موقت در آن ایجاد می‌شوند.\&
.PP
.RE
\fB%__urlhelpercmd\fR \fIEXECUTABLE\fR
.RS 4
فایل اجرایی مورد استفاده برای دریافت فایل‌های راه دور.\&
.PP
.RE
\fB%__urlhelperopts\fR \fIOPTIONS\fR
.RS 4
گزینه‌های عمومی برای ارسال به دستور
.BR %__urlhelpercmd .\&
.PP
.RE
\fB%__urlhelper_localopts\fR \fIOPTIONS\fR
.RS 4
گزینه‌های اختصاصی کاربر/میزبان برای ارسال به دستور
.BR %__urlhelpercmd .\&
.PP
.RE
\fB%__urlhelper_proxyopts\fR \fIOPTIONS\fR
.RS 4
گزینه‌های پراکسی برای ارسال به دستور
.BR %__urlhelpercmd .\&
.PP
.RE
\fB%_urlhelper\fR \fICOMMAND\fR
.RS 4
دستور کامل (همراه با گزینه‌ها) برای استفاده هنگام دریافت فایل‌های راه دور.\& معمولاً از ترکیب ماکروهای با زیرخط دوگانه
.B %__urlhelper*
تشکیل می‌شود.\&
.PP
.RE
\fB%_transaction_color\fR \fIVALUE\fR
.RS 4
رفتار تعارض فایل‌ها و بسته‌ها در تراکنش‌های دو معماری (bi-arch).\& همچنین ببینید
.BR %_prefer_color .\&
مقادیر ممکن عبارتند از:
.PD 0
.IP \(bu 4
\fB0\fR: به «رنگ‌ها» توجه نکن، تنها از نقشه سازگاری معماری استفاده کن
.IP \(bu 4
\fB1\fR: تنها اجازه به بسته‌های ۳۲ بیتی
.IP \(bu 4
\fB2\fR: تنها اجازه به بسته‌های ۶۴ بیتی
.IP \(bu 4
\fB3\fR: اجازه به بسته‌های ۳۲ و ۶۴ بیتی برای اشتراک فایل‌ها
.PD
.PP
.RE
\fB%_vsflags_erase\fR \fIVSFLAGS\fR
.RS 4
فلگ‌های اعتبارسنجی تراکنش هنگام حذف یا به‌روزرسانی بسته‌ها.\&
.PP
.RE
\fB%_vsflags_install\fR \fIVSFLAGS\fR
.RS 4
فلگ‌های اعتبارسنجی تراکنش هنگام نصب بسته‌ها.\&
.PP
.RE
\fB%_vsflags_query\fR \fIVSFLAGS\fR
.RS 4
فلگ‌های اعتبارسنجی تراکنش هنگام پرس‌وجوی بسته‌ها.\&
.PP
.RE
\fB%_vsflags_rebuilddb\fR \fIVSFLAGS\fR
.RS 4
فلگ‌های اعتبارسنجی تراکنش هنگام بازسازی پایگاه داده.\&
.PP
.RE
\fB%_vsflags_verify\fR \fIVSFLAGS\fR
.RS 4
فلگ‌های اعتبارسنجی تراکنش هنگام بازبینی و اعتبارسنجی بسته‌ها.\&
.PP
.RE
.SS "فلگ‌های اعتبارسنجی (Verification flags)"
فلگ‌های اعتبارسنجی چکیده/امضا برای عملیات گوناگون rpm توسط ماسک بیتی موسوم به
.I VSFLAGS
کنترل می‌شوند.\& این فلگ‌ها جنبه‌های گوناگون بررسی مجموع مقابله‌ای و اعتبارسنجی امضای دیجیتال را هنگام خواندن فایل‌های بسته rpm و هدرهای آن‌ها کنترل می‌کنند.\&
.PP
متغیر
.I VSFLAGS
از طریق عملیات OR بیتی میان فلگ‌های تکی تشکیل می‌شود:
.PD 0
.IP \(bu 4
\fB0x00001\fR (RPMVSF_NOHDRCHK): هدرها از rpmdb بررسی نشوند
.IP \(bu 4
\fB0x00100\fR (RPMVSF_NOSHA1HEADER): چکیده SHA1 هدر بررسی نشود
.IP \(bu 4
\fB0x00200\fR (RPMVSF_NOSHA256HEADER): چکیده SHA256 هدر بررسی نشود
.IP \(bu 4
\fB0x00400\fR (RPMVSF_NODSAHEADER): امضا(های) DSA هدر بررسی نشود
.IP \(bu 4
\fB0x00800\fR (RPMVSF_NORSAHEADER): امضا(های) RSA هدر بررسی نشود
.IP \(bu 4
\fB0x01000\fR (RPMVSF_NOOPENPGP): امضا(های) OpenPGP هدر بررسی نشود
.IP \(bu 4
\fB0x02000\fR (RPMVSF_NOSHA3_256HEADER): چکیده SHA3_256 هدر بررسی نشود
.IP \(bu 4
\fB0x04000\fR (RPMVSF_NOSHA512PAYLOAD): چکیده SHA512 بار بسته (payload) بررسی نشود
.IP \(bu 4
\fB0x08000\fR (RPMVSF_NOSHA3_256PAYLOAD): چکیده SHA3_256 بار بسته بررسی نشود
.IP \(bu 4
\fB0x10000\fR (RPMVSF_NOSHA256PAYLOAD): چکیده SHA256 بار بسته بررسی نشود
.IP \(bu 4
\fB0x20000\fR (RPMVSF_NOMD5): چکیده سنتی MD5 هدر+بار بسته بررسی نشود
.IP \(bu 4
\fB0x40000\fR (RPMVSF_NODSA): امضای سنتی DSA هدر+بار بسته بررسی نشود
.IP \(bu 4
\fB0x80000\fR (RPMVSF_NORSA): امضای سنتی RSA هدر+بار بسته بررسی نشود
.PD
.PP
اتصالات پایتون RPM (Python bindings) می‌توانند برای کار با این مقادیر مفید باشند، برای نمونه:
.nf
.RS 4
>>> import rpm
>>> hex(rpm\&.RPMVSF_NOSHA1HEADER)
\&'0x100\&'
>>> hex(rpm\&.RPMVSF_NOSHA1HEADER|rpm\&.RPMVSF_NOMD5)
\&'0x20100\&'
>>>
.fi
.RE
.PP
.SS "الگوریتم‌های درهم‌سازی (Hash algorithms)"
الگوریتم‌های درهم‌سازی زیر (که با
.I HASHALGO
مشخص می‌شوند) برای rpm شناخته‌شده هستند، اما در دسترس بودن آن‌ها بسته به نحوه ساخت rpm و کتابخانه‌های زیربنایی آن ممکن است متفاوت باشد:
.PD 0
.IP \(bu 4
\fB1\fR: MD5 (منسوخ‌شده)
.IP \(bu 4
\fB2\fR: SHA1 (منسوخ‌شده)
.IP \(bu 4
\fB8\fR: SHA256
.IP \(bu 4
\fB9\fR: SHA384
.IP \(bu 4
\fB10\fR: SHA512
.IP \(bu 4
\fB12\fR: SHA3-256
.IP \(bu 4
\fB14\fR: SHA3-512
.PD
.PP
.SH "محیط (ENVIRONMENT)"
اگر متغیر محیطی
.B XDG_CONFIG_HOME
تنظیم شده باشد، جایگزین
.I \(ti/.\&config
در
.I macro path
می‌شود.\&
.PP
.SH "همچنین ببینید (SEE ALSO)"
\fBrpm\fR(8), \fBrpm-common\fR(8), \fBrpm-macrofile\fR(5), \fBrpm-rpmrc\fR(5), \fBrpm-macros\fR(7)