/**************************************************************************** * include/spawn.h * * Copyright (C) 2013 Gregory Nutt. All rights reserved. * Author: Gregory Nutt * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions * are met: * * 1. Redistributions of source code must retain the above copyright * notice, this list of conditions and the following disclaimer. * 2. Redistributions in binary form must reproduce the above copyright * notice, this list of conditions and the following disclaimer in * the documentation and/or other materials provided with the * distribution. * 3. Neither the name NuttX nor the names of its contributors may be * used to endorse or promote products derived from this software * without specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS * FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE * COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, * BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS * OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED * AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN * ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE * POSSIBILITY OF SUCH DAMAGE. * ****************************************************************************/ #ifndef __INCLUDE_SPAWN_H #define __INCLUDE_SPAWN_H /**************************************************************************** * Included Files ****************************************************************************/ #include #include #include #include #include /**************************************************************************** * Pre-processor Definitions ****************************************************************************/ /* Configuration ************************************************************/ #ifndef CONFIG_TASK_SPAWN_DEFAULT_STACKSIZE # define CONFIG_TASK_SPAWN_DEFAULT_STACKSIZE 2048 #endif /* "The spawn.h header shall define the flags that may be set in a * posix_spawnattr_t object using the posix_spawnattr_setflags() function:" */ #define POSIX_SPAWN_RESETIDS (1 << 0) /* 1: Reset effective user ID */ #define POSIX_SPAWN_SETPGROUP (1 << 1) /* 1: Set process group */ #define POSIX_SPAWN_SETSCHEDPARAM (1 << 2) /* 1: Set task's priority */ #define POSIX_SPAWN_SETSCHEDULER (1 << 3) /* 1: Set task's scheduler policy */ #define POSIX_SPAWN_SETSIGDEF (1 << 4) /* 1: Set default signal actions */ #define POSIX_SPAWN_SETSIGMASK (1 << 5) /* 1: Set sigmask */ /**************************************************************************** * Type Definitions ****************************************************************************/ /* "The spawn.h header shall define the posix_spawnattr_t and * posix_spawn_file_actions_t types used in performing spawn operations. * * The internal structure underlying the posix_spawnattr_t is exposed here * because the user will be required to allocate this memory. */ struct posix_spawnattr_s { /* Used by posix_spawn, posix_spawnp, and task_spawn */ uint8_t flags; /* See POSIX_SPAWN_ definitions */ uint8_t priority; /* Task scheduling priority */ uint8_t policy; /* Task scheduling policy */ #ifndef CONFIG_DISABLE_SIGNALS sigset_t sigmask; /* Signals to be masked */ #endif #ifndef CONFIG_BUILD_KERNEL /* Used only by task_spawn (non-standard) */ size_t stacksize; /* Task stack size */ #endif }; typedef struct posix_spawnattr_s posix_spawnattr_t; /* posix_spawn_file_actions_addclose(), posix_spawn_file_actions_adddup2(), * and posix_spawn_file_actions_addopen() will allocate memory and append * a new file action to an instance of posix_spawn_file_actions_t. The * internal representation of these structures is not exposed to the user. * The user need only know that the size sizeof(posix_spawn_file_actions_t) * will hold a pointer to data. */ typedef FAR void *posix_spawn_file_actions_t; /**************************************************************************** * Public Function Prototypes ****************************************************************************/ /* "The following shall be declared as functions and may also be defined as * macros. Function prototypes shall be provided." */ #ifdef __cplusplus extern "C" { #endif /* Spawn interfaces *********************************************************/ /* Standard posix_spawn[p] interfaces. These functions execute files in the * file system at 'path' */ #ifdef CONFIG_BINFMT_EXEPATH int posix_spawnp(FAR pid_t *pid, FAR const char *path, FAR const posix_spawn_file_actions_t *file_actions, FAR const posix_spawnattr_t *attr, FAR char *const argv[], FAR char *const envp[]); #define posix_spawn(pid,path,file_actions,attr,argv,envp) \ posix_spawnp(pid,path,file_actions,attr,argv,envp) #else int posix_spawn(FAR pid_t *pid, FAR const char *path, FAR const posix_spawn_file_actions_t *file_actions, FAR const posix_spawnattr_t *attr, FAR char *const argv[], FAR char *const envp[]); #define posix_spawnp(pid,path,file_actions,attr,argv,envp) \ posix_spawn(pid,path,file_actions,attr,argv,envp) #endif #ifndef CONFIG_BUILD_KERNEL /* Non-standard task_spawn interface. This function uses the same * semantics to execute a file in memory at 'entry', giving it the name * 'name'. */ int task_spawn(FAR pid_t *pid, FAR const char *name, main_t entry, FAR const posix_spawn_file_actions_t *file_actions, FAR const posix_spawnattr_t *attr, FAR char *const argv[], FAR char *const envp[]); #endif /* File action interfaces ***************************************************/ /* File action initialization and destruction */ int posix_spawn_file_actions_init(FAR posix_spawn_file_actions_t *file_actions); int posix_spawn_file_actions_destroy(FAR posix_spawn_file_actions_t *file_actions); /* Add file action interfaces */ int posix_spawn_file_actions_addclose(FAR posix_spawn_file_actions_t *file_actions, int fd); int posix_spawn_file_actions_adddup2(FAR posix_spawn_file_actions_t *file_actions, int fd1, int fd2); int posix_spawn_file_actions_addopen(FAR posix_spawn_file_actions_t *file_actions, int fd, FAR const char *path, int oflags, mode_t mode); /* Spawn attributes interfaces **********************************************/ /* Spawn attributes initialization and destruction */ int posix_spawnattr_init(FAR posix_spawnattr_t *attr); /* int posix_spawnattr_destroy(FAR posix_spawnattr_t *); */ #ifdef CONFIG_DEBUG # define posix_spawnattr_destroy(attr) (attr ? 0 : EINVAL) #else # define posix_spawnattr_destroy(attr) (0) #endif /* Get spawn attributes interfaces */ int posix_spawnattr_getflags(FAR const posix_spawnattr_t *attr, FAR short *flags); #define posix_spawnattr_getpgroup(attr,group) (ENOSYS) int posix_spawnattr_getschedparam(FAR const posix_spawnattr_t *attr, FAR struct sched_param *param); int posix_spawnattr_getschedpolicy(FAR const posix_spawnattr_t *attr, FAR int *policy); #define posix_spawnattr_getsigdefault(attr,sigdefault) (ENOSYS) #ifndef CONFIG_DISABLE_SIGNALS int posix_spawnattr_getsigmask(FAR const posix_spawnattr_t *attr, FAR sigset_t *sigmask); #else # define posix_spawnattr_getsigmask(attr,sigmask) (ENOSYS) #endif /* Set spawn attributes interfaces */ int posix_spawnattr_setflags(FAR posix_spawnattr_t *attr, short flags); #define posix_spawnattr_setpgroup(attr,group) (ENOSYS) int posix_spawnattr_setschedparam(FAR posix_spawnattr_t *attr, FAR const struct sched_param *param); int posix_spawnattr_setschedpolicy(FAR posix_spawnattr_t *attr, int policy); #define posix_spawnattr_setsigdefault(attr,sigdefault) (ENOSYS) #ifndef CONFIG_DISABLE_SIGNALS int posix_spawnattr_setsigmask(FAR posix_spawnattr_t *attr, FAR const sigset_t *sigmask); #else # define posix_spawnattr_setsigmask(attr,sigmask) (ENOSYS) #endif /* Non-standard get/set spawn attributes interfaces for use only with * task_spawn() */ int task_spawnattr_getstacksize(FAR const posix_spawnattr_t *attr, size_t *stacksize); int task_spawnattr_setstacksize(FAR posix_spawnattr_t *attr, size_t stacksize); /* Non standard debug functions */ #ifdef CONFIG_DEBUG void posix_spawn_file_actions_dump(FAR posix_spawn_file_actions_t *file_actions); void posix_spawnattr_dump(FAR posix_spawnattr_t *attr); #else # define posix_spawn_file_actions_dump(fa) # define posix_spawnattr_dump(a) #endif #ifdef __cplusplus } #endif #endif /* __INCLUDE_SPAWN_H */