diff options
| -rw-r--r-- | include/unistd.h | 91 |
1 files changed, 91 insertions, 0 deletions
diff --git a/include/unistd.h b/include/unistd.h index 33a3db0..9c2b419 100644 --- a/include/unistd.h +++ b/include/unistd.h @@ -643,6 +643,97 @@ int execvpeat(int, const char*, char* const[], char* const[], int) #endif +#if defined(_SLIBC_SOURCE) && !defined(__PORTABLE) +/** + * Replace the current process image with a new process image. + * + * This is a slibc extension. + * + * @param fd File descriptor for the file to execute. + * @param ... The arguments with which to execute the file. + * The arguments should have the type `const char*`. + * As a slibc extension, it can be empty. + * This list shall be terminated by a `NULL` sentinel. + * @return This function does not return on success, + * on error, -1 is returned and `errno` is + * set to describe the error. + * + * @throws Any error specified for execve(2). + */ +int fexecl(int, ... /*, NULL */) + __GCC_ONLY(__attribute__((sentinel(0)))); + +/** + * Replace the current process image with a new process image. + * + * This is a slibc extension. + * + * @param fd File descriptor for the file to execute. + * @param ... The arguments with which to execute the file. + * The arguments should have the type `const char*`. + * As a slibc extension, it can be empty. + * This list shall be terminated by a `NULL` sentinel. + * @param envp The list of environment variables the new program shall + * have set. Each element shall be formatted $name=$value. + * This list shall be `NULL`-terminated. The behaviour + * is system-dependant if this argument is `NULL`. + * @return This function does not return on success, + * on error, -1 is returned and `errno` is + * set to describe the error. + * + * @throws Any error specified for execve(2). + */ +int fexecle(int, ... /*, NULL, char* const[] */) + __GCC_ONLY(__attribute__((sentinel(1)))); + +/** + * Replace the current process image with a new process image. + * + * This is a slibc extension. + * + * @param fd File descriptor for the file to execute. + * @param argv The arguments with which to execute the file. + * This parameter should really have the type + * `const char* const[]`, but that probably not + * so because compiles take issue with casts + * adding const to any pointer in the type + * except the outmost pointer. This list shall + * be `NULL`-terminated. The behaviour is + * system-dependant if this argument is `NULL`. + * @return This function does not return on success, + * on error, -1 is returned and `errno` is + * set to describe the error. + * + * @throws Any error specified for execve(2). + */ +int fexecv(int, char* const[]); +#endif + +/** + * Replace the current process image with a new process image. + * + * @param fd File descriptor for the file to execute. + * @param argv The arguments with which to execute the file. + * This parameter should really have the type + * `const char* const[]`, but that probably not + * so because compiles take issue with casts + * adding const to any pointer in the type + * except the outmost pointer. This list shall + * be `NULL`-terminated. The behaviour is + * system-dependant if this argument is `NULL`. + * @param envp The list of environment variables the new program shall + * have set. Each element shall be formatted $name=$value. + * This list shall be `NULL`-terminated. The behaviour + * is system-dependant if this argument is `NULL`. + * @return This function does not return on success, + * on error, -1 is returned and `errno` is + * set to describe the error. + * + * @throws Any error specified for execve(2). + */ +int fexecve(int, char* const[], char* const[]); + + #endif |