X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?a=blobdiff_plain;f=man%2Fsd-login.xml;h=f21170db160afd71cab8e819506c7e8b814af736;hb=92ff080be100aff15f292e2631921131c610afe7;hp=62ec6ffefd07e3dc6e8bfef5547233b03c6cc479;hpb=01448ff92d9549785242ffab453bf5bcde348c61;p=elogind.git
diff --git a/man/sd-login.xml b/man/sd-login.xml
index 62ec6ffef..f21170db1 100644
--- a/man/sd-login.xml
+++ b/man/sd-login.xml
@@ -8,20 +8,21 @@
Copyright 2010 Lennart Poettering
systemd is free software; you can redistribute it and/or modify it
- under the terms of the GNU General Public License as published by
- the Free Software Foundation; either version 2 of the License, or
+ under the terms of the GNU Lesser General Public License as published by
+ the Free Software Foundation; either version 2.1 of the License, or
(at your option) any later version.
systemd is distributed in the hope that it will be useful, but
WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
- General Public License for more details.
+ Lesser General Public License for more details.
- You should have received a copy of the GNU General Public License
+ You should have received a copy of the GNU Lesser General Public License
along with systemd; If not, see .
-->
-
+
sd-login
@@ -39,7 +40,7 @@
sd-login
- 7
+ 3
@@ -54,7 +55,7 @@
- pkg-config --cflags --libs libsystemd-login
+ pkg-config --cflags --libs libsystemd
@@ -75,7 +76,36 @@
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.
+ systemd-logind, instead.
+
+ These functions synchronously access data in
+ /proc,
+ /sys/fs/cgroup and
+ /run. All of these are virtual
+ file systems, hence the runtime cost of the accesses
+ is relatively cheap.
+
+ It is possible (and often a very good choice) to
+ mix calls to the synchronous interface of
+ sd-login.h 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
+ sd-login.h interfaces such as the
+ login monitor are asynchronous and not ordered against
+ each other.
+
+ If the functions return string arrays, these are
+ generally NULL terminated and need to be freed by the
+ caller with the libc
+ free3
+ call after use, including the strings referenced
+ therein. Similarly, individual strings returned need to
+ be freed, as well.
+
+ As a special exception, instead of an empty
+ string array NULL may be returned, which should be
+ treated equivalent to an empty string array.
See
sd_pid_get_session3,
@@ -88,15 +118,7 @@
implemented.
-
- Notes
-
- These APIs are implemented as shared library,
- which can be compiled and linked to with the
- libsystemd-login
- pkg-config1
- file.
-
+
See Also
@@ -108,9 +130,8 @@
sd_seat_get_active3,
sd_get_seats3,
sd_login_monitor_new3,
- sd-daemon7,
- sd-readahead7,
- pkg-config1
+ sd-daemon3,
+ pkg-config1