mirror of
https://github.com/docker/cli.git
synced 2025-08-29 00:47:54 +03:00
f30bde6adb
these markdown files are not consumed directly in the docs, but only their content is included through the YAML does, so there's no need to have these comments in them Signed-off-by: Sebastiaan van Stijn <github@gone.nl>
63 lines
1.6 KiB
Markdown
63 lines
1.6 KiB
Markdown
---
|
||
title: "kill"
|
||
description: "The kill command description and usage"
|
||
keywords: "container, kill, signal"
|
||
---
|
||
|
||
# kill
|
||
|
||
```markdown
|
||
Usage: docker kill [OPTIONS] CONTAINER [CONTAINER...]
|
||
|
||
Kill one or more running containers
|
||
|
||
Options:
|
||
--help Print usage
|
||
-s, --signal string Signal to send to the container (default "KILL")
|
||
```
|
||
|
||
## Description
|
||
|
||
The `docker kill` subcommand kills one or more containers. The main process
|
||
inside the container is sent `SIGKILL` signal (default), or the signal that is
|
||
specified with the `--signal` option. You can kill a container using the
|
||
container's ID, ID-prefix, or name.
|
||
|
||
> **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.
|
||
|
||
## Examples
|
||
|
||
|
||
### Send a KILL signal to a container
|
||
|
||
The following example sends the default `KILL` signal to the container named
|
||
`my_container`:
|
||
|
||
```bash
|
||
$ docker kill my_container
|
||
```
|
||
|
||
### Send a custom signal to a container
|
||
|
||
The following example sends a `SIGHUP` signal to the container named
|
||
`my_container`:
|
||
|
||
```bash
|
||
$ docker kill --signal=SIGHUP my_container
|
||
```
|
||
|
||
|
||
You can specify a custom signal either by _name_, or _number_. The `SIG` prefix
|
||
is optional, so the following examples are equivalent:
|
||
|
||
```bash
|
||
$ docker kill --signal=SIGHUP my_container
|
||
$ docker kill --signal=HUP my_container
|
||
$ docker kill --signal=1 my_container
|
||
```
|
||
|
||
Refer to the [`signal(7)`](http://man7.org/linux/man-pages/man7/signal.7.html)
|
||
man-page for a list of standard Linux signals.
|