diff options
| author | Lennart Poettering <lennart@poettering.net> | 2013-04-24 17:54:17 -0300 |
|---|---|---|
| committer | Lennart Poettering <lennart@poettering.net> | 2013-04-24 19:02:13 -0300 |
| commit | a20affe2f0fb4c8d488155a0b860549e9389f32a (patch) | |
| tree | 21dbbb3a84784688b8a1139e91648299e219771b /man/sd_get_seats.xml | |
| parent | e8a7a315391a6a07897122725cd707f4e9ce63d7 (diff) | |
login: add new call sd_get_machine_names() to get a list of current virtual machines and containers
Diffstat (limited to 'man/sd_get_seats.xml')
| -rw-r--r-- | man/sd_get_seats.xml | 27 |
1 files changed, 20 insertions, 7 deletions
diff --git a/man/sd_get_seats.xml b/man/sd_get_seats.xml index 4bdb5c3e9e..9bc866dc68 100644 --- a/man/sd_get_seats.xml +++ b/man/sd_get_seats.xml @@ -46,7 +46,8 @@ <refname>sd_get_seats</refname> <refname>sd_get_sessions</refname> <refname>sd_get_uids</refname> - <refpurpose>Determine available seats, sessions and logged in users</refpurpose> + <refname>sd_get_machine_names</refname> + <refpurpose>Determine available seats, sessions, logged in users and virtual machines/containers</refpurpose> </refnamediv> <refsynopsisdiv> @@ -68,6 +69,11 @@ <paramdef>uid_t** <parameter>users</parameter></paramdef> </funcprototype> + <funcprototype> + <funcdef>int <function>sd_get_machine_names</function></funcdef> + <paramdef>char*** <parameter>machines</parameter></paramdef> + </funcprototype> + </funcsynopsis> </refsynopsisdiv> @@ -90,6 +96,11 @@ <para>Similar, <function>sd_get_uids()</function> may be used to determine all Unix users who currently have login sessions.</para> + <para>Similar, + <function>sd_get_machine_names()</function> may be + used to determine all current virtual machines and + containers on the system.</para> + <para>Note that the returned lists are not sorted and in an undefined order.</para> </refsect1> @@ -97,18 +108,20 @@ <title>Return Value</title> <para>On success <function>sd_get_seats()</function>, - <function>sd_get_sessions()</function> and - <function>sd_get_uids()</function> return the number - of entries in the arrays. On failure, these calls - return a negative errno-style error code.</para> + <function>sd_get_sessions()</function>, + <function>sd_get_uids()</function> and + <function>sd_get_machine_names()</function> return the + number of entries in the arrays. On failure, these + calls return a negative errno-style error code.</para> </refsect1> <refsect1> <title>Notes</title> <para>The <function>sd_get_seats()</function>, - <function>sd_get_sessions()</function> and - <function>sd_get_uids()</function> interfaces + <function>sd_get_sessions()</function>, + <function>sd_get_uids()</function> and + <function>sd_get_machine_names()</function> interfaces are available as shared library, which can be compiled and linked to with the <literal>libsystemd-login</literal> |