.\" -*- coding: UTF-8 -*-
.if \n(.g .ds T< \\FC
.if \n(.g .ds T> \\F[\n[.fam]]
.de URL
\\$2 \(la\\$1\(ra\\$3
..
.if \n(.g .mso www.tmac
.TH lxc-stop 1 2026-08-01 "" ""
.SH "نام (NAME)"
lxc-stop \- متوقف کردن برنامه در حال اجرا درون یک کانتینر
.SH "خلاصه دستور (SYNOPSIS)"
'nh
.fi
.ad l
\fBlxc-stop\fR \kx
.if (\nx>(\n(.l/2)) .nr x (\n(.l/5)
'in \n(.iu+\nxu
{-n \fIname\fR} [-W] [-r] [-t \fItimeout\fR] [-k] [--nokill] [--nolock]
'in \n(.iu-\nxu
.ad b
'hy
.SH "توضیحات (DESCRIPTION)"
دستور \fBlxc-stop\fR تمامی فرآیندهای درون کانتینر را بازراه‌اندازی (reboot) کرده، به‌صورت تمیز خاموش می‌کند (clean shutdown)، یا آن‌ها را به اجبار متوقف می‌کند (kill). به‌طور پیش‌فرض، این دستور با ارسال \fBlxc.signal.halt\fR (پیش‌فرض SIGPWR) به فرآیند init کانتینر، درخواست خاموش‌سازی تمیز را صادر کرده، حداکثر تا ۶۰ ثانیه برای خروج کانتینر منتظر می‌ماند و سپس بازمی‌گردد. اگر کانتینر ظرف ۶۰ ثانیه به‌صورت تمیز خارج نشود، سیگنال \fBlxc.signal.stop\fR (پیش‌فرض SIGKILL) برای اجبار به خاموش شدن به آن ارسال خواهد شد. درخواست بازراه‌اندازی نیز سیگنال \fBlxc.signal.reboot\fR (پیش‌فرض SIGINT) را به فرآیند init کانتینر ارسال می‌کند.
.PP
گزینه‌های [-W]، [-r]، [-k] و [--nokill] عملیات اجرایی را تعیین می‌کنند. گزینه [-W] نشان می‌دهد که پس از انجام عمل مشخص‌شده، \fBlxc-stop\fR باید بلافاصله خارج شود، در حالی که گزینه [-t TIMEOUT] حداکثر مدت‌زمان انتظار برای تکمیل فرایند خاموش‌سازی یا بازراه‌اندازی کانتینر را مشخص می‌کند.
.SH "گزینه‌ها (OPTIONS)"
.TP 
\*(T<\fB\-r,\-\-reboot \fR\*(T>
درخواست بازراه‌اندازی کانتینر.
.TP 
\*(T<\fB\-k,\-\-kill \fR\*(T>
به جای درخواست خاموش‌سازی تمیز کانتینر، صراحتاً تمام وظایف (tasks) موجود در کانتینر را می‌کشد (kill). این رفتار سنتی و قدیمی \fBlxc-stop\fR است.
.TP 
\*(T<\fB\-\-nokill\fR\*(T> 
تنها درخواست خاموش‌سازی تمیز را ارسال می‌کند و در صورت عدم موفقیت در خاموش‌سازی تمیز، وظایف کانتینر را با kill متوقف نمی‌کند.
.TP 
\*(T<\fB\-\-nolock \fR\*(T>
این گزینه از اعمال هرگونه قفل‌گذاری در API lxc جلوگیری می‌کند و تنها در حالتی باید استفاده شود که \fBlxc-stop\fR به دلیل وضعیت نامناسب سیستم معلق (hang) شده باشد.
.TP 
\*(T<\fB\-W,\-\-nowait \fR\*(T>
صرفاً عمل درخواستی (بازراه‌اندازی، خاموش‌سازی یا توقف اجباری) را انجام داده و بلافاصله خارج می‌شود.
.TP 
\*(T<\fB\-t,\-\-timeout \fR\*(T>\fITIMEOUT\fR 
به مدت TIMEOUT ثانیه پیش از متوقف کردن اجباری (hard-stop) کانتینر منتظر می‌ماند.
.SH "وضعیت خروج (EXIT STATUS)"
.TP 
0
کانتینر با موفقیت متوقف شد.
.TP 
1
هنگام متوقف کردن کانتینر خطایی رخ داد.
.TP 
2
کانتینر مشخص‌شده وجود دارد اما در حال اجرا نبود.
.SH "خطاها (DIAGNOSTICS)"
.TP 
The container was not found
کانتینر مشخص‌شده قبلاً با استفاده از دستور \fBlxc-create\fR ایجاد نشده است.
.SH "همچنین ببینید (SEE ALSO)"
\fBlxc\fR(7),
\fBlxc-create\fR(1),
\fBlxc-copy\fR(1),
\fBlxc-destroy\fR(1),
\fBlxc-start\fR(1),
\fBlxc-stop\fR(1),
\fBlxc-execute\fR(1),
\fBlxc-console\fR(1),
\fBlxc-monitor\fR(1),
\fBlxc-wait\fR(1),
\fBlxc-cgroup\fR(1),
\fBlxc-ls\fR(1),
\fBlxc-info\fR(1),
\fBlxc-freeze\fR(1),
\fBlxc-unfreeze\fR(1),
\fBlxc-attach\fR(1),
\fBlxc.conf\fR(5)