← Back to branch summary

~ubuntu-branches/ubuntu/trusty/systemd/trusty

« back to all changes in this revision

Viewing changes to man/sd-login.7

  • Committer: Package Import Robot
  • Author(s): Michael Biebl, Michael Biebl, Michael Stapelberg, Daniel Schaal, Ondrej Balaz
  • Date: 2013-09-12 00:13:11 UTC
  • mfrom: (1.1.11) (9.1.2 experimental)
  • mto: This revision was merged to the branch mainline in revision 53.
  • Revision ID: package-import@ubuntu.com-20130912001311-dz35it34wr2lbday
Tags: 204-3
http://bugs.debian.org/719444
http://bugs.debian.org/721347
http://bugs.debian.org/722180
http://bugs.debian.org/709780
http://bugs.debian.org/711245
[ Michael Biebl ]
* Upload to unstable.
* Use /bin/bash in debug-shell.service as Debian doesn't have /sbin/sushell.
* Only import net.ifaces cmdline property for network devices.
* Generate strict dependencies between the binary packages using a
  shlibs.local file and add an explicit versioned dependency on
  libsystemd-login0 to systemd to ensure packages are upgraded in sync.
  Closes: #719444
* Drop obsolete Replaces: libudev0 from udev package.
* Use correct paths for various binaries, like /sbin/quotaon, which are
  installed in / and not /usr in Debian.  Closes: #721347
* Don't install kernel-install(8) man page since we don't install the
  corresponding binary either.  Closes: #722180
* Cherry-pick upstream fixes to make switching runlevels and starting
  reboot via ctrl-alt-del more robust.
* Cherry-pick upstream fix to properly apply ACLs to Journal files.

[ Michael Stapelberg ]
* Make systemctl enable|disable call update-rc.d for SysV init scripts.
  Closes: #709780
* Don't mount /tmp as tmpfs by default and make it possible to enable this
  feature via "systemctl enable tmp.mount".

[ Daniel Schaal ]
* Add bug-script to systemd and udev.  Closes: #711245

[ Ondrej Balaz ]
* Recognize discard option in /etc/crypttab.

Show diffs side-by-side

added added

removed removed

Lines of Context:
man/sd-login.7
1
 
'\" t
2
 
.\"     Title: sd-login
3
 
.\"    Author: Lennart Poettering <lennart@poettering.net>
4
 
.\" Generator: DocBook XSL Stylesheets v1.76.1 <http://docbook.sf.net/>
5
 
.\"      Date: 03/16/2012
6
 
.\"    Manual: sd-login
7
 
.\"    Source: systemd
8
 
.\"  Language: English
9
 
.\"
10
 
.TH "SD\-LOGIN" "7" "03/16/2012" "systemd" "sd-login"
11
 
.\" -----------------------------------------------------------------
12
 
.\" * Define some portability stuff
13
 
.\" -----------------------------------------------------------------
14
 
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
15
 
.\" http://bugs.debian.org/507673
16
 
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
17
 
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
18
 
.ie \n(.g .ds Aq \(aq
19
 
.el       .ds Aq '
20
 
.\" -----------------------------------------------------------------
21
 
.\" * set default formatting
22
 
.\" -----------------------------------------------------------------
23
 
.\" disable hyphenation
24
 
.nh
25
 
.\" disable justification (adjust text to left margin only)
26
 
.ad l
27
 
.\" -----------------------------------------------------------------
28
 
.\" * MAIN CONTENT STARTS HERE *
29
 
.\" -----------------------------------------------------------------
30
 
.SH "NAME"
31
 
sd-login \- APIs for tracking logins
32
 
.SH "SYNOPSIS"
33
 
.sp
34
 
.ft B
35
 
.nf
36
 
#include <systemd/sd\-login\&.h>
37
 
.fi
38
 
.ft
39
 
.HP \w'\fBpkg\-config\ \-\-cflags\ \-\-libs\ libsystemd\-login\fR\ 'u
40
 
\fBpkg\-config \-\-cflags \-\-libs libsystemd\-login\fR
41
 
.SH "DESCRIPTION"
42
 
.PP
43
 
sd\-login\&.h
44
 
provides APIs to introspect and monitor seat, login session and user status information on the local system\&.
45
 
.PP
46
 
See
47
 
\m[blue]\fBMulti\-Seat on Linux\fR\m[]\&\s-2\u[1]\d\s+2
48
 
for an introduction into multi\-seat support on Linux, the background for this set of APIs\&.
49
 
.PP
50
 
Note that these APIs only allow purely passive access and monitoring of seats, sessions and users\&. To actively make changes to the seat configuration, terminate login sessions, or switch session on a seat you need to utilize the D\-Bus API of systemd\-logind, instead\&.
51
 
.PP
52
 
These functions synchronously access data in
53
 
/proc,
54
 
/sys/fs/cgroup
55
 
and
56
 
/run\&. All of these are virtual file systems, hence the runtime cost of the accesses is relatively cheap\&.
57
 
.PP
58
 
It is possible (and often a very good choice) to mix calls to the synchronous interface of
59
 
sd\-login\&.h
60
 
with the asynchronous D\-Bus interface of systemd\-logind\&. However, if this is done you need to think a bit about possible races since the stream of events from D\-Bus and from
61
 
sd\-login\&.h
62
 
interfaces such as the login monitor are asynchronous and not ordered against each other\&.
63
 
.PP
64
 
If the functions return string arrays, these are generally NULL terminated and need to be freed by the caller with the libc
65
 
\fBfree\fR(3)
66
 
call after use, including the strings referenced therein\&. Similar, individual strings returned need to be freed, as well\&.
67
 
.PP
68
 
As a special exception, instead of an empty string array NULL may be returned, which should be treated equivalent to an empty string array\&.
69
 
.PP
70
 
See
71
 
\fBsd_pid_get_session\fR(3),
72
 
\fBsd_uid_get_state\fR(3),
73
 
\fBsd_session_is_active\fR(3),
74
 
\fBsd_seat_get_active\fR(3),
75
 
\fBsd_get_seats\fR(3),
76
 
\fBsd_login_monitor_new\fR(3)
77
 
for more information about the functions implemented\&.
78
 
.SH "NOTES"
79
 
.PP
80
 
These APIs are implemented as shared library, which can be compiled and linked to with the
81
 
libsystemd\-login
82
 
\fBpkg-config\fR(1)
83
 
file\&.
84
 
.SH "SEE ALSO"
85
 
.PP
86
 
 
87
 
\fBsystemd\fR(1),
88
 
\fBsd_pid_get_session\fR(3),
89
 
\fBsd_uid_get_state\fR(3),
90
 
\fBsd_session_is_active\fR(3),
91
 
\fBsd_seat_get_active\fR(3),
92
 
\fBsd_get_seats\fR(3),
93
 
\fBsd_login_monitor_new\fR(3),
94
 
\fBsd-daemon\fR(7),
95
 
\fBsd-readahead\fR(7),
96
 
\fBpkg-config\fR(1)
97
 
.SH "AUTHOR"
98
 
.PP
99
 
\fBLennart Poettering\fR <\&lennart@poettering\&.net\&>
100
 
.RS 4
101
 
Developer
102
 
.RE
103
 
.SH "NOTES"
104
 
.IP " 1." 4
105
 
Multi-Seat on Linux
106
 
.RS 4
107
 
\%http://www.freedesktop.org/wiki/Software/systemd/multiseat
108
 
.RE