← Back to branch summary

~serge-hallyn/ubuntu/natty/lxc/lxc-clone

« back to all changes in this revision

Viewing changes to doc/lxc-kill.1

  • Committer: Bazaar Package Importer
  • Author(s): Guido Trotter
  • Date: 2010-06-28 10:15:48 UTC
  • mfrom: (1.2.4 upstream)
  • mto: This revision was merged to the branch mainline in revision 7.
  • Revision ID: james.westby@ubuntu.com-20100628101548-mtmloxk8n4ro2wvw
* New upstream version
* Convert to quilt format
* Use pristine-tar option in git-buildpackage
* lxc-$distro scripts (debian, fedora, sshd, ubuntu, busybox) are now
  shipped under /usr/lib/lxc/lxc/templates/
* Bump up standards version

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/lxc-kill.1
 
1
.\" This manpage has been automatically generated by docbook2man 
 
2
.\" from a DocBook document.  This tool can be found at:
 
3
.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> 
 
4
.\" Please send any bug reports, improvements, comments, patches, 
 
5
.\" etc. to Steve Cheng <steve@ggi-project.org>.
 
6
.TH "LXC-KILL" "1" "24 June 2010" "IBM" ""
 
7
 
 
8
.SH NAME
 
9
lxc-kill \- Send a signal to the process 1 of the container.
 
10
.SH SYNOPSIS
 
11
 
 
12
\fBlxc-kill --name=\fINAME\fB \fISIGNUM\fB\fR
 
13
 
 
14
.SH "DESCRIPTION"
 
15
.PP
 
16
\fBlxc-kill\fR send
 
17
the \fISIGNUM\fR signal to the first process of the container.
 
18
.PP
 
19
The \fISIGNUM\fR is a numeric value,
 
20
the signal name is not supported.
 
21
.PP
 
22
If this command is used on an application container ran by
 
23
lxc-execute, the lxc-init will receive the signal and will forward it to
 
24
the process 2 which is the command specified in the command line. See
 
25
lxc-execute (1).
 
26
Obviously the SIGKILL and SIGSTOP signals are not able to be forwarded,
 
27
(as per the signal(7) man page).
 
28
.SH "COMMON OPTIONS"
 
29
.PP
 
30
These options are common to most of lxc commands.
 
31
.TP
 
32
\fB-?, -h, --help\fR
 
33
Print a longer usage message than normal.
 
34
.TP
 
35
\fB--usage\fR
 
36
Give the usage message
 
37
.TP
 
38
\fB-q, --quiet\fR
 
39
mute on
 
40
.TP
 
41
\fB-o, --logfile=\fIFILE\fB\fR
 
42
Output to an alternate log
 
43
\fIFILE\fR\&. The default is no log.
 
44
.TP
 
45
\fB-l, --logpriority=\fILEVEL\fB\fR
 
46
Set log priority to
 
47
\fILEVEL\fR\&. The default log
 
48
priority is ERROR\&. Possible values are :
 
49
FATAL, CRIT,
 
50
WARN, ERROR,
 
51
NOTICE, INFO,
 
52
DEBUG\&.
 
53
 
 
54
Note that this option is setting the priority of the events
 
55
log in the alternate log file. It do not have effect on the
 
56
ERROR events log on stderr.
 
57
.TP
 
58
\fB-n, --name=\fINAME\fB\fR
 
59
Use container identifier \fINAME\fR\&.
 
60
The container identifier format is an alphanumeric string.
 
61
.SH "EXAMPLES"
 
62
.PP
 
63
To send the signal 26 to the process pi1 running in container
 
64
123 :
 
65
 
 
66
.nf
 
67
      lxc-execute -n 123 -- pi1 -d 500000
 
68
      lxc-kill --name=123 26
 
69
    
 
70
.fi
 
71
.SH "SEE ALSO"
 
72
.PP
 
73
\fBlxc\fR(1),
 
74
\fBlxc-create\fR(1),
 
75
\fBlxc-destroy\fR(1),
 
76
\fBlxc-start\fR(1),
 
77
\fBlxc-stop\fR(1),
 
78
\fBlxc-execute\fR(1),
 
79
\fBlxc-kill\fR(1),
 
80
\fBlxc-console\fR(1),
 
81
\fBlxc-monitor\fR(1),
 
82
\fBlxc-wait\fR(1),
 
83
\fBlxc-cgroup\fR(1),
 
84
\fBlxc-ls\fR(1),
 
85
\fBlxc-ps\fR(1),
 
86
\fBlxc-info\fR(1),
 
87
\fBlxc-freeze\fR(1),
 
88
\fBlxc-unfreeze\fR(1),
 
89
\fBlxc.conf\fR(5)
 
90
.SH "AUTHOR"
 
91
.PP
 
92
Daniel Lezcano <daniel.lezcano@free.fr>