# docker container kill

**Descripción:** Termina abruptamente (kill) uno o más contenedores en ejecución

**Uso:** `docker container kill [OPTIONS] CONTAINER [CONTAINER...]`

**Alias:** `docker kill`








## Descripción

El subcomando `docker kill` termina abruptamente (kill) uno o más contenedores. Al proceso principal
dentro del contenedor se le envía la señal `SIGKILL` (por defecto), o la señal que sea
especificada con la opción `--signal`. Puedes hacer referencia a un contenedor mediante su
ID, prefijo de ID o nombre.

La bandera `--signal` establece la señal de llamada del sistema que se envía al contenedor.
Esta señal puede ser el nombre de una señal en el formato `SIG<NOMBRE>`, por ejemplo `SIGINT`,
o un número sin signo que coincida con una posición en la tabla de llamadas al sistema del kernel,
por ejemplo `2`.

Aunque la señal por defecto (`SIGKILL`) detendrá el contenedor, la señal
establecida a través de `--signal` puede no ser terminal, dependiendo del proceso principal
del contenedor. Por ejemplo, la señal `SIGHUP` en la mayoría de los casos no será terminal,
y el contenedor continuará ejecutándose después de recibir la señal.

> [!NOTE]
> `ENTRYPOINT` y `CMD` en la forma de *shell* se ejecutan como un proceso hijo de
> `/bin/sh -c`, el cual no transmite señales. Esto significa que el ejecutable
> no es el PID 1 del contenedor y no recibe las señales de Unix.


## Opciones

| Opción                                                        | Predeterminado                                        | Descripción                                                                                                                                    |
| ------------------------------------------------------------- | ----------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|  | `-s`, `--signal` |  |  Señal a enviar al contenedor |




## Ejemplos

### Enviar una señal KILL a un contenedor

El siguiente ejemplo envía la señal `SIGKILL` por defecto al contenedor llamado
`my_container`:

```console
$ docker kill my_container
```

### Enviar una señal personalizada a un contenedor (--signal) {#signal}

El siguiente ejemplo envía una señal `SIGHUP` al contenedor llamado
`my_container`:

```console
$ docker kill --signal=SIGHUP  my_container
```


Puedes especificar una señal personalizada ya sea por _nombre_ o por _número_. El prefijo `SIG`
es opcional, por lo que los siguientes ejemplos son equivalentes:

```console
$ docker kill --signal=SIGHUP my_container
$ docker kill --signal=HUP my_container
$ docker kill --signal=1 my_container
```

Consulta la página de manual [`signal(7)`](https://man7.org/linux/man-pages/man7/signal.7.html)
para obtener una lista de las señales estándar de Linux.