.TH KILLTREE 1 "8 اکتبر 2026" "Parch Linux" "دستورات کاربر"
.SH "نام (NAME)"
killtree \- خاتمه دادن و متوقف‌سازی یک فرآیند به همراه تمامی فرزندان آن در درخت فرآیند
.SH "خلاصه دستور (SYNOPSIS)"
.B killtree
[\fIگزینه‌ها\fR]
.I شناسه_پردازش...
.br
.B killtree
[\fB\-s\fR \fIسیگنال\fR | \fB\-\fR\fIسیگنال\fR]
.I شناسه_پردازش...
.SH "توضیحات (DESCRIPTION)"
دستور
.B killtree
یک ابزار سیستمی برای ارسال سیگنال خاتمه به یک فرآیند ریشه (مشخص‌شده با
.IR شناسه_پردازش )
و به صورت بازگشتی به تمامی زیرفرآیندها و فرزندان آن در درخت سلسله‌مراتبی پردازش‌ها است.
این دستور تضمین می‌کند که هیچ پردازش یتیم یا فرآیند پس‌زمینه‌ای وابسته به پردازش اصلی در حال اجرا باقی نماند.
.PP
به طور پیش‌فرض، سیگنال
.B SIGTERM
(سیگنال شماره ۱۵) ارسال می‌شود تا به برنامه‌ها فرصت داده شود منابع خود را پاکسازی کرده و به شکل امن بسته شوند. در صورت نیاز می‌توان با گزینه‌های مربوطه سیگنال‌های دیگری مانند
.B SIGKILL
(سیگنال شماره ۹) را ارسال نمود.
.SH "گزینه‌ها (OPTIONS)"
.TP
.BI \-s " سیگنال" "\fR, \fB\-\-signal " سیگنال
تعیین نام یا شماره سیگنالی که باید به درخت پردازش ارسال شود (مانند
.BR SIGKILL ،
.B SIGTERM
یا شماره سیگنال مانند
.BR 9 ).
.TP
.BR \-f ", " \-\-force
ارسال اجباری سیگنال
.B SIGKILL
به کل درخت فرآیند جهت متوقف‌سازی فوری و بدون معطلی پردازش‌ها.
.TP
.BR \-v ", " \-\-verbose
حالت پرحرف؛ نمایش شناسه‌های پردازش (PID) و نام فرآیندهایی که سیگنال دریافت می‌کنند به همراه سلسله‌مراتب درختی.
.TP
.BR \-q ", " \-\-quiet
حالت بی‌صدا؛ سرکوب پیام‌های هشدار و خطاهای مربوط به پردازش‌هایی که پیش از دریافت سیگنال بسته شده‌اند.
.TP
.BR \-h ", " \-\-help
نمایش راهنمای استفاده از دستور و خروج.
.TP
.BR \-V ", " \-\-version
نمایش اطلاعات نگارش برنامه و خروج.
.SH "مثال‌ها (EXAMPLES)"
.PP
خاتمه دادن به پردازش شماره 1234 و تمامی فرزندان آن با سیگنال پیش‌فرض TERM:
.PP
.RS
.nf
$ killtree 1234
.fi
.RE
.PP
ارسال سیگنال اجباری KILL (شماره ۹) به فرآیند و کلیه فرزندان:
.PP
.RS
.nf
$ killtree -s 9 1234
.fi
.RE
.PP
اجرای با جزئیات کامل و نمایش درخت فرآیندهای متوقف‌شده:
.PP
.RS
.nf
$ killtree -v 1234
.fi
.RE
.SH "همچنین ببینید (SEE ALSO)"
.BR kill (1),
.BR killall (1),
.BR pkill (1),
.BR pstree (1),
.BR ps (1),
.BR signal (7)