.\" -*- nroff -*-
.TH SYSTEMTAP 8
.SH "نام (NAME)"
systemtap-service \- اسکریپت راه‌انداز و سرویس systemd برای SystemTap

.\" macros
.de SAMPLE

.nr oldin \\n(.i
.br
.RS
.nf
.nh
..
.de ESAMPLE
.hy
.fi
.RE
.in \\n[oldin]u

..

.SH "خلاصه دستور (SYNOPSIS)"
.B systemtap-service
.IR COMMAND " [" OPTIONS "] [" SCRIPT ...]

.B service systemtap
.IR COMMAND " [" OPTIONS "] [" SCRIPT ...]

.SH "توضیحات (DESCRIPTION)"
هدف اسکریپت راه‌انداز SystemTap فراهم کردن راهکاری برای اجرای اسکریپت‌ها به عنوان یک سرویس و
کنترل آسان و مجزای هر یک از آن‌ها است. اسکریپت‌ها می‌توانند طوری پیکربندی شوند که با درخواست
دستی کاربر یا هنگام راه‌اندازی سیستم اجرا شوند. در سیستم‌های مبتنی بر dracut، امکان ادغام
اسکریپت‌ها در initramfs و اجرای آن‌ها در مراحل اولیه بوت (early-boot) نیز وجود دارد.
.PP
اسکریپت راه‌انداز SystemTap را می‌توان به صورت دستی با استفاده از دستور
.B systemtap-service
فراخوانی کرد. در سیستم‌های مبتنی بر systemd، این اسکریپت توسط
.B systemctl
و با فایل سرویس
\fBsystemtap.service\fR
کنترل می‌شود.
.PP
پارامترها و گزینه‌های گوناگونی برای تغییر رفتار کلی سیستم و همچنین رفتار هر اسکریپت در دسترس است.
می‌توان بین اسکریپت‌ها وابستگی تعریف کرد تا شروع یکی موجب اجرای سایر موارد شود.
.PP
فایل پیکربندی اسکریپت راه‌انداز در مسیر
\fB/etc/systemtap/config\fR
قرار دارد. پارامترهای مجاز با جزئیات در بخش
«پارامترهای سراسری (GLOBAL PARAMETERS)»
شرح داده شده‌اند.
.PP
اسکریپت‌ها باید در دایرکتوری
\fB/etc/systemtap/script.d\fR
قرار گیرند و پسوند
\fB.stp\fR
داشته باشند. هنگام ارجاع به آن‌ها در خط فرمان، نیازی به درج پسوند
\fB.stp\fR
نیست. نام اسکریپت‌ها فقط می‌تواند شامل نویسه‌های الفبایی‌عددی (و '_') باشد و نباید با عدد
شروع شود. دایرکتوری اسکریپت‌ها را می‌توان با تنظیم پارامتر
SCRIPT_PATH
در فایل پیکربندی تغییر داد.

.SH "دستورات (COMMANDS)"
یکی از دستورات زیر باید مشخص شود:

.TP
.B start
اجرای \fISCRIPT\fRها. اگر هیچ اسکریپتی مشخص نشده باشد، اسکریپت‌های تعیین‌شده در پیکربندی
DEFAULT_START
اجرا می‌شوند. اگر DEFAULT_START تنظیم نشده باشد، تمام اسکریپت‌های موجود در دایرکتوری اسکریپت‌ها اجرا خواهند شد. برای اسکریپت‌هایی که از قبل اجرا شده‌اند، این دستور نادیده گرفته می‌شود. در صورت عدم موفقیت در اجرای اسکریپت‌ها، دستور با خطا مواجه خواهد شد (همچنین به پیکربندی
PASSALL
مراجعه کنید).
.PP
اگر گزینه پیکربندی AUTOCOMPILE فعال باشد، در صورت برقرار بودن یکی از شرایط زیر، دستور سعی می‌کند اسکریپت‌های مشخص‌شده را کامپایل یا به‌روزرسانی کند:
.RS
.IP - 2
فایل کش کامپایل‌شده وجود نداشته باشد.
.IP -
زمان ویرایش (mtime) فایل اسکریپت اصلی جدیدتر از زمان کش اسکریپت کامپایل‌شده باشد.
.IP -
گزینه‌های stap مشخص‌شده برای کامپایل اسکریپت تغییر کرده باشند (همچنین به بخش
«پارامترهای اسکریپت (SCRIPT PARAMETERS)»
مراجعه کنید).
.IP -
نتیجه دستور `uname -a` تغییر کرده باشد.
.RE

.TP
.B stop
متوقف کردن \fISCRIPT\fRها. اگر هیچ اسکریپتی مشخص نشده باشد، تمام اسکریپت‌های در حال اجرا متوقف می‌شوند. برای اسکریپت‌هایی که از قبل متوقف شده‌اند، این دستور نادیده گرفته می‌شود. در صورت عدم موفقیت در متوقف کردن اسکریپت‌ها، دستور با خطا مواجه خواهد شد (همچنین به پیکربندی
PASSALL
مراجعه کنید).

.TP
.B restart
متوقف کردن و اجرای مجدد \fISCRIPT\fRها.

.TP
.B status
نمایش وضعیت \fISCRIPT\fRها و وابستگی‌های آن‌ها.

.TP
.B compile
کامپایل کردن \fISCRIPT\fRها بدون شروع اجرای آن‌ها. اگر اسکریپت‌ها از قبل کامپایل شده باشند، پیش از بازنویسی کش، برای تأیید پیام داده می‌شود. کامپایل برای هسته فعلی، یا نسخه انتشار هسته مشخص‌شده با گزینه
\fB-r\fR
انجام می‌شود.

.TP
.B onboot
قرار دادن \fISCRIPT\fRها به عنوان بخشی از initramfs به طوری که در مراحل اولیه فرآیند بوت اجرا شوند. این دستور فقط در سیستم‌های مبتنی بر dracut در دسترس است. اگر هیچ اسکریپتی مشخص نشده باشد، یک initramfs عادی و فاقد هرگونه فایل SystemTap ایجاد می‌شود.
.PP
تصویر initramfs برای هسته فعلی، یا نسخه انتشار هسته مشخص‌شده توسط گزینه
\fB-r\fR
ایجاد می‌شود. مسیر فایل initramfs ایجادشده به صورت پیش‌فرض
\fB/boot/initramfs-KVER.img\fR
است، که در آن KVER خروجی دستور `uname -r` می‌باشد. بوت‌لودر نیز (با استفاده از
\fInew-kernel-pkg\fR(8))
به‌روزرسانی می‌شود تا مدخل مربوط به هسته از فایل جدید initramfs استفاده کند. از گزینه
\fB-o\fR
برای تعیین مسیری متفاوت استفاده کنید (در این حالت پیکربندی بوت‌لودر به‌روزرسانی نخواهد شد).
.PP
اگر فایل خروجی از قبل وجود داشته باشد، بازنویسی می‌شود مگر آنکه سوییچ
\fB-b\fR
داده شده باشد، که در این صورت به جای بازنویسی، پسوند
\fB.bak\fR
به انتهای نام فایل اضافه می‌شود. با این حال، اگر نسخه‌ای با پسوند
\fB.bak\fR
از قبل وجود داشته باشد، فایل پشتیبان بازنویسی نخواهد شد.
.PP
هشدار: از گزینه
\fB-o\fR
دستور
\fIstap\fR(1)
همراه با اسکریپت‌های onboot استفاده نکنید، زیرا اسکریپت حتی پیش از مانت شدن فایل‌سیستم ریشه اجرا می‌شود. در صورت نیاز به فضای بیشتر، اندازه بافر را افزایش دهید.

.TP
.B cleanup
حذف \fISCRIPT\fRهای کامپایل‌شده از حافظه کش. اگر هیچ اسکریپتی مشخص نشود، تمام اسکریپت‌های کامپایل‌شده حذف می‌شوند. تنها کش مربوط به هسته فعلی، یا نسخه انتشار هسته مشخص‌شده با گزینه
\fB-r\fR
حذف خواهد شد. قبل از حذف، برای تأیید پیام داده می‌شود.

.SH "گزینه‌ها (OPTIONS)"
بسیاری از این دستورات می‌توانند گزینه‌هایی را نیز دریافت کنند. با این حال، از آنجا که کاربران نمی‌توانند این گزینه‌ها را هنگام بوت ارسال کنند، آن‌ها فقط برای مدیریت اسکریپت‌ها پس از بوت و برای آزمودن در نظر گرفته شده‌اند. گزینه‌های موجود عبارتند از:

.TP
.BI "-c " CONFIG_FILE
مشخص کردن یک فایل پیکربندی دیگر به جای فایل پیش‌فرض.

.TP
.B -R
هنگام استفاده از دستورات
\fBstart\fR
و
\fBstop\fR ،
وابستگی‌های اسکریپت‌ها را نیز (به صورت بازگشتی) در بر می‌گیرد.

.TP
.BI "-r " KERNEL_RELEASE
هنگام استفاده از دستورات
\fBcompile\fR ،
\fBonboot\fR
و
\fBcleanup\fR ،
نسخه هسته هدف را به جای استفاده از هسته فعلی مشخص می‌کند. این مقدار باید در همان قالب خروجی `uname -r` باشد.

.TP
.B -y
پاسخ بله (yes) به تمام پرسش‌های تأییدیه.

.TP
.BI "-o " PATH.IMG
هنگام استفاده از دستور
\fBonboot\fR ،
مسیر خروجی فایل initramfs ایجادشده را مشخص می‌کند. در صورت مشخص شدن، پیکربندی بوت‌لودر به‌روزرسانی نمی‌شود.

.TP
.B -b
هنگام استفاده از دستور
\fBonboot\fR ،
با افزودن پسوند
\fB.bak\fR
به جای بازنویسی، از تصویر initramfs موجود یک نسخه پشتیبان تهیه می‌کند. بدون این گزینه، فایل initramfs بازنویسی خواهد شد.

.SH "پارامترهای سراسری (GLOBAL PARAMETERS)"
این پارامترها بر رفتار کلی سرویس اسکریپت راه‌انداز SystemTap تأثیر می‌گذارند. آن‌ها را می‌توان در فایل پیکربندی تعیین کرد.

.TP
.B SCRIPT_PATH
مسیر مطلق دایرکتوری اسکریپت‌ها را مشخص می‌کند. این‌ها اسکریپت‌هایی هستند که اسکریپت راه‌انداز می‌تواند روی آن‌ها عملیات انجام دهد. اسکریپت‌ها باید پسوند
\fB.stp\fR
داشته باشند. مسیر پیش‌فرض
\fB/etc/systemtap/script.d\fR
است.

.TP
.B CONFIG_PATH
مسیر مطلق دایرکتوری پیکربندی اسکریپت‌ها را مشخص می‌کند. این فایل‌های پیکربندی شامل گزینه‌هایی برای اسکریپت‌های مشخص هستند. آن‌ها باید پسوند
\fB.conf\fR
داشته باشند. مسیر پیش‌فرض
\fB/etc/systemtap/conf.d\fR
است.

.TP
.B CACHE_PATH
مسیر مطلق دایرکتوری کش را مشخص می‌کند. مسیر پیش‌فرض
\fB/var/cache/systemtap\fR
است.

.TP
.B TEMP_PATH
مسیر مطلق دایرکتوری موقتی که SystemTap برای کامپایل اسکریپت‌ها پوشه‌های موقت در آن ایجاد می‌کند را مشخص می‌سازد. مسیر پیش‌فرض
\fB/tmp\fR
است.

.TP
.B STAT_PATH
مسیر مطلق دایرکتوری حاوی فایل‌های PID که برای ردیابی وضعیت اسکریپت‌های SystemTap به کار می‌روند را مشخص می‌کند. مسیر پیش‌فرض
\fB/var/run/systemtap\fR
است.

.TP
.B LOG_FILE
مسیر مطلق فایل لاگ را مشخص می‌کند. تمام پیام‌ها، از جمله خطاهای کامپایل و زمان اجرا، به این فایل ارسال می‌شوند. مسیر پیش‌فرض
\fB/var/log/systemtap.log\fR
است.

.TP
.B PASSALL
اگر روی
\fByes\fR
تنظیم شده باشد، دستورات اسکریپت راه‌انداز که روی چند اسکریپت عملیات انجام می‌دهند، در صورت عدم امکان انجام عملیات روی حداقل یک اسکریپت، به عنوان شکست‌خورده گزارش می‌شوند. اگر روی
\fBno\fR
تنظیم شود، تنها یک هشدار صادر می‌شود. مقدار پیش‌فرض
\fByes\fR
است.

.TP
.B RECURSIVE
اگر روی
\fByes\fR
تنظیم شده باشد، اسکریپت راه‌انداز همواره وابستگی‌های اسکریپت را به صورت بازگشتی دنبال خواهد کرد. این بدان معناست که نیازی به تعیین گزینه
\fB-R\fR
نیست. این فلگ تنها در صورتی مؤثر است که اسکریپت(ها) را از طریق خط فرمان مشخص کنید. مقدار پیش‌فرض
\fBno\fR
است.

.TP
.B AUTOCOMPILE
اگر روی
\fByes\fR
تنظیم شده باشد، در صورت عدم وجود کش معتبر، اسکریپت راه‌انداز در هنگام نیاز به صورت خودکار اقدام به کامپایل اسکریپت‌های مشخص‌شده می‌کند. در غیر این صورت، دستور مربوطه به سادگی با شکست مواجه می‌شود. مقدار پیش‌فرض
\fByes\fR
است.

.TP
.B DEFAULT_START
اسکریپت‌هایی را مشخص می‌کند که باید به طور پیش‌فرض راه‌اندازی شوند. در صورت عدم درج (یا خالی بودن)، تمام اسکریپت‌های موجود در دایرکتوری اسکریپت‌ها راه‌اندازی خواهند شد. مقدار پیش‌فرض
\fB""\fR
است.

.TP
.B ALLOW_CACHEONLY
اگر روی
\fByes\fR
تنظیم شود، اسکریپت راه‌انداز اجازه عملیات روی اسکریپت‌هایی را که در دایرکتوری کش قرار دارند اما در دایرکتوری اسکریپت‌ها موجود نیستند نیز می‌دهد. مقدار پیش‌فرض
\fBno\fR
است.
.PP
هشدار: با فعال بودن این گزینه، اسکریپت راه‌انداز ممکن است کش‌های منسوخ و غیرمنتظره را بارگذاری کند. پیش از فعال کردن این گزینه، دایرکتوری کش باید بررسی شود.

.TP
.B LOG_BOOT_ERR
از آنجا که اسکریپت‌های زمان بوت پیش از مانت شدن فایل‌سیستم ریشه اجرا می‌شوند، خروجی stderr دستور staprun را نمی‌توان طبق معمول در LOG_FILE ثبت کرد. با این حال، با تنظیم LOG_BOOT_ERR روی
\fByes\fR
می‌توان خروجی لاگ را در مسیر /run/systemtap/$script.log ذخیره کرد. اگر STAT_PATH با مقدار پیش‌فرض تفاوت داشته باشد، فایل‌های لاگ پس از اجرای هر یک از دستورات اسکریپت راه‌انداز به آنجا منتقل خواهند شد. مقدار پیش‌فرض
\fBno\fR
است.

.PP
نمونه‌ای از یک فایل پیکربندی سراسری در اینجا آمده است:
.SAMPLE
SCRIPT_PATH=/var/systemtap/script.d/
PASSALL=yes
RECURSIVE=no
.ESAMPLE

.SH "پارامترهای اسکریپت (SCRIPT PARAMETERS)"
این پارامترها بر کامپایل یا رفتار زمان اجرای اسکریپت‌های خاص SystemTap تأثیر می‌گذارند. آن‌ها باید در فایل‌های پیکربندی واقع در دایرکتوری
CONFIG_PATH
قرار گیرند.

.TP
.B <SCRIPT>_OPT
گزینه‌های ارسالی به دستور
\fIstap\fR(1)
را برای SCRIPT مشخص می‌کند. در اینجا، SCRIPT نام فایل اسکریپت بدون پسوند
\fB.stp\fR
است. توجه داشته باشید که گزینه
\fB-F\fR
همواره اضافه می‌شود.
.PP
گزینه‌های زیر هنگام کامپایل اسکریپت‌ها نادیده گرفته می‌شوند:
.BR \-p ,
.BR \-m ,
.BR \-r ,
.BR \-c ,
.BR \-x ,
.BR \-e ,
.BR \-s ,
.BR \-o ,
.BR \-h ,
.BR \-V ,
.BR \-k .
.PP
گزینه‌های زیر هنگام اجرای اسکریپت‌های در حال شروع نادیده گرفته می‌شوند:
.BR \-h ,
.BR \-V ,
.BR \-v ,
.BR \-t ,
.BR \-p ,
.BR \-I ,
.BR \-e ,
.BR \-R ,
.BR \-r ,
.BR \-m ,
.BR \-k ,
.BR \-g ,
.BR \-P ,
.BR \-D ,
.BR \-b ,
.BR \-u ,
.BR \-q ,
.BR \-w ,
.BR \-l ,
.BR \-d ,
.BR \-L ,
.BR \-F
و تمام گزینه‌های بلند (long options).

.TP
.B <SCRIPT>_REQ
وابستگی‌های اسکریپت را مشخص می‌کند (یعنی این اسکریپت به کدام اسکریپت نیاز دارد). برای مثال، اگر foo.stp به bar.stp نیاز داشته باشد (یا لازم باشد پس از آن اجرا شود)، مقدار زیر را تنظیم کنید:
.SAMPLE
foo_REQ="bar"
.ESAMPLE
چندین اسکریپت را با جدا کردن نام‌های آن‌ها با فاصله مشخص کنید.

.PP
نمونه‌ای از یک فایل پیکربندی اسکریپت در اینجا آمده است:
.SAMPLE
script1_OPT="-o /var/log/script1.out"
script2_OPT="-o /var/log/script2.out"
script2_REQ="script1"
.ESAMPLE

.SH "مثال‌ها (EXAMPLES)"

.TP
.B "نصب اسکریپت‌ها (INSTALLING SCRIPTS)"
ابتدا یک اسکریپت SystemTap (برای مثال "script1.stp") را در دایرکتوری اسکریپت‌ها کپی می‌کنیم:
.SAMPLE
\fB#\fR cp script1.stp /etc/systemtap/script.d/
.ESAMPLE
سپس می‌توانیم گزینه‌های مورد نظر اسکریپت را تنظیم کنیم، به عنوان مثال:
.SAMPLE
\fB#\fR vi /etc/systemtap/conf.d/group1.conf
script1_OPT="-o /var/log/group1.out"
.ESAMPLE
سپس اسکریپتی (برای مثال "script2.stp") را نصب می‌کنیم که لازم است پس از script1 اجرا شود. در این حالت، می‌توانیم مراحل زیر را انجام دهیم:
.SAMPLE
\fB#\fR cp script2.stp /etc/systemtap/script.d/
\fB#\fR vi /etc/systemtap/conf.d/group1.conf
script2_OPT="-o /var/log/group2.out"
script2_REQ="script1"
.ESAMPLE
به این ترتیب، اگر دستور
\fIstap\fR(1)
در اجرای script1 با شکست مواجه شود، اسکریپت راه‌انداز حتی تلاشی برای اجرای script2 نخواهد کرد.

.TP
.B "آزمودن (TESTING)"
پس از نصب اسکریپت‌ها، می‌توانیم با انجام دستورات زیر اطمینان حاصل کنیم که آن‌ها کار می‌کنند:
.SAMPLE
\fB#\fR systemtap-service start
\fB#\fR systemtap-service stop
.ESAMPLE
همچنین می‌توانیم جزئیات بیشتری مشخص کنیم، برای مثال:
.SAMPLE
\fB#\fR systemtap-service start script1
\fB#\fR systemtap-service stop script1
.ESAMPLE
اگر خطایی وجود نداشت، برای استفاده آماده هستیم.

.TP
.B "فعال‌سازی سرویس (ENABLING SERVICE)"
پس از رضایت از کارکرد اسکریپت‌ها و آزمایش آن‌ها، می‌توانیم سرویس اسکریپت راه‌انداز SystemTap را فعال کنیم:
.SAMPLE
\fB#\fR chkconfig systemtap on
.ESAMPLE

.TP
.B "حذف اسکریپت‌ها (DELETING SCRIPTS)"
اسکریپت‌ها به سادگی با پاک کردن آن‌ها از دایرکتوری اسکریپت‌ها و حذف خطوط پیکربندی مختص به آن‌ها پاک می‌شوند:
.SAMPLE
\fB#\fR rm /etc/systemtap/script.d/script2.stp
\fB#\fR vi /etc/systemtap/conf.d/group1.conf
.ESAMPLE
اگر اسکریپت هنوز در حال اجرا است، باید آن را متوقف کنیم:
.SAMPLE
\fB#\fR systemtap-service stop script2
.ESAMPLE
سپس می‌توانیم کش مرتبط با اسکریپت را نیز حذف کنیم:
.SAMPLE
\fB#\fR systemtap-service cleanup script2
.ESAMPLE

.TP
.B "آماده‌سازی برای به‌روزرسانی‌های هسته (PREPARING FOR KERNEL UPDATES)"
معمولاً هنگام بوت شدن با یک هسته جدید نیاز به انجام کاری نیست. اسکریپت راه‌انداز تفاوت نسخه هسته را متوجه شده و اسکریپت‌ها را کامپایل می‌کند. همچنین با استفاده از گزینه
\fB-r\fR
می‌توان کامپایل را از قبل انجام داد تا از انجام کامپایل در زمان بوت جلوگیری شود:
.SAMPLE
\fB#\fR systemtap-service compile myscript -r <NEW_KERNEL_VERSION>
.ESAMPLE

.TP
.B "وارد کردن اسکریپت‌های کامپایل‌شده (IMPORTING COMPILED SCRIPTS)"
برای محیط‌هایی که فاقد زیرساخت کامپایل هستند (برای مثال بدون کامپایلرها یا debuginfo)، مانند یک سیستم عملیاتی (production)، اسکریپت‌ها را می‌توان روی یک ماشین دیگر (محیط توسعه) کامپایل کرد و سپس به سیستم عملیاتی انتقال داد:
.SAMPLE
\fB#\fR systemtap-service compile myscript -r \
.br
>   <KERNEL_VERSION_OF_TARGET_MACHINE>
\fB#\fR tar czf stap-scripts-<kernel-version>.tar.gz \
.br
>   /var/cache/systemtap/<kernel-version> \
.br
>   /etc/systemtap/conf.d/<configfile>
.ESAMPLE
سپس این بسته را به ماشین هدف منتقل کرده و آن را استخراج کنید.

.TP
.B "اجرای اسکریپت‌ها در زمان بوت اولیه (STARTING SCRIPTS DURING EARLY-BOOT)"
اسکریپت راه‌انداز همچنین به ما اجازه می‌دهد تا اسکریپت‌ها را با ایجاد یک initramfs حاوی ماژول اسکریپت، زودتر در طول فرآیند بوت اجرا کنیم. سیستم برای کارکرد این قابلیت باید مبتنی بر dracut باشد. اجرای یک اسکریپت در این مرحله، امکان دسترسی به اطلاعاتی را فراهم می‌کند که در غیر این صورت دستیابی به آن‌ها بسیار دشوار خواهد بود.
.PP
ما ابتدا اسکریپت را طبق معمول با کپی کردن در دایرکتوری اسکریپت‌ها نصب کرده و هر گزینه‌ای را که می‌خواهیم تنظیم می‌کنیم:
.SAMPLE
\fB#\fR cp myscript.stp /etc/systemtap/script.d
\fB#\fR vi /etc/systemtap/conf.d/myscript.conf
.ESAMPLE
برای افزودن اسکریپت به initramfs، از دستور
\fBonboot\fR
استفاده می‌کنیم:
.SAMPLE
\fB#\fR systemtap-service onboot myscript
.ESAMPLE
اگر اسکریپت از قبل کامپایل و کش نشده باشد، در این مرحله انجام می‌شود. سپس یک initramfs جدید در محل پیش‌فرض ایجاد خواهد شد. می‌توانیم از گزینه
\fB-b\fR
استفاده کنیم تا اطمینان حاصل شود که از initramfs موجود نسخه پشتیبان تهیه می‌شود. سپس می‌توانیم سیستم را ری‌استارت کنیم.

.TP
.B "استفاده از یک INITRAMFS متفاوت (USING A DIFFERENT INITRAMFS)"
اگر ترجیح می‌دهیم اسکریپت را فقط برای یک بار بوت اجرا کنیم و نه دفعات دیگر، شاید آسان‌تر باشد که از گزینه
\fB-o\fR
برای تعیین یک فایل خروجی initramfs دیگر استفاده کنیم:
.SAMPLE
\fB#\fR systemtap-service onboot myscript \
>   -o /boot/special_initramfs.img
.ESAMPLE
پس از ایجاد initramfs، کافی است گزینه‌های خط فرمان را در زمان بوت تغییر دهیم تا تصویر جدید به جای تصویر همیشگی استفاده شود.

.TP
.B "ایجاد INITRAMFS برای یک هسته دیگر (CREATING AN INITRAMFS FOR A DIFFERENT KERNEL)"
درست همانند دستور compile، می‌توانیم از گزینه
\fB-r\fR
برای مشخص کردن هسته‌ای که می‌خواهیم initramfs را برای آن بسازیم استفاده کنیم. این گزینه زمانی مفید است که قصد ارتقا داریم و می‌خواهیم از قبل آماده باشیم. به عنوان مثال:
.SAMPLE
\fB#\fR systemtap-service onboot myscript \
>   -r 3.12.6-200.fc19.x86_64
.ESAMPLE

.TP
.B "حذف اسکریپت‌ها از INITRAMFS (REMOVING SCRIPTS FROM THE INITRAMFS)"
در نهایت، برای حذف تمام اسکریپت‌ها از initramfs، کافی است دستور
\fBonboot\fR
را بدون مشخص کردن هیچ اسکریپتی اجرا کنیم:
.SAMPLE
\fB#\fR systemtap-service onboot
.ESAMPLE
این کار صرفاً یک initramfs استاندارد و بدون هیچ‌گونه ماژول تعبیه‌شده SystemTap ایجاد خواهد کرد.

.TP
.B "عیب‌یابی مشکلات بوت اولیه (TROUBLESHOOTING EARLY-BOOT ISSUES)"
دلایل زیادی می‌تواند وجود داشته باشد که چرا ماژول درج نشده یا مطابق انتظار کار نکرده است. فعال کردن عیب‌یابی dracut با افزودن 'rdinitdebug' به خط فرمان هسته و بررسی dmesg/journalctl -ae می‌تواند مفید باشد. همچنین، خروجی خطای استاندارد (stderr) مربوط به staprun را می‌توان با تنظیم گزینه LOG_BOOT_ERR روی
\fByes\fR
ذخیره کرد.

.SH "همچنین ببینید (SEE ALSO)"
.IR stap (1)
.IR dracut (8)
.IR new-kernel-pkg (8)

.SH "اشکالات (BUGS)"
از پیوند باگزیلا در صفحه وب پروژه یا فهرست پستی ما استفاده کنید.
.nh
.BR http://sourceware.org/systemtap ", " <systemtap@sourceware.org> .
.hy