[solarish/illumos] add the posix_spawn family of functions

Add definitions from `spawn.h` as present [in illumos-gate (blame
view)][spawn-h]. I added definitions more than 15 years old to
`solarish/mod.rs`, and others to `solarish/illumos.rs`.

There are a lot of definitions here -- it's easiest to look at them in the
blame view linked above. But here are the corresponding man pages:

For solarish:

* [`posix_spawn`, `posix_spawnp`](https://illumos.org/man/3C/posix_spawn)
* [`posix_spawn_file_actions_{init,destroy}`](https://illumos.org/man/3C/posix_spawn_file_actions_init)
* [`posix_spawn_file_actions_{addopen,addclose}`](https://illumos.org/man/3C/posix_spawn_file_actions_addopen)
* [`posix_spawn_file_actions_adddup2`](https://illumos.org/man/3C/posix_spawn_file_actions_adddup2)
* [`posix_spawn_file_actions_addclosefrom_np`](https://illumos.org/man/3C/posix_spawn_file_actions_addclosefrom_np)
* [`posix_spawnattr_{init,destroy}`](https://illumos.org/man/3C/posix_spawnattr_init)
* [`posix_spawnattr_{setflags,getflags}`](https://illumos.org/man/3C/posix_spawnattr_setflags)
* [`posix_spawnattr_{setpgroup,getpgroup}`](https://illumos.org/man/3C/posix_spawnattr_setpgroup)
* [`posix_spawnattr_{setschedparam,getschedparam}`](https://illumos.org/man/3C/posix_spawnattr_setschedparam)
* [`posix_spawnattr_{setschedpolicy,getschedpolicy}`](https://illumos.org/man/3C/posix_spawnattr_setschedpolicy)
* [`posix_spawnattr_{setsigdefault,getsigdefault}`](https://illumos.org/man/3C/posix_spawnattr_setsigdefault)
* [`posix_spawnattr_{setsigignore,getsigignore}_np`](https://illumos.org/man/3C/posix_spawnattr_setsigignore_np)
* [`posix_spawnattr_{setsigmask,getsigmask}`](https://illumos.org/man/3C/posix_spawnattr_setsigmask)

Newer functions added independently to Solaris and illumos:

* [`posix_spawn_file_actions_{addchdir,addchdir_np,addfchdir}` on Solaris](https://docs.oracle.com/cd/E88353_01/html/E37843/posix-spawn-file-actions-addchdir-np-3c.html)

* The illumos-only functions are quite recent so the man pages haven't been
  uploaded to illumos.org yet. But [here's the one for `addchdir` and
  `addfchdir`](https://github.com/illumos/illumos-gate/blob/7633a05bff8c639f2df722d1fba7b889b2763d3d/usr/src/man/man3c/posix_spawn_file_actions_addchdir.3c).
  Note that the `_np` functions are not documented in the manual, but they are
  available for compatibility.

The one function I skipped over was
[`posix_spawn_pipe_np`](https://illumos.org/man/3C/posix_spawn_pipe_np) -- it
seemed a bit niche and I wasn't quite sure how to model `boolean_t`.

[spawn-h]: https://github.com/illumos/illumos-gate/blame/7633a05bff8c639f2df722d1fba7b889b2763d3d/usr/src/head/spawn.h#L1

Author: sunshowers

libc-test/build.rs

@@ -864,6 +864,7 @@ fn test_solarish(target: &str) {
         "sched.h",
         "semaphore.h",
         "signal.h",
+        "spawn.h",
         "stddef.h",
         "stdint.h",
         "stdio.h",

libc-test/semver/illumos.txt

@@ -14,8 +14,10 @@ POSIX_FADV_NORMAL
 POSIX_FADV_RANDOM
 POSIX_FADV_SEQUENTIAL
 POSIX_FADV_WILLNEED
+POSIX_SPAWN_SETSID
 posix_fadvise
 posix_fallocate
+posix_spawn_file_actions_addfchdir_np
 pthread_attr_get_np
 pthread_attr_getstackaddr
 pthread_attr_setstack

libc-test/semver/solarish.txt

@@ -15,6 +15,16 @@ LIO_READ
 LIO_WAIT
 LIO_WRITE
 PIPE_BUF
+POSIX_SPAWN_NOEXECERR_NP
+POSIX_SPAWN_NOSIGCHLD_NP
+POSIX_SPAWN_RESETIDS
+POSIX_SPAWN_SETPGROUP
+POSIX_SPAWN_SETSCHEDPARAM
+POSIX_SPAWN_SETSCHEDULER
+POSIX_SPAWN_SETSIGDEF
+POSIX_SPAWN_SETSIGIGN_NP
+POSIX_SPAWN_SETSIGMASK
+POSIX_SPAWN_WAITPID_NP
 SIGEV_PORT
 SIGRTMAX
 SIGRTMIN
@@ -37,5 +47,32 @@ bind
 in6_pktinfo
 in_pktinfo
 lio_listio
+posix_spawn
+posix_spawn_file_actions_addchdir
+posix_spawn_file_actions_addchdir_np
+posix_spawn_file_actions_addclose
+posix_spawn_file_actions_addclosefrom_np
+posix_spawn_file_actions_adddup2
+posix_spawn_file_actions_addfchdir
+posix_spawn_file_actions_addopen
+posix_spawn_file_actions_destroy
+posix_spawn_file_actions_init
+posix_spawnattr_destroy
+posix_spawnattr_getflags
+posix_spawnattr_getpgroup
+posix_spawnattr_getschedparam
+posix_spawnattr_getschedpolicy
+posix_spawnattr_getsigdefault
+posix_spawnattr_getsigignore_np
+posix_spawnattr_getsigmask
+posix_spawnattr_init
+posix_spawnattr_setflags
+posix_spawnattr_setpgroup
+posix_spawnattr_setschedparam
+posix_spawnattr_setschedpolicy
+posix_spawnattr_setsigdefault
+posix_spawnattr_setsigignore_np
+posix_spawnattr_setsigmask
+posix_spawnp
 recvmsg
 sendmsg

src/unix/solarish/illumos.rs

@@ -205,6 +205,8 @@ pub const POSIX_FADV_WILLNEED: c_int = 3;
 pub const POSIX_FADV_DONTNEED: c_int = 4;
 pub const POSIX_FADV_NOREUSE: c_int = 5;
 
+pub const POSIX_SPAWN_SETSID: c_short = 0x40;
+
 pub const SIGINFO: c_int = 41;
 
 pub const O_DIRECT: c_int = 0x2000000;
@@ -335,6 +337,11 @@ extern "C" {
     pub fn pwritev(fd: c_int, iov: *const crate::iovec, iovcnt: c_int, offset: off_t) -> ssize_t;
     pub fn getpagesizes2(pagesize: *mut size_t, nelem: c_int) -> c_int;
 
+    pub fn posix_spawn_file_actions_addfchdir_np(
+        file_actions: *mut crate::posix_spawn_file_actions_t,
+        fd: c_int,
+    ) -> c_int;
+
     pub fn ptsname_r(fildes: c_int, name: *mut c_char, namelen: size_t) -> c_int;
 
     pub fn syncfs(fd: c_int) -> c_int;

src/unix/solarish/mod.rs

@@ -54,6 +54,9 @@ pub type lgrp_lat_between_t = c_uint;
 pub type lgrp_mem_size_flag_t = c_uint;
 pub type lgrp_view_t = c_uint;
 
+pub type posix_spawnattr_t = *mut c_void;
+pub type posix_spawn_file_actions_t = *mut c_void;
+
 #[cfg_attr(feature = "extra_traits", derive(Debug))]
 pub enum timezone {}
 impl Copy for timezone {}
@@ -1541,6 +1544,17 @@ pub const POSIX_MADV_SEQUENTIAL: c_int = 2;
 pub const POSIX_MADV_WILLNEED: c_int = 3;
 pub const POSIX_MADV_DONTNEED: c_int = 4;
 
+pub const POSIX_SPAWN_RESETIDS: c_short = 0x1;
+pub const POSIX_SPAWN_SETPGROUP: c_short = 0x2;
+pub const POSIX_SPAWN_SETSIGDEF: c_short = 0x4;
+pub const POSIX_SPAWN_SETSIGMASK: c_short = 0x8;
+pub const POSIX_SPAWN_SETSCHEDPARAM: c_short = 0x10;
+pub const POSIX_SPAWN_SETSCHEDULER: c_short = 0x20;
+pub const POSIX_SPAWN_SETSIGIGN_NP: c_short = 0x800;
+pub const POSIX_SPAWN_NOSIGCHLD_NP: c_short = 0x1000;
+pub const POSIX_SPAWN_WAITPID_NP: c_short = 0x2000;
+pub const POSIX_SPAWN_NOEXECERR_NP: c_short = 0x4000;
+
 pub const PTHREAD_CREATE_JOINABLE: c_int = 0;
 pub const PTHREAD_CREATE_DETACHED: c_int = 0x40;
 pub const PTHREAD_PROCESS_SHARED: c_int = 1;
@@ -2686,6 +2700,106 @@ extern "C" {
     pub fn posix_fallocate(fd: c_int, offset: off_t, len: off_t) -> c_int;
     pub fn posix_madvise(addr: *mut c_void, len: size_t, advice: c_int) -> c_int;
 
+    pub fn posix_spawn(
+        pid: *mut crate::pid_t,
+        path: *const c_char,
+        file_actions: *const posix_spawn_file_actions_t,
+        attrp: *const posix_spawnattr_t,
+        argv: *const *mut c_char,
+        envp: *const *mut c_char,
+    ) -> c_int;
+    pub fn posix_spawnp(
+        pid: *mut crate::pid_t,
+        file: *const c_char,
+        file_actions: *const posix_spawn_file_actions_t,
+        attrp: *const posix_spawnattr_t,
+        argv: *const *mut c_char,
+        envp: *const *mut c_char,
+    ) -> c_int;
+
+    pub fn posix_spawn_file_actions_init(file_actions: *mut posix_spawn_file_actions_t) -> c_int;
+    pub fn posix_spawn_file_actions_destroy(file_actions: *mut posix_spawn_file_actions_t)
+        -> c_int;
+    pub fn posix_spawn_file_actions_addopen(
+        file_actions: *mut posix_spawn_file_actions_t,
+        fildes: c_int,
+        path: *const c_char,
+        oflag: c_int,
+        mode: crate::mode_t,
+    ) -> c_int;
+    pub fn posix_spawn_file_actions_addclose(
+        file_actions: *mut posix_spawn_file_actions_t,
+        fildes: c_int,
+    ) -> c_int;
+    pub fn posix_spawn_file_actions_adddup2(
+        file_actions: *mut posix_spawn_file_actions_t,
+        fildes: c_int,
+        newfildes: c_int,
+    ) -> c_int;
+    pub fn posix_spawn_file_actions_addclosefrom_np(
+        file_actions: *mut posix_spawn_file_actions_t,
+        lowfiledes: c_int,
+    ) -> c_int;
+    pub fn posix_spawn_file_actions_addchdir(
+        file_actions: *mut posix_spawn_file_actions_t,
+        path: *const c_char,
+    ) -> c_int;
+    pub fn posix_spawn_file_actions_addchdir_np(
+        file_actions: *mut posix_spawn_file_actions_t,
+        path: *const c_char,
+    ) -> c_int;
+    pub fn posix_spawn_file_actions_addfchdir(
+        file_actions: *mut posix_spawn_file_actions_t,
+        fd: c_int,
+    ) -> c_int;
+
+    pub fn posix_spawnattr_init(attr: *mut posix_spawnattr_t) -> c_int;
+    pub fn posix_spawnattr_destroy(attr: *mut posix_spawnattr_t) -> c_int;
+    pub fn posix_spawnattr_setflags(attr: *mut posix_spawnattr_t, flags: c_short) -> c_int;
+    pub fn posix_spawnattr_getflags(attr: *const posix_spawnattr_t, flags: *mut c_short) -> c_int;
+    pub fn posix_spawnattr_setpgroup(attr: *mut posix_spawnattr_t, pgroup: crate::pid_t) -> c_int;
+    pub fn posix_spawnattr_getpgroup(
+        attr: *const posix_spawnattr_t,
+        _pgroup: *mut crate::pid_t,
+    ) -> c_int;
+    pub fn posix_spawnattr_setschedparam(
+        attr: *mut posix_spawnattr_t,
+        param: *const crate::sched_param,
+    ) -> c_int;
+    pub fn posix_spawnattr_getschedparam(
+        attr: *const posix_spawnattr_t,
+        param: *mut crate::sched_param,
+    ) -> c_int;
+    pub fn posix_spawnattr_setschedpolicy(attr: *mut posix_spawnattr_t, policy: c_int) -> c_int;
+    pub fn posix_spawnattr_getschedpolicy(
+        attr: *const posix_spawnattr_t,
+        _policy: *mut c_int,
+    ) -> c_int;
+    pub fn posix_spawnattr_setsigdefault(
+        attr: *mut posix_spawnattr_t,
+        sigdefault: *const sigset_t,
+    ) -> c_int;
+    pub fn posix_spawnattr_getsigdefault(
+        attr: *const posix_spawnattr_t,
+        sigdefault: *mut sigset_t,
+    ) -> c_int;
+    pub fn posix_spawnattr_setsigignore_np(
+        attr: *mut posix_spawnattr_t,
+        sigignore: *const sigset_t,
+    ) -> c_int;
+    pub fn posix_spawnattr_getsigignore_np(
+        attr: *const posix_spawnattr_t,
+        sigignore: *mut sigset_t,
+    ) -> c_int;
+    pub fn posix_spawnattr_setsigmask(
+        attr: *mut posix_spawnattr_t,
+        sigmask: *const sigset_t,
+    ) -> c_int;
+    pub fn posix_spawnattr_getsigmask(
+        attr: *const posix_spawnattr_t,
+        sigmask: *mut sigset_t,
+    ) -> c_int;
+
     pub fn shmat(shmid: c_int, shmaddr: *const c_void, shmflg: c_int) -> *mut c_void;
 
     pub fn shmctl(shmid: c_int, cmd: c_int, buf: *mut crate::shmid_ds) -> c_int;

src/unix/solarish/solaris.rs

@@ -189,6 +189,8 @@ pub const PRIV_TPD_UNSAFE: c_uint = 0x0800;
 pub const PRIV_PROC_TPD_RESET: c_uint = 0x1000;
 pub const PRIV_TPD_KILLABLE: c_uint = 0x2000;
 
+pub const POSIX_SPAWN_SETSID: c_short = 0x400;
+
 pub const PRIV_USER: c_uint = PRIV_DEBUG
     | PRIV_PROC_SENSITIVE
     | NET_MAC_AWARE