File: kill.2

package info (click to toggle)
manpages-es 0.4a-2
  • links: PTS
  • area: main
  • in suites: hamm, slink
  • size: 3,592 kB
  • ctags: 3
  • sloc: sh: 59; makefile: 42
file content (100 lines) | stat: -rw-r--r-- 4,075 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
.\" Hey Emacs! This file is -*- nroff -*- source.
.\"
.\" Copyright (c) 1992 Drew Eckhardt (drew@cs.colorado.edu), March 28, 1992
.\"
.\" Permission is granted to make and distribute verbatim copies of this
.\" manual provided the copyright notice and this permission notice are
.\" preserved on all copies.
.\"
.\" Permission is granted to copy and distribute modified versions of this
.\" manual under the conditions for verbatim copying, provided that the
.\" entire resulting derived work is distributed under the terms of a
.\" permission notice identical to this one
.\" 
.\" Since the Linux kernel and libraries are constantly changing, this
.\" manual page may be incorrect or out-of-date.  The author(s) assume no
.\" responsibility for errors or omissions, or for damages resulting from
.\" the use of the information contained herein.  The author(s) may not
.\" have taken the same level of care in the production of this manual,
.\" which is licensed free of charge, as they might when working
.\" professionally.
.\" 
.\" Formatted or processed versions of this manual, if unaccompanied by
.\" the source, must acknowledge the copyright and authors of this work.
.\"
.\" Modified by Michael Haardt (u31b3hs@pool.informatik.rwth-aachen.de)
.\" Modified by Thomas Koenig (ig25@rz.uni-karlsruhe.de)
.\" Modified Fri Jul 23 21:51:36 1993 by Rik Faith (faith@cs.unc.edu)
.\" Modified Sun Jul 25 10:53:24 1993 by Rik Faith (faith@cs.unc.edu)
.\" Modified Wed Nov 01 18:56:43 1995 by Michael Haardt
.\"  (michael@cantor.informatik.rwth-aachen.de)
.\" Modified Sun Apr 14 17:04:32 1996 by Andries Brouwer (aeb@cwi.nl)
.\"  [added some polishing contributed by Mike Battersby (mib@deakin.edu.au)]
.\" Modified Sun Jul 21 21:25:26 1996 by Andries Brouwer (aeb@cwi.nl)
.\" Modified Fri Jan 17 23:49:46 1997 by Andries Brouwer (aeb@cwi.nl)
.\" Translated 16 Jan 1998 by Vicente Pastor Gmez <VPASTORG@santandersupernet.com , vicpastor@hotmail.com>
.\"
.TH KILL 2 "1 Noviembre 1995" "Linux" "Manual del Programador Linux"
.SH NOMBRE
kill \- enviar una seal a un proceso
.SH SINOPSIS
.nf
.B #include <sys/types.h>
.br
.B #include <signal.h>
.sp
.BI "int kill(pid_t " pid ", int " sig );
.fi
.SH DESCRIPCIN
La llamada
.B kill
se puede usar para enviar cualquier seal a un proceso o grupo de 
procesos.
.PP
Si \fIpid\fP es positivo, entonces la seal \fIsig\fP es enviada a
\fIpid\fP.
En este caso, se devuelve 0 si hay xito, o un valor negativo si hay error.
.PP
Si \fIpid\fP es igual a \-1, entonces se enva \fIsig\fP a cada proceso,
excepto al primero, desde los nmeros ms altos en la tabla proc, hasta
los ms bajos. En este caso, se devuelve 0 si hay xito, o si no,
se devuelve la condicin de error resultante de enviar la seal al
ltimo proceso.
.PP
Si \fIpid\fP es menor que \-1, entonces se enva \fIsig\fP a cada proceso
en el grupo de procesos \fI\-pid\fP. En este caso, se devuelve el nmero
de procesos al que se envi la seal, o bien un valor negativo para un fallo.
.SH "VALOR REGRESADO"
Si hay xito, se devuelve cero. Si hay error, se devuelve \-1, y se actualiza
.I errno
apropiadamente.
.SH ERRORES
.TP
.B EINVAL
Se envi una seal invlida.
.TP
.B ESRCH
El pid o grupo de procesos no existe. Ntese que un proceso existente podra
ser un zombi, un proceso que ya ha sido terminado, pero que an no ha sido
"\fBwait()\fPeado".
.TP
.B EPERM
El proceso no tiene permiso para enviar la seal a alguno de los procesos
que la recibirn. Para que un proceso tenga permiso para enviar una seal
al proceso
.I pid
debe, o bien tener privilegios de root, o bien el ID de usuario real o
efectivo del proceso que enva la seal ha de ser igual al set-user-ID real
o guardado del proceso que la recibe.
.SH "BUGS"
Es imposible enviar una seal a la tarea nmero uno, el proceso init, para
el que no ha sido instalado un manejador de seales. Esto se hace para
asegurarse de que el sistema no se venga abajo accidentalmente.
.SH "CONFORMA CON"
SVr4, SVID, POSIX.1, X/OPEN, BSD 4.3
.SH "VASE TAMBIN"
.BR _exit "(2), " exit "(2), " signal "(2), " signal (7)