Print this page
manifest


   5  * Common Development and Distribution License (the "License").
   6  * You may not use this file except in compliance with the License.
   7  *
   8  * You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
   9  * or http://www.opensolaris.org/os/licensing.
  10  * See the License for the specific language governing permissions
  11  * and limitations under the License.
  12  *
  13  * When distributing Covered Code, include this CDDL HEADER in each
  14  * file and include the License file at usr/src/OPENSOLARIS.LICENSE.
  15  * If applicable, add the following below this CDDL HEADER, with the
  16  * fields enclosed by brackets "[]" replaced with your own identifying
  17  * information: Portions Copyright [yyyy] [name of copyright owner]
  18  *
  19  * CDDL HEADER END
  20  */
  21 
  22 /*
  23  * Copyright 2015 Joyent, Inc.
  24  * Copyright 2015 Nexenta Systems, Inc.  All rights reserved.

  25  *
  26  * Copyright 2010 Sun Microsystems, Inc.  All rights reserved.
  27  * Use is subject to license terms.
  28  */
  29 
  30 /*      Copyright (c) 1984, 1986, 1987, 1988, 1989 AT&T     */
  31 /*        All Rights Reserved   */
  32 
  33 #ifndef _SYS_UCONTEXT_H
  34 #define _SYS_UCONTEXT_H
  35 
  36 #include <sys/feature_tests.h>
  37 
  38 #include <sys/types.h>
  39 #include <sys/mcontext.h>
  40 #if !defined(_XPG4_2) || defined(__EXTENSIONS__)
  41 #include <sys/signal.h>
  42 #endif
  43 
  44 #ifdef  __cplusplus


  69 #endif /* _STACK_T */
  70 #endif /* defined(_XPG4_2) && !defined(__EXTENSIONS__) */
  71 
  72 #if !defined(_XPG4_2) || defined(__EXTENSIONS__)
  73 typedef struct ucontext ucontext_t;
  74 #else
  75 typedef struct __ucontext ucontext_t;
  76 #endif /* !defined(_XPG4_2) || defined(__EXTENSIONS__) */
  77 
  78 #if !defined(_XPG4_2) || defined(__EXTENSIONS__)
  79 struct  ucontext {
  80 #else
  81 struct  __ucontext {
  82 #endif
  83         unsigned long   uc_flags;
  84         ucontext_t      *uc_link;
  85         sigset_t        uc_sigmask;
  86         stack_t         uc_stack;
  87         mcontext_t      uc_mcontext;
  88         /*
  89          * The Intel386 ABI specification includes a 5-element array of longs
  90          * called "uc_filler", padding the size of the struct to 512 bytes.  To
  91          * allow zone brands to communicate extra data right the way through
  92          * the signal handling process, from sigacthandler to setcontext, we
  93          * steal the first three of these longs as a brand-private member.
  94          */
  95         void            *uc_brand_data[3];
  96         long            uc_filler[2];

  97 };
  98 #if defined(_SYSCALL32)
  99 
 100 /* Kernel view of user ILP32 ucontext structure */
 101 
 102 typedef struct ucontext32 {
 103         uint32_t        uc_flags;
 104         caddr32_t       uc_link;
 105         sigset_t        uc_sigmask;
 106         stack32_t       uc_stack;
 107         mcontext32_t    uc_mcontext;
 108         caddr32_t       uc_brand_data[3];
 109         int32_t         uc_filler[2];

 110 } ucontext32_t;
 111 
 112 #if defined(_KERNEL)
 113 extern void ucontext_nto32(const ucontext_t *src, ucontext32_t *dest);
 114 extern void ucontext_32ton(const ucontext32_t *src, ucontext_t *dest);
 115 #endif
 116 
 117 #endif  /* _SYSCALL32 */
 118 
 119 #if !defined(_XPG4_2) || defined(__EXTENSIONS__)
 120 #define GETCONTEXT      0
 121 #define SETCONTEXT      1
 122 #define GETUSTACK       2
 123 #define SETUSTACK       3

 124 
 125 /*
 126  * values for uc_flags
 127  * these are implementation dependent flags, that should be hidden
 128  * from the user interface, defining which elements of ucontext
 129  * are valid, and should be restored on call to setcontext
 130  */
 131 
 132 #define UC_SIGMASK      0x01
 133 #define UC_STACK        0x02
 134 #define UC_CPU          0x04
 135 #define UC_MAU          0x08
 136 #define UC_FPU          UC_MAU

 137 
 138 #define UC_MCONTEXT     (UC_CPU|UC_FPU)
 139 
 140 /*
 141  * UC_ALL specifies the default context
 142  */
 143 
 144 #define UC_ALL          (UC_SIGMASK|UC_STACK|UC_MCONTEXT)
 145 #endif /* !defined(_XPG4_2) || defined(__EXTENSIONS__) */
 146 
 147 #ifdef _KERNEL
 148 void savecontext(ucontext_t *, const k_sigset_t *);
































 149 void restorecontext(ucontext_t *);
 150 
 151 #ifdef _SYSCALL32
 152 extern void savecontext32(ucontext32_t *, const k_sigset_t *);

 153 #endif
 154 #endif
 155 
 156 #ifdef  __cplusplus
 157 }
 158 #endif
 159 
 160 #endif /* _SYS_UCONTEXT_H */


   5  * Common Development and Distribution License (the "License").
   6  * You may not use this file except in compliance with the License.
   7  *
   8  * You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
   9  * or http://www.opensolaris.org/os/licensing.
  10  * See the License for the specific language governing permissions
  11  * and limitations under the License.
  12  *
  13  * When distributing Covered Code, include this CDDL HEADER in each
  14  * file and include the License file at usr/src/OPENSOLARIS.LICENSE.
  15  * If applicable, add the following below this CDDL HEADER, with the
  16  * fields enclosed by brackets "[]" replaced with your own identifying
  17  * information: Portions Copyright [yyyy] [name of copyright owner]
  18  *
  19  * CDDL HEADER END
  20  */
  21 
  22 /*
  23  * Copyright 2015 Joyent, Inc.
  24  * Copyright 2015 Nexenta Systems, Inc.  All rights reserved.
  25  * Copyright 2023 Oxide Computer Company
  26  *
  27  * Copyright 2010 Sun Microsystems, Inc.  All rights reserved.
  28  * Use is subject to license terms.
  29  */
  30 
  31 /*      Copyright (c) 1984, 1986, 1987, 1988, 1989 AT&T     */
  32 /*        All Rights Reserved   */
  33 
  34 #ifndef _SYS_UCONTEXT_H
  35 #define _SYS_UCONTEXT_H
  36 
  37 #include <sys/feature_tests.h>
  38 
  39 #include <sys/types.h>
  40 #include <sys/mcontext.h>
  41 #if !defined(_XPG4_2) || defined(__EXTENSIONS__)
  42 #include <sys/signal.h>
  43 #endif
  44 
  45 #ifdef  __cplusplus


  70 #endif /* _STACK_T */
  71 #endif /* defined(_XPG4_2) && !defined(__EXTENSIONS__) */
  72 
  73 #if !defined(_XPG4_2) || defined(__EXTENSIONS__)
  74 typedef struct ucontext ucontext_t;
  75 #else
  76 typedef struct __ucontext ucontext_t;
  77 #endif /* !defined(_XPG4_2) || defined(__EXTENSIONS__) */
  78 
  79 #if !defined(_XPG4_2) || defined(__EXTENSIONS__)
  80 struct  ucontext {
  81 #else
  82 struct  __ucontext {
  83 #endif
  84         unsigned long   uc_flags;
  85         ucontext_t      *uc_link;
  86         sigset_t        uc_sigmask;
  87         stack_t         uc_stack;
  88         mcontext_t      uc_mcontext;
  89         /*
  90          * The first three entries have been borrowed by the lx brand right now.
  91          * That should be consolidated into a single uc_brand entry with a
  92          * UC_BRAND flag. Until such time, we leave them as is.
  93          *
  94          * We rename those first three entries here for SmartOS.
  95          */
  96         void            *uc_brand_data[3];
  97         long            uc_xsave;
  98         long            uc_filler1;
  99 };
 100 #if defined(_SYSCALL32)
 101 
 102 /* Kernel view of user ILP32 ucontext structure */
 103 
 104 typedef struct ucontext32 {
 105         uint32_t        uc_flags;
 106         caddr32_t       uc_link;
 107         sigset_t        uc_sigmask;
 108         stack32_t       uc_stack;
 109         mcontext32_t    uc_mcontext;
 110         caddr32_t       uc_brand_data[3];
 111         int32_t         uc_xsave;
 112         int32_t         uc_filler1;
 113 } ucontext32_t;
 114 
 115 #if defined(_KERNEL)
 116 extern void ucontext_nto32(const ucontext_t *src, ucontext32_t *dest);
 117 extern void ucontext_32ton(const ucontext32_t *src, ucontext_t *dest);
 118 #endif
 119 
 120 #endif  /* _SYSCALL32 */
 121 
 122 #if !defined(_XPG4_2) || defined(__EXTENSIONS__)
 123 #define GETCONTEXT      0
 124 #define SETCONTEXT      1
 125 #define GETUSTACK       2
 126 #define SETUSTACK       3
 127 #define GETCONTEXT_EXTD 4
 128 
 129 /*
 130  * values for uc_flags
 131  * these are implementation dependent flags, that should be hidden
 132  * from the user interface, defining which elements of ucontext
 133  * are valid, and should be restored on call to setcontext
 134  */
 135 
 136 #define UC_SIGMASK      0x01
 137 #define UC_STACK        0x02
 138 #define UC_CPU          0x04
 139 #define UC_MAU          0x08
 140 #define UC_FPU          UC_MAU
 141 #define UC_XSAVE        0x10
 142 
 143 #define UC_MCONTEXT     (UC_CPU|UC_FPU)
 144 
 145 /*
 146  * UC_ALL specifies the default context
 147  */
 148 
 149 #define UC_ALL          (UC_SIGMASK|UC_STACK|UC_MCONTEXT)
 150 #endif /* !defined(_XPG4_2) || defined(__EXTENSIONS__) */
 151 
 152 #ifdef _KERNEL
 153 /*
 154  * This structure is the private header for the xsave data that we end up
 155  * sending to the stack. This is basically our own compressed form. See,
 156  * uts/intel/os/fpu.c for more information.
 157  */
 158 #define UC_XSAVE_VERS   (('u' << 24) | ('c' << 16) | 0x01)
 159 typedef struct uc_xsave {
 160         uint32_t ucx_vers;
 161         uint32_t ucx_len;
 162         uint64_t ucx_bv;
 163 } uc_xsave_t;
 164 
 165 typedef enum {
 166         /*
 167          * Do a boring old savecontext() where we assume that only the data
 168          * structure that we're given must be filled in.
 169          */
 170         SAVECTXT_F_NONE = 0,
 171         /*
 172          * Indicate that we should treat the ucontext_t as having valid user
 173          * pointers for copying out extended state. Currently this means that we
 174          * treat the uc_xsave member as something that points to a user address.
 175          */
 176         SAVECTXT_F_EXTD = 1 << 0,
 177         /*
 178          * This indicates that we shouldn't do normal copyout handling and need
 179          * to actually avoid potentially triggering a watchpoint because we're
 180          * probably in signal handling context.
 181          */
 182         SAVECTXT_F_ONFAULT = 1 << 1
 183 } savecontext_flags_t;
 184 
 185 int savecontext(ucontext_t *, const k_sigset_t *, savecontext_flags_t);
 186 void restorecontext(ucontext_t *);
 187 
 188 #ifdef _SYSCALL32
 189 extern int savecontext32(ucontext32_t *, const k_sigset_t *,
 190     savecontext_flags_t);
 191 #endif
 192 #endif
 193 
 194 #ifdef  __cplusplus
 195 }
 196 #endif
 197 
 198 #endif /* _SYS_UCONTEXT_H */