'\" t
.nh
.TH podman-stop 1
.SH "نام (NAME)"
podman-stop \- متوقف کردن یک یا چند کانتینر در حال اجرا

.SH "خلاصه دستور (SYNOPSIS)"
\fBpodman stop\fP [\fIoptions\fP] \fIcontainer\fP ...

.PP
\fBpodman container stop\fP [\fIoptions\fP] \fIcontainer\fP ...

.SH "توضیحات (DESCRIPTION)"
یک یا چند کانتینر را با استفاده از شناسه (ID) یا نام کانتینر به عنوان ورودی متوقف می‌کند. گزینه \fB--time\fP
تعداد ثانیه‌های انتظار پیش از توقف اجباری کانتینر پس از صدور دستور توقف به آن را مشخص می‌کند. مقدار پیش‌فرض ۱۰ ثانیه است.
به‌طور پیش‌فرض، کانتینرها ابتدا با سیگنال SIGTERM متوقف می‌شوند و پس از پایان مهلت زمانی با SIGKILL خاتمه می‌یابند.
مقدار پیش‌فرض SIGTERM می‌تواند توسط ایمیج سازنده کانتینر و همچنین از طریق خط فرمان در زمان ساخت کانتینر بازنویسی شود.

.SH "گزینه‌ها (OPTIONS)"
.SS \fB--all\fP, \fB-a\fP
متوقف کردن تمام کانتینرهای در حال اجرا. این گزینه شامل کانتینرهای متوقف‌شده موقت (paused) نمی‌شود.

.SS \fB--cidfile\fP=\fIfile\fP
خواندن شناسه کانتینر از \fIfile\fP مشخص‌شده و متوقف کردن آن کانتینر.
می‌تواند چندین بار مشخص شود.

.PP
در صورتی که \fIfile\fP وجود نداشته باشد و کاربر گزینه \fB--ignore\fP را مشخص کرده باشد، دستور با خطا مواجه نمی‌شود.

.SS \fB--filter\fP, \fB-f\fP=\fIfilter\fP
فیلتر کردن کانتینرهایی که باید متوقف شوند.
با چند بار استفاده از فلگ \fB--filter\fP می‌توان چندین فیلتر را تعیین کرد.
فیلترهای دارای کلید یکسان به صورت فراگیر (OR) عمل می‌کنند، به استثنای
\fBlabel\fR که انحصاری (AND) است. فیلترهای با کلیدهای مختلف همیشه به صورت انحصاری عمل می‌کنند.

.PP
فیلترهای معتبر در زیر فهرست شده‌اند:

.TS
allbox;
l l 
l l .
\fB\fBFilter\fP\fP	\fB\fBDescription\fP\fP
id	T{
[ID] شناسه کانتینر (تطبیق پیشوند CID به‌طور پیش‌فرض؛ رجکس را می‌پذیرد)
T}
name	T{
[Name] نام کانتینر (رجکس را می‌پذیرد)
T}
annotation	T{
[Key] یا [Key=Value] یادداشت اختصاص‌یافته به یک کانتینر
T}
annotation!	T{
[Key] یا [Key=Value] یادداشتی که به کانتینر اختصاص نیافته است
T}
label	T{
[Key] یا [Key=Value] برچسب اختصاص‌یافته به یک کانتینر
T}
label!	T{
[Key] یا [Key=Value] برچسبی که به کانتینر اختصاص نیافته است
T}
exited	[Int] کد خروج کانتینر
status	T{
[Status] وضعیت کانتینر: 'created' ،'initialized' ،'running' ،'stopped' ،'paused' ،'exited' ،'removing' ،'stopping' ،'unknown'
T}
ancestor	T{
[ImageName] ایمیج یا والدی که برای ساخت کانتینر استفاده شده (رجکس را می‌پذیرد)
T}
before	T{
[ID] یا [Name] کانتینرهایی که قبل از این کانتینر ساخته شده‌اند
T}
since	T{
[ID] یا [Name] کانتینرهایی که پس از این کانتینر ساخته شده‌اند
T}
volume	T{
[VolumeName] یا [MountpointDestination] ولوم متصل‌شده در کانتینر
T}
health	[Status] سالم (healthy) یا ناسالم (unhealthy)
pod	T{
[Pod] نام یا شناسه کامل یا جزئی پاد
T}
network	T{
[Network] نام یا شناسه کامل شبکه
T}
restart-policy	T{
[Policy] سیاست راه‌اندازی مجدد کانتینر (مانند 'no' ،'on-failure' ،'always' ،'unless-stopped')
T}
until	T{
[DateTime] کانتینرهای ساخته‌شده پیش از مدت‌زمان یا زمان مشخص‌شده
T}
command	T{
[Command] دستوری که کانتینر اجرا می‌کند، تنها argv[0] در نظر گرفته می‌شود
T}
should-start-on-boot	T{
[Bool] کانتینرهایی که پس از راه‌اندازی مجدد سیستم باید ری‌استارت شوند. برای کانتینرهای با سیاست 'always' یا 'unless-stopped' که صراحتاً توسط کاربر متوقف نشده‌اند برابر با True است
T}
.TE

.SS \fB--ignore\fP, \fB-i\fP
نادیده گرفتن خطاها در صورتی که کانتینرهای مشخص‌شده در مخزن کانتینر وجود نداشته باشند. ممکن است
کاربر تصمیم گرفته باشد کانتینری را به صورت دستی حذف کند که منجر به شکست
در دستور ExecStop سرویس systemd ارجاع‌دهنده به آن کانتینر شود.

.SS \fB--latest\fP, \fB-l\fP
به جای ارائه نام یا شناسه کانتینر، از آخرین کانتینر ساخته‌شده استفاده شود.
نکته: آخرین کانتینر راه‌اندازی‌شده می‌تواند متعلق به کاربران دیگر پادمن بر روی ماشین میزبان باشد.
(این گزینه در کلاینت ریموت پادمن، از جمله ماشین‌های مک و ویندوز (به‌جز WSL2) در دسترس نیست)

.SS \fB--time\fP, \fB-t\fP=\fIseconds\fP
مدت‌زمان انتظار به ثانیه پیش از متوقف کردن اجباری کانتینر.
از مقدار -1 برای انتظار نامحدود استفاده کنید.

.SH "مثال‌ها (EXAMPLES)"
متوقف کردن کانتینر مشخص‌شده از طریق نام آن:

.EX
$ podman stop mywebserver
.EE

.PP
متوقف کردن کانتینر از طریق شناسه آن:

.EX
$ podman stop 860a4b235279
.EE

.PP
متوقف کردن چندین کانتینر:

.EX
$ podman stop mywebserver 860a4b235279
.EE

.PP
متوقف کردن کانتینر مشخص‌شده در cidfile:

.EX
$ podman stop --cidfile /home/user/cidfile-1
.EE

.PP
متوقف کردن کانتینرهای مشخص‌شده در چندین فایل cidfile:

.EX
$ podman stop --cidfile /home/user/cidfile-1 --cidfile ./cidfile-2
.EE

.PP
متوقف کردن کانتینر مشخص‌شده ظرف ۲ ثانیه:

.EX
$ podman stop --time 2 860a4b235279
.EE

.PP
متوقف کردن تمام کانتینرهای در حال اجرا:

.EX
$ podman stop -a
.EE

.PP
متوقف کردن آخرین کانتینر ساخته‌شده (این گزینه در کلاینت ریموت پادمن از جمله ماشین‌های مک و ویندوز (به‌جز WSL2) در دسترس نیست):

.EX
$ podman stop --latest
.EE

.PP
متوقف کردن بر اساس برچسب (label):

.EX
$ podman stop --filter label=app=frontend
9351ccb3ef4272532bc0c188bd4f0ddfc2b0de217732cd108259ea126b014647
.EE

.PP
متوقف کردن بر اساس نام:

.EX
$ podman stop --filter name=db-replica
6c2680da61d54690718ac3aecdb04a8aad95ae353e42cc942736823bd05c8a1d
.EE

.PP
متوقف کردن بر اساس برچسب نقش (role):

.EX
$ podman stop --filter label=role=primary
bb3ff91d969a8dc622d627e4a8d76c18bdbd417d317c5e7e66543c0b0c8ed1e8
.EE

.SH "همچنین ببینید (SEE ALSO)"
\fBpodman(1)\fP, \fBpodman-rm(1)\fP

.SH "تاریخچه (HISTORY)"
سپتامبر ۲۰۱۸، در ابتدا توسط Brent Baude گردآوری شد bbaude@redhat.com
\[la]mailto:bbaude@redhat.com\[ra]