X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?a=blobdiff_plain;f=man%2Fsd_notify.xml;h=ae6792dd708185650163e9c2239edac8e8173b73;hb=47f94046d2208b0ca48928df3ac3bce803361f23;hp=03efe0193a7501bfd3bb4863feaa1903bc335156;hpb=35eec258c4523c92fe985d764198b266ebc3881a;p=elogind.git
diff --git a/man/sd_notify.xml b/man/sd_notify.xml
index 03efe0193..ae6792dd7 100644
--- a/man/sd_notify.xml
+++ b/man/sd_notify.xml
@@ -66,7 +66,7 @@
int sd_notifyf
int unset_environment
const char *format
- ...
+ â¦
@@ -81,7 +81,7 @@
pid_t pid
int unset_environment
const char *format
- ...
+ â¦
@@ -152,7 +152,7 @@
- STATUS=...
+ STATUS=â¦
Passes a single-line UTF-8 status string back
to the service manager that describes the service state. This
@@ -160,11 +160,11 @@
state feedback, fsck-like programs could pass completion
percentages and failing programs could pass a human-readable
error message. Example: STATUS=Completed 66% of file
- system check...
+ system checkâ¦
- ERRNO=...
+ ERRNO=â¦
If a service fails, the errno-style error
code, formatted as string. Example: ERRNO=2
@@ -172,7 +172,7 @@
- BUSERROR=...
+ BUSERROR=â¦
If a service fails, the D-Bus error-style
error code. Example:
@@ -180,7 +180,7 @@
- MAINPID=...
+ MAINPID=â¦
The main process ID (PID) of the service, in
case the service manager did not fork off the process itself.
@@ -205,32 +205,29 @@
FDSTORE=1
- Stores additional file descriptors in the
- service manager. File descriptors sent this way will be
- maintained per-service by the service manager and be passed
- again using the usual file descriptor passing logic on the
- next invocation of the service (see
- sd_listen_fds3).
- This is useful for implementing service restart schemes where
- services serialize their state to /run,
- push their file descriptors to the system manager, and are
- then restarted, retrieving their state again via socket
- passing and /run. Note that the service
- manager will accept messages for a service only if
- FileDescriptorStoreMax= is set to non-zero
- for it (defaults to zero). See
- systemd.service5
- for details. Multiple arrays of file descriptors may be sent
- in separate messages, in which case the arrays are combined.
- Note that the service manager removes duplicate file
- descriptors before passing them to the service. Use
- sd_pid_notify_with_fds() to send messages
- with FDSTORE=1, see
- below.
+ Stores additional file descriptors in the service manager. File
+ descriptors sent this way will be maintained per-service by the service manager
+ and will be passed again using the usual file descriptor passing logic on the next
+ invocation of the service, see
+ sd_listen_fds3.
+ This is useful for implementing service restart schemes where services serialize
+ their state to /run, push their file descriptors to the
+ system manager, and are then restarted, retrieving their state again via socket
+ passing and /run. Note that the service manager will accept
+ messages for a service only if FileDescriptorStoreMax= is set
+ to non-zero for it (defaults to zero, see
+ systemd.service5).
+ File descriptors must be pollable, see
+ epoll_ctl2.
+ Multiple arrays of file descriptors may be sent in separate messages, in which
+ case the arrays are combined. Note that the service manager removes duplicate
+ file descriptors before passing them to the service. Use
+ sd_pid_notify_with_fds() to send messages with
+ FDSTORE=1, see below.
- FDNAME=...
+ FDNAME=â¦
When used in combination with
FDSTORE=1, specifies a name for the
@@ -251,7 +248,7 @@
- WATCHDOG_USEC=...
+ WATCHDOG_USEC=â¦
Reset watchdog_usec value during runtime.
Notice that this is not available when using sd_event_set_watchdog()
@@ -365,7 +362,7 @@
initialization:
sd_notifyf(0, "READY=1\n"
- "STATUS=Processing requests...\n"
+ "STATUS=Processing requestsâ¦\n"
"MAINPID=%lu",
(unsigned long) getpid());