~ubuntu-branches/debian/jessie/systemd/jessie

« back to all changes in this revision

Viewing changes to man/sd_notify.3

  • Committer: Package Import Robot
  • Author(s): Tollef Fog Heen, Tollef Fog Heen, Michael Biebl
  • Date: 2012-04-03 19:59:17 UTC
  • mfrom: (1.1.10) (6.1.3 experimental)
  • Revision ID: package-import@ubuntu.com-20120403195917-l532urrbg4pkreas
Tags: 44-1
[ Tollef Fog Heen ]
* New upstream version.
  - Backport 3492207: journal: PAGE_SIZE is not known on ppc and other
    archs
  - Backport 5a2a2a1: journal: react with immediate rotation to a couple
    of more errors
  - Backport 693ce21: util: never follow symlinks in rm_rf_children()
    Fixes CVE-2012-1174, closes: #664364
* Drop output message from init-functions hook, it's pointless.
* Only rmdir /lib/init/rw if it exists.
* Explicitly order debian-fixup before sysinit.target to prevent a
  possible race condition with the creation of sockets.  Thanks to
  Michael Biebl for debugging this.
* Always restart the initctl socket on upgrades, to mask sysvinit
  removing it.

[ Michael Biebl ]
* Remove workaround for non-interactive sessions from pam config again.
* Create compat /dev/initctl symlink in case we are upgrading from a system
  running a newer version of sysvinit (using /run/initctl) and sysvinit is
  replaced with systemd-sysv during the upgrade. Closes: #663219
* Install new man pages.
* Build-Depend on valac (>= 0.12) instead of valac-0.12. Closes: #663323

Show diffs side-by-side

added added

removed removed

Lines of Context:
2
2
.\"     Title: sd_notify
3
3
.\"    Author: Lennart Poettering <lennart@poettering.net>
4
4
.\" Generator: DocBook XSL Stylesheets v1.76.1 <http://docbook.sf.net/>
5
 
.\"      Date: 10/11/2011
 
5
.\"      Date: 03/16/2012
6
6
.\"    Manual: sd_notify
7
7
.\"    Source: systemd
8
8
.\"  Language: English
9
9
.\"
10
 
.TH "SD_NOTIFY" "3" "10/11/2011" "systemd" "sd_notify"
 
10
.TH "SD_NOTIFY" "3" "03/16/2012" "systemd" "sd_notify"
11
11
.\" -----------------------------------------------------------------
12
12
.\" * Define some portability stuff
13
13
.\" -----------------------------------------------------------------
33
33
.sp
34
34
.ft B
35
35
.nf
36
 
#include "sd\-daemon\&.h"
 
36
#include <systemd/sd\-daemon\&.h>
37
37
.fi
38
38
.ft
39
39
.HP \w'int\ sd_notify('u
84
84
The main pid of the daemon, in case the init system did not fork off the process itself\&. Example: "MAINPID=4711"
85
85
.RE
86
86
.PP
 
87
WATCHDOG=1
 
88
.RS 4
 
89
Tells systemd to update the watchdog timestamp\&. Services using this feature should do this in regular intervals\&. A watchdog framework can use the timestamps to detect failed services\&.
 
90
.RE
 
91
.PP
87
92
It is recommended to prefix variable names that are not shown in the list above with
88
93
\fIX_\fR
89
94
to avoid namespace clashes\&.
96
101
.PP
97
102
\fBsd_notifyf()\fR
98
103
is similar to
99
 
\fBsd_notifyf()\fR
 
104
\fBsd_notify()\fR
100
105
but takes a
101
106
\fBprintf()\fR\-like format string plus arguments\&.
102
107
.SH "RETURN VALUE"
115
120
is @ the string is understood as Linux abstract namespace socket\&. The datagram is accompanied by the process credentials of the sending daemon, using SCM_CREDENTIALS\&.
116
121
.PP
117
122
For details about the algorithms check the liberally licensed reference implementation sources:
118
 
\m[blue]\fB\%http://cgit.freedesktop.org/systemd/tree/src/sd-daemon.c\fR\m[]
 
123
\m[blue]\fB\%http://cgit.freedesktop.org/systemd/systemd/plain/src/sd-daemon.c\fR\m[]
119
124
resp\&.
120
 
\m[blue]\fB\%http://cgit.freedesktop.org/systemd/tree/src/sd-daemon.h\fR\m[]
 
125
\m[blue]\fB\%http://cgit.freedesktop.org/systemd/systemd/plain/src/systemd/sd-daemon.h\fR\m[]
121
126
.PP
122
127
\fBsd_notify()\fR
123
128
and