'\" t .\" Title: mkinitcpio .\" Author: [بخش "نویسندگان (AUTHORS)" را ببینید] .\" Generator: Asciidoctor 2.0.26 .\" Date: 2026-08-11 .\" Manual: mkinitcpio manual .\" Source: mkinitcpio 41.1 .\" Language: Persian .\" .TH "MKINITCPIO" "8" "2026-08-11" "mkinitcpio 41.1" "راهنمای mkinitcpio" .ie \n(.g .ds Aq \(aq .el .ds Aq ' .ss \n[.ss] 0 .nh .ad l .de URL \fI\\$2\fP <\\$1>\\$3 .. .als MTO URL .if \n[.g] \{\ . mso www.tmac . am URL . ad l . . . am MTO . ad l . . . LINKSTYLE blue R < > .\} .SH "نام (NAME)" mkinitcpio \- ایجاد محیط دیسک رم اولیه (ramdisk) .SH "خلاصه دستور (SYNOPSIS)" .sp \fImkinitcpio\fP [options] .SH "توضیحات (DESCRIPTION)" .sp یک محیط دیسک رم اولیه (initial ramdisk) برای راه‌اندازی هسته لینوکس ایجاد می‌کند. دیسک رم اولیه در اصل یک محیط بسیار کوچک (فضای کاربری اولیه یا early userspace) است که ماژول‌های مختلف هسته را بارگذاری کرده و پیش از واگذاری کنترل به init، موارد لازم را تنظیم می‌کند. این امر امکان داشتن مواردی مانند سیستم‌های فایل ریشه رمزنگاری‌شده و سیستم‌های فایل ریشه روی آرایه RAID نرم‌افزاری را فراهم می‌سازد. mkinitcpio امکان توسعه آسان با قلاب‌های سفارشی را فراهم می‌کند، قابلیت تشخیص خودکار در زمان اجرا دارد، و ویژگی‌های متعدد دیگری را ارائه می‌دهد. .SH "گزینه‌ها (OPTIONS)" .sp \fB\-A\fP, \fB\-\-addhooks\fP \fIhooks\fP .RS 4 افزودن \fIhooks\fP (قلاب‌های) اضافی به تصویر. این قلاب‌ها پس از تمام قلاب‌های دیگرِ فایل پیکربندی، به ترتیب پردازش خواهند شد. قلاب‌های متعدد باید با کاما جدا شوند. این گزینه می‌تواند چندین بار مشخص شود. .RE .sp \fB\-c\fP, \fB\-\-config\fP \fIconfig\fP .RS 4 استفاده از فایل \fIconfig\fP برای تولید دیسک رم. پیش‌فرض: \fI/etc/mkinitcpio.conf\fP. در صورت مشخص شدن، فایل‌های تکمیلی (drop-in) در \fI/etc/mkinitcpio.conf.d\fP نادیده گرفته خواهند شد. .RE .sp \fB\-d\fP, \fB\-\-generatedir\fP \fIdirectory\fP .RS 4 تنظیم \fIdirectory\fP به عنوان مکانی که initramfs در آن ساخته می‌شود. این گزینه ممکن است برای تولید یک ramfs خاموش‌سازی در \fI/run/initramfs/\fP مفید باشد. .RE .sp \fB\-D\fP, \fB\-\-hookdir\fP \fIdirectory\fP .RS 4 تنظیم \fIdirectory\fP به عنوان مکانی که هنگام تولید تصویر، قلاب‌ها در آن جستجو خواهند شد. .RE .sp \fB\-I\fP, \fB\-\-include\fP \fIpath\fP .RS 4 افزودن \fIfiles\fP یا \fIdirectories\fP اضافی به تصویر. این موارد پس از گنجانده شدن تمامی فایل‌های دیگر در تصویر، به ترتیب پردازش خواهند شد. .br اگر مسیر یک فایل باشد، می‌توانید مبدأ و مقصد در تصویر را با کاما جدا کنید. مثال: \fIsource:destination:mode\fP. .br اگر مسیر یک دایرکتوری باشد، تنها کل دایرکتوری را می‌پذیرد و دایرکتوری را از ریشه تصویر می‌گنجاند. .br مسیرهای متعدد باید با کاما جدا شوند. این گزینه می‌تواند چندین بار مشخص شود. .RE .sp \fB\-g\fP, \fB\-\-generate\fP \fIfilename\fP .RS 4 تولید یک تصویر CPIO با نام \fIfilename\fP. پیش‌فرض: no؛ این بدان معناست که هیچ چیزی در سیستم فایل نوشته نخواهد شد مگر اینکه این گزینه مشخص شود. .RE .sp \fB\-H\fP, \fB\-\-hookhelp\fP \fIhookname\fP .RS 4 نمایش راهنما برای نام قلاب \fIhookname\fP. .RE .sp \fB\-h\fP, \fB\-\-help\fP .RS 4 نمایش یک نمای کلی کوتاه از سوئیچ‌های خط فرمان موجود. .RE .sp \fB\-k\fP, \fB\-\-kernel\fP \fIkernelversion\fP .RS 4 استفاده از \fIkernelversion\fP به جای هسته در حال اجرای فعلی. این می‌تواند مسیری به یک تصویر هسته (تنها برای معماری‌های مبتنی بر x86 پشتیبانی می‌شود)، یک نسخه خاص هسته یا کلیدواژه ویژه \fInone\fP باشد. در حالت اخیر، هیچ ماژول هسته‌ای به تصویر افزوده نمی‌شود. .RE .sp \fB\-L\fP, \fB\-\-listhooks\fP .RS 4 فهرست کردن تمامی قلاب‌های موجود. .RE .sp \fB\-M\fP, \fB\-\-automods\fP .RS 4 نمایش ماژول‌های یافت‌شده از طریق تشخیص خودکار. mkinitcpio به طور خودکار تلاش خواهد کرد تعیین کند کدام ماژول‌های هسته برای راه‌اندازی رایانه شما مورد نیاز هستند. این گزینه ماژول‌های شناسایی‌شده را فهرست می‌کند. .RE .sp \fB\-n\fP, \fB\-\-nocolor\fP .RS 4 غیرفعال کردن خروجی رنگی. .RE .sp \fB\-\-nopost\fP .RS 4 عدم اجرای قلاب‌های پسین (post hooks). .RE .sp \fB\-U\fP, \fB\-\-uki\fP \fIfilename\fP .RS 4 تولید یک تصویر هسته یکپارچه (unified kernel image) با نام \fIfilename\fP. اگر یک تصویر CPIO با موفقیت ساخته شود، برای تولید تصویر هسته یکپارچه جهت راه‌اندازی با UEFI استفاده خواهد شد. این کار initramfs، هسته و cmdline هسته را در یک فایل اجرایی واحد ترکیب می‌کند. این قابلیت برای یکپارچگی زنجیره راه‌اندازی در شرایطی که فایل امضا می‌شود مفید است. پیش‌فرض: no. برای فهرستی از گزینه‌های مرتبط، بخش \fIگزینه‌های تصویر هسته یکپارچه\fP در زیر را ببینید. .RE .sp \fB\-P\fP, \fB\-\-allpresets\fP .RS 4 پردازش تمام پیش‌تنظیم‌های موجود در \fI/etc/mkinitcpio.d\fP. برای جزئیات بیشتر درباره پیش‌تنظیم‌ها، گزینه \fB\-p\fP را ببینید. .RE .sp \fB\-p\fP, \fB\-\-preset\fP \fIpreset\fP .RS 4 ساخت تصویر(های) initramfs بر اساس \fIpreset\fP مشخص‌شده. این می‌تواند فایلی در \fI/etc/mkinitcpio.d\fP (بدون پسوند .preset) یا یک مسیر کامل و مطلق به یک فایل باشد. این گزینه می‌تواند چندین بار برای پردازش چندین پیش‌تنظیم مشخص شود. .RE .sp \fB\-R\fP, \fB\-\-remove\fP .RS 4 حذف تصویر(های) initramfs تولیدشده توسط پیش‌تنظیم(های) مشخص‌شده. اگر در ترکیب با \fB\-P\fP|\fB\-\-allpresets\fP استفاده شود، تصاویر مربوط به تمام پیش‌تنظیم‌ها را حذف می‌کند. این گزینه تنها همراه با \fB\-p\fP|\fB\-\-presets\fP یا \fB\-P\fP|\fB\-\-allpresets\fP قابل استفاده است. .RE .sp \fB\-r\fP, \fB\-\-moduleroot\fP \fIroot\fP .RS 4 دایرکتوری ریشه را برای یافتن ماژول‌ها تعیین می‌کند، مقدار پیش‌فرض \fI/\fP است. .RE .sp \fB\-S\fP, \fB\-\-skiphooks\fP \fIhooks\fP .RS 4 نادیده گرفتن \fIhooks\fP (قلاب‌ها) هنگام تولید تصویر. قلاب‌های متعدد باید با کاما جدا شوند. این گزینه می‌تواند چندین بار مشخص شود. .RE .sp \fB\-s\fP, \fB\-\-save\fP .RS 4 ذخیره دایرکتوری ساخت برای دیسک رم اولیه. پیش‌فرض: no؛ این بدان معناست که در صورت مشخص نشدن این گزینه، دایرکتوری حفظ نخواهد شد. برای اهداف اشکال‌زدایی مفید است. .RE .sp \fB\-t\fP, \fB\-\-builddir\fP \fItmpdir\fP .RS 4 استفاده از \fItmpdir\fP به عنوان دایرکتوری ساخت موقت به جای \fI/tmp\fP. \fItmpdir\fP باید وجود داشته باشد. متغیر محیطی \fITMPDIR\fP نیز برای تنظیم این مکان مد نظر قرار می‌گیرد، اما گزینه خط فرمان اولویت خواهد داشت. .RE .sp \fB\-V\fP, \fB\-\-version\fP .RS 4 نمایش اطلاعات نسخه. .RE .sp \fB\-v\fP, \fB\-\-verbose\fP .RS 4 خروجی پرگو (با جزئیات). اطلاعات بیشتری درباره آنچه در طول ایجاد دیسک رم رخ می‌دهد ارائه می‌دهد. .RE .sp \fB\-z\fP, \fB\-\-compress\fP \fIcompress\fP .RS 4 جایگزینی روش فشرده‌سازی با برنامه \fIcompress\fP. .RE .SH "گزینه‌های تصویر هسته یکپارچه (OPTIONS FOR UNIFIED KERNEL IMAGE)" .sp \fB\-\-cmdline\fP \fIfilename\fP .RS 4 استفاده از خط فرمان هسته با تصویر هسته یکپارچه. اگر یک دایرکتوری داده شود، تمام فایل‌های منطبق با \fI*.conf\fP در آن دایرکتوری استفاده می‌شوند. اگر هیچ موردی مشخص نشود، یکی از فایل‌های \fI/etc/kernel/cmdline\fP، \fI/usr/lib/kernel/cmdline\fP، \fI/etc/cmdline.d/*.conf\fP یا \fI/proc/cmdline\fP امتحان می‌شود. .RE .sp \fB\-\-no\-cmdline\fP .RS 4 صرف‌نظر کردن از جاسازی رشته خط فرمان هسته در تصویر هسته یکپارچه. گزینه‌های خط فرمان هسته باید از طریق خط فرمان هسته منتقل شوند. بر گزینه \fB\-\-cmdline\fP تقدم دارد. .RE .sp \fB\-\-splash\fP \fIfilename\fP .RS 4 فایل‌های اجرایی UEFI می‌توانند در زمان راه‌اندازی یک فایل نقشه‌بیتی (bitmap) را نمایش دهند. .RE .sp \fB\-\-uefistub\fP \fIfilename\fP .RS 4 تصویر UEFI stub مورد استفاده برای تولید تصویر هسته یکپارچه. در صورت استفاده از \fIukify\fP هیچ تأثیری ندارد. پیش‌فرض: تلاش برای یافتن بارگذار stub مربوط به systemd\-boot یا gummiboot. .RE .sp \fB\-\-ukiconfig\fP \fIfilename\fP .RS 4 فایل پیکربندی برای ارسال به \fIukify\fP. اگر هیچ موردی مشخص نشود، یکی از فایل‌های \fI/etc/kernel/uki.conf\fP یا \fI/usr/lib/kernel/uki.conf\fP امتحان می‌شود. اگر هیچ‌یک از آن‌ها وجود نداشته باشد، \fIukify\fP از پیش‌فرض داخلی خود استفاده خواهد کرد. .RE .sp \fB\-\-no\-ukify\fP .RS 4 عدم استفاده از \fIukify\fP برای ساخت UKIها حتی در صورت در دسترس بودن. این کار توصیه نمی‌شود. .RE .sp \fB\-\-kernelimage\fP \fIfilename\fP .RS 4 گنجاندن یک تصویر هسته برای تصویر هسته یکپارچه. پیش‌فرض: یکی از مسیرهای \fI/lib/modules/${KERNELVERSION}/vmlinuz\fP، \fI/lib/modules/${KERNELVERSION}/vmlinux\fP، \fI/boot/vmlinuz\-${KERNELVERSION}\fP، \fI/boot/vmlinux\-${KERNELVERSION}\fP، \fI/boot/vmlinuz\-linux\fP یا \fI/boot/vmlinux\-linux\fP. .RE .sp \fB\-\-osrelease\fP \fIfilename\fP .RS 4 گنجاندن یک فایل os\-release برای تصویر هسته یکپارچه. پیش‌فرض: \fI/etc/os\-release\fP یا \fI/usr/lib/os\-release\fP. .RE .SH "درباره پیش‌تنظیم‌ها (ABOUT PRESETS)" .sp یک پیش‌تنظیم (preset)، تعریفی از پیش تعیین‌شده در مورد نحوه ایجاد دیسک رم اولیه است. به جای مشخص کردن فایل پیکربندی و فایل خروجی در هر بار تولید یک دیسک رم اولیه جدید، شما یک پیش‌تنظیم تعریف می‌کنید و از سوئیچ \fB\-p\fP برای تولید دیسک رم اولیه بر اساس پیش‌تنظیم خود استفاده می‌نمایید. .sp به طور معمول، پیش‌تنظیم‌ها فایل‌هایی با پسوند \fI.preset\fP هستند که در \fI/etc/mkinitcpio.d\fP قرار دارند، برای مثال \fI/etc/mkinitcpio.d/linux.preset\fP برای پیش‌تنظیم \fBlinux\fP. همچنین امکان استفاده از فایل‌ها در مکان‌های دیگر نیز وجود دارد؛ در این حالت باید مسیر فایل مشخص شود. .sp فایل‌های پیش‌تنظیم اسکریپت‌های شل هستند که توسط mkinitcpio بارگذاری (source) می‌شوند و متغیرهای زیر بر رفتار آن تأثیر می‌گذارند. .sp توجه داشته باشید که mkinitcpio خود را برای هر پیش‌تنظیم فراخوانی می‌کند و گزینه‌های تعریف‌شده در فایل پیش‌تنظیم را از طریق آرگومان‌های خط فرمان ارسال می‌نماید. این موارد در توضیحات گزینه‌های زیر ذکر شده‌اند، بنابراین برای اطلاعات بیشتر در مورد یک گزینه خاص، به راهنمای آرگومان‌های خط فرمان مراجعه کنید. .sp \fBPRESETS\fP .RS 4 آرایه‌ای از نام‌های پیش‌تنظیم تعریف‌شده در این فایل. این نام‌ها به عنوان پیشوند سایر گزینه‌ها استفاده خواهند شد تا گزینه‌های مخصوص هر پیش‌تنظیم را فراهم کنند. برای مثال، اگر \fIPRESET=(\*(Aqcustom\*(Aq)\fP مشخص شود، تصویر از طریق \fIcustom_image=\*(Aq/boot/custom.img\*(Aq\fP تعیین می‌گردد. .RE .sp \fB_kver\fP (پیش‌فرض مقدار \fBALL_kver\fP است \(em یکی از این دو \fBالزامی\fP است) .RS 4 تعیین نسخه هسته (از طریق \fB\-k\fP در mkinitcpio). .RE .sp \fB_config\fP (پیش‌فرض مقدار \fBALL_config\fP است \(em یکی از این دو \fBالزامی\fP است) .RS 4 مسیر فایل پیکربندی (ارسال‌شده از طریق \fB\-c\fP به mkinitcpio). .RE .sp \fB_uki\fP (یکی از دو مورد \fB_uki\fP و \fB_image\fP \fBالزامی\fP است) .RS 4 مسیر فایل خروجی برای تصویر هسته یکپارچه (ارسال‌شده از طریق \fB\-U\fP به mkinitcpio). .RE .sp \fB_image\fP (یکی از دو مورد \fB_uki\fP و \fB_image\fP \fBالزامی\fP است) .RS 4 مسیر فایل خروجی برای تصویر تولیدشده (ارسال‌شده از طریق \fB\-g\fP به mkinitcpio). .RE .sp \fB_cmdline\fP (پیش‌فرض مقدار \fBALL_cmdline\fP است) .RS 4 مسیر فایل خط فرمان هسته (ارسال‌شده از طریق \fB\-\-cmdline\fP به mkinitcpio). این گزینه تنها هنگام تولید تصاویر هسته یکپارچه استفاده می‌شود. .RE .sp \fB_splash\fP (پیش‌فرض مقدار \fBALL_splash\fP است) .RS 4 مسیر فایل تصویر اسپلش (ارسال‌شده از طریق \fB\-\-splash\fP به mkinitcpio). این گزینه تنها هنگام تولید تصاویر هسته یکپارچه استفاده می‌شود. .RE .sp \fB_kerneldest\fP (پیش‌فرض مقدار \fBALL_kerneldest\fP است) .RS 4 مسیر مقصد هسته که به قلاب‌های پسین ارسال خواهد شد. این گزینه مکان پیش‌فرض هسته (معمولاً /boot) را بازنویسی می‌کند و اجازه می‌دهد مکان قرارگیری هسته برای راه‌اندازی سفارشی‌سازی شود. این مقدار از طریق متغیر محیطی KERNELDESTINATION به قلاب‌های پسین ارسال می‌شود. .RE .sp \fB_options\fP .RS 4 آرگومان‌های خط فرمان بیشتر برای ارسال به mkinitcpio به صورت یک رشته یا آرایه. آن‌ها در انتهای فراخوانی mkinitcpio (پس از تمامی گزینه‌های ذکرشده در بالا) افزوده می‌شوند، بنابراین می‌توان از این مورد برای بازنویسی گزینه‌ها استفاده کرد (برای مثال ارسال \fB\-S\fP \fIhook\fP در اینجا برای نادیده گرفتن یک قلاب). .RE .SH "درباره قلاب‌های نصب (ABOUT INSTALL HOOKS)" .sp قلاب‌های نصب اسکریپت‌های bash هستند که در زمان اجرای mkinitcpio بارگذاری (source) می‌شوند تا ماژول‌ها، باینری‌ها و فایل‌های دیگر را به تصویر اضافه کنند. توابع مختلفی برای تسهیل این کار وجود دارند. .sp \fBadd_module\fP \fImodname\fP .RS 4 ماژول مشخص‌شده توسط \fImodname\fP را به تصویر اضافه می‌کند. وابستگی‌ها به طور خودکار استخراج شده و افزوده می‌شوند. .RE .sp \fBadd_binary\fP \fIbinary\fP [ \fIdestination\fP ] [ \fImode\fP ] .RS 4 یک فایل باینری را به تصویر اضافه می‌کند. آرگومان \fIbinary\fP نیازی نیست مسیری مطلق باشد و در صورت نیاز، جستجو انجام خواهد شد. اگر باینری یک فایل ELF پیوندیافته پویا باشد، وابستگی‌ها به طور خودکار افزوده می‌شوند. اگر یک پیوند نمادین باشد، هم پیوند نمادین و هم باینری هدف اضافه خواهند شد. به صورت اختیاری، مقصدی درون تصویر initramfs و همچنین حالت دسترسی فایل (mode) می‌تواند مشخص شود. به طور پیش‌فرض، مقصد و حالت دسترسی از مبدأ مشتق‌شده از \fIbinary\fP گرفته می‌شوند. .RE .sp \fBadd_file\fP \fIpath\fP [ \fIdestination\fP ] [ \fImode\fP ] .RS 4 یک فایل و هر دایرکتوری والد مورد نیاز را به تصویر اضافه می‌کند. اگر یک پیوند نمادین باشد، هم پیوند نمادین و هم فایل هدف اضافه خواهند شد. به صورت اختیاری، مقصدی درون تصویر initramfs و همچنین حالت دسترسی فایل می‌تواند مشخص شود. به طور پیش‌فرض، مقصد و حالت دسترسی از مبدأ و حالت دسترسی فایل مشخص‌شده با \fIpath\fP گرفته می‌شوند. .RE .sp \fBadd_file_early\fP \fIpath\fP [ \fIdestination\fP ] [ \fImode\fP ] .RS 4 یک فایل و هر دایرکتوری والد مورد نیاز را به تصویر فشرده‌نشده اولیه اضافه می‌کند. به همان شیوه \fBadd_file\fP عمل می‌کند. .RE .sp \fBadd_dir\fP \fIpath\fP .RS 4 یک دایرکتوری و والدین آن را به تصویر اضافه می‌کند. .RE .sp \fBadd_dir_early\fP \fIpath\fP .RS 4 یک دایرکتوری و والدین آن را به تصویر فشرده‌نشده اولیه اضافه می‌کند. به همان شیوه \fBadd_dir\fP عمل می‌کند. .RE .sp \fBadd_full_dir\fP \fIdirectory\fP [ \fIglob\fP ] [ \fIstrip_prefix\fP ] .RS 4 با پیمایش مسیر داده‌شده و فراخوانی متناظر \fBadd_file\fP، \fBadd_dir\fP و \fBadd_symlink\fP، یک دایرکتوری را به صورت بازگشتی به تصویر اضافه می‌کند. این تابع از پیوندهای نمادین پیروی نمی‌کند و هدف‌های پیوندهای نمادین را نیز اضافه نمی‌کند. .br اگر آرگومان \fIglob\fP ارسال شود، تنها فایل‌ها و پیوندهای نمادین منطبق بر این الگو اضافه خواهند شد. .br اگر آرگومان \fIstrip_prefix\fP ارسال شود، برای حذف پیشوند مشخص‌شده توسط آرگومان \fIstrip_prefix\fP از مسیر مقصد (مسیر درون تصویر initramfs) استفاده خواهد شد. این قابلیت هنگام نوشتن قلاب‌های rootfs-overlay می‌تواند مفید باشد. .RE .sp \fBadd_symlink\fP \fIpath\fP [ \fIlink\-target\fP ] .RS 4 یک پیوند نمادین را در مسیر مشخص‌شده \fIpath\fP به تصویر اضافه می‌کند که می‌تواند به صورت اختیاری به \fIlink\-target\fP مشخص‌شده اشاره کند. اگر \fIlink\-target\fP ارائه نشود، فرض می‌شود که این پیوند نمادین در سیستم فایل واقعی وجود دارد و هدف با استفاده از \fBreadlink\fP(1) خوانده خواهد شد. هیچ بررسی برای اطمینان از وجود هدف پیوند نمادین انجام نمی‌شود و پیوندهای نمادین به صورت بازگشتی دنبال نخواهند شد. .RE .sp \fBadd_all_modules\fP [ \fB\-f\fP \fIfilter\fP ] \fIpattern\fP .RS 4 ماژول‌ها را بدون در نظر گرفتن لیست سفید تشخیص خودکار (autodetect) به تصویر اضافه می‌کند. \fIpattern\fP باید یک زیردایرکتوری در درخت هسته باشد که زیرمجموعه‌ای از ماژول‌های قابل گنجاندن را توصیف می‌کند. پالایش بیشتر می‌تواند از طریق پرچم \fB\-f\fP همراه با یک عبارت باقاعده گسترش‌یافته ارائه شود. .RE .sp \fBadd_checked_modules\fP [ \fB\-f\fP \fIfilter\fP ] \fIpattern\fP .RS 4 مشابه \fBadd_all_modules\fP با این محدودیت که تنها ماژول‌های منطبق بر لیست سفید ایجادشده توسط قلاب autodetect به تصویر اضافه خواهند شد. اگر قلاب autodetect در تصویر وجود نداشته باشد، این تابع با \fBadd_all_modules\fP یکسان است. .RE .sp \fBadd_runscript\fP \fIscriptname\fP .RS 4 یک قلاب زمان اجرا را به تصویر اضافه می‌کند که یک اسکریپت شل سازگار با busybox ash است. تضمین می‌شود که نام اسکریپت با نام قلابی که اسکریپت از آن فراخوانی شده است، مطابقت داشته باشد. .RE .sp \fBadd_udev_rule\fP \fIrule\-file\fP .RS 4 یک قانون udev را به تصویر اضافه می‌کند. وابستگی‌ها به فایل‌های باینری کشف شده و افزوده خواهند شد. آرگومان می‌تواند نام یک فایل قانون (کشف‌شده از مسیرهای شناخته‌شده udev) یا یک مسیر مطلق باشد. .RE .sp \fBadd_all_modules_from_symbol\fP \fIsymbol\fP \fIpaths\fP .RS 4 ماژول‌های موجود در دایرکتوری‌های \fIpaths\fP را که حاوی \fIsymbol\fP هستند به تصویر اضافه می‌کند. .RE .sp \fBadd_checked_modules_from_symbol\fP \fIsymbol\fP \fIpaths\fP .RS 4 مشابه \fBadd_all_modules_from_symbol\fP با این محدودیت که تنها ماژول‌های منطبق بر لیست سفید ایجادشده توسط قلاب autodetect به تصویر افزوده خواهند شد. اگر قلاب autodetect در تصویر حاضر نباشد، این تابع با \fBadd_all_modules_from_symbol\fP یکسان است. .RE .sp \fBadd_initcpio_binary\fP \fIbinary\fP [ \fIdestination\fP ] [ \fImode\fP ] .RS 4 مشابه \fBadd_binary\fP است با این تفاوت که برای یافتن باینری جهت گنجاندن در تصویر، مسیر \fI/usr/lib/initcpio\fP را جستجو می‌کند. این مورد برای قلاب‌هایی مفید است که بدون نیاز به مسیرنویسی ثابت (hardcoding)، فایل‌هایی درون آن دایرکتوری دارند. .RE .SH "درباره CPIO اولیه (ABOUT EARLY CPIO)" .sp دستور mkinitcpio از CPIO اولیه (early CPIO) پشتیبانی می‌کند. این‌ها آرشیوهای CPIO فشرده‌نشده‌ای هستند که پیش از آرشیو اصلی CPIO فشرده‌شده قرار می‌گیرند. آن‌ها برای بارگذاری زودهنگام ریزکد پردازنده یا بارگذاری بازنویسی‌های جداول ACPI استفاده می‌شوند. .sp قلاب‌های نصب می‌توانند با افزودن فایل‌ها به \fI$EARLYROOT\fP، آن‌ها را در این آرشیو نصب کنند. .SH "درباره قلاب‌های زمان اجرا (ABOUT RUNTIME HOOKS)" .sp قلاب‌های زمان اجرا که از طریق تابع \fBadd_runscript\fP از یک قلاب نصب به تصویر اضافه می‌شوند، قادرند قابلیت‌های اضافی را در طول فضای کاربری اولیه فراهم کنند. توابع خاصی در این فایل‌ها در زمان‌های متفاوتی اجرا خواهند شد. یک قلاب می‌تواند یک یا چند مورد از این توابع را تعریف کند. در هر نقطه اتصال، قلاب‌ها به ترتیبی که در متغیر HOOKS تعریف شده‌اند اجرا می‌شوند، به جز قلاب‌های پاکسازی که به ترتیب معکوس اجرا می‌گردند. .sp \fBrun_earlyhook\fP .RS 4 توابعی با این نام پس از برپایی اتصالات API و تجزیه خط فرمان هسته اجرا خواهند شد. دیمن‌های مورد نیاز برای فضای کاربری اولیه باید از این نقطه اتصال راه‌اندازی شوند. .RE .sp \fBrun_hook\fP .RS 4 توابعی با این نام پس از هر قلاب اولیه و پس از نصب ماژول‌های تعریف‌شده توسط کاربر اجرا خواهند شد. این متداول‌ترین نقطه اتصال قلاب است، و عملکردهایی مانند اسکن برای حجم‌های LVM و نگاشت حجم‌های رمزنگاری‌شده باید در اینجا انجام شوند. .RE .sp \fBrun_latehook\fP .RS 4 توابعی با این نام پس از اتصال ریشه اجرا خواهند شد. این تابع عموماً برای تنظیمات لازم بعدی در ریشه واقعی، مانند اتصال سایر پارتیشن‌های سیستم، استفاده می‌شود. .RE .sp \fBrun_cleanuphook\fP .RS 4 توابعی با این نام تا جای ممکن دیر اجرا می‌شوند. هر دیمنی که از طریق تابع \fBrun_earlyhook\fP شروع به کار کرده است باید در اینجا برای آماده‌سازی جابجایی به ریشه واقعی متوقف شود. .RE .sp \fBrun_emergencyhook\fP .RS 4 توابعی با این نام پیش از راه‌اندازی شل اضطراری (در صورت بروز شکست در بوت) اجرا می‌شوند. برای مثال این امکان را می‌دهد تا صفحات اسپلش بوت فرآیند خود را متوقف کنند تا کاربران متوجه شکست شوند. .RE .sp \fBgetarg\fP \fIargument\fP [ \fIdefault\fP ] .RS 4 این تابع می‌تواند در قلاب‌های زمان اجرا برای دریافت یک آرگومان از cmdline هسته استفاده شود. اگر \fIargument\fP همراه با مقدار وجود داشته باشد، آن مقدار بازگردانده می‌شود. اگر \fIargument\fP بدون مقدار وجود داشته باشد، \fIy\fP بازگردانده می‌شود. اگر \fIargument\fP وجود نداشته باشد، \fIdefault\fP بازگردانده می‌شود. اگر \fIdefault\fP مشخص نشده باشد، چیزی بازگردانده نخواهد شد. .RE .SH "درباره قلاب‌های پسین (ABOUT POST HOOKS)" .sp قلاب‌های پسین، فایل‌های اجرایی یا اسکریپت‌هایی هستند که پس از تولید موفق تصویر برای پردازش‌های بیشتر، مانند امضا کردن، اجرا می‌شوند. هنگامی که \fBkernel\-install\fP(8) دستور mkinitcpio را فراخوانی می‌کند، قلاب‌های پسین غیرفعال می‌شوند. .sp آن‌ها هسته را به عنوان آرگومان اول، تصویر را به عنوان آرگومان دوم و به صورت اختیاری تصویر هسته یکپارچه را به عنوان آرگومان سوم دریافت می‌کنند. .sp توجه: اگر mkinitcpio با \fB\-k\fP \fInone\fP یا \fB\-k\fP \fIversion\fP فراخوانی شود و تصویر هسته یافت نشود، آرگومان اول خالی خواهد بود. .sp متغیرهای محیطی زیر ارسال می‌شوند: .sp \fBKERNELVERSION\fP .RS 4 شامل نسخه کامل هسته‌ای است که تصویر از آن ساخته شده است. .RE .sp \fBKERNELDESTINATION\fP .RS 4 مکان پیش‌فرضی که هسته باید برای راه‌اندازی در آن قرار گیرد. این معمولاً همان آرگومان اول است اما اگر mkinitcpio با \fB\-k\fP \fI/boot/*\fP فراخوانی نشده باشد ممکن است تفاوت داشته باشد. اگر هیچ تصویر هسته‌ای پیدا نشود، این متغیر نیز خالی خواهد بود. .RE .SH "محیط راه‌اندازی اولیه (EARLY INIT ENVIRONMENT)" .sp دستور mkinitcpio با برخی متغیرهای محیطی ارسال‌شده در خط فرمان هسته، رفتار ویژه‌ای دارد: .sp \fBbreak\fP[=\fI\fP] .RS 4 در صورت تعیین، mkinitcpio در طول راه‌اندازی اولیه یک شل اجرا خواهد کرد. پارامتر اختیاری زمان وقوع آن را کنترل می‌کند: هنگامی که \fIpremount\fP یا هیچ پارامتری مشخص نشده باشد، شل پیش از متصل کردن ریشه اجرا می‌شود. اگر \fIpostmount\fP مشخص شود، شل پس از متصل کردن ریشه اجرا خواهد شد. .RE .sp \fBdisablehooks=\fP\fIhooklist\fP .RS 4 فهرستی از قلاب‌ها جداشده با کاما که در طول راه‌اندازی اولیه نادیده گرفته می‌شوند. .RE .sp \fBearlymodules=\fP\fImodulelist\fP .RS 4 فهرستی از ماژول‌ها جداشده با کاما که پیش از سایر ماژول‌ها بارگذاری خواهند شد. این عموماً مورد نیاز نیست و معمولاً به مشکلی در پیکربندی یا هسته اشاره دارد. .RE .sp \fBquiet\fP .RS 4 باعث می‌شود mkinitcpio در طول راه‌اندازی پیام‌های کمتری نمایش دهد. خطاها پوشانده نخواهند شد. .RE .sp \fBro\fP .RS 4 مشخص می‌کند که ریشه باید با مجوزهای فقط‌خواندنی (readonly) متصل شود. این رفتار پیش‌فرض است. .RE .sp \fBrw\fP .RS 4 مشخص می‌کند که ریشه باید با مجوزهای خواندن/نوشتن (readwrite) متصل شود. این عموماً تنها در صورتی مفید است که initramfs شما از قلاب \fIfsck\fP استفاده کند. .RE .sp \fBroot=\fP\fIrootdevice\fP .RS 4 این متغیر پارتیشن ریشه را توصیف می‌کند که راه‌اندازی اولیه پیش از واگذاری کنترل به init واقعی، آن را متصل خواهد کرد. mkinitcpio قالب‌های متنوعی را می‌شناسد که پایه‌ای‌ترین آن‌ها مسیر دستگاه بلوکی است، چه به طور مستقیم مانند \fI/dev/sda2\fP، یا با استفاده از یک پیوند نمادین udev مانند \fI/dev/disk/by\-label/CorsairF80\-root\fP. پشتیبانی از شناسایی با برچسب‌های LABEL یا مشخصه‌های UUID نیز فراهم است، مانند \fILABEL=CorsairF80\-root\fP. از زمان انتشار util-linux 2.22، مقادیر PARTUUID و PARTLABEL نیز پشتیبانی می‌شوند. شناسایی از طریق شناسه دستگاه major/minor با کدگذاری هگزادسیمال به دلایل قدیمی پشتیبانی می‌شود، اما باید از آن اجتناب کرد زیرا شکننده است. .RE .sp \fBrootdelay\fP[=\fIseconds\fP] .RS 4 تأخیر (بر حسب ثانیه) را تعیین می‌کند که mkinitcpio در صورت در دسترس نبودن فوری دستگاه ریشه، برای ظاهر شدن آن منتظر می‌ماند. مقدار پیش‌فرض \fI10\fP ثانیه است. اگر یک عدد صحیح نامعتبر ارسال شود، این متغیر اثری نخواهد داشت. .RE .sp \fBrootflags=\fP\fIflaglist\fP .RS 4 فهرستی از پرچم‌ها جداشده با کاما که هنگام متصل کردن سیستم فایل ریشه به دستور \fBmount\fP(8) ارسال می‌شوند. مقادیر قابل قبول بر اساس سیستم فایل متفاوت است. .RE .sp \fBrootfstype=\fP\fIfstype\fP .RS 4 نوع سیستم فایل در حال اتصال به عنوان ریشه را بازنویسی می‌کند. این گزینه تقریباً هرگز مورد نیاز نخواهد بود زیرا \fBmount\fP(8) معمولاً خود به خود این مورد را تشخیص می‌دهد. .RE .sp \fBrd.debug\fP .RS 4 اشکال‌زدایی شل (xtrace) را فعال می‌کند. اگر \fIrd.log\fP نیز پارامتری در خط فرمان هسته نباشد، این پارامتر متضمن \fIrd.log=console\fP خواهد بود. .RE .sp \fBrd.log\fP[\fI=\fP] .RS 4 ثبت لاگ پیام‌های فضای کاربری اولیه را فعال می‌کند. در صورت مشخص شدن، پارامتر اختیاری مکان ثبت این اطلاعات را شرح می‌دهد. چندین گزینه را می‌توان با استفاده از نویسه خط عمودی (|) با یکدیگر ترکیب (\fBOR\fP) کرد. پیام‌ها همواره در کنسول ثبت می‌شوند مگر اینکه پارامتر \fIquiet\fP ارسال شود. اگر پارامتر اختیاری مشخص نشود، \fIkmsg|console\fP فرض می‌گردد. اگر \fIrd.log\fP در خط فرمان هسته وجود نداشته باشد، هیچ ثبتی انجام نخواهد شد. .br .sp \fBconsole\fP .RS 4 خروجی را در \fI/dev/console\fP می‌نویسد. .RE .sp \fBfile\fP .RS 4 خروجی را در \fI/run/initramfs/init.log\fP می‌نویسد. .RE .sp \fBkmsg\fP .RS 4 خروجی را در دستگاه \fI/dev/kmsg\fP (معرفی‌شده در لینوکس 3.5) می‌نویسد. اگر هسته شما فاقد پشتیبانی از \fI/dev/kmsg\fP باشد، این گزینه بی‌استفاده (no-op) خواهد بود. .RE .sp \fBall\fP .RS 4 خروجی را در تمامی مقاصد شناخته‌شده ثبت لاگ می‌نویسد. .RE .RE .sp این‌ها تنها متغیرهایی هستند که هسته اصلی mkinitcpio رعایت می‌کند. قلاب‌های دیگر ممکن است به دنبال سایر متغیرهای محیطی باشند و این موارد باید در خروجی راهنمای آن قلاب مستند شده باشند. .SH "بازتولیدپذیری (REPRODUCIBILITY)" .sp دستور mkinitcpio قصد دارد به طور پیش‌فرض تصاویر initramfs بازتولیدپذیر ایجاد کند. .sp این بدان معناست که دو بار اجرای پیاپی mkinitcpio باید دو فایل تولید کند که در سطح باینری همسان باشند. .sp مُهرهای زمانی درون initramfs بر روی مبدأ زمان یونیکس یعنی 1970\-01\-01 تنظیم می‌شوند. .sp توجه داشته باشید که برای بازتولیدپذیر بودن کامل فرآیند ساخت، فشرده‌ساز تعیین‌شده (مانند gzip، xz) نیز باید آرشیوهای بازتولیدپذیر تولید کند. در زمان نگارش این متن، به عنوان یک نمونه غیرجامع، فشرده‌ساز lzop به دلیل درج مُهر زمانیِ زمان اجرا، قادر به تولید آرشیوهای بازتولیدپذیر نیست. .sp اطلاعات بیشتر در .URL "https://reproducible\-builds.org" "" قابل مشاهده است. .SH "فایل‌ها (FILES)" .sp \fI/etc/mkinitcpio.conf\fP .RS 4 فایل پیکربندی پیش‌فرض برای mkinitcpio. .RE .sp \fI/etc/mkinitcpio.conf.d\fP .RS 4 دایرکتوری حاوی فایل‌های پیکربندی تکمیلی (drop-in). .RE .sp \fI/etc/mkinitcpio.d\fP .RS 4 دایرکتوری حاوی پیش‌تنظیم‌های mkinitcpio. .RE .sp \fI/etc/initcpio/install\fP, \fI/usr/lib/initcpio/install\fP .RS 4 مسیر جستجو برای قلاب‌های زمان ساخت. .RE .sp \fI/etc/initcpio/hooks\fP, \fI/usr/lib/initcpio/hooks\fP .RS 4 مسیر جستجو برای قلاب‌های زمان اجرای فضای کاربری اولیه. .RE .sp \fI/etc/initcpio/post\fP, \fI/usr/lib/initcpio/post\fP .RS 4 مسیر جستجو برای قلاب‌های پس از تولید. .RE .SH "مثال‌ها (EXAMPLES)" .sp \fBmkinitcpio\fP .RS 4 انجام یک اجرای آزمایشی (dry-run). این کار یک دیسک رم اولیه تولید می‌کند اما چیزی در دیسک نمی‌نویسد. برای ایجاد تصویر واقعی از \fB\-g\fP استفاده کنید. .RE .sp \fBmkinitcpio \-p linux\fP .RS 4 ایجاد یک دیسک رم اولیه بر اساس پیش‌تنظیم \fIlinux\fP. .RE .sp \fBmkinitcpio \-g /boot/initramfs\-linux.img \-k /boot/vmlinuz\-linux\fP .RS 4 ایجاد یک دیسک رم اولیه برای هسته در /boot/vmlinuz\-linux. تصویر حاصل در /boot/initramfs\-linux.img نوشته خواهد شد. .RE .sp \fBmkinitcpio \-U /efi/EFI/Linux/systemd\-linux.efi\fP .RS 4 ایجاد یک دیسک رم اولیه برای هسته همراه با یک تصویر هسته یکپارچه. فایل اجرایی حاصل در \fI/efi/EFI/Linux/systemd\-linux.efi\fP نوشته خواهد شد. .RE .sp \fBmkinitcpio \-U /efi/EFI/Linux/systemd\-linux.efi \-\-splash /usr/share/systemd/bootctl/splash\-arch.bmp\fP .RS 4 ایجاد یک دیسک رم اولیه برای هسته و یک تصویر هسته یکپارچه. این مورد همچنین شامل یک تصویر اسپلش است که در طول راه‌اندازی استفاده خواهد شد. .RE .SH "همچنین ببینید (SEE ALSO)" .sp مقاله‌ای دقیق‌تر درباره پیکربندی mkinitcpio: .URL "https://wiki.archlinux.org/title/mkinitcpio" "" "" .sp \fBinitrd\fP(4), \fBlsinitcpio\fP(1), \fBmkinitcpio.conf\fP(5), \fBbootparam\fP(7) .SH "اشکالات (BUGS)" .sp در زمان نگارش این صفحه راهنما، هیچ اشکال قابل توجهی وجود نداشت. لطفاً برای مشاهده فهرستی به‌روز به .URL "https://gitlab.archlinux.org/archlinux/mkinitcpio/mkinitcpio/\-/issues" "" "" مراجعه کنید. .SH "نویسندگان (AUTHORS)" .sp دستور mkinitcpio توسط جامعه Arch Linux نگهداری می‌شود. برای مشاهده فهرست کامل مشارکت‌کنندگان به فایل \fIAUTHORS\fP مراجعه کنید. .SH "حق نشر (COPYRIGHT)" .sp حق نشر 🄯 مشارکت‌کنندگان mkinitcpio. مجوز GPL\-2.0\-only.