'\" t
.TH "SYSTEMD\-DEBUG\-GENERATOR" "8" "" "systemd 261.2" "systemd-debug-generator"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "نام (NAME)"
systemd-debug-generator \- تولیدکننده فعال‌سازی شل اشکال‌زدایی و تنظیمات دیباگ در زمان بوت
.SH "خلاصه دستور (SYNOPSIS)"
.PP
/usr/lib/systemd/system\-generators/systemd\-debug\-generator
.SH "توضیحات (DESCRIPTION)"
.PP
\fBsystemd\-debug\-generator\fR
تولیدکننده‌ای است که برخی قابلیت‌های اشکال‌زدایی (دیباگ) را فراهم می‌کند\&.
.PP
\fBsystemd\-debug\-generator\fR
از
\fBsystemd.generator\fR(7)
پیروی و آن را پیاده‌سازی می‌کند\&.
.SH "خط فرمان کرنل (KERNEL COMMAND LINE)"
.PP
\fBsystemd\-debug\-generator\fR
پارامترهای خط فرمان هسته (کرنل) زیر را درک می‌کند:
.PP
\fIsystemd\&.mask=\fR, \fIrd\&.systemd\&.mask=\fR
.RS 4
این گزینه‌ها نام یک واحد (unit) را به عنوان آرگومان دریافت می‌کنند\&. واحد مشخص‌شده برای زمان اجرا (یعنی برای این نشست \(em از زمان بوت تا خاموش شدن سیستم) ماسک (غیرفعال) می‌شود، مشابه با اثری که دستور
\fBmask\fR
در
\fBsystemctl\fR(1)
دارد\&. این ویژگی برای بوت کردن سیستم در حالی که برخی واحدها به منظور اشکال‌زدایی راه‌اندازی سیستم از تراکنش اولیه بوت حذف شده‌اند مفید است\&. این گزینه می‌تواند بیش از یک بار مشخص شود\&. گزینه‌ای که دارای پیشوند
"rd\&."
است فقط در initrd اعمال می‌شود، در حالی که گزینه بدون پیشوند تنها روی سیستم میزبان اعمال می‌گردد\&.
.sp
افزوده‌شده در نسخه 215\&.
.RE
.PP
\fIsystemd\&.wants=\fR, \fIrd\&.systemd\&.wants=\fR
.RS 4
این گزینه‌ها نام یک واحد را به عنوان آرگومان دریافت می‌کنند\&. یک کار شروع (start job) برای این واحد به تراکنش اولیه اضافه می‌شود\&. این ویژگی برای راه‌اندازی یک یا چند واحد اضافی هنگام بوت مفید است\&. این گزینه می‌تواند بیش از یک بار مشخص شود\&. گزینه‌ای که با پیشوند
"rd\&."
مشخص شده است فقط در initrd اعمال می‌شود، در حالی که گزینه بدون پیشوند تنها روی سیستم میزبان اعمال می‌گردد\&.
.sp
افزوده‌شده در نسخه 215\&.
.RE
.PP
\fIsystemd\&.debug_shell\fR, \fIrd\&.systemd\&.debug_shell\fR, \fIsystemd\&.default_debug_tty=\fR, \fIrd\&.systemd\&.default_debug_tty=\fR
.RS 4
اگر گزینه
\fBsystemd\&.debug_shell\fR
یا
\fBrd\&.systemd\&.debug_shell\fR
مشخص شود، سرویس شل اشکال‌زدایی
"debug\-shell\&.service"
به داخل تراکنش بوت آورده می‌شود و یک شل اشکال‌زدایی در مراحل اولیه بوت اجرا خواهد شد\&. به‌طور پیش‌فرض،
/dev/tty9
استفاده می‌شود، اما یک tty خاص نیز می‌تواند با پیشوند
/dev/
یا بدون آن مشخص شود\&. برای تنظیم tty مورد استفاده بدون فعال‌سازی شل اشکال‌زدایی، می‌توان از گزینه
\fBsystemd\&.default_debug_tty=\fR
استفاده کرد که آن نیز یک tty را با پیشوند
/dev/
یا بدون آن دریافت می‌کند\&. توجه داشته باشید که این شل را می‌توان با فعال‌سازی از طریق دستور
\fBenable\fR
در
\fBsystemctl\fR(1)
به‌صورت دائمی نیز فعال کرد\&. گزینه‌های دارای پیشوند
"rd\&."
فقط در initrd اعمال می‌شوند، در حالی که گزینه‌های بدون پیشوند تنها روی سیستم میزبان معتبر هستند\&.
.sp
افزوده‌شده در نسخه 215\&.
.RE
.PP
\fIsystemd\&.break=\fR, \fIrd\&.systemd\&.break=\fR
.RS 4
یکی از مقادیر
\fBpre\-udev\fR،
\fBpre\-basic\fR،
\fBpre\-mount\fR
یا
\fBpre\-switch\-root\fR
(مقدار پیش‌فرض برای گزینه
"rd\&.")
را می‌پذیرد\&. همچنین چندین مقدار جداشده با کاما (",") را نیز می‌پذیرد\&. این گزینه‌ها امکان متوقف کردن موقت فرآیند بوت در یک نقطه مشخص و اجرای یک شل اشکال‌زدایی را فراهم می‌کنند\&. پس از خروج از این شل، سیستم فرآیند بوت را ادامه خواهد داد\&. گزینه دارای پیشوند
"rd\&."
تنها در initrd اعمال می‌شود، در حالی که گزینه بدون پیشوند فقط روی سیستم میزبان معتبر است\&.
.sp
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.B جدول\ \&1.\ \&نقاط توقف (Breakpoints) موجود
.TS
allbox tab(:);
lB lB lB lB.
T{
نقاط توقف (Breakpoints)
T}:T{
توضیحات
T}:T{
قابل استفاده در initrd
T}:T{
قابل استفاده روی سیستم میزبان
T}
.T&
l l l l
l l l l
l l l l
l l l l.
T{
\fBpre\-udev\fR
T}:T{
پیش از آغاز پردازش رویدادهای uevent هسته، یعنی پیش از شروع systemd\-udevd\&.service\&.
T}:T{
✓
T}:T{
✓
T}
T{
\fBpre\-basic\fR
T}:T{
پیش از خروج از مراحل اولیه بوت و آغاز سرویس‌های عادی، یعنی پیش از رسیدن به basic\&.target\&.
T}:T{
✓
T}:T{
✓
T}
T{
\fBpre\-mount\fR
T}:T{
پیش از سوار شدن (mount) فایل‌سیستم ریشه، یعنی پیش از شروع sysroot\&.mount\&.
T}:T{
✓
T}:T{
✗
T}
T{
\fBpre\-switch\-root\fR
T}:T{
پیش از جابه‌جایی و تغییر از initrd به ریشه اصلی سیستم\&.
T}:T{
✓
T}:T{
✗
T}
.TE
.sp 1
افزوده‌شده در نسخه 258\&.
.RE
.SH "اعتبارنامه‌های سیستم (SYSTEM CREDENTIALS)"
.PP
\fIsystemd\&.extra\-unit\&.*\fR
.RS 4
اعتبارنامه‌هایی با پیشوند
"systemd\&.extra\-unit\&."
واحدهای اضافی را برای افزودن به سیستم نهایی مشخص می‌کنند\&. توجه داشته باشید که این واحدهای اضافی هم به initrd و هم به سیستم نهایی اضافه می‌شوند\&.
\fIConditionPathExists=!/etc/initrd\-release\fR
می‌تواند برای اطمینان از این که واحد در initrd نادیده گرفته می‌شود (شرط آن برقرار نیست) استفاده شود\&. توجه داشته باشید که با مشخص کردن یک مقدار خالی، می‌توان از این ویژگی برای ماسک کردن واحدها نیز استفاده کرد\&.
.sp
افزوده‌شده در نسخه 256\&.
.RE
.PP
\fIsystemd\&.unit\-dropin\&.*\fR
.RS 4
اعتبارنامه‌هایی با پیشوند
"systemd\&.unit\-dropin\&."
فایل‌های drop\-in را برای واحدهای متناظر در سیستم نهایی اضافه می‌کنند\&. هر اعتبارنامه باید با نام کامل واحد شامل پسوند واحد پسوندگذاری شود\&. محتوای آن باید یک فایل معتبر drop\-in واحد باشد\&. به‌طور اختیاری، نام واحد می‌تواند با
"~"،
و به دنبال آن نام drop\-in بدون پسوند
"\&.conf"
بیاید\&. اگر مشخص نشود، نام drop\-in تولیدشده
"50\-credential\&.conf"
خواهد بود\&. توجه داشته باشید که این drop\-inهای اضافی هم به initrd و هم به سیستم نهایی اضافه می‌شوند\&.
.sp
افزوده‌شده در نسخه 256\&.
.RE
.SH "همچنین ببینید (SEE ALSO)"
.PP
\fBsystemd\fR(1), \fBsystemctl\fR(1), \fBkernel-command-line\fR(7), \fBsystemd.system-credentials\fR(7), \fBbootup\fR(7)