bsd/sys/spawn.h

   1 /*
   2  * Copyright (c) 2006 Apple Computer, Inc. All rights reserved.
   3  *
   4  * @APPLE_OSREFERENCE_LICENSE_HEADER_START@
   5  *
   6  * This file contains Original Code and/or Modifications of Original Code
   7  * as defined in and that are subject to the Apple Public Source License
   8  * Version 2.0 (the 'License'). You may not use this file except in
   9  * compliance with the License. The rights granted to you under the License
  10  * may not be used to create, or enable the creation or redistribution of,
  11  * unlawful or unlicensed copies of an Apple operating system, or to
  12  * circumvent, violate, or enable the circumvention or violation of, any
  13  * terms of an Apple operating system software license agreement.
  14  *
  15  * Please obtain a copy of the License at
  16  * http://www.opensource.apple.com/apsl/ and read it before using this file.
  17  *
  18  * The Original Code and all software distributed under the License are
  19  * distributed on an 'AS IS' basis, WITHOUT WARRANTY OF ANY KIND, EITHER
  20  * EXPRESS OR IMPLIED, AND APPLE HEREBY DISCLAIMS ALL SUCH WARRANTIES,
  21  * INCLUDING WITHOUT LIMITATION, ANY WARRANTIES OF MERCHANTABILITY,
  22  * FITNESS FOR A PARTICULAR PURPOSE, QUIET ENJOYMENT OR NON-INFRINGEMENT.
  23  * Please see the License for the specific language governing rights and
  24  * limitations under the License.
  25  *
  26  * @APPLE_OSREFERENCE_LICENSE_HEADER_END@
  27  */
  28
  29 /*
  30  * [SPN] Support for _POSIX_SPAWN
  31  *
  32  * This header contains information that is shared between the user space
  33  * and kernel versions of the posix_spawn() code.  Shared elements are all
  34  * manifest constants, at the current time.
  35  */
  36
  37 #ifndef _SYS_SPAWN_H_
  38 #define _SYS_SPAWN_H_
  39
  40 /*
  41  * Possible bit values which may be OR'ed together and provided as the second
  42  * parameter to posix_spawnattr_setflags() or implicit returned in the value of
  43  * the second parameter to posix_spawnattr_getflags().
  44  */
  45 #define POSIX_SPAWN_RESETIDS            0x0001  /* [SPN] R[UG]ID not E[UG]ID */
  46 #define POSIX_SPAWN_SETPGROUP           0x0002  /* [SPN] set non-parent PGID */
  47 #define POSIX_SPAWN_SETSIGDEF           0x0004  /* [SPN] reset sigset default */
  48 #define POSIX_SPAWN_SETSIGMASK          0x0008  /* [SPN] set signal mask */
  49
  50 #if 0   /* _POSIX_PRIORITY_SCHEDULING [PS] : not supported */
  51 #define POSIX_SPAWN_SETSCHEDPARAM       0x0010
  52 #define POSIX_SPAWN_SETSCHEDULER        0x0020
  53 #endif  /* 0 */
  54
  55 #if     !defined(_POSIX_C_SOURCE) || defined(_DARWIN_C_SOURCE)
  56 /*
  57  * Darwin-specific flags
  58  */
  59 #define POSIX_SPAWN_SETEXEC             0x0040
  60 #define POSIX_SPAWN_START_SUSPENDED     0x0080
  61 #ifdef  PRIVATE
  62 #define _POSIX_SPAWN_DISABLE_ASLR       0x0100
  63 #define _POSIX_SPAWN_NANO_ALLOCATOR     0x0200
  64 #endif  /* PRIVATE */
  65 #define POSIX_SPAWN_SETSID              0x0400
  66 #ifdef  PRIVATE
  67 /* unused                               0x0800 */
  68 /* unused                               0x1000 */
  69 #define _POSIX_SPAWN_ALLOW_DATA_EXEC    0x2000
  70 #endif  /* PRIVATE */
  71 #define POSIX_SPAWN_CLOEXEC_DEFAULT     0x4000
  72 #ifdef PRIVATE
  73 #define _POSIX_SPAWN_HIGH_BITS_ASLR     0x8000
  74 #endif /* PRIVATE */
  75
  76 /*
  77  * Possible values to be set for the process control actions on resource starvation.
  78  * POSIX_SPAWN_PCONTROL_THROTTLE indicates that the process is to be throttled on starvation.
  79  * POSIX_SPAWN_PCONTROL_SUSPEND indicates that the process is to be suspended on starvation.
  80  * POSIX_SPAWN_PCONTROL_KILL indicates that the process is to be terminated  on starvation.
  81  */
  82 #define POSIX_SPAWN_PCONTROL_NONE       0x0000
  83 #define POSIX_SPAWN_PCONTROL_THROTTLE   0x0001
  84 #define POSIX_SPAWN_PCONTROL_SUSPEND    0x0002
  85 #define POSIX_SPAWN_PCONTROL_KILL       0x0003
  86
  87 #endif /* (!_POSIX_C_SOURCE || _DARWIN_C_SOURCE) */
  88
  89 #endif  /* _SYS_SPAWN_H_ */