2016-10-14 18:30:36 -04:00
|
|
|
|
---
|
|
|
|
|
title: "kill"
|
|
|
|
|
description: "The kill command description and usage"
|
2016-11-03 18:48:30 -04:00
|
|
|
|
keywords: "container, kill, signal"
|
2016-10-14 18:30:36 -04:00
|
|
|
|
---
|
2015-06-21 16:41:38 -04:00
|
|
|
|
|
2017-07-28 13:28:23 -04:00
|
|
|
|
<!-- This file is maintained within the docker/cli Github
|
|
|
|
|
repository at https://github.com/docker/cli/. Make all
|
2016-10-19 13:25:45 -04:00
|
|
|
|
pull requests against that repo. If you see this file in
|
|
|
|
|
another repository, consider it read-only there, as it will
|
|
|
|
|
periodically be overwritten by the definitive file. Pull
|
|
|
|
|
requests which include edits to this file in other repositories
|
|
|
|
|
will be rejected.
|
|
|
|
|
-->
|
|
|
|
|
|
2015-06-21 16:41:38 -04:00
|
|
|
|
# kill
|
|
|
|
|
|
2016-07-07 14:43:18 -04:00
|
|
|
|
```markdown
|
|
|
|
|
Usage: docker kill [OPTIONS] CONTAINER [CONTAINER...]
|
2015-06-21 16:41:38 -04:00
|
|
|
|
|
2016-07-29 13:41:52 -04:00
|
|
|
|
Kill one or more running containers
|
2015-06-21 16:41:38 -04:00
|
|
|
|
|
2016-07-07 14:43:18 -04:00
|
|
|
|
Options:
|
|
|
|
|
--help Print usage
|
|
|
|
|
-s, --signal string Signal to send to the container (default "KILL")
|
|
|
|
|
```
|
2015-06-21 16:41:38 -04:00
|
|
|
|
|
2017-02-07 18:42:48 -05:00
|
|
|
|
## Description
|
|
|
|
|
|
2015-06-21 16:41:38 -04:00
|
|
|
|
The main process inside the container will be sent `SIGKILL`, or any
|
|
|
|
|
signal specified with option `--signal`.
|
2015-10-28 14:06:21 -04:00
|
|
|
|
|
2017-02-07 18:42:48 -05:00
|
|
|
|
> **Note**: `ENTRYPOINT` and `CMD` in the *shell* form run as a subcommand of
|
|
|
|
|
> `/bin/sh -c`, which does not pass signals. This means that the executable is
|
|
|
|
|
> not the container’s PID 1 and does not receive Unix signals.
|