diff options
Diffstat (limited to 'libdaemon/dexec.h')
-rw-r--r-- | libdaemon/dexec.h | 84 |
1 files changed, 84 insertions, 0 deletions
diff --git a/libdaemon/dexec.h b/libdaemon/dexec.h new file mode 100644 index 0000000..7c03017 --- /dev/null +++ b/libdaemon/dexec.h @@ -0,0 +1,84 @@ +#ifndef foodexechfoo +#define foodexechfoo + +/*** + This file is part of libdaemon. + + Copyright 2003-2008 Lennart Poettering + + Permission is hereby granted, free of charge, to any person obtaining a copy + of this software and associated documentation files (the "Software"), to deal + in the Software without restriction, including without limitation the rights + to use, copy, modify, merge, publish, distribute, sublicense, and/or sell + copies of the Software, and to permit persons to whom the Software is + furnished to do so, subject to the following conditions: + + The above copyright notice and this permission notice shall be included in + all copies or substantial portions of the Software. + + THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR + IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, + FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE + AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER + LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, + OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE + SOFTWARE. + +***/ + +#include <stdarg.h> + +#ifdef __cplusplus +extern "C" { +#endif + +/** \file + * + * Contains a robust API for running sub processes with STDOUT and + * STDERR redirected to syslog + */ + +/** This variable is defined to 1 iff daemon_exec() is supported. + * @since 0.4 + * @see daemon_exec() */ +#define DAEMON_EXEC_AVAILABLE 1 + +#if defined(__GNUC__) && ! defined(DAEMON_GCC_SENTINEL) +#define DAEMON_GCC_SENTINEL __attribute__ ((sentinel)) +#else +/** A macro for making use of GCCs printf compilation warnings */ +#define DAEMON_GCC_SENTINEL +#endif + +/** 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. + * + * @param dir Working directory for the process. + * @param ret A pointer to an integer to write the return value of the program to. + * @param prog The path to the executable + * @param ... The arguments to be passed to the program, followed by a (char *) NULL + * @return Nonzero on failure, zero on success + * @since 0.4 + * @see DAEMON_EXEC_AVAILABLE + */ +int daemon_exec(const char *dir, int *ret, const char *prog, ...) DAEMON_GCC_SENTINEL; + +/** This variable is defined to 1 iff daemon_execv() is supported. + * @since 0.11 + * @see daemon_execv() */ +#define DAEMON_EXECV_AVAILABLE 1 + +/** The same as daemon_exec, but without variadic arguments + * @since 0.11 + * @see DAEMON_EXECV_AVAILABLE */ +int daemon_execv(const char *dir, int *ret, const char *prog, va_list ap); + +#ifdef __cplusplus +} +#endif + +#endif |