D-Bus: dbus-sysdeps.h Source File

D-Bus 1.8.16

- Main Page
- Related Pages
- Modules
- Data Structures
- Files

- File List

dbus-sysdeps.h
1 /* -*- mode: C; c-file-style: "gnu"; indent-tabs-mode: nil; -*- */
2 /* dbus-sysdeps.h Wrappers around system/libc features (internal to D-Bus implementation)
3 *
4 * Copyright (C) 2002, 2003 Red Hat, Inc.
5 * Copyright (C) 2003 CodeFactory AB
6 *
7 * Licensed under the Academic Free License version 2.1
8 *
9 * This program is free software; you can redistribute it and/or modify
10 * it under the terms of the GNU General Public License as published by
11 * the Free Software Foundation; either version 2 of the License, or
12 * (at your option) any later version.
13 *
14 * This program is distributed in the hope that it will be useful,
15 * but WITHOUT ANY WARRANTY; without even the implied warranty of
16 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
17 * GNU General Public License for more details.
18 *
19 * You should have received a copy of the GNU General Public License
20 * along with this program; if not, write to the Free Software
21 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
22 *
23 */
24
25 #ifndef DBUS_SYSDEPS_H
26 #define DBUS_SYSDEPS_H
27
28 #include "config.h"
29
30 #ifdef HAVE_STDINT_H
31 #include <stdint.h>
32 #endif
33
34 #ifdef HAVE_INTTYPES_H
35 #include <inttypes.h>
36 #endif
37
38 #include <dbus/dbus-errors.h>
39 #include <dbus/dbus-file.h>
40 #include <dbus/dbus-string.h>
41
42 /* this is perhaps bogus, but strcmp() etc. are faster if we use the
43 * stuff straight out of string.h, so have this here for now.
44 */
45 #include <string.h>
46 #include <stdarg.h>
47
48 /* AIX sys/poll.h does #define events reqevents, and other
49 * wonderousness, so must include sys/poll before declaring
50 * DBusPollFD
51 */
52 #ifdef HAVE_POLL
53 #include <sys/poll.h>
54 #endif
55
56 #ifdef DBUS_WINCE
57 /* Windows CE lacks some system functions (such as errno and clock).
58 We bring them in here. */
59 #include "dbus-sysdeps-wince-glue.h"
60 #endif
61
62 DBUS_BEGIN_DECLS
63
64 #ifdef DBUS_WIN
65 #define _DBUS_PATH_SEPARATOR ";"
66 #else
67 #define _DBUS_PATH_SEPARATOR ":"
68 #endif
69
70 /* Forward declarations */
71
72
74 typedef struct DBusList DBusList;
75
77 typedef struct DBusCredentials DBusCredentials;
78
80 typedef struct DBusPipe DBusPipe;
81
88 void _dbus_abort (void) _DBUS_GNUC_NORETURN;
89
90 dbus_bool_t _dbus_check_setuid (void);
91 const char* _dbus_getenv (const char *varname);
92 dbus_bool_t _dbus_clearenv (void);
93 char ** _dbus_get_environment (void);
94
96 typedef unsigned long dbus_pid_t;
98 typedef unsigned long dbus_uid_t;
100 typedef unsigned long dbus_gid_t;
101
103 #define DBUS_PID_UNSET ((dbus_pid_t) -1)
104
105 #define DBUS_UID_UNSET ((dbus_uid_t) -1)
106
107 #define DBUS_GID_UNSET ((dbus_gid_t) -1)
108
110 #define DBUS_PID_FORMAT "%lu"
111
112 #define DBUS_UID_FORMAT "%lu"
113
114 #define DBUS_GID_FORMAT "%lu"
115
116
127 dbus_bool_t _dbus_close_socket (int fd,
128 DBusError *error);
129 int _dbus_read_socket (int fd,
130 DBusString *buffer,
131 int count);
132 int _dbus_write_socket (int fd,
133 const DBusString *buffer,
134 int start,
135 int len);
136 int _dbus_write_socket_two (int fd,
137 const DBusString *buffer1,
138 int start1,
139 int len1,
140 const DBusString *buffer2,
141 int start2,
142 int len2);
143
144 int _dbus_read_socket_with_unix_fds (int fd,
145 DBusString *buffer,
146 int count,
147 int *fds,
148 int *n_fds);
149 int _dbus_write_socket_with_unix_fds (int fd,
150 const DBusString *buffer,
151 int start,
152 int len,
153 const int *fds,
154 int n_fds);
155 int _dbus_write_socket_with_unix_fds_two (int fd,
156 const DBusString *buffer1,
157 int start1,
158 int len1,
159 const DBusString *buffer2,
160 int start2,
161 int len2,
162 const int *fds,
163 int n_fds);
164
165 dbus_bool_t _dbus_socket_is_invalid (int fd);
166
167 int _dbus_connect_tcp_socket (const char *host,
168 const char *port,
169 const char *family,
170 DBusError *error);
171 int _dbus_connect_tcp_socket_with_nonce (const char *host,
172 const char *port,
173 const char *family,
174 const char *noncefile,
175 DBusError *error);
176 int _dbus_listen_tcp_socket (const char *host,
177 const char *port,
178 const char *family,
179 DBusString *retport,
180 int **fds_p,
181 DBusError *error);
182 int _dbus_accept (int listen_fd);
183
184
185 dbus_bool_t _dbus_read_credentials_socket (int client_fd,
186 DBusCredentials *credentials,
187 DBusError *error);
188 dbus_bool_t _dbus_send_credentials_socket (int server_fd,
189 DBusError *error);
190
191 dbus_bool_t _dbus_credentials_add_from_user (DBusCredentials *credentials,
192 const DBusString *username);
193 dbus_bool_t _dbus_credentials_add_from_current_process (DBusCredentials *credentials);
194 dbus_bool_t _dbus_append_user_from_current_process (DBusString *str);
195
196 dbus_bool_t _dbus_parse_unix_user_from_config (const DBusString *username,
197 dbus_uid_t *uid_p);
198 dbus_bool_t _dbus_parse_unix_group_from_config (const DBusString *groupname,
199 dbus_gid_t *gid_p);
200 dbus_bool_t _dbus_unix_groups_from_uid (dbus_uid_t uid,
201 dbus_gid_t **group_ids,
202 int *n_group_ids);
203 dbus_bool_t _dbus_unix_user_is_at_console (dbus_uid_t uid,
204 DBusError *error);
205 dbus_bool_t _dbus_unix_user_is_process_owner (dbus_uid_t uid);
206 dbus_bool_t _dbus_windows_user_is_process_owner (const char *windows_sid);
207
208 dbus_bool_t _dbus_append_keyring_directory_for_credentials (DBusString *directory,
209 DBusCredentials *credentials);
210
211 dbus_bool_t _dbus_daemon_is_session_bus_address_published (const char *scope);
212
213 dbus_bool_t _dbus_daemon_publish_session_bus_address (const char* address, const char* shm_name);
214
215 void _dbus_daemon_unpublish_session_bus_address (void);
216
217 dbus_bool_t _dbus_socket_can_pass_unix_fd(int fd);
218
222 typedef struct DBusAtomic DBusAtomic;
223
227 struct DBusAtomic
228 {
229 #ifdef DBUS_WIN
230 volatile long value;
231 #else
232 volatile dbus_int32_t value;
233 #endif
234 };
235
236 /* The value we get from autofoo is in the form of a cpp expression;
237 * convert that to a conventional defined/undef switch. (We can't get
238 * the conventional defined/undef because of multiarch builds only running
239 * ./configure once, on Darwin.) */
240 #if DBUS_HAVE_ATOMIC_INT_COND
241 # define DBUS_HAVE_ATOMIC_INT 1
242 #else
243 # undef DBUS_HAVE_ATOMIC_INT
244 #endif
245
246 dbus_int32_t _dbus_atomic_inc (DBusAtomic *atomic);
247 dbus_int32_t _dbus_atomic_dec (DBusAtomic *atomic);
248 dbus_int32_t _dbus_atomic_get (DBusAtomic *atomic);
249
250
251 /* AIX uses different values for poll */
252
253 #ifdef _AIX
254
255 #define _DBUS_POLLIN 0x0001
256
257 #define _DBUS_POLLPRI 0x0004
258
259 #define _DBUS_POLLOUT 0x0002
260
261 #define _DBUS_POLLERR 0x4000
262
263 #define _DBUS_POLLHUP 0x2000
264
265 #define _DBUS_POLLNVAL 0x8000
266 #elif defined(__HAIKU__)
267
268 #define _DBUS_POLLIN 0x0001
269
270 #define _DBUS_POLLOUT 0x0002
271
272 #define _DBUS_POLLERR 0x0004
273
274 #define _DBUS_POLLPRI 0x0020
275
276 #define _DBUS_POLLHUP 0x0080
277
278 #define _DBUS_POLLNVAL 0x1000
279 #elif defined(__QNX__)
280
281 #define _DBUS_POLLOUT 0x0002
282
283 #define _DBUS_POLLIN 0x0005
284
285 #define _DBUS_POLLPRI 0x0008
286
287 #define _DBUS_POLLERR 0x0020
288
289 #define _DBUS_POLLHUP 0x0040
290
291 #define _DBUS_POLLNVAL 0x1000
292 #else
293
294 #define _DBUS_POLLIN 0x0001
295
296 #define _DBUS_POLLPRI 0x0002
297
298 #define _DBUS_POLLOUT 0x0004
299
300 #define _DBUS_POLLERR 0x0008
301
302 #define _DBUS_POLLHUP 0x0010
303
304 #define _DBUS_POLLNVAL 0x0020
305 #endif
306
310 typedef struct
311 {
312 int fd;
313 short events;
314 short revents;
315 } DBusPollFD;
316
317 int _dbus_poll (DBusPollFD *fds,
318 int n_fds,
319 int timeout_milliseconds);
320
321 void _dbus_sleep_milliseconds (int milliseconds);
322
323 void _dbus_get_monotonic_time (long *tv_sec,
324 long *tv_usec);
325
326 void _dbus_get_real_time (long *tv_sec,
327 long *tv_usec);
328
332 dbus_bool_t _dbus_create_directory (const DBusString *filename,
333 DBusError *error);
334 dbus_bool_t _dbus_delete_directory (const DBusString *filename,
335 DBusError *error);
336
337 dbus_bool_t _dbus_concat_dir_and_file (DBusString *dir,
338 const DBusString *next_component);
339 dbus_bool_t _dbus_string_get_dirname (const DBusString *filename,
340 DBusString *dirname);
341 dbus_bool_t _dbus_path_is_absolute (const DBusString *filename);
342
343 dbus_bool_t _dbus_get_standard_session_servicedirs (DBusList **dirs);
344 dbus_bool_t _dbus_get_standard_system_servicedirs (DBusList **dirs);
345
346 dbus_bool_t _dbus_append_system_config_file (DBusString *str);
347 dbus_bool_t _dbus_append_session_config_file (DBusString *str);
348
350 typedef struct DBusDirIter DBusDirIter;
351
352 DBusDirIter* _dbus_directory_open (const DBusString *filename,
353 DBusError *error);
354 dbus_bool_t _dbus_directory_get_next_file (DBusDirIter *iter,
355 DBusString *filename,
356 DBusError *error);
357 void _dbus_directory_close (DBusDirIter *iter);
358
359 dbus_bool_t _dbus_check_dir_is_private_to_user (DBusString *dir,
360 DBusError *error);
361
362 void _dbus_fd_set_close_on_exec (intptr_t fd);
363
364 const char* _dbus_get_tmpdir (void);
365
369 void _dbus_generate_pseudorandom_bytes_buffer (char *buffer,
370 int n_bytes);
371 void _dbus_generate_random_bytes_buffer (char *buffer,
372 int n_bytes);
373 dbus_bool_t _dbus_generate_random_bytes (DBusString *str,
374 int n_bytes);
375 dbus_bool_t _dbus_generate_random_ascii (DBusString *str,
376 int n_bytes);
377
378 const char* _dbus_error_from_errno (int error_number);
379 const char* _dbus_error_from_system_errno (void);
380
381 void _dbus_set_errno_to_zero (void);
382 dbus_bool_t _dbus_get_is_errno_nonzero (void);
383 dbus_bool_t _dbus_get_is_errno_eagain_or_ewouldblock (void);
384 dbus_bool_t _dbus_get_is_errno_enomem (void);
385 dbus_bool_t _dbus_get_is_errno_eintr (void);
386 dbus_bool_t _dbus_get_is_errno_epipe (void);
387 dbus_bool_t _dbus_get_is_errno_etoomanyrefs (void);
388 const char* _dbus_strerror_from_errno (void);
389
390 void _dbus_disable_sigpipe (void);
391
392
393 void _dbus_exit (int code) _DBUS_GNUC_NORETURN;
394
395 int _dbus_printf_string_upper_bound (const char *format,
396 va_list args);
397
398
402 typedef struct
403 {
404 unsigned long mode;
405 unsigned long nlink;
406 dbus_uid_t uid;
407 dbus_gid_t gid;
408 unsigned long size;
409 unsigned long atime;
410 unsigned long mtime;
411 unsigned long ctime;
412 } DBusStat;
413
414 dbus_bool_t _dbus_stat (const DBusString *filename,
415 DBusStat *statbuf,
416 DBusError *error);
417 dbus_bool_t _dbus_full_duplex_pipe (int *fd1,
418 int *fd2,
419 dbus_bool_t blocking,
420 DBusError *error);
421
422 void _dbus_print_backtrace (void);
423
424 dbus_bool_t _dbus_become_daemon (const DBusString *pidfile,
425 DBusPipe *print_pid_pipe,
426 DBusError *error,
427 dbus_bool_t keep_umask);
428
429 dbus_bool_t _dbus_verify_daemon_user (const char *user);
430 dbus_bool_t _dbus_change_to_daemon_user (const char *user,
431 DBusError *error);
432
433 dbus_bool_t _dbus_write_pid_to_file_and_pipe (const DBusString *pidfile,
434 DBusPipe *print_pid_pipe,
435 dbus_pid_t pid_to_write,
436 DBusError *error);
437
438 dbus_bool_t _dbus_command_for_pid (unsigned long pid,
439 DBusString *str,
440 int max_len,
441 DBusError *error);
442
444 typedef void (* DBusSignalHandler) (int sig);
445
446 void _dbus_set_signal_handler (int sig,
447 DBusSignalHandler handler);
448
449 dbus_bool_t _dbus_user_at_console (const char *username,
450 DBusError *error);
451
452 void _dbus_init_system_log (dbus_bool_t is_daemon);
453
454 typedef enum {
455 DBUS_SYSTEM_LOG_INFO,
456 DBUS_SYSTEM_LOG_SECURITY,
457 DBUS_SYSTEM_LOG_FATAL
458 } DBusSystemLogSeverity;
459
460 void _dbus_system_log (DBusSystemLogSeverity severity, const char *msg, ...) _DBUS_GNUC_PRINTF (2, 3);
461 void _dbus_system_logv (DBusSystemLogSeverity severity, const char *msg, va_list args);
462
463 /* Define DBUS_VA_COPY() to do the right thing for copying va_list variables.
464 * config.h may have already defined DBUS_VA_COPY as va_copy or __va_copy.
465 */
466 #if !defined (DBUS_VA_COPY)
467 # if defined (__GNUC__) && defined (__PPC__) && (defined (_CALL_SYSV) || defined (_WIN32))
468 # define DBUS_VA_COPY(ap1, ap2) (*(ap1) = *(ap2))
469 # elif defined (DBUS_VA_COPY_AS_ARRAY)
470 # define DBUS_VA_COPY(ap1, ap2) memcpy ((ap1), (ap2), sizeof (va_list))
471 # else /* va_list is a pointer */
472 # define DBUS_VA_COPY(ap1, ap2) ((ap1) = (ap2))
473 # endif /* va_list is a pointer */
474 #endif /* !DBUS_VA_COPY */
475
476
481 #define _DBUS_BYTE_OF_PRIMITIVE(p, i) \
482 (((const char*)&(p))[(i)])
483
488 #define _DBUS_DOUBLES_BITWISE_EQUAL(a, b) \
489 (_DBUS_BYTE_OF_PRIMITIVE (a, 0) == _DBUS_BYTE_OF_PRIMITIVE (b, 0) && \
490 _DBUS_BYTE_OF_PRIMITIVE (a, 1) == _DBUS_BYTE_OF_PRIMITIVE (b, 1) && \
491 _DBUS_BYTE_OF_PRIMITIVE (a, 2) == _DBUS_BYTE_OF_PRIMITIVE (b, 2) && \
492 _DBUS_BYTE_OF_PRIMITIVE (a, 3) == _DBUS_BYTE_OF_PRIMITIVE (b, 3) && \
493 _DBUS_BYTE_OF_PRIMITIVE (a, 4) == _DBUS_BYTE_OF_PRIMITIVE (b, 4) && \
494 _DBUS_BYTE_OF_PRIMITIVE (a, 5) == _DBUS_BYTE_OF_PRIMITIVE (b, 5) && \
495 _DBUS_BYTE_OF_PRIMITIVE (a, 6) == _DBUS_BYTE_OF_PRIMITIVE (b, 6) && \
496 _DBUS_BYTE_OF_PRIMITIVE (a, 7) == _DBUS_BYTE_OF_PRIMITIVE (b, 7))
497
498 dbus_bool_t _dbus_get_autolaunch_address (const char *scope,
499 DBusString *address,
500 DBusError *error);
501
502 dbus_bool_t _dbus_lookup_session_address (dbus_bool_t *supported,
503 DBusString *address,
504 DBusError *error);
505
509 typedef union DBusGUID DBusGUID;
510
511 dbus_bool_t _dbus_read_local_machine_uuid (DBusGUID *machine_id,
512 dbus_bool_t create_if_not_found,
513 DBusError *error);
514
520 dbus_bool_t _dbus_threads_init_platform_specific (void);
521
525 void _dbus_threads_lock_platform_specific (void);
526
530 void _dbus_threads_unlock_platform_specific (void);
531
532 dbus_bool_t _dbus_split_paths_and_append (DBusString *dirs,
533 const char *suffix,
534 DBusList **dir_list);
535
536 unsigned long _dbus_pid_for_log (void);
537
538 /* FIXME move back to dbus-sysdeps-unix.h probably -
539 * the PID file handling just needs a little more abstraction
540 * in the bus daemon first.
541 */
542 dbus_pid_t _dbus_getpid (void);
543
544 dbus_bool_t _dbus_change_to_daemon_user (const char *user,
545 DBusError *error);
546
547 void _dbus_flush_caches (void);
548
549 /*
550 * replaces the term DBUS_PREFIX in configure_time_path by the
551 * current dbus installation directory. On unix this function is a noop
552 *
553 * @param configure_time_path
554 * @return real path
555 */
556 const char *
557 _dbus_replace_install_prefix (const char *configure_time_path);
558
559 /* Do not set this too high: it is a denial-of-service risk.
560 * See <https://bugs.freedesktop.org/show_bug.cgi?id=82820>
561 *
562 * (This needs to be in the non-Unix-specific header so that
563 * the config-parser can use it.)
564 */
565 #define DBUS_DEFAULT_MESSAGE_UNIX_FDS 16
566
567 typedef struct DBusRLimit DBusRLimit;
568
569 DBusRLimit *_dbus_rlimit_save_fd_limit (DBusError *error);
570 dbus_bool_t _dbus_rlimit_raise_fd_limit_if_privileged (unsigned int desired,
571 DBusError *error);
572 dbus_bool_t _dbus_rlimit_restore_fd_limit (DBusRLimit *saved,
573 DBusError *error);
574 void _dbus_rlimit_free (DBusRLimit *lim);
575
578 DBUS_END_DECLS
579
580
581 #ifdef DBUS_WIN
582 #include "dbus-sysdeps-win.h"
583 #endif
584
585 #endif /* DBUS_SYSDEPS_H */
DBusAtomic
An atomic integer safe to increment or decrement from multiple threads.
Definition: dbus-sysdeps.h:227
_dbus_atomic_get
dbus_int32_t _dbus_atomic_get(DBusAtomic *atomic)
Atomically get the value of an integer.
Definition: dbus-sysdeps-unix.c:2547
DBusCredentials
Definition: dbus-credentials.c:48
_dbus_append_system_config_file
dbus_bool_t _dbus_append_system_config_file(DBusString *str)
Append the absolute path of the system.conf file (there is no system bus on Windows so this can just ...
Definition: dbus-sysdeps-util-unix.c:1430
DBusAtomic::value
volatile dbus_int32_t value
Value of the atomic integer.
Definition: dbus-sysdeps.h:232
_dbus_check_dir_is_private_to_user
dbus_bool_t _dbus_check_dir_is_private_to_user(DBusString *dir, DBusError *error)
Checks to make sure the given directory is private to the user.
Definition: dbus-sysdeps-unix.c:2022
DBUS_BEGIN_DECLS
#define DBUS_BEGIN_DECLS
Macro used prior to declaring functions in the D-Bus header files.
_dbus_delete_directory
dbus_bool_t _dbus_delete_directory(const DBusString *filename, DBusError *error)
Removes a directory; Directory must be empty.
Definition: dbus-sysdeps-unix.c:3926
_dbus_socket_can_pass_unix_fd
dbus_bool_t _dbus_socket_can_pass_unix_fd(int fd)
Checks whether file descriptors may be passed via the socket.
Definition: dbus-sysdeps-unix.c:3954
DBusStat
Portable struct with stat() results.
Definition: dbus-sysdeps.h:402
_dbus_parse_unix_group_from_config
dbus_bool_t _dbus_parse_unix_group_from_config(const DBusString *groupname, dbus_gid_t *gid_p)
Parse a UNIX group from the bus config file.
Definition: dbus-sysdeps-util-unix.c:1046
_dbus_error_from_errno
const char * _dbus_error_from_errno(int error_number)
Converts a UNIX errno, or Windows errno or WinSock error value into a DBusError name.
Definition: dbus-sysdeps.c:614
_dbus_flush_caches
void _dbus_flush_caches(void)
Called when the bus daemon is signaled to reload its configuration; any caches should be nuked...
Definition: dbus-sysdeps-unix.c:3807
_dbus_full_duplex_pipe
dbus_bool_t _dbus_full_duplex_pipe(int *fd1, int *fd2, dbus_bool_t blocking, DBusError *error)
Creates a full-duplex pipe (as in socketpair()).
Definition: dbus-sysdeps-unix.c:3108
_dbus_write_socket_two
int _dbus_write_socket_two(int fd, const DBusString *buffer1, int start1, int len1, const DBusString *buffer2, int start2, int len2)
Like _dbus_write_two() but only works on sockets and is thus available on Windows.
Definition: dbus-sysdeps-unix.c:546
DBusStat::atime
unsigned long atime
Access time.
Definition: dbus-sysdeps.h:409
_dbus_get_is_errno_etoomanyrefs
dbus_bool_t _dbus_get_is_errno_etoomanyrefs(void)
See if errno is ETOOMANYREFS.
Definition: dbus-sysdeps.c:769
_dbus_check_setuid
dbus_bool_t _dbus_check_setuid(void)
NOTE: If you modify this function, please also consider making the corresponding change in GLib...
Definition: dbus-sysdeps-unix.c:4053
_dbus_threads_init_platform_specific
dbus_bool_t _dbus_threads_init_platform_specific(void)
Initialize threads as in dbus_threads_init_default(), appropriately for the platform.
Definition: dbus-sysdeps-pthread.c:278
_dbus_get_standard_session_servicedirs
dbus_bool_t _dbus_get_standard_session_servicedirs(DBusList **dirs)
Returns the standard directories for a session bus to look for service activation files...
Definition: dbus-sysdeps-util-unix.c:1304
_dbus_read_socket_with_unix_fds
int _dbus_read_socket_with_unix_fds(int fd, DBusString *buffer, int count, int *fds, int *n_fds)
Like _dbus_read_socket() but also tries to read unix fds from the socket.
Definition: dbus-sysdeps-unix.c:273
DBusPollFD
A portable struct pollfd wrapper.
Definition: dbus-sysdeps.h:310
DBusGUID
A globally unique ID ; we have one for each DBusServer, and also one for each machine with libdbus in...
Definition: dbus-internals.h:350
_dbus_accept
int _dbus_accept(int listen_fd)
Accepts a connection on a listening socket.
Definition: dbus-sysdeps-unix.c:1967
_dbus_getpid
dbus_pid_t _dbus_getpid(void)
Gets our process ID.
Definition: dbus-sysdeps-unix.c:2409
_dbus_get_is_errno_nonzero
dbus_bool_t _dbus_get_is_errno_nonzero(void)
See if errno is set.
Definition: dbus-sysdeps.c:729
_dbus_append_user_from_current_process
dbus_bool_t _dbus_append_user_from_current_process(DBusString *str)
Append to the string the identity we would like to have when we authenticate, on UNIX this is the cur...
Definition: dbus-sysdeps-unix.c:2398
_dbus_command_for_pid
dbus_bool_t _dbus_command_for_pid(unsigned long pid, DBusString *str, int max_len, DBusError *error)
Get a printable string describing the command used to execute the process with pid.
Definition: dbus-sysdeps-util-unix.c:1203
DBusPollFD::events
short events
Events to poll for.
Definition: dbus-sysdeps.h:313
_dbus_read_credentials_socket
dbus_bool_t _dbus_read_credentials_socket(int client_fd, DBusCredentials *credentials, DBusError *error)
Reads a single byte which must be nul (an error occurs otherwise), and reads unix credentials if avai...
Definition: dbus-sysdeps-unix.c:1664
DBusSignalHandler
void(* DBusSignalHandler)(int sig)
A UNIX signal handler.
Definition: dbus-sysdeps.h:444
_dbus_getenv
const char * _dbus_getenv(const char *varname)
Wrapper for getenv().
Definition: dbus-sysdeps.c:185
_dbus_abort
void _dbus_abort(void)
Aborts the program with SIGABRT (dumping core).
Definition: dbus-sysdeps.c:77
_dbus_get_autolaunch_address
dbus_bool_t _dbus_get_autolaunch_address(const char *scope, DBusString *address, DBusError *error)
Returns the address of a new session bus.
Definition: dbus-sysdeps-unix.c:3507
DBusDirIter
Internals of directory iterator.
Definition: dbus-sysdeps-util-unix.c:735
_dbus_user_at_console
dbus_bool_t _dbus_user_at_console(const char *username, DBusError *error)
Checks if user is at the console.
Definition: dbus-sysdeps-util-unix.c:640
_dbus_path_is_absolute
dbus_bool_t _dbus_path_is_absolute(const DBusString *filename)
Checks whether the filename is an absolute path.
Definition: dbus-sysdeps-util-unix.c:684
DBusStat::mode
unsigned long mode
File mode.
Definition: dbus-sysdeps.h:404
_dbus_get_monotonic_time
void _dbus_get_monotonic_time(long *tv_sec, long *tv_usec)
Get current time, as in gettimeofday().
Definition: dbus-sysdeps-unix.c:2671
dbus_pid_t
unsigned long dbus_pid_t
A process ID.
Definition: dbus-sysdeps.h:96
_dbus_atomic_dec
dbus_int32_t _dbus_atomic_dec(DBusAtomic *atomic)
Atomically decrement an integer.
Definition: dbus-sysdeps-unix.c:2523
_dbus_threads_unlock_platform_specific
void _dbus_threads_unlock_platform_specific(void)
Undo _dbus_threads_lock_platform_specific().
Definition: dbus-sysdeps-pthread.c:299
_dbus_generate_random_bytes_buffer
void _dbus_generate_random_bytes_buffer(char *buffer, int n_bytes)
Fills n_bytes of the given buffer with random bytes.
Definition: dbus-sysdeps.c:543
_dbus_fd_set_close_on_exec
void _dbus_fd_set_close_on_exec(intptr_t fd)
Sets the file descriptor to be close on exec.
Definition: dbus-sysdeps-unix.c:2936
_dbus_get_real_time
void _dbus_get_real_time(long *tv_sec, long *tv_usec)
Get current time, as in gettimeofday().
Definition: dbus-sysdeps-unix.c:2702
_dbus_threads_lock_platform_specific
void _dbus_threads_lock_platform_specific(void)
Lock a static mutex used to protect _dbus_threads_init_platform_specific().
Definition: dbus-sysdeps-pthread.c:293
DBusStat::gid
dbus_gid_t gid
Group owning file.
Definition: dbus-sysdeps.h:407
_dbus_concat_dir_and_file
dbus_bool_t _dbus_concat_dir_and_file(DBusString *dir, const DBusString *next_component)
Appends the given filename to the given directory.
Definition: dbus-sysdeps-unix.c:2758
DBusPipe
Definition: dbus-pipe.h:41
DBusString
Definition: dbus-string.h:42
dbus_bool_t
dbus_uint32_t dbus_bool_t
A boolean, valid values are TRUE and FALSE.
Definition: dbus-types.h:35
_dbus_write_pid_to_file_and_pipe
dbus_bool_t _dbus_write_pid_to_file_and_pipe(const DBusString *pidfile, DBusPipe *print_pid_pipe, dbus_pid_t pid_to_write, DBusError *error)
Writes the given pid_to_write to a pidfile (if non-NULL) and/or to a pipe (if non-NULL).
Definition: dbus-sysdeps-util-unix.c:236
_dbus_poll
int _dbus_poll(DBusPollFD *fds, int n_fds, int timeout_milliseconds)
Wrapper for poll().
Definition: dbus-sysdeps-unix.c:2572
_dbus_change_to_daemon_user
dbus_bool_t _dbus_change_to_daemon_user(const char *user, DBusError *error)
Changes the user and group the bus is running as.
Definition: dbus-sysdeps-util-unix.c:330
_dbus_append_keyring_directory_for_credentials
dbus_bool_t _dbus_append_keyring_directory_for_credentials(DBusString *directory, DBusCredentials *credentials)
Appends the directory in which a keyring for the given credentials should be stored.
Definition: dbus-sysdeps-unix.c:3826
_dbus_read_socket
int _dbus_read_socket(int fd, DBusString *buffer, int count)
Like _dbus_read(), but only works on sockets so is available on Windows.
Definition: dbus-sysdeps-unix.c:217
_dbus_verify_daemon_user
dbus_bool_t _dbus_verify_daemon_user(const char *user)
Verify that after the fork we can successfully change to this user.
Definition: dbus-sysdeps-util-unix.c:310
DBusError
Object representing an exception.
Definition: dbus-errors.h:48
_dbus_set_signal_handler
void _dbus_set_signal_handler(int sig, DBusSignalHandler handler)
Installs a UNIX signal handler.
Definition: dbus-sysdeps-util-unix.c:609
_dbus_disable_sigpipe
void _dbus_disable_sigpipe(void)
signal (SIGPIPE, SIG_IGN);
Definition: dbus-sysdeps-unix.c:2923
_dbus_send_credentials_socket
dbus_bool_t _dbus_send_credentials_socket(int server_fd, DBusError *error)
Sends a single nul byte with our UNIX credentials as ancillary data.
Definition: dbus-sysdeps-unix.c:1946
_dbus_stat
dbus_bool_t _dbus_stat(const DBusString *filename, DBusStat *statbuf, DBusError *error)
stat() wrapper.
Definition: dbus-sysdeps-util-unix.c:701
_dbus_unix_user_is_process_owner
dbus_bool_t _dbus_unix_user_is_process_owner(dbus_uid_t uid)
Checks to see if the UNIX user ID matches the UID of the process.
Definition: dbus-sysdeps-util-unix.c:1095
_dbus_unix_user_is_at_console
dbus_bool_t _dbus_unix_user_is_at_console(dbus_uid_t uid, DBusError *error)
Checks to see if the UNIX user ID is at the console.
Definition: dbus-sysdeps-util-unix.c:1080
_dbus_atomic_inc
dbus_int32_t _dbus_atomic_inc(DBusAtomic *atomic)
Atomically increments an integer.
Definition: dbus-sysdeps-unix.c:2500
_dbus_string_get_dirname
dbus_bool_t _dbus_string_get_dirname(const DBusString *filename, DBusString *dirname)
Get the directory name from a complete filename.
Definition: dbus-sysdeps-util-unix.c:1127
_dbus_windows_user_is_process_owner
dbus_bool_t _dbus_windows_user_is_process_owner(const char *windows_sid)
Checks to see if the Windows user SID matches the owner of the process.
Definition: dbus-sysdeps-util-unix.c:1108
_dbus_system_logv
void _dbus_system_logv(DBusSystemLogSeverity severity, const char *msg, va_list args)
Log a message to the system log file (e.g.
Definition: dbus-sysdeps-util-unix.c:563
DBusStat::ctime
unsigned long ctime
Creation time.
Definition: dbus-sysdeps.h:411
_dbus_strerror_from_errno
const char * _dbus_strerror_from_errno(void)
Get error message from errno.
Definition: dbus-sysdeps.c:783
DBusPollFD::fd
int fd
File descriptor.
Definition: dbus-sysdeps.h:312
_dbus_create_directory
dbus_bool_t _dbus_create_directory(const DBusString *filename, DBusError *error)
directory interface
Definition: dbus-sysdeps-unix.c:2724
_dbus_credentials_add_from_current_process
dbus_bool_t _dbus_credentials_add_from_current_process(DBusCredentials *credentials)
Adds the credentials of the current process to the passed-in credentials object.
Definition: dbus-sysdeps-unix.c:2368
DBusStat::nlink
unsigned long nlink
Number of hard links.
Definition: dbus-sysdeps.h:405
DBusStat::uid
dbus_uid_t uid
User owning file.
Definition: dbus-sysdeps.h:406
_dbus_get_is_errno_epipe
dbus_bool_t _dbus_get_is_errno_epipe(void)
See if errno is EPIPE.
Definition: dbus-sysdeps.c:759
_dbus_get_tmpdir
const char * _dbus_get_tmpdir(void)
Gets the temporary files directory by inspecting the environment variables TMPDIR, TMP, and TEMP in that order.
Definition: dbus-sysdeps-unix.c:3253
_dbus_become_daemon
dbus_bool_t _dbus_become_daemon(const DBusString *pidfile, DBusPipe *print_pid_pipe, DBusError *error, dbus_bool_t keep_umask)
Does the chdir, fork, setsid, etc.
Definition: dbus-sysdeps-util-unix.c:83
_dbus_system_log
void _dbus_system_log(DBusSystemLogSeverity severity, const char *msg,...)
Log a message to the system log file (e.g.
Definition: dbus-sysdeps-util-unix.c:541
_dbus_pid_for_log
unsigned long _dbus_pid_for_log(void)
The only reason this is separate from _dbus_getpid() is to allow it on Windows for logging but not fo...
Definition: dbus-sysdeps-unix.c:2439
_dbus_directory_close
void _dbus_directory_close(DBusDirIter *iter)
Closes a directory iteration.
Definition: dbus-sysdeps-util-unix.c:845
_dbus_clearenv
dbus_bool_t _dbus_clearenv(void)
Wrapper for clearenv().
Definition: dbus-sysdeps.c:201
_dbus_write_socket
int _dbus_write_socket(int fd, const DBusString *buffer, int start, int len)
Like _dbus_write(), but only supports sockets and is thus available on Windows.
Definition: dbus-sysdeps-unix.c:235
_dbus_get_is_errno_eintr
dbus_bool_t _dbus_get_is_errno_eintr(void)
See if errno is EINTR.
Definition: dbus-sysdeps.c:749
_dbus_exit
void _dbus_exit(int code) _DBUS_GNUC_NORETURN
Exit the process, returning the given value.
Definition: dbus-sysdeps-unix.c:2894
_dbus_parse_unix_user_from_config
dbus_bool_t _dbus_parse_unix_user_from_config(const DBusString *username, dbus_uid_t *uid_p)
Parse a UNIX user from the bus config file.
Definition: dbus-sysdeps-util-unix.c:1030
DBusList
A node in a linked list.
Definition: dbus-list.h:34
_dbus_split_paths_and_append
dbus_bool_t _dbus_split_paths_and_append(DBusString *dirs, const char *suffix, DBusList **dir_list)
Split paths into a list of char strings.
Definition: dbus-sysdeps.c:226
_dbus_get_is_errno_eagain_or_ewouldblock
dbus_bool_t _dbus_get_is_errno_eagain_or_ewouldblock(void)
See if errno is EAGAIN or EWOULDBLOCK (this has to be done differently for Winsock so is abstracted) ...
Definition: dbus-sysdeps-unix.c:3913
_dbus_get_environment
char ** _dbus_get_environment(void)
Gets a NULL-terminated list of key=value pairs from the environment.
Definition: dbus-sysdeps-util.c:49
_dbus_generate_random_ascii
dbus_bool_t _dbus_generate_random_ascii(DBusString *str, int n_bytes)
Generates the given number of random bytes, where the bytes are chosen from the alphanumeric ASCII su...
Definition: dbus-sysdeps.c:575
_dbus_lookup_session_address
dbus_bool_t _dbus_lookup_session_address(dbus_bool_t *supported, DBusString *address, DBusError *error)
Determines the address of the session bus by querying a platform-specific method. ...
Definition: dbus-sysdeps-unix.c:3782
_dbus_generate_pseudorandom_bytes_buffer
void _dbus_generate_pseudorandom_bytes_buffer(char *buffer, int n_bytes)
Random numbers.
Definition: dbus-sysdeps.c:508
_dbus_get_is_errno_enomem
dbus_bool_t _dbus_get_is_errno_enomem(void)
See if errno is ENOMEM.
Definition: dbus-sysdeps.c:739
_dbus_read_local_machine_uuid
dbus_bool_t _dbus_read_local_machine_uuid(DBusGUID *machine_id, dbus_bool_t create_if_not_found, DBusError *error)
Reads the uuid of the machine we're running on from the dbus configuration.
Definition: dbus-sysdeps-unix.c:3610
_dbus_unix_groups_from_uid
dbus_bool_t _dbus_unix_groups_from_uid(dbus_uid_t uid, dbus_gid_t **group_ids, int *n_group_ids)
Gets all groups corresponding to the given UNIX user ID.
Definition: dbus-sysdeps-util-unix.c:1063
DBusStat::mtime
unsigned long mtime
Modify time.
Definition: dbus-sysdeps.h:410
_dbus_print_backtrace
void _dbus_print_backtrace(void)
On GNU libc systems, print a crude backtrace to stderr.
Definition: dbus-sysdeps-unix.c:3066
_dbus_directory_open
DBusDirIter * _dbus_directory_open(const DBusString *filename, DBusError *error)
Open a directory to iterate over.
Definition: dbus-sysdeps-util-unix.c:749
_dbus_printf_string_upper_bound
int _dbus_printf_string_upper_bound(const char *format, va_list args)
Measure the length of the given format string and arguments, not including the terminating nul...
Definition: dbus-sysdeps-unix.c:3183
dbus_gid_t
unsigned long dbus_gid_t
A group ID.
Definition: dbus-sysdeps.h:100
DBusStat::size
unsigned long size
Size of file.
Definition: dbus-sysdeps.h:408
_dbus_close_socket
dbus_bool_t _dbus_close_socket(int fd, DBusError *error)
Socket interface.
Definition: dbus-sysdeps-unix.c:201
_dbus_append_session_config_file
dbus_bool_t _dbus_append_session_config_file(DBusString *str)
Append the absolute path of the session.conf file.
Definition: dbus-sysdeps-util-unix.c:1442
dbus_uid_t
unsigned long dbus_uid_t
A user ID.
Definition: dbus-sysdeps.h:98
DBusPollFD::revents
short revents
Events that occurred.
Definition: dbus-sysdeps.h:314
_dbus_set_errno_to_zero
void _dbus_set_errno_to_zero(void)
Assign 0 to the global errno variable.
Definition: dbus-sysdeps.c:715
_dbus_get_standard_system_servicedirs
dbus_bool_t _dbus_get_standard_system_servicedirs(DBusList **dirs)
Returns the standard directories for a system bus to look for service activation files.
Definition: dbus-sysdeps-util-unix.c:1396
_dbus_sleep_milliseconds
void _dbus_sleep_milliseconds(int milliseconds)
Sleeps the given number of milliseconds.
Definition: dbus-sysdeps-unix.c:2803
_dbus_directory_get_next_file
dbus_bool_t _dbus_directory_get_next_file(DBusDirIter *iter, DBusString *filename, DBusError *error)
Get next file in the directory.
Definition: dbus-sysdeps-util-unix.c:797
_dbus_connect_tcp_socket
int _dbus_connect_tcp_socket(const char *host, const char *port, const char *family, DBusError *error)
Creates a socket and connects to a socket at the given host and port.
Definition: dbus-sysdeps-unix.c:1253
_dbus_listen_tcp_socket
int _dbus_listen_tcp_socket(const char *host, const char *port, const char *family, DBusString *retport, int **fds_p, DBusError *error)
Creates a socket and binds it to the given path, then listens on the socket.
Definition: dbus-sysdeps-unix.c:1377
_dbus_generate_random_bytes
dbus_bool_t _dbus_generate_random_bytes(DBusString *str, int n_bytes)
Generates the given number of random bytes, using the best mechanism we can come up with...
Definition: dbus-sysdeps-unix.c:2851
_dbus_error_from_system_errno
const char * _dbus_error_from_system_errno(void)
Converts the current system errno value into a DBusError name.
Definition: dbus-sysdeps.c:706
_dbus_credentials_add_from_user
dbus_bool_t _dbus_credentials_add_from_user(DBusCredentials *credentials, const DBusString *username)
Adds the credentials corresponding to the given username.
Definition: dbus-sysdeps-win.c:2048
DBUS_END_DECLS
#define DBUS_END_DECLS
Macro used after declaring functions in the D-Bus header files.