نام (NAME)

kexec - بوت مستقیم به یک هسته جدید

خلاصه دستور (SYNOPSIS)

/sbin/kexec [-v (--version)] [-f (--force)] [-x (--no-ifdown)] [-y (--no-sync)] [-l (--load)] [-p (--load-panic)] [-u (--unload)] [-e (--exec)] [-t (--type)] [--mem-min=addr] [--mem-max=addr]

توضیحات (DESCRIPTION)

دستور kexec یک فراخوان سیستمی است که به شما امکان می‌دهد از درون هسته در حال اجرا، هسته دیگری را بارگذاری کرده و به آن بوت شوید. kexec وظیفه بارگذار بوت را از داخل هسته انجام می‌دهد. تفاوت اصلی میان یک بوت استاندارد سیستم و بوت با kexec این است که مقداردهی اولیه سخت‌افزار که معمولاً توسط BIOS یا سفت‌افزار (بسته به معماری) انجام می‌شود، در طول بوت kexec انجام نمی‌گیرد. این ویژگی مدت زمان مورد نیاز برای راه‌اندازی مجدد را کاهش می‌دهد.

اطمینان حاصل کنید که هنگام پیکربندی هسته گزینه CONFIG_KEXEC=y را انتخاب کرده باشید. گزینه CONFIG_KEXEC فراخوان سیستمی kexec را فعال می‌کند.

نحوه استفاده (USAGE)

استفاده از kexec شامل موارد زیر است:

برای بارگذاری یک هسته، نحو دستور به صورت زیر است:

که در آن kernel-image فایل هسته‌ای است که قصد دارید به آن ریبوت شوید.

پارامترهای خط فرمانی را که باید به هسته جدید ارسال شوند در command-line-options قرار دهید. ارسال دقیق محتویات /proc/cmdline به command-line-options امن‌ترین روش برای اطمینان از ارسال مقادیر صحیح به هسته‌ای است که در حال راه‌اندازی مجدد است.

گزینه اختیاری initrd-image تصویر initrd مورد استفاده در حین بوت است.

همچنین امکان فراخوانی kexec بدون پارامتر گزینه وجود دارد. در این حالت، kexec هسته مشخص‌شده را بارگذاری کرده و سپس shutdown(8) را فراخوانی می‌کند. اگر اسکریپت‌های خاموش‌سازی توزیع لینوکس شما از راه‌اندازی مجدد مبتنی بر kexec پشتیبانی کنند، درست قبل از ریبوت واقعی دستگاه، kexec را با -e فراخوانی می‌کنند. به این ترتیب دستگاه یک خاموش‌سازی تمیز شامل تمام اسکریپت‌های خاموش‌سازی انجام می‌دهد.

مثال (EXAMPLE)

برای مثال، اگر تصویر هسته‌ای که می‌خواهید به آن ریبوت شوید /boot/vmlinux، محتوای /proc/cmdline برابر با root=/dev/hda1، و مسیر initrd برابر با /boot/initrd باشد، برای بارگذاری هسته از دستور زیر استفاده می‌کنید:

پس از بارگذاری این هسته، با فرض پشتیبانی فضای کاربری از راه‌اندازی مجدد مبتنی بر kexec، می‌توان با یک خاموش‌سازی تمیز با استفاده از دستور زیر به آن بوت شد:

همچنین می‌توان بدون فراخوانی shutdown(8)، با استفاده از دستور زیر به آن بوت شد:

گزینه‌ها (OPTIONS)

-d (--debug)

فعال‌سازی پیام‌های اشکال‌زدایی.

-S (--status)

در صورتی که نوع (به‌طور پیش‌فرض crash) بارگذاری شده باشد مقدار 1 و در غیر این صورت 0 را برمی‌گرداند. می‌تواند در ترکیب با -l یا -p برای تغییر نوع استفاده شود. توجه داشته باشید که این گزینه بر سایر گزینه‌ها اولویت دارد و هسته را بارگذاری یا تخلیه نخواهد کرد.

-e (--exec)

اجرای هسته بارگذاری‌شده فعلی. توجه داشته باشید که این گزینه بدون فراخوانی shutdown(8) به هسته بارگذاری‌شده ریبوت می‌کند.

-f (--force)

اجبار به فراخوانی فوری kexec، عدم فراخوانی shutdown(8) (برخلاف عملکرد پیش‌فرض بدون هیچ پارامتر گزینه). این گزینه همانند اجرای -l و -e در یک فراخوانی عمل می‌کند.

-h (--help)

باز کردن فایل راهنما برای kexec.

--hotplug

تنظیم سگمنت‌های kexec به گونه‌ای که هسته بتواند در رویدادهای افزودن/حذف گرم پردازنده/حافظه، آن‌ها را با امنیت به‌روزرسانی کند. اگر این گزینه فعال باشد، هسته به‌روزرسانی سگمنت‌های kexec را در رویدادهای افزودن/حذف گرم پردازنده/حافظه در درون خود هسته انجام می‌دهد، بنابراین از نیاز به بارگذاری مجدد هسته kdump جلوگیری می‌شود.

-i (--no-checks)

راه‌اندازی مجدد سریع، بدون بررسی‌های یکپارچگی حافظه.

-l (--load) kernel

بارگذاری kernel مشخص‌شده در هسته جاری.

-p (--load-panic)

بارگذاری هسته جدید برای استفاده در هنگام panic (وحشت هسته).

-t (--type=type)

مشخص کردن اینکه هسته جدید از این type (نوع) است.

-s (--kexec-file-syscall)

مشخص کردن اینکه منحصراً از فراخوان سیستمی جدید KEXEC_FILE_LOAD استفاده شود. در XEN نادیده گرفته می‌شود.

-c (--kexec-syscall)

مشخص کردن اینکه منحصراً از فراخوان سیستمی قدیمی KEXEC_LOAD استفاده شود.

-a (--kexec-syscall-auto)

ابتدا فراخوان سیستمی جدید KEXEC_FILE_LOAD را امتحان می‌کند و در صورتی که پشتیبانی نشود یا هسته تصویر ارائه‌شده را تشخیص ندهد، به رابط قدیمی KEXEC_LOAD بازمی‌گردد.

هیچ رابط واحدی وجود ندارد که همیشه کار کند، بنابراین این گزینه پیش‌فرض است.

گزینه KEXEC_FILE_LOAD در سیستم‌هایی که از بوت امن قفل‌شده برای تایید امضای هسته استفاده می‌کنند الزامی است. همچنین ممکن است KEXEC_LOAD در پیکربندی هسته غیرفعال شده باشد.

گزینه KEXEC_LOAD برای برخی فرمت‌های تصویر هسته و در معماری‌هایی که KEXEC_FILE_LOAD را پیاده‌سازی نکرده‌اند الزامی است.

-u (--unload)

تخلیه هسته هدف kexec فعلی. در صورتی که یک هسته capture در حال تخلیه است، -p را همراه با -u مشخص کنید.

-v (--version)

نمایش شماره نسخه ابزار نصب‌شده.

-x (--no-ifdown)

خاموش کردن هسته در حال اجرا، اما بازیابی رابط شبکه در بارگذاری مجدد.

-y (--no-sync)

خاموش کردن هسته در حال اجرا، اما صرف‌نظر کردن از همگام‌سازی سیستم‌های فایل.

--mem-min=addr

مشخص کردن پایین‌ترین آدرس حافظه addr برای بارگذاری کد در آن.

--mem-max=addr

مشخص کردن بالاترین آدرس حافظه addr برای بارگذاری کد در آن.

--entry=addr

مشخص کردن آدرس پرش به عقب (jump back). (مقدار 0 به معنای عدم پرش به عقب یا عدم حفظ زمینه است).

--load-preserve-context

بارگذاری هسته جدید و حفظ زمینه (context) هسته جاری در طول kexec.

--load-jump-back-helper

بارگذاری یک تصویر کمکی برای پرش به عقب به هسته اصلی.

--reuseinitrd

استفاده مجدد از initrd از بوت نخست.

--print-ckr-size

چاپ اندازه ناحیه هسته خرابی (crash kernel)، در صورت موجود بودن.

انواع فایل‌های پشتیبانی‌شده هسته و گزینه‌ها (SUPPORTED KERNEL FILE TYPES AND OPTIONS)

Beoboot-x86

elf-x86

bzImage-x86

multiboot-x86

multiboot2-x86

elf-ppc64

گزینه‌های معماری (ARCHITECTURE OPTIONS)

--console-serial

فعال‌سازی کنسول سریال.

--console-vga

فعال‌سازی کنسول VGA.

--elf32-core-headers

آماده‌سازی هدرهای هسته (core headers) در قالب ELF32.

--elf64-core-headers

آماده‌سازی هدرهای هسته در قالب ELF64.

--reset-vga

تلاش برای بازنشانی (reset) یک دستگاه استاندارد VGA.

--serial=port

مشخص کردن پورت سریال port برای خروجی اشکال‌زدایی.

--serial-baud=baud_rate

مشخص کردن baud rate (نرخ باود) پورت سریال.

--dt-no-old-root

عدم استفاده مجدد از پارامتر root=<device> هسته قدیمی در هنگام ایجاد درخت دستگاه مسطح (flattened device tree).