1 .\" Copyright 2014 Garrett D'Amore <garrett@damore.org>
   2 .\"  Copyright 1989 AT&T  Copyright (c) 2002, Sun Microsystems, Inc.  All Rights Reserved
   3 .\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License").  You may not use this file except in compliance with the License.
   4 .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing.  See the License for the specific language governing permissions and limitations under the License.
   5 .\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE.  If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
   6 .Dd "Jul 20, 2014"
   7 .Dt UCONTEXT.H 3HEAD
   8 .Os
   9 .Sh NAME
  10 .Nm ucontext.h, ucontext
  11 .Nd user context
  12 .Sh SYNOPSIS
  13 .In ucontext.h
  14 .Sh DESCRIPTION
  15 The
  16 .In ucontext.h
  17 header defines the
  18 .Ft ucontext_t
  19 type as a structure that includes at least the following members:
  20 .Bl -column -offset indent "ucontext_t" "uc_mcontext"
  21 .It Ft ucontext_t       Fa uc_link ;
  22 .It Ft sigset_t Fa uc_sigmask ;
  23 .It Ft stack_t  Fa uc_stack ;
  24 .It Ft mcontext_t       Fa uc_mcontext ;
  25 .El
  26 .Lp
  27 The
  28 .Fa uc_link
  29 member is a pointer to the context that to be resumed when
  30 this context returns. If
  31 .Fa uc_link
  32 is equal to 0, this context is the main
  33 context and the process exits when this context returns.
  34 .Lp
  35 The
  36 .Fa uc_sigmask
  37 member defines the set of signals that are blocked when
  38 this context is active. See
  39 .Xr sigprocmask 2 .
  40 .Lp
  41 The
  42 .Fa uc_stack
  43 member defines the stack used by this context. See
  44 .Xr sigaltstack 2 .
  45 .Lp
  46 The
  47 .Fa uc_mcontext
  48 member contains the saved set of machine registers and
  49 any implementation-specific context data. Portable applications should not
  50 modify or access
  51 .Fa uc_mcontext .
  52 .Sh INTERFACE STABILITY
  53 .Sy Obsolete Standard .
  54 .Sh SEE ALSO
  55 .Xr getcontext 2 ,
  56 .Xr sigaction 2 ,
  57 .Xr sigaltstack 2 ,
  58 .Xr sigprocmask 2 ,
  59 .Xr makecontext 3C ,
  60 .Xr standards 5
  61 .Sh STANDARDS
  62 The
  63 .In ucontext.h
  64 header was introduced in
  65 .St -xpg4.2 .
  66 It was subsequently obsoleted in
  67 .St -p1003.1-2001 ,
  68 and removed in
  69 .St -p1003.1-2008 .