chiark / gitweb /
sd-netlink: introduce api for new NL type NLA_FLAG
[elogind.git] / src / systemd / sd-login.h
1 /*-*- Mode: C; c-basic-offset: 8; indent-tabs-mode: nil -*-*/
2
3 #ifndef foosdloginhfoo
4 #define foosdloginhfoo
5
6 /***
7   This file is part of systemd.
8
9   Copyright 2011 Lennart Poettering
10
11   systemd is free software; you can redistribute it and/or modify it
12   under the terms of the GNU Lesser General Public License as published by
13   the Free Software Foundation; either version 2.1 of the License, or
14   (at your option) any later version.
15
16   systemd is distributed in the hope that it will be useful, but
17   WITHOUT ANY WARRANTY; without even the implied warranty of
18   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
19   Lesser General Public License for more details.
20
21   You should have received a copy of the GNU Lesser General Public License
22   along with systemd; If not, see <http://www.gnu.org/licenses/>.
23 ***/
24
25 #include <sys/types.h>
26 #include <inttypes.h>
27
28 #include "_sd-common.h"
29
30 /*
31  * A few points:
32  *
33  * Instead of returning an empty string array or empty uid array, we
34  * may return NULL.
35  *
36  * Free the data the library returns with libc free(). String arrays
37  * are NULL terminated, and you need to free the array itself, in
38  * addition to the strings contained.
39  *
40  * We return error codes as negative errno, kernel-style. On success, we
41  * return 0 or positive.
42  *
43  * These functions access data in /proc, /sys/fs/cgroup, and /run. All
44  * of these are virtual file systems; therefore, accesses are
45  * relatively cheap.
46  *
47  * See sd-login(3) for more information.
48  */
49
50 _SD_BEGIN_DECLARATIONS;
51
52 /* Get session from PID. Note that 'shared' processes of a user are
53  * not attached to a session, but only attached to a user. This will
54  * return an error for system processes and 'shared' processes of a
55  * user. */
56 int sd_pid_get_session(pid_t pid, char **session);
57
58 /* Get UID of the owner of the session of the PID (or in case the
59  * process is a 'shared' user process, the UID of that user is
60  * returned). This will not return the UID of the process, but rather
61  * the UID of the owner of the cgroup that the process is in. This will
62  * return an error for system processes. */
63 int sd_pid_get_owner_uid(pid_t pid, uid_t *uid);
64
65 /* Get systemd non-slice unit (i.e. service) name from PID, for system
66  * services. This will return an error for non-service processes. */
67 int sd_pid_get_unit(pid_t pid, char **unit);
68
69 /* Get systemd non-slice unit (i.e. service) name from PID, for user
70  * services. This will return an error for non-user-service
71  * processes. */
72 int sd_pid_get_user_unit(pid_t pid, char **unit);
73
74 /* Get slice name from PID. */
75 int sd_pid_get_slice(pid_t pid, char **slice);
76
77 /* Get user slice name from PID. */
78 int sd_pid_get_user_slice(pid_t pid, char **slice);
79
80 /* Get machine name from PID, for processes assigned to a VM or
81  * container. This will return an error for non-machine processes. */
82 int sd_pid_get_machine_name(pid_t pid, char **machine);
83
84 /* Similar to sd_pid_get_session(), but retrieves data about peer of
85  * connected AF_UNIX socket */
86 int sd_peer_get_session(int fd, char **session);
87
88 /* Similar to sd_pid_get_owner_uid(), but retrieves data about peer of
89  * connected AF_UNIX socket */
90 int sd_peer_get_owner_uid(int fd, uid_t *uid);
91
92 /* Similar to sd_pid_get_unit(), but retrieves data about peer of
93  * connected AF_UNIX socket */
94 int sd_peer_get_unit(int fd, char **unit);
95
96 /* Similar to sd_pid_get_user_unit(), but retrieves data about peer of
97  * connected AF_UNIX socket */
98 int sd_peer_get_user_unit(int fd, char **unit);
99
100 /* Similar to sd_pid_get_slice(), but retrieves data about peer of
101  * connected AF_UNIX socket */
102 int sd_peer_get_slice(int fd, char **slice);
103
104 /* Similar to sd_pid_get_user_slice(), but retrieves data about peer of
105  * connected AF_UNIX socket */
106 int sd_peer_get_user_slice(int fd, char **slice);
107
108 /* Similar to sd_pid_get_machine_name(), but retrieves data about peer
109  * of connected AF_UNIX socket */
110 int sd_peer_get_machine_name(int fd, char **machine);
111
112 /* Get state from UID. Possible states: offline, lingering, online, active, closing */
113 int sd_uid_get_state(uid_t uid, char **state);
114
115 /* Return primary session of user, if there is any */
116 int sd_uid_get_display(uid_t uid, char **session);
117
118 /* Return 1 if UID has session on seat. If require_active is true, this will
119  * look for active sessions only. */
120 int sd_uid_is_on_seat(uid_t uid, int require_active, const char *seat);
121
122 /* Return sessions of user. If require_active is true, this will look for
123  * active sessions only. Returns the number of sessions.
124  * If sessions is NULL, this will just return the number of sessions. */
125 int sd_uid_get_sessions(uid_t uid, int require_active, char ***sessions);
126
127 /* Return seats of user is on. If require_active is true, this will look for
128  * active seats only. Returns the number of seats.
129  * If seats is NULL, this will just return the number of seats. */
130 int sd_uid_get_seats(uid_t uid, int require_active, char ***seats);
131
132 /* Return 1 if the session is active. */
133 int sd_session_is_active(const char *session);
134
135 /* Return 1 if the session is remote. */
136 int sd_session_is_remote(const char *session);
137
138 /* Get state from session. Possible states: online, active, closing.
139  * This function is a more generic version of sd_session_is_active(). */
140 int sd_session_get_state(const char *session, char **state);
141
142 /* Determine user ID of session */
143 int sd_session_get_uid(const char *session, uid_t *uid);
144
145 /* Determine seat of session */
146 int sd_session_get_seat(const char *session, char **seat);
147
148 /* Determine the (PAM) service name this session was registered by. */
149 int sd_session_get_service(const char *session, char **service);
150
151 /* Determine the type of this session, i.e. one of "tty", "x11", "wayland", "mir" or "unspecified". */
152 int sd_session_get_type(const char *session, char **type);
153
154 /* Determine the class of this session, i.e. one of "user", "greeter" or "lock-screen". */
155 int sd_session_get_class(const char *session, char **clazz);
156
157 /* Determine the desktop brand of this session, i.e. something like "GNOME", "KDE" or "systemd-console". */
158 int sd_session_get_desktop(const char *session, char **desktop);
159
160 /* Determine the X11 display of this session. */
161 int sd_session_get_display(const char *session, char **display);
162
163 /* Determine the remote host of this session. */
164 int sd_session_get_remote_host(const char *session, char **remote_host);
165
166 /* Determine the remote user of this session (if provided by PAM). */
167 int sd_session_get_remote_user(const char *session, char **remote_user);
168
169 /* Determine the TTY of this session. */
170 int sd_session_get_tty(const char *session, char **display);
171
172 /* Determine the VT number of this session. */
173 int sd_session_get_vt(const char *session, unsigned *vtnr);
174
175 /* Return active session and user of seat */
176 int sd_seat_get_active(const char *seat, char **session, uid_t *uid);
177
178 /* Return sessions and users on seat. Returns number of sessions.
179  * If sessions is NULL, this returns only the number of sessions. */
180 int sd_seat_get_sessions(const char *seat, char ***sessions, uid_t **uid, unsigned *n_uids);
181
182 /* Return whether the seat is multi-session capable */
183 int sd_seat_can_multi_session(const char *seat);
184
185 /* Return whether the seat is TTY capable, i.e. suitable for showing console UIs */
186 int sd_seat_can_tty(const char *seat);
187
188 /* Return whether the seat is graphics capable, i.e. suitable for showing graphical UIs */
189 int sd_seat_can_graphical(const char *seat);
190
191 /* Return the class of machine */
192 int sd_machine_get_class(const char *machine, char **clazz);
193
194 /* Return the list if host-side network interface indices of a machine */
195 int sd_machine_get_ifindices(const char *machine, int **ifindices);
196
197 /* Get all seats, store in *seats. Returns the number of seats. If
198  * seats is NULL, this only returns the number of seats. */
199 int sd_get_seats(char ***seats);
200
201 /* Get all sessions, store in *sessions. Returns the number of
202  * sessions. If sessions is NULL, this only returns the number of sessions. */
203 int sd_get_sessions(char ***sessions);
204
205 /* Get all logged in users, store in *users. Returns the number of
206  * users. If users is NULL, this only returns the number of users. */
207 int sd_get_uids(uid_t **users);
208
209 /* Get all running virtual machines/containers */
210 int sd_get_machine_names(char ***machines);
211
212 /* Monitor object */
213 typedef struct sd_login_monitor sd_login_monitor;
214
215 /* Create a new monitor. Category must be NULL, "seat", "session",
216  * "uid", or "machine" to get monitor events for the specific category
217  * (or all). */
218 int sd_login_monitor_new(const char *category, sd_login_monitor** ret);
219
220 /* Destroys the passed monitor. Returns NULL. */
221 sd_login_monitor* sd_login_monitor_unref(sd_login_monitor *m);
222
223 /* Flushes the monitor */
224 int sd_login_monitor_flush(sd_login_monitor *m);
225
226 /* Get FD from monitor */
227 int sd_login_monitor_get_fd(sd_login_monitor *m);
228
229 /* Get poll() mask to monitor */
230 int sd_login_monitor_get_events(sd_login_monitor *m);
231
232 /* Get timeout for poll(), as usec value relative to CLOCK_MONOTONIC's epoch */
233 int sd_login_monitor_get_timeout(sd_login_monitor *m, uint64_t *timeout_usec);
234
235 _SD_END_DECLARATIONS;
236
237 #endif