diff options
| author | cgd <cgd@NetBSD.org> | 1995-02-27 13:21:35 +0000 |
|---|---|---|
| committer | cgd <cgd@NetBSD.org> | 1995-02-27 13:21:35 +0000 |
| commit | 110ae2f20381dbec6bc2f947e8940ffdf8232a30 (patch) | |
| tree | 1d02864c6bc712323548359375b43da22e3dad2f /lib/libc/sys/sigstack.2 | |
| parent | a954b0787c56004d4bf4ccf8db8b121fcb4d04c4 (diff) | |
resurrect man page, only to note deprecation; belongs elsewhere (where?)
Diffstat (limited to 'lib/libc/sys/sigstack.2')
| -rw-r--r-- | lib/libc/sys/sigstack.2 | 72 |
1 files changed, 12 insertions, 60 deletions
diff --git a/lib/libc/sys/sigstack.2 b/lib/libc/sys/sigstack.2 index 9b64464311f..fc3999f99cb 100644 --- a/lib/libc/sys/sigstack.2 +++ b/lib/libc/sys/sigstack.2 @@ -1,5 +1,7 @@ -.\" Copyright (c) 1983, 1991 The Regents of the University of California. -.\" All rights reserved. +.\" $NetBSD: sigstack.2,v 1.5 1995/02/27 13:21:35 cgd Exp $ +.\" +.\" Copyright (c) 1983, 1992, 1993 +.\" The Regents of the University of California. All rights reserved. .\" .\" Redistribution and use in source and binary forms, with or without .\" modification, are permitted provided that the following conditions @@ -29,73 +31,23 @@ .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" -.\" from: @(#)sigstack.2 6.5 (Berkeley) 3/10/91 -.\" $Id: sigstack.2,v 1.4 1993/11/29 21:25:42 jtc Exp $ +.\" @(#)sigstack.2 8.1 (Berkeley) 6/4/93 .\" -.Dd March 10, 1991 +.Dd June 4, 1993 .Dt SIGSTACK 2 .Os BSD 4.2 .Sh NAME .Nm sigstack .Nd set and/or get signal stack context -.Sh SYNOPSIS -.Fd #include <sys/signal.h> -.Bd -literal -struct sigstack { - caddr_t ss_sp; - int ss_onstack; -}; -.Ed -.Ft int -.Fn sigstack "const struct sigstack *ss" "struct sigstack *oss" .Sh DESCRIPTION -.Fn Sigstack -allows users to define an alternate stack on which signals -are to be processed. If -.Fa ss -is non-zero, -it specifies a -.Em "signal stack" -on which to deliver signals -and tells the system if the process is currently executing -on that stack. When a signal's action indicates its handler -should execute on the signal stack (specified with a -.Xr sigvec 2 -call), the system checks to see -if the process is currently executing on that stack. If the -process is not currently executing on the signal stack, -the system arranges a switch to the signal stack for the -duration of the signal handler's execution. -If -.Fa oss -is non-zero, the current signal stack state is returned. -.Sh NOTES -Signal stacks are not ``grown'' automatically, as is -done for the normal stack. If the stack overflows -unpredictable results may occur. -.Sh RETURN VALUES -Upon successful completion, a value of 0 is returned. -Otherwise, a value of -1 is returned and -.Va errno -is set to indicate the error. -.Sh ERRORS -.Fn Sigstack -will fail and the signal stack context will remain unchanged -if one of the following occurs. -.Bl -tag -width Er -.It Bq Er EFAULT -Either -.Fa ss -or -.Fa oss -points to memory that is not a valid part of the process -address space. -.El +The +.Fn sigstack +function has been deprecated in favor of the interface described in +.Xr sigaltstack 2 . .Sh SEE ALSO -.Xr sigvec 2 , -.Xr setjmp 3 +.Xr sigaltstack 2 .Sh HISTORY The -.Fn sigstack +.Nm function call appeared in .Bx 4.2 . |
