.\" 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-COMMON" "8" "2026-03-06" "RPM 6.0.1"
.PP
.SH "نام (NAME)"
rpm-common \- عملیات‌ها و گزینه‌های مشترک میان برنامه‌های اجرایی اصلی \fBrpm\fR(8)
.PP
.SH "خلاصه دستور (SYNOPSIS)"
\fIRPMCMD\fR [options] {\fB-?\&\fR|\fB--help\fR}
.PP
\fIRPMCMD\fR [options] \fB--showrc\fR
.PP
\fIRPMCMD\fR [options] \fB--version\fR
.PP
.SH "توضیحات (DESCRIPTION)"
برنامه‌های اجرایی \fIRPMCMD\fR زیر دارای پیکربندی مشترک بوده و گزینه‌ها و عملیات‌های مستندشده در این راهنما میان آن‌ها مشترک است:
.PD 0
.IP \(bu 4
\fBrpm\fR(8)
.IP \(bu 4
\fBrpmdb\fR(8)
.IP \(bu 4
\fBrpmkeys\fR(8)
.IP \(bu 4
\fBrpmbuild\fR(1)
.IP \(bu 4
\fBrpmsign\fR(1)
.IP \(bu 4
\fBrpmspec\fR(1)
.PD
.PP
.SH "عملیات‌ها (OPERATIONS)"
\fB-?\&\fR,
\fB--help\fR
.RS 4
چاپ پیام راهنمای استفاده، طولانی‌تر از حالت عادی.\&
.PP
.RE
\fB--version\fR
.RS 4
چاپ یک خط شامل شماره نگارش \fBrpm\fR در حال استفاده.\&
.PP
.RE
\fB--showrc\fR
.RS 4
تخلیه اطلاعات مربوط به پیکربندی \fBrpm\fR در خروجی استاندارد.\&
.PP
.RE
.SH "گزینه‌ها (OPTIONS)"
\fB--color\fR <\fIMODE\fR>
.RS 4
استفاده از رنگ‌های پایانه برای برجسته‌سازی پیام‌های خطا و اشکال‌زدایی،
که در آن \fIMODE\fR یکی از موارد زیر است:
.PD 0
.IP \(bu 4
\fBalways\fR
.IP \(bu 4
\fBauto\fR (استفاده از خروجی رنگی در پایانه‌ها)
.IP \(bu 4
\fBnever\fR (پیش‌فرض)
.PD
.PP
.RE
\fB--dbpath\fR \fIDIRECTORY\fR
.RS 4
استفاده از پایگاه داده موجود در \fIDIRECTORY\fR به جای مسیر پیش‌فرض
\fI/var/lib/rpm\fR.\&
.PP
.RE
\fB-D\fR '\&\fIMACRO\fR \fIEXPR\fR'\&,
\fB--define\fR='\&\fIMACRO\fR \fIEXPR\fR'\&
.RS 4
تعریف \fIMACRO\fR با مقدار \fIEXPR\fR.\&
.PP
.RE
\fB-E\fR '\&\fIEXPR\fR'\&,
\fB--eval\fR='\&\fIEXPR\fR'\&
.RS 4
چاپ بسط \fBrpm-macros\fR(7) عبارت \fIEXPR\fR.\&
.PP
.RE
\fB--load\fR \fIFILE\fR
.RS 4
بارگذاری یک فایل \fBrpm-macrofile\fR(5) منفرد.\&
.PP
.RE
\fB--macros\fR \fIFILELIST\fR
.RS 4
جایگزین کردن فهرست فایل‌های ماکرو که باید بارگذاری شوند با \fIFILELIST\fR.\&
برای جزئیات به \fBپیکربندی ماکرو (Macro Configuration)\fR مراجعه کنید.\&
.PP
.RE
\fB--nodigest\fR
.RS 4
عدم اعتبارسنجی چکیده (digest) بسته یا سرآیند هنگام خواندن.\&
.PP
.RE
\fB--nohdrchk\fR
.RS 4
عدم اعتبارسنجی سرآیند(های) پایگاه داده هنگام بازیابی.\&
.PP
.RE
\fB--nosignature\fR
.RS 4
عدم اعتبارسنجی امضای بسته یا سرآیند هنگام خواندن.\&
.PP
.RE
\fB--pipe\fR \fICMD\fR
.RS 4
هدایت خروجی \fBrpm\fR به دستور \fICMD\fR از طریق لوله (pipe).\&
.PP
.RE
\fB--predefine\fR='\&\fIMACRO\fR \fIEXPR\fR'\&
.RS 4
تعریف \fIMACRO\fR با مقدار \fIEXPR\fR پیش از بارگذاری فایل‌های ماکرو.\&
این یک سوئیچ بسیار نادر و خاص‌منظوره است، برای نیازهای معمول تعریف ماکرو از \fB--define\fR
استفاده کنید.\&
.PP
.RE
\fB--target\fR \fIPLATFORM\fR
.RS 4
استفاده از پیکربندی \fIPLATFORM\fR به جای تشخیص خودکار.\&
\fIPLATFORM\fR به صورت \fIarch\fR[-\fIos\fR] تشکیل می‌شود.\&
.PP
.RE
\fB--quiet\fR
.RS 4
چاپ کمترین اطلاعات ممکن - به طور معمول فقط پیام‌های خطا نمایش داده خواهند
شد.\&
.PP
.RE
\fB--rcfile\fR \fIFILELIST\fR
.RS 4
جایگزین کردن فهرست پیش‌فرض فایل‌های پیکربندی که باید خوانده شوند با
\fIFILELIST\fR.\& برای جزئیات به \fBپیکربندی rpmrc (rpmrc Configuration)\fR مراجعه کنید.\&
.PP
.RE
\fB--root\fR \fIDIRECTORY\fR
.RS 4
استفاده از درخت فایل‌سیستم با ریشه \fIDIRECTORY\fR برای تمام عملیات‌ها.\&
توجه داشته باشید که این بدان معناست که از پایگاه داده درون \fIDIRECTORY\fR
برای بررسی وابستگی‌ها استفاده خواهد شد و هرگونه اسکریپت‌(هایی) (برای مثال \fB%post\fR هنگام
نصب، یا \fB%prep\fR هنگام ساخت یک بسته) پس از یک \fBchroot\fR(2) به
\fIDIRECTORY\fR اجرا خواهند شد.\&
.PP
توجه داشته باشید که rpm فرض می‌کند محیط داخل دایرکتوری ریشه توسط فراخواننده
آماده‌سازی شده است، مانند هرگونه سوار کردن (mount) مورد نیاز برای عملیات
درون دایرکتوری ریشه.\&
.PP
.RE
\fB--undefine\fR='\&\fIMACRO\fR'\&
.RS 4
لغو تعریف \fIMACRO\fR.\&
.PP
.RE
\fB-v\fR,
\fB--verbose\fR
.RS 4
چاپ اطلاعات با جزئیات (مشروح) - به طور معمول پیام‌های معمول پیشرفت کار نمایش داده خواهند
شد.\& برای افزایش سطح جزئیات، این گزینه را بیش از یک بار وارد کنید، مانند \fB-vv\fR.\&
.PP
.RE
.SH "گزینه‌های اشکال‌زدایی (DEBUG OPTIONS)"
\fB--debug\fR
.RS 4
چاپ اطلاعات فراوان اشکال‌زدایی.\&
.PP
.RE
\fB--fsmdebug\fR
.RS 4
چاپ اطلاعات اشکال‌زدایی درباره مدیریت محموله (payload).\&
.PP
.RE
\fB--rpmiodebug\fR
.RS 4
چاپ اطلاعات اشکال‌زدایی درباره ورودی/خروجی (IO) فایل.\&
.PP
.RE
\fB--stats\fR
.RS 4
چاپ آمارهای زمان اجرا از توابع پرکاربرد.\&
.PP
.RE
.SH "گزینه‌های FTP/HTTP (FTP/HTTP OPTIONS)"
این گزینه‌ها منسوخ شده‌اند.\& برای واکشی داده‌ها از اینترنت از نرم‌افزارهای اختصاصی مانند
\fBcurl\fR(1) یا \fBwget\fR(1) استفاده کنید.\&
.PP
در برخی عملیات‌ها، \fBrpm\fR می‌تواند به عنوان یک کارخواه FTP و/یا HTTP عمل کند تا
بسته‌ها بتوانند از طریق اینترنت پرس‌وجو یا نصب شوند.\& فایل‌های بسته برای
عملیات‌های نصب، ارتقا و پرس‌وجو ممکن است به عنوان یک URL با قالب \fBftp\fR یا \fBhttp\fR
مشخص شوند:
.PP
\fIhttp://HOST[:PORT]/path/to/package.\&rpm\fR
.PP
\fIftp://[USER:PASSWORD]@HOST[:PORT]/path/to/package.\&rpm\fR
.PP
اگر هم نام کاربری و هم گذرواژه حذف شوند، از \fBftp\fR ناشناس (anonymous) استفاده می‌شود.\&
.PP
\fBrpm\fR اجازه می‌دهد تا گزینه‌های زیر با نشانی‌های اینترنتی \fBhttp\fR و \fBftp\fR استفاده شوند:
.PP
\fB--httpproxy\fR \fIHOST\fR
.RS 4
استفاده از \fIHOST\fR به عنوان کارگزار پروکسی برای تمام انتقال‌های \fBhttp\fR و
\fBftp\fR.\& این گزینه همچنین می‌تواند با پیکربندی ماکروی \fB%_httpproxy\fR
مشخص شود.\&
.PP
.RE
\fB--httpport\fR \fIPORT\fR
.RS 4
شماره درگاه (پورت) TCP \fIPORT\fR برای استفاده جهت اتصال \fBhttp\fR روی
کارگزار پروکسی http به جای درگاه پیش‌فرض.\& این گزینه همچنین می‌تواند با
پیکربندی ماکروی \fB%_httpport\fR مشخص شود.\&
.PP
.RE
.SH "محیط (ENVIRONMENT)"
\fBRPM_CONFIGDIR\fR
.RS 4
برای لغو و تغییر پوشه اصلی پیکربندی پیش‌فرض \fBrpm\fR استفاده می‌شود،
که معمولاً \fI/usr/lib/rpm\fR است.\&
.PP
.RE
.SH "وضعیت خروج (EXIT STATUS)"
در صورت موفقیت، مقدار 0 و در غیر این صورت یک کد شکست غیرصفر بازگردانده می‌شود.\&
.PP
.SH "اشکالات (BUGS)"
همه گزینه‌ها در تمام برنامه‌های اجرایی که در آن‌ها نمایش داده می‌شوند معنادار نبوده یا
پیاده‌سازی نشده‌اند.\& به ویژه، \fB--root\fR و گزینه‌های گوناگون مرتبط با اعتبارسنجی
تنها توسط \fBrpm\fR(8) و \fBrpmdb\fR(8) رعایت و اعمال می‌شوند.\&
.PP
.SH "فایل‌ها (FILES)"
.PP
.SS "پایگاه داده (Database)"
.PP
.nf
.RS 4
/var/lib/rpm/
.fi
.RE
.PP
.SS "موقت (Temporary)"
.PP
.nf
.RS 4
/var/tmp/rpm*
.fi
.RE
.PP
.SH "همچنین ببینید (SEE ALSO)"
\fBpopt\fR(3)، \fBrpm\fR(8)، \fBrpm-config\fR(5)، \fBrpm-rpmrc\fR(5)، \fBrpm-macros\fR(7)