X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?a=blobdiff_plain;f=man%2Fsd-login.xml;h=a0df90377cae52b8172642fcc9c4cf80b5696ab9;hb=88ae7333ee052e64607ae6678fe0e84991fe3482;hp=9926d2b85cfd85df91bebb2384d233754fc6c8da;hpb=595aae376fae21f885ec9af2cac1aaf3ff3e9bee;p=elogind.git
diff --git a/man/sd-login.xml b/man/sd-login.xml
index 9926d2b85..a0df90377 100644
--- a/man/sd-login.xml
+++ b/man/sd-login.xml
@@ -8,20 +8,20 @@
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 +39,7 @@
sd-login
- 7
+ 3
@@ -54,7 +54,7 @@
- pkg-config --cflags --libs libsystemd-login
+ pkg-config --cflags --libs libsystemd
@@ -77,23 +77,33 @@
you need to utilize the D-Bus API of
systemd-logind, instead.
- These functions access data in
+ 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
+ generally NULL terminated and need to be freed by the
caller with the libc
free3
call after use, including the strings referenced
- therein. Similar, individual strings returned need to
+ 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
+ string array NULL may be returned, which should be
treated equivalent to an empty string array.
See
@@ -110,10 +120,9 @@
Notes
- These APIs are implemented as shared library,
+ These APIs are implemented as a shared library,
which can be compiled and linked to with the
- libsystemd-login
- pkg-config1
+ libsystemd pkg-config1
file.
@@ -127,8 +136,8 @@
sd_seat_get_active3,
sd_get_seats3,
sd_login_monitor_new3,
- sd-daemon7,
- sd-readahead7,
+ sd-daemon3,
+ sd-readahead3,
pkg-config1