summaryrefslogtreecommitdiffstats
path: root/upstream/opensuse-tumbleweed/man3/sd_get_seats.3
diff options
context:
space:
mode:
Diffstat (limited to 'upstream/opensuse-tumbleweed/man3/sd_get_seats.3')
-rw-r--r--upstream/opensuse-tumbleweed/man3/sd_get_seats.395
1 files changed, 0 insertions, 95 deletions
diff --git a/upstream/opensuse-tumbleweed/man3/sd_get_seats.3 b/upstream/opensuse-tumbleweed/man3/sd_get_seats.3
deleted file mode 100644
index dd47c95c..00000000
--- a/upstream/opensuse-tumbleweed/man3/sd_get_seats.3
+++ /dev/null
@@ -1,95 +0,0 @@
-'\" t
-.TH "SD_GET_SEATS" "3" "" "systemd 254" "sd_get_seats"
-.\" -----------------------------------------------------------------
-.\" * Define some portability stuff
-.\" -----------------------------------------------------------------
-.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-.\" http://bugs.debian.org/507673
-.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
-.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-.ie \n(.g .ds Aq \(aq
-.el .ds Aq '
-.\" -----------------------------------------------------------------
-.\" * set default formatting
-.\" -----------------------------------------------------------------
-.\" disable hyphenation
-.nh
-.\" disable justification (adjust text to left margin only)
-.ad l
-.\" -----------------------------------------------------------------
-.\" * MAIN CONTENT STARTS HERE *
-.\" -----------------------------------------------------------------
-.SH "NAME"
-sd_get_seats, sd_get_sessions, sd_get_uids, sd_get_machine_names \- Determine available seats, sessions, logged in users and virtual machines/containers
-.SH "SYNOPSIS"
-.sp
-.ft B
-.nf
-#include <systemd/sd\-login\&.h>
-.fi
-.ft
-.HP \w'int\ sd_get_seats('u
-.BI "int sd_get_seats(char\ ***" "seats" ");"
-.HP \w'int\ sd_get_sessions('u
-.BI "int sd_get_sessions(char\ ***" "sessions" ");"
-.HP \w'int\ sd_get_uids('u
-.BI "int sd_get_uids(uid_t\ **" "users" ");"
-.HP \w'int\ sd_get_machine_names('u
-.BI "int sd_get_machine_names(char\ ***" "machines" ");"
-.SH "DESCRIPTION"
-.PP
-\fBsd_get_seats()\fR
-may be used to determine all currently available local seats\&. Returns the number of seat identifiers and if the input pointer is non\-\fBNULL\fR, a
-\fBNULL\fR\-terminated array of seat identifiers is stored at the address\&. The returned array and all strings it references need to be freed with the libc
-\fBfree\fR(3)
-call after use\&. Note that instead of an empty array
-\fBNULL\fR
-may be returned and should be considered equivalent to an empty array\&.
-.PP
-Similarly,
-\fBsd_get_sessions()\fR
-may be used to determine all current login sessions\&.
-.PP
-Similarly,
-\fBsd_get_uids()\fR
-may be used to determine all Unix users who currently have login sessions\&.
-.PP
-Similarly,
-\fBsd_get_machine_names()\fR
-may be used to determine all current virtual machines and containers on the system\&.
-.PP
-Note that the returned lists are not sorted and in an undefined order\&.
-.SH "RETURN VALUE"
-.PP
-On success,
-\fBsd_get_seats()\fR,
-\fBsd_get_sessions()\fR,
-\fBsd_get_uids()\fR
-and
-\fBsd_get_machine_names()\fR
-return the number of entries in the arrays\&. On failure, these calls return a negative errno\-style error code\&.
-.SS "Errors"
-.PP
-Returned errors may indicate the following problems:
-.PP
-\fB\-ENOMEM\fR
-.RS 4
-Memory allocation failed\&.
-.RE
-.SH "NOTES"
-.PP
-Functions described here are available as a shared library, which can be compiled against and linked to with the
-\fBlibsystemd\fR\ \&\fBpkg-config\fR(1)
-file\&.
-.PP
-The code described here uses
-\fBgetenv\fR(3), which is declared to be not multi\-thread\-safe\&. This means that the code calling the functions described here must not call
-\fBsetenv\fR(3)
-from a parallel thread\&. It is recommended to only do calls to
-\fBsetenv()\fR
-from an early phase of the program when no other threads have been started\&.
-.SH "SEE ALSO"
-.PP
-\fBsystemd\fR(1),
-\fBsd-login\fR(3),
-\fBsd_session_get_seat\fR(3)