X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?a=blobdiff_plain;f=src%2Fsystemd%2Fsd-daemon.h;h=305b4d604afa85665e1423b86ccde4f3c48fa170;hb=d77d27f4ca2945f88343fbe72ed0bf1236ad2aa6;hp=1d636df3ea51a620c75569faf9a26a0b75cf3f9d;hpb=952d1536f4d7b64cfe938a569402434decffe4cd;p=elogind.git diff --git a/src/systemd/sd-daemon.h b/src/systemd/sd-daemon.h index 1d636df3e..305b4d604 100644 --- a/src/systemd/sd-daemon.h +++ b/src/systemd/sd-daemon.h @@ -1,5 +1,3 @@ -/*-*- Mode: C; c-basic-offset: 8; indent-tabs-mode: nil -*-*/ - #ifndef foosddaemonhfoo #define foosddaemonhfoo @@ -22,8 +20,8 @@ along with systemd; If not, see . ***/ -#include #include +#include #include "_sd-common.h" @@ -59,6 +57,7 @@ _SD_BEGIN_DECLARATIONS; /* The first passed file descriptor is fd 3 */ #define SD_LISTEN_FDS_START 3 +#if 0 /// UNNEEDED by elogind /* Returns how many file descriptors have been passed, or a negative errno code on failure. Optionally, removes the $LISTEN_FDS and @@ -76,6 +75,8 @@ _SD_BEGIN_DECLARATIONS; */ int sd_listen_fds(int unset_environment); +int sd_listen_fds_with_names(int unset_environment, char ***names); + /* Helper call for identifying a passed file descriptor. Returns 1 if the file descriptor is a FIFO in the file system stored under the @@ -99,6 +100,7 @@ int sd_is_fifo(int fd, const char *path); See sd_is_special(3) for more information. */ int sd_is_special(int fd, const char *path); +#endif // 0 /* Helper call for identifying a passed file descriptor. Returns 1 if @@ -116,6 +118,7 @@ int sd_is_special(int fd, const char *path); */ int sd_is_socket(int fd, int family, int type, int listening); +#if 0 /// UNNEEDED by elogind /* Helper call for identifying a passed file descriptor. Returns 1 if the file descriptor is an Internet socket, of the specified family @@ -155,6 +158,7 @@ int sd_is_socket_unix(int fd, int type, int listening, const char *path, size_t See sd_is_mq(3) for more information. */ int sd_is_mq(int fd, const char *path); +#endif // 0 /* Informs systemd about changed daemon state. This takes a number of @@ -168,7 +172,7 @@ int sd_is_mq(int fd, const char *path); value daemons should send is "READY=1". STATUS=... Passes a single-line status string back to systemd - that describes the daemon state. This is free-from + that describes the daemon state. This is free-form and can be used for various purposes: general state feedback, fsck-like programs could pass completion percentages and failing programs could pass a human @@ -190,6 +194,17 @@ int sd_is_mq(int fd, const char *path); timestamps to detect failed services. Also see sd_watchdog_enabled() below. + FDSTORE=1 Store the file descriptors passed along with the + message in the per-service file descriptor store, + and pass them to the main process again on next + invocation. This variable is only supported with + sd_pid_notify_with_fds(). + + WATCHDOG_USEC=... + Reset watchdog_usec value during runtime. + To reset watchdog_usec value, start the service again. + Example: "WATCHDOG_USEC=20000000" + Daemons can choose to send additional variables. However, it is recommended to prefix variable names not listed above with X_. @@ -208,6 +223,7 @@ int sd_is_mq(int fd, const char *path); */ int sd_notify(int unset_environment, const char *state); +#if 0 /// UNNEEDED by elogind /* Similar to sd_notify() but takes a format string. @@ -230,6 +246,27 @@ int sd_notify(int unset_environment, const char *state); */ int sd_notifyf(int unset_environment, const char *format, ...) _sd_printf_(2,3); +/* + Similar to sd_notify(), but send the message on behalf of another + process, if the appropriate permissions are available. +*/ +int sd_pid_notify(pid_t pid, int unset_environment, const char *state); + +/* + Similar to sd_notifyf(), but send the message on behalf of another + process, if the appropriate permissions are available. +*/ +int sd_pid_notifyf(pid_t pid, int unset_environment, const char *format, ...) _sd_printf_(3,4); +#endif // 0 + +/* + Similar to sd_pid_notify(), but also passes the specified fd array + to the service manager for storage. This is particularly useful for + FDSTORE=1 messages. +*/ +int sd_pid_notify_with_fds(pid_t pid, int unset_environment, const char *state, const int *fds, unsigned n_fds); + +#if 0 /// UNNEEDED by elogind /* Returns > 0 if the system was booted with systemd. Returns < 0 on error. Returns 0 if the system was not booted with systemd. Note @@ -242,6 +279,7 @@ int sd_notifyf(int unset_environment, const char *format, ...) _sd_printf_(2,3); See sd_booted(3) for more information. */ int sd_booted(void); +#endif // 0 /* Returns > 0 if the service manager expects watchdog keep-alive