'\" te
.\"  Copyright 1989 AT&T. Copyright (c) 2005, Sun Microsystems, Inc.  All Rights Reserved.
.TH raise 3C "23 Mar 2005" "SunOS 5.11" "Standard C Library Functions"
.SH NAME
raise \- send a signal to the executing thread
.SH SYNOPSIS
.LP
.nf
#include <signal.h>

\fBint\fR \fBraise\fR(\fBint\fR \fIsig\fR);
.fi

.SH DESCRIPTION
.sp
.LP
The \fBraise()\fR function sends the signal \fIsig\fR to the executing thread. If a signal handler is called, the raise function does not return until after the signal handler returns.
.sp
.LP
The effect of the raise function is equivalent to calling:
.sp
.in +2
.nf
pthread_kill(pthread_self(), sig);
.fi
.in -2

.sp
.LP
See the \fBpthread_kill\fR(3C) manual page for a detailed list of failure conditions and the \fBsignal.h\fR(3HEAD) manual page for a list of signals.
.SH RETURN VALUES
.sp
.LP
Upon successful completion, \fB0\fR is returned.  Otherwise, \fB\(mi1\fR is returned and \fBerrno\fR is set to indicate the error.
.SH ATTRIBUTES
.sp
.LP
See \fBattributes\fR(5) for descriptions of the following attributes:
.sp

.sp
.TS
tab() box;
cw(2.75i) |cw(2.75i) 
lw(2.75i) |lw(2.75i) 
.
ATTRIBUTE TYPEATTRIBUTE VALUE
_
Interface StabilityCommitted
_
MT-LevelMT-Safe
_
StandardSee \fBstandards\fR(5).
.TE

.SH SEE ALSO
.sp
.LP
\fBpthread_kill\fR(3C), \fBpthread_self\fR(3C), \fBsignal.h\fR(3HEAD), \fBattributes\fR(5), \fBstandards\fR(5)