نام (NAME)

lxc-stop - متوقف کردن برنامه در حال اجرا درون یک کانتینر

خلاصه دستور (SYNOPSIS)

lxc-stop
{-n name} [-W] [-r] [-t timeout] [-k] [--nokill] [--nolock]

توضیحات (DESCRIPTION)

دستور lxc-stop تمامی فرآیندهای درون کانتینر را بازراه‌اندازی (reboot) کرده، به‌صورت تمیز خاموش می‌کند (clean shutdown)، یا آن‌ها را به اجبار متوقف می‌کند (kill). به‌طور پیش‌فرض، این دستور با ارسال lxc.signal.halt (پیش‌فرض SIGPWR) به فرآیند init کانتینر، درخواست خاموش‌سازی تمیز را صادر کرده، حداکثر تا ۶۰ ثانیه برای خروج کانتینر منتظر می‌ماند و سپس بازمی‌گردد. اگر کانتینر ظرف ۶۰ ثانیه به‌صورت تمیز خارج نشود، سیگنال lxc.signal.stop (پیش‌فرض SIGKILL) برای اجبار به خاموش شدن به آن ارسال خواهد شد. درخواست بازراه‌اندازی نیز سیگنال lxc.signal.reboot (پیش‌فرض SIGINT) را به فرآیند init کانتینر ارسال می‌کند.

گزینه‌های [-W]، [-r]، [-k] و [--nokill] عملیات اجرایی را تعیین می‌کنند. گزینه [-W] نشان می‌دهد که پس از انجام عمل مشخص‌شده، lxc-stop باید بلافاصله خارج شود، در حالی که گزینه [-t TIMEOUT] حداکثر مدت‌زمان انتظار برای تکمیل فرایند خاموش‌سازی یا بازراه‌اندازی کانتینر را مشخص می‌کند.

گزینه‌ها (OPTIONS)

-r,--reboot: درخواست بازراه‌اندازی کانتینر.
-k,--kill: به جای درخواست خاموش‌سازی تمیز کانتینر، صراحتاً تمام وظایف (tasks) موجود در کانتینر را می‌کشد (kill). این رفتار سنتی و قدیمی lxc-stop است.
--nokill: تنها درخواست خاموش‌سازی تمیز را ارسال می‌کند و در صورت عدم موفقیت در خاموش‌سازی تمیز، وظایف کانتینر را با kill متوقف نمی‌کند.
--nolock: این گزینه از اعمال هرگونه قفل‌گذاری در API lxc جلوگیری می‌کند و تنها در حالتی باید استفاده شود که lxc-stop به دلیل وضعیت نامناسب سیستم معلق (hang) شده باشد.
-W,--nowait: صرفاً عمل درخواستی (بازراه‌اندازی، خاموش‌سازی یا توقف اجباری) را انجام داده و بلافاصله خارج می‌شود.
-t,--timeout TIMEOUT: به مدت TIMEOUT ثانیه پیش از متوقف کردن اجباری (hard-stop) کانتینر منتظر می‌ماند.

وضعیت خروج (EXIT STATUS)

0: کانتینر با موفقیت متوقف شد.
1: هنگام متوقف کردن کانتینر خطایی رخ داد.
2: کانتینر مشخص‌شده وجود دارد اما در حال اجرا نبود.

خطاها (DIAGNOSTICS)

The container was not found: کانتینر مشخص‌شده قبلاً با استفاده از دستور lxc-create ایجاد نشده است.

همچنین ببینید (SEE ALSO)

lxc(7), lxc-create(1), lxc-copy(1), lxc-destroy(1), lxc-start(1), lxc-stop(1), lxc-execute(1), lxc-console(1), lxc-monitor(1), lxc-wait(1), lxc-cgroup(1), lxc-ls(1), lxc-info(1), lxc-freeze(1), lxc-unfreeze(1), lxc-attach(1), lxc.conf(5)