dwww Home | Manual pages | Find package

dexec.h(3)                         libdaemon                         dexec.h(3)

NAME
       dexec.h - Contains a robust API for running sub processes with STDOUT
       and STDERR redirected to syslog.

SYNOPSIS
       #include <stdarg.h>

   Macros
       #define DAEMON_EXEC_AVAILABLE   1
           This variable is defined to 1 iff daemon_exec() is supported.
       #define DAEMON_GCC_SENTINEL
           A macro for making use of GCCs printf compilation warnings.
       #define DAEMON_EXECV_AVAILABLE   1
           This variable is defined to 1 iff daemon_execv() is supported.

   Functions
       int daemon_exec (const char *dir, int *ret, const char *prog,...)
           DAEMON_GCC_SENTINEL
           Run the specified executable with the specified arguments in the
           specified directory and return the return value of the program in
           the specified pointer.
       int daemon_execv (const char *dir, int *ret, const char *prog, va_list
           ap)
           The same as daemon_exec, but without variadic arguments.

Detailed Description
       Contains a robust API for running sub processes with STDOUT and STDERR
       redirected to syslog.

       Definition in file dexec.h.

Macro Definition Documentation
   #define DAEMON_EXEC_AVAILABLE   1
       This variable is defined to 1 iff daemon_exec() is supported.

       Since
           0.4

       See also
           daemon_exec()

       Definition at line 39 of file dexec.h.

   #define DAEMON_EXECV_AVAILABLE   1
       This variable is defined to 1 iff daemon_execv() is supported.

       Since
           0.11

       See also
           daemon_execv()

       Definition at line 68 of file dexec.h.

   #define DAEMON_GCC_SENTINEL
       A macro for making use of GCCs printf compilation warnings.

       Definition at line 45 of file dexec.h.

Function Documentation
   int daemon_exec (const char * dir, int * ret, const char * prog,  ...)
       Run the specified executable with the specified arguments in the
       specified directory and return the return value of the program in the
       specified pointer. The calling process is blocked until the child
       finishes and all child output (either STDOUT or STDIN) has been written
       to syslog. Running this function requires that daemon_signal() has been
       called with SIGCHLD as argument.

       Parameters
           dir Working directory for the process.
           ret A pointer to an integer to write the return value of the program
           to.
           prog The path to the executable
           ... The arguments to be passed to the program, followed by a (char
           *) NULL

       Returns
           Nonzero on failure, zero on success

       Since
           0.4

       See also
           DAEMON_EXEC_AVAILABLE

       Examples
           testd.c.

   int daemon_execv (const char * dir, int * ret, const char * prog, va_list
       ap)
       The same as daemon_exec, but without variadic arguments.

       Since
           0.11

       See also
           DAEMON_EXECV_AVAILABLE

Author
       Generated automatically by Doxygen for libdaemon from the source code.

Version 0.14                    Mon Dec 21 2020                      dexec.h(3)

Generated by dwww version 1.16 on Sat Oct 3 07:32:22 CEST 2026.