<!DOCTYPE refentry PUBLIC "-//Davenport//DTD DocBook V3.0//EN" [

<!ENTITY copyrights SYSTEM "@builddir@/copyrights.sgml">

<!ENTITY commonoptions SYSTEM "@builddir@/common_options.sgml">

<!ENTITY seealso SYSTEM "@builddir@/see_also.sgml">

<!ENTITY mcr "<citerefentry>

<manvolnum/1/</citerefentry>">

]>

<refentry>

<docinfo><date>@LXC_GENERATE_DATE@</date></docinfo>

<refmeta>

<refentrytitle>lxc-kill</refentrytitle>

<manvolnum>1</manvolnum>

<refmiscinfo>IBM</refmiscinfo>

</refmeta>

<refnamediv>

<refname>lxc-kill</refname>

<refpurpose>

Send a signal to the process 1 of the container.

</refpurpose>

</refnamediv>

<refsynopsisdiv>

<cmdsynopsis>

<command>lxc-kill --name=<replaceable>NAME</replaceable> <replaceable>SIGNUM</replaceable></command>

</cmdsynopsis>

</refsynopsisdiv>

<refsect1>

<title>Description</title>

<para>

<command>lxc-kill</command> send

the <replaceable>SIGNUM</replaceable> signal to the first process of the container.

</para>

<para>

If this command is used on an application container ran by

lxc-execute, the lxc-init will receive the signal and will forward it to

the process 2 which is the command specified in the command line. See

lxc-execute (1).

</para>

</refsect1>

&commonoptions;

<refsect1>

<title>Examples</title>

<para>

To send the signal 26 to the process pi1 running in container

<literal>123</literal> :

</para>

<programlisting>

lxc-execute -n 123 -- pi1 -d 500000

lxc-kill --name=123 26

</programlisting>

</refsect1>

&copyrights;

&seealso;

</refentry>