NAME | SYNOPSIS | DESCRIPTION | OPTIONS | EXIT VALUE | DIAGNOSTIC | SEE ALSO | AUTHOR | COLOPHON

LXC-STOP(1)                                                      LXC-STOP(1)

NAME         top

       lxc-stop - stop the application running inside a container

SYNOPSIS         top

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

DESCRIPTION         top

       lxc-stop reboots, cleanly shuts down, or kills all the processes
       inside the container. By default, it will request a clean shutdown of
       the container by sending lxc.haltsignal (defaults to SIGPWR) to the
       container's init process, waiting up to 60 seconds for the container
       to exit, and then returning. If the container fails to cleanly exit
       in 60 seconds, it will be sent the lxc.stopsignal (defaults to
       SIGKILL) to force it to shut down. A request to reboot will send the
       lxc.rebootsignal (defaults to SIGINT) to the container's init
       process.

       The [-W], [-r], [-k] and [--nokill] options specify the action to
       perform.  [-W] indicates that after performing the specified action,
       lxc-stop should immediately exit, while [-t TIMEOUT] specifies the
       maximum amount of time to wait for the container to complete the
       shutdown or reboot.

OPTIONS         top

       -r,--reboot
              Request a reboot of the container.

       -k,--kill
              Rather than requesting a clean shutdown of the container,
              explicitly kill all tasks in the container. This is the legacy
              lxc-stop behavior.

       --nokill
              Only request a clean shutdown, do not kill the container tasks
              if the clean shutdown fails.

       --nolock
              This option avoids the use of any of the API lxc locking, and
              should only be used if lxc-stop is hanging due to a bad system
              state.

       -W,--nowait
              Simply perform the requestion action (reboot, shutdown, or
              hard kill) and exit.

       -t,--timeout TIMEOUT
              Wait TIMEOUT seconds before hard-stopping the container.

EXIT VALUE         top

       0      The container was successfully stopped.

       1      An error occurred while stopping the container.

       2      The specified container exists but was not running.

DIAGNOSTIC         top

       The container was not found
              The specified container was not created before with the lxc-
              create command.

SEE ALSO         top

       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)

AUTHOR         top

       Daniel Lezcano <daniel.lezcano@free.fr>

COLOPHON         top

       This page is part of the lxc (Linux containers) project.  Information
       about the project can be found at ⟨http://linuxcontainers.org/⟩.  If
       you have a bug report for this manual page, send it to
       lxc-devel@lists.linuxcontainers.org.  This page was obtained from the
       project's upstream Git repository ⟨git://github.com/lxc/lxc⟩ on
       2017-03-13.  If you discover any rendering problems in this HTML ver‐
       sion of the page, or you believe there is a better or more up-to-date
       source for the page, or you have corrections or improvements to the
       information in this COLOPHON (which is not part of the original man‐
       ual page), send a mail to man-pages@man7.org

                                 2017-03-13                      LXC-STOP(1)