:orphan: .. index:: pair: group; Execute a program in a child process .. _doxid-group__te__tools__te__exec__child: Execute a program in a child process ==================================== .. toctree:: :hidden: enum_te_exec_param_type.rst enum_te_sched_param_type.rst struct_te_exec_affinity_param.rst struct_te_exec_param.rst struct_te_exec_priority_param.rst struct_te_exec_workdir_param.rst Overview ~~~~~~~~ Routines to execute a program in a child process :ref:`More...` .. ref-code-block:: cpp :class: doxyrest-overview-code-block // typedefs typedef enum :ref:`te_exec_param_type` :ref:`te_exec_param_type`; typedef enum :ref:`te_sched_param_type` :ref:`te_sched_param_type`; typedef struct :ref:`te_exec_param` :ref:`te_exec_param`; typedef :ref:`te_exec_param` :ref:`te_sched_param`; typedef struct :ref:`te_exec_affinity_param` :ref:`te_exec_affinity_param`; typedef :ref:`te_exec_affinity_param` :ref:`te_sched_affinity_param`; typedef struct :ref:`te_exec_priority_param` :ref:`te_exec_priority_param`; typedef :ref:`te_exec_priority_param` :ref:`te_sched_priority_param`; typedef struct :ref:`te_exec_workdir_param` :ref:`te_exec_workdir_param`; // enums enum :ref:`te_exec_param_type`; enum :ref:`te_sched_param_type`; // structs struct :ref:`te_exec_affinity_param`; struct :ref:`te_exec_param`; struct :ref:`te_exec_priority_param`; struct :ref:`te_exec_workdir_param`; // global functions pid_t :ref:`te_exec_child`(const char* file, char*const argv[], char*const envp[], uid_t uid, int* in_fd, int* out_fd, int* err_fd, const :ref:`te_exec_param`* exec_param); // macros #define :target:`TE_EXEC_CHILD_DEV_NULL_FD` .. _details-group__te__tools__te__exec__child: Detailed Documentation ~~~~~~~~~~~~~~~~~~~~~~ Routines to execute a program in a child process Typedefs -------- .. index:: pair: typedef; te_exec_param_type .. _doxid-group__te__tools__te__exec__child_1gad647ff4c53b681547a6662bb85f1f251: .. ref-code-block:: cpp :class: doxyrest-title-code-block typedef enum :ref:`te_exec_param_type` te_exec_param_type Kinds of process parameters. .. index:: pair: typedef; te_sched_param_type .. _doxid-group__te__tools__te__exec__child_1ga3461e5186b2c6ec5c9b114e222232d60: .. ref-code-block:: cpp :class: doxyrest-title-code-block typedef enum :ref:`te_sched_param_type` te_sched_param_type Use ``te_exec_param_type`` in the new code. Deprecated .. index:: pair: typedef; te_exec_param .. _doxid-group__te__tools__te__exec__child_1ga52f217c5921ef2c9e60b4281c0bd66e6: .. ref-code-block:: cpp :class: doxyrest-title-code-block typedef struct :ref:`te_exec_param` te_exec_param Process parameter. .. index:: pair: typedef; te_sched_param .. _doxid-group__te__tools__te__exec__child_1gab02c35e789fce26a1fa5f4208d9e7369: .. ref-code-block:: cpp :class: doxyrest-title-code-block typedef :ref:`te_exec_param` te_sched_param Use ``:ref:`te_exec_param ``` in the new code. Deprecated .. index:: pair: typedef; te_exec_affinity_param .. _doxid-group__te__tools__te__exec__child_1ga96e63bfd9e5c4e079746dd775b28177a: .. ref-code-block:: cpp :class: doxyrest-title-code-block typedef struct :ref:`te_exec_affinity_param` te_exec_affinity_param Data specific for CPU affinity type (``TE_EXEC_AFFINITY``). .. index:: pair: typedef; te_sched_affinity_param .. _doxid-group__te__tools__te__exec__child_1gaddd48af21092e30666b6910d6e51be86: .. ref-code-block:: cpp :class: doxyrest-title-code-block typedef :ref:`te_exec_affinity_param` te_sched_affinity_param Use ``:ref:`te_exec_affinity_param ``` in the new code. Deprecated .. index:: pair: typedef; te_exec_priority_param .. _doxid-group__te__tools__te__exec__child_1ga92fb08712ecb11a35b875740d1be9739: .. ref-code-block:: cpp :class: doxyrest-title-code-block typedef struct :ref:`te_exec_priority_param` te_exec_priority_param Data specific for priority type (``TE_EXEC_PRIORITY``). .. index:: pair: typedef; te_sched_priority_param .. _doxid-group__te__tools__te__exec__child_1ga3a1ffad3d5dd9440a6d0c5745af89dbd: .. ref-code-block:: cpp :class: doxyrest-title-code-block typedef :ref:`te_exec_priority_param` te_sched_priority_param Use ``:ref:`te_exec_priority_param ``` in the new code. Deprecated .. index:: pair: typedef; te_exec_workdir_param .. _doxid-group__te__tools__te__exec__child_1ga60a169570af1c6e6d6a513f502891ac2: .. ref-code-block:: cpp :class: doxyrest-title-code-block typedef struct :ref:`te_exec_workdir_param` te_exec_workdir_param Data specific for working directory type (``TE_EXEC_WORKDIR``). Global Functions ---------------- .. index:: pair: function; te_exec_child .. _doxid-group__te__tools__te__exec__child_1ga4e6e1d8339021d32e2fa90ae0148bf78: .. ref-code-block:: cpp :class: doxyrest-title-code-block pid_t te_exec_child(const char* file, char*const argv[], char*const envp[], uid_t uid, int* in_fd, int* out_fd, int* err_fd, const :ref:`te_exec_param`* exec_param) Function to base system()-like and popen()-like functions on it. You MUST use uid parameter instead of "su - user -c", because su makes one more fork, and you do not know how to kill this grandchild process. The function: 1) creates pipes (if necessary) to communicate with a child process; 2) fork()'s the child process; 3) modifies standard file descriptors of the child process according to ``in_fd`` ``out_fd`` ``err_fd``; 4) executes specified program in the child process; if a file descriptor location is ``NULL``, copy of the respective standard file descriptor will be inherited by the child; if a file descriptor location is ``TE_EXEC_CHILD_DEV_NULL_FD``, the respective standard file descriptor of the child will be redirected to /dev/null If you use this fuction from agent, this process SHOULD be catched by :ref:`ta_waitpid() ` or killed by :ref:`ta_kill_death() `. .. rubric:: Parameters: .. list-table:: :widths: 20 80 * - file - file to execute * - argv - command line arguments terminated by ``NULL``; MUST NOT be ``NULL`` * - envp - environment variables terminated by ``NULL``; use NULL to keep the current environment * - uid - user id to execute the file; use -1 for default * - in_fd - location to store file descriptor of pipe to stdin of the process; see note * - out_fd - location to store file descriptor of pipe to stdout of the process; see note * - out_fd - location to store file descriptor of pipe to stderr of the process; see note * - exec_param - Array of process parameters. The last element must have the type TE_EXEC_END and data pointer to ``NULL``. May be ``NULL``. .. rubric:: Returns: pid value, positive on success, negative on failure