xref: /original-bsd/lib/libc/gen/raise.3 (revision c3e32dec)
1.\" Copyright (c) 1990, 1991, 1993
2.\"	The Regents of the University of California.  All rights reserved.
3.\"
4.\" This code is derived from software contributed to Berkeley by
5.\" the American National Standards Committee X3, on Information
6.\" Processing Systems.
7.\"
8.\" %sccs.include.redist.man%
9.\"
10.\"     @(#)raise.3	8.1 (Berkeley) 06/04/93
11.\"
12.Dd
13.Dt RAISE 3
14.Os
15.Sh NAME
16.Nm raise
17.Nd send a signal to the current process
18.Sh SYNOPSIS
19.Fd #include <signal.h>
20.Ft int
21.Fn raise "int sig"
22.Sh DESCRIPTION
23The
24.Fn raise
25function sends the signal
26.Fa sig
27to the current process.
28.Sh RETURN VALUES
29Upon successful completion, a value of 0 is returned.
30Otherwise, a value of \-1 is returned and the global variable
31.Va errno
32is set to indicate the error.
33.Sh ERRORS
34The
35.Fn raise
36function
37may fail and set
38.Va errno
39for any of the errors specified for the
40library functions
41.Xr getpid 2
42and
43.Xr kill 2 .
44.Sh SEE ALSO
45.Xr kill 2
46.Sh STANDARDS
47The
48.Fn raise
49function
50conforms to
51.St -ansiC .
52