xref: /csrg-svn/lib/libc/gen/raise.3 (revision 61111)
1*61111Sbostic.\" Copyright (c) 1990, 1991, 1993
2*61111Sbostic.\"	The Regents of the University of California.  All rights reserved.
346465Sbostic.\"
450316Sbostic.\" This code is derived from software contributed to Berkeley by
550316Sbostic.\" the American National Standards Committee X3, on Information
650316Sbostic.\" Processing Systems.
750316Sbostic.\"
846465Sbostic.\" %sccs.include.redist.man%
946465Sbostic.\"
10*61111Sbostic.\"     @(#)raise.3	8.1 (Berkeley) 06/04/93
1146465Sbostic.\"
1248352Scael.Dd
1348352Scael.Dt RAISE 3
1448352Scael.Os
1548352Scael.Sh NAME
1648352Scael.Nm raise
1748352Scael.Nd send a signal to the current process
1848352Scael.Sh SYNOPSIS
1948352Scael.Fd #include <signal.h>
2048352Scael.Ft int
2148352Scael.Fn raise "int sig"
2248352Scael.Sh DESCRIPTION
2346465SbosticThe
2448352Scael.Fn raise
2546465Sbosticfunction sends the signal
2648352Scael.Fa sig
2746465Sbosticto the current process.
2848352Scael.Sh RETURN VALUES
2946465SbosticUpon successful completion, a value of 0 is returned.
3048352ScaelOtherwise, a value of \-1 is returned and the global variable
3148352Scael.Va errno
3246465Sbosticis set to indicate the error.
3348352Scael.Sh ERRORS
3448352ScaelThe
3548352Scael.Fn raise
3648352Scaelfunction
3746465Sbosticmay fail and set
3848352Scael.Va errno
3948352Scaelfor any of the errors specified for the
4048352Scaellibrary functions
4148352Scael.Xr getpid 2
4246465Sbosticand
4348352Scael.Xr kill 2 .
4448352Scael.Sh SEE ALSO
4548352Scael.Xr kill 2
4648352Scael.Sh STANDARDS
4748352ScaelThe
4848352Scael.Fn raise
4948352Scaelfunction
5048352Scaelconforms to
5148352Scael.St -ansiC .
52