]> git.saurik.com Git - apple/xnu.git/blobdiff - bsd/sys/spawn_internal.h
xnu-2782.1.97.tar.gz
[apple/xnu.git] / bsd / sys / spawn_internal.h
index d295260951465e63e62274632d99dac6ce9b546c..7054f6bb966cacb9aed4adf69fbbbd22850cbc9d 100644 (file)
@@ -38,7 +38,7 @@
  */
 
 #ifndef        _SYS_SPAWN_INTERNAL_H_
-#define        _SYS_SPAWN__INTERNALH_
+#define        _SYS_SPAWN_INTERNAL_H_
 
 #include <sys/_types.h>                /* __offsetof(), __darwin_size_t */
 #include <sys/syslimits.h>     /* PATH_MAX */
@@ -54,6 +54,7 @@ typedef enum {
        PSPA_SPECIAL = 0,
        PSPA_EXCEPTION = 1,
        PSPA_AU_SESSION = 2,
+       PSPA_IMP_WATCHPORTS = 3,
 } pspa_t;
 
 /*
@@ -64,7 +65,7 @@ typedef enum {
 typedef struct _ps_port_action {
        pspa_t                  port_type;
        exception_mask_t        mask;
-       mach_port_t             new_port;
+       mach_port_name_t        new_port;
        exception_behavior_t    behavior;
        thread_state_flavor_t   flavor;
        int                     which;
@@ -87,6 +88,36 @@ typedef struct _posix_spawn_port_actions {
 
 #define NBINPREFS      4
 
+/*
+ * Mapping of opaque data pointer to a MAC policy (specified by name).
+ */
+typedef struct _ps_mac_policy_extension {
+       char                    policyname[128];
+       union {
+               uint64_t        data;
+               void            *datap;         /* pointer in kernel memory */
+       };
+       uint64_t                datalen;
+} _ps_mac_policy_extension_t;
+
+/*
+ * A collection of extra data passed to MAC policies for the newly spawned process.
+ */
+typedef struct _posix_spawn_mac_policy_extensions {
+       int                     psmx_alloc;
+       int                     psmx_count;
+       _ps_mac_policy_extension_t psmx_extensions[];
+} *_posix_spawn_mac_policy_extensions_t;
+
+/*
+ * Returns size in bytes of a _posix_spawn_mac_policy_extensions holding x elements.
+ */
+#define PS_MAC_EXTENSIONS_SIZE(x)     \
+        __offsetof(struct _posix_spawn_mac_policy_extensions, psmx_extensions[(x)])
+
+#define PS_MAC_EXTENSIONS_INIT_COUNT   2
+
+
 /*
  * A posix_spawnattr structure contains all of the attribute elements that
  * can be set, as well as any metadata whose validity is signalled by the
@@ -95,14 +126,94 @@ typedef struct _posix_spawn_port_actions {
  */
 typedef struct _posix_spawnattr {
        short           psa_flags;              /* spawn attribute flags */
+       short           flags_padding;  /* get the flags to be int aligned */
        sigset_t        psa_sigdefault;         /* signal set to default */
        sigset_t        psa_sigmask;            /* signal set to mask */
        pid_t           psa_pgroup;             /* pgroup to spawn into */
        cpu_type_t      psa_binprefs[NBINPREFS];   /* cpu affinity prefs*/
-       _posix_spawn_port_actions_t     psa_ports; /* special/exception ports */
        int             psa_pcontrol;           /* process control bits on resource starvation */
+       int             psa_apptype;            /* app type and process spec behav */
+       uint64_t        psa_cpumonitor_percent; /* CPU usage monitor percentage */
+       uint64_t        psa_cpumonitor_interval; /* CPU usage monitor interval, in seconds */
+       uint64_t        psa_coalitionid;        /* coalition to spawn into */
+
+       short       psa_jetsam_flags; /* jetsam flags */
+       short           short_padding;  /* Padding for alignment issues */
+       int         psa_priority;   /* jetsam relative importance */
+       int         psa_high_water_mark; /* jetsam resident page count limit */
+       int             int_padding;    /* Padding for alignment issues */
+
+       uint64_t        psa_qos_clamp;          /* QoS Clamp to set on the new process */
+
+       /*
+        * NOTE: Extensions array pointers must stay at the end so that
+        * everything above this point stays the same size on different bitnesses
+        * see <rdar://problem/12858307>
+        */
+        _posix_spawn_port_actions_t    psa_ports; /* special/exception ports */
+       _posix_spawn_mac_policy_extensions_t psa_mac_extensions; /* MAC policy-specific extensions. */
 } *_posix_spawnattr_t;
 
+/*
+ * Jetsam flags
+ */
+#define        POSIX_SPAWN_JETSAM_SET                      0x8000
+
+#define        POSIX_SPAWN_JETSAM_USE_EFFECTIVE_PRIORITY   0x1
+#define        POSIX_SPAWN_JETSAM_HIWATER_BACKGROUND       0x2
+#define        POSIX_SPAWN_JETSAM_MEMLIMIT_FATAL           0x4
+
+/*
+ * Deprecated posix_spawn psa_flags values
+ * 
+ * POSIX_SPAWN_OSX_TALAPP_START         0x0400
+ * POSIX_SPAWN_IOS_RESV1_APP_START      0x0400
+ * POSIX_SPAWN_IOS_APPLE_DAEMON_START   0x0800
+ * POSIX_SPAWN_IOS_APP_START            0x1000
+ * POSIX_SPAWN_OSX_WIDGET_START         0x0800
+ * POSIX_SPAWN_OSX_DBCLIENT_START       0x0800
+ * POSIX_SPAWN_OSX_RESVAPP_START        0x1000
+ */
+
+/*
+ * Deprecated posix_spawn psa_apptype values
+ *
+ * POSIX_SPAWN_PROCESS_TYPE_APPLEDAEMON             0x00000001
+ * POSIX_SPAWN_PROCESS_TYPE_UIAPP                   0x00000002
+ * POSIX_SPAWN_PROCESS_TYPE_ADAPTIVE                0x00000004
+ * POSIX_SPAWN_PROCESS_TYPE_TAL                     0x00000001
+ * POSIX_SPAWN_PROCESS_TYPE_WIDGET                  0x00000002
+ * POSIX_SPAWN_PROCESS_TYPE_DELAYIDLESLEEP          0x10000000
+ *
+ * POSIX_SPAWN_PROCESS_FLAG_IMPORTANCE_DONOR        0x00000010
+ * POSIX_SPAWN_PROCESS_FLAG_ADAPTIVE                0x00000020
+ * POSIX_SPAWN_PROCESS_FLAG_START_BACKGROUND        0x00000040
+ * POSIX_SPAWN_PROCESS_FLAG_START_LIGHT_THROTTLE    0x00000080
+ */
+
+/*
+ * posix_spawn psa_apptype process type settings.
+ * when POSIX_SPAWN_PROC_TYPE is set, old psa_apptype bits are ignored
+ */
+
+#define POSIX_SPAWN_PROCESS_TYPE_NORMAL             0x00000000
+#define POSIX_SPAWN_PROCESS_TYPE_DEFAULT            POSIX_SPAWN_PROCESS_TYPE_NORMAL
+
+#define POSIX_SPAWN_PROC_TYPE_MASK                  0x00000F00
+
+#define POSIX_SPAWN_PROC_TYPE_APP_DEFAULT           0x00000100
+#define POSIX_SPAWN_PROC_TYPE_APP_TAL               0x00000200
+
+#define POSIX_SPAWN_PROC_TYPE_DAEMON_STANDARD       0x00000300
+#define POSIX_SPAWN_PROC_TYPE_DAEMON_INTERACTIVE    0x00000400
+#define POSIX_SPAWN_PROC_TYPE_DAEMON_BACKGROUND     0x00000500
+#define POSIX_SPAWN_PROC_TYPE_DAEMON_ADAPTIVE       0x00000600
+
+#define POSIX_SPAWN_PROC_CLAMP_NONE                 0x00000000
+#define POSIX_SPAWN_PROC_CLAMP_UTILITY              0x00000001
+#define POSIX_SPAWN_PROC_CLAMP_BACKGROUND           0x00000002
+#define POSIX_SPAWN_PROC_CLAMP_MAINTENANCE          0x00000003
+#define POSIX_SPAWN_PROC_CLAMP_LAST                 0x00000004
 
 /*
  * Allowable posix_spawn() file actions
@@ -190,9 +301,14 @@ struct _posix_spawn_args_desc {
        __darwin_size_t file_actions_size;      /* size of file actions block */
        _posix_spawn_file_actions_t
                                file_actions;   /* pointer to block */
-       __darwin_size_t port_actions_size; /* size of port actions block */
+       __darwin_size_t port_actions_size;      /* size of port actions block */
        _posix_spawn_port_actions_t
                                port_actions;   /* pointer to port block */
+       __darwin_size_t mac_extensions_size;
+       _posix_spawn_mac_policy_extensions_t
+                               mac_extensions; /* pointer to policy-specific
+                                                * attributes */
+
 };
 
 #ifdef KERNEL
@@ -210,6 +326,8 @@ struct user32__posix_spawn_args_desc {
        uint32_t                file_actions;   /* pointer to block */
        uint32_t        port_actions_size;      /* size of port actions block */
        uint32_t                port_actions;   /* pointer to block */
+       uint32_t        mac_extensions_size;
+       uint32_t        mac_extensions;
 };
 
 struct user__posix_spawn_args_desc {
@@ -219,6 +337,8 @@ struct user__posix_spawn_args_desc {
        user_addr_t             file_actions;   /* pointer to block */
        user_size_t     port_actions_size;      /* size of port actions block */
        user_addr_t             port_actions;   /* pointer to block */
+       user_size_t     mac_extensions_size;    /* size of MAC-specific attrs. */
+       user_addr_t     mac_extensions;         /* pointer to block */
 };