D-Bus 1.12.4

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#ifndef VERSION
29#warning Please include config.h before dbus-sysdeps.h
30#include "config.h"
31#endif
32
33#ifdef HAVE_STDINT_H
34#include <stdint.h>
35#endif
36
37#ifdef HAVE_INTTYPES_H
38#include <inttypes.h>
39#endif
40
41#include <dbus/dbus-errors.h>
42#include <dbus/dbus-file.h>
43#include <dbus/dbus-string.h>
44
45/* this is perhaps bogus, but strcmp() etc. are faster if we use the
46 * stuff straight out of string.h, so have this here for now.
47 */
48#include <string.h>
49#include <stdarg.h>
50
51/* AIX sys/poll.h does #define events reqevents, and other
52 * wonderousness, so must include sys/poll before declaring
53 * DBusPollFD
54 */
55#ifdef HAVE_POLL
56#include <sys/poll.h>
57#endif
58
59#ifdef DBUS_WINCE
60/* Windows CE lacks some system functions (such as errno and clock).
61 We bring them in here. */
62#include "dbus-sysdeps-wince-glue.h"
63#endif
64
65#ifdef DBUS_WIN
66#include <ws2tcpip.h>
67#endif
68
69 DBUS_BEGIN_DECLS
70
71#ifdef DBUS_WIN
72#define _DBUS_PATH_SEPARATOR ";"
73#else
74#define _DBUS_PATH_SEPARATOR ":"
75#endif
76
77/* Forward declarations */
78
79
81 typedef struct DBusList DBusList;
82
84 typedef struct DBusCredentials DBusCredentials;
85
87 typedef struct DBusPipe DBusPipe;
88
95DBUS_PRIVATE_EXPORT
96 void _dbus_abort (void) _DBUS_GNUC_NORETURN;
97
98 dbus_bool_t _dbus_check_setuid (void);
99DBUS_PRIVATE_EXPORT
100 const char* _dbus_getenv (const char *varname);
101DBUS_PRIVATE_EXPORT
102 dbus_bool_t _dbus_clearenv (void);
103 char ** _dbus_get_environment (void);
104
106 typedef unsigned long dbus_pid_t;
108 typedef unsigned long dbus_uid_t;
110 typedef unsigned long dbus_gid_t;
111
113#define DBUS_PID_UNSET ((dbus_pid_t) -1)
115#define DBUS_UID_UNSET ((dbus_uid_t) -1)
117#define DBUS_GID_UNSET ((dbus_gid_t) -1)
118
120#define DBUS_PID_FORMAT "%lu"
122#define DBUS_UID_FORMAT "%lu"
124#define DBUS_GID_FORMAT "%lu"
125
129#ifdef DBUS_WIN
130
131 typedef struct { SOCKET sock; } DBusSocket;
132# define DBUS_SOCKET_FORMAT "Iu"
133# define DBUS_SOCKET_INIT { INVALID_SOCKET }
134
135 static inline SOCKET
136_dbus_socket_printable (DBusSocket s) { return s.sock; }
137
138 static inline dbus_bool_t
139_dbus_socket_is_valid (DBusSocket s) { return s.sock != INVALID_SOCKET; }
140
141 static inline void
142_dbus_socket_invalidate (DBusSocket *s) { s->sock = INVALID_SOCKET; }
143
144 static inline int
145_dbus_socket_get_int (DBusSocket s) { return (int)s.sock; }
146
147#else /* not DBUS_WIN */
148
149 typedef struct { int fd; } DBusSocket;
150# define DBUS_SOCKET_FORMAT "d"
151# define DBUS_SOCKET_INIT { -1 }
152
153 static inline int
154_dbus_socket_printable (DBusSocket s) { return s.fd; }
155
156 static inline dbus_bool_t
157_dbus_socket_is_valid (DBusSocket s) { return s.fd >= 0; }
158
159 static inline void
160_dbus_socket_invalidate (DBusSocket *s) { s->fd = -1; }
161
162 static inline int
163_dbus_socket_get_int (DBusSocket s) { return s.fd; }
164
165#endif /* not DBUS_WIN */
166
167 static inline DBusSocket
168_dbus_socket_get_invalid (void)
169{
170 DBusSocket s = DBUS_SOCKET_INIT;
171
172 return s;
173}
174
175 dbus_bool_t _dbus_set_socket_nonblocking (DBusSocket fd,
176 DBusError *error);
177
178DBUS_PRIVATE_EXPORT
179 dbus_bool_t _dbus_close_socket (DBusSocket fd,
180 DBusError *error);
181DBUS_PRIVATE_EXPORT
182 int _dbus_read_socket (DBusSocket fd,
183 DBusString *buffer,
184 int count);
185DBUS_PRIVATE_EXPORT
186 int _dbus_write_socket (DBusSocket fd,
187 const DBusString *buffer,
188 int start,
189 int len);
190 int _dbus_write_socket_two (DBusSocket fd,
191 const DBusString *buffer1,
192 int start1,
193 int len1,
194 const DBusString *buffer2,
195 int start2,
196 int len2);
197
198 int _dbus_read_socket_with_unix_fds (DBusSocket fd,
199 DBusString *buffer,
200 int count,
201 int *fds,
202 unsigned int *n_fds);
203DBUS_PRIVATE_EXPORT
204 int _dbus_write_socket_with_unix_fds (DBusSocket fd,
205 const DBusString *buffer,
206 int start,
207 int len,
208 const int *fds,
209 int n_fds);
210 int _dbus_write_socket_with_unix_fds_two (DBusSocket fd,
211 const DBusString *buffer1,
212 int start1,
213 int len1,
214 const DBusString *buffer2,
215 int start2,
216 int len2,
217 const int *fds,
218 int n_fds);
219
220 DBusSocket _dbus_connect_tcp_socket (const char *host,
221 const char *port,
222 const char *family,
223 DBusError *error);
224 DBusSocket _dbus_connect_tcp_socket_with_nonce (const char *host,
225 const char *port,
226 const char *family,
227 const char *noncefile,
228 DBusError *error);
229 int _dbus_listen_tcp_socket (const char *host,
230 const char *port,
231 const char *family,
232 DBusString *retport,
233 DBusSocket **fds_p,
234 DBusError *error);
235 DBusSocket _dbus_accept (DBusSocket listen_fd);
236
237 dbus_bool_t _dbus_read_credentials_socket (DBusSocket client_fd,
238 DBusCredentials *credentials,
239 DBusError *error);
240 dbus_bool_t _dbus_send_credentials_socket (DBusSocket server_fd,
241 DBusError *error);
242
243 dbus_bool_t _dbus_credentials_add_from_user (DBusCredentials *credentials,
244 const DBusString *username);
245 dbus_bool_t _dbus_credentials_add_from_current_process (DBusCredentials *credentials);
246DBUS_PRIVATE_EXPORT
247 dbus_bool_t _dbus_append_user_from_current_process (DBusString *str);
248
249 dbus_bool_t _dbus_parse_unix_user_from_config (const DBusString *username,
250 dbus_uid_t *uid_p);
251 dbus_bool_t _dbus_parse_unix_group_from_config (const DBusString *groupname,
252 dbus_gid_t *gid_p);
253 dbus_bool_t _dbus_unix_groups_from_uid (dbus_uid_t uid,
254 dbus_gid_t **group_ids,
255 int *n_group_ids);
256 dbus_bool_t _dbus_unix_user_is_at_console (dbus_uid_t uid,
257 DBusError *error);
258 dbus_bool_t _dbus_unix_user_is_process_owner (dbus_uid_t uid);
259 dbus_bool_t _dbus_windows_user_is_process_owner (const char *windows_sid);
260
261 dbus_bool_t _dbus_append_keyring_directory_for_credentials (DBusString *directory,
262 DBusCredentials *credentials);
263
264 dbus_bool_t _dbus_daemon_is_session_bus_address_published (const char *scope);
265
266 dbus_bool_t _dbus_daemon_publish_session_bus_address (const char* address, const char* shm_name);
267
268 void _dbus_daemon_unpublish_session_bus_address (void);
269
270 dbus_bool_t _dbus_socket_can_pass_unix_fd(DBusSocket fd);
271
275 typedef struct DBusAtomic DBusAtomic;
276
280 struct DBusAtomic
281{
282#ifdef DBUS_WIN
283 volatile long value;
284#else
285 volatile dbus_int32_t value;
286#endif
287};
288
289DBUS_PRIVATE_EXPORT
290 dbus_int32_t _dbus_atomic_inc (DBusAtomic *atomic);
291DBUS_PRIVATE_EXPORT
292 dbus_int32_t _dbus_atomic_dec (DBusAtomic *atomic);
293DBUS_PRIVATE_EXPORT
294 dbus_int32_t _dbus_atomic_get (DBusAtomic *atomic);
295
296#ifdef DBUS_WIN
297
298/* On Windows, you can only poll sockets. We emulate Unix poll() using
299 * select(), so it doesn't matter what precise type we put in DBusPollFD;
300 * use DBusSocket so that the compiler can check we are doing it right.
301 */
302 typedef DBusSocket DBusPollable;
303# define DBUS_POLLABLE_FORMAT "Iu"
304
305 static inline DBusPollable
306_dbus_socket_get_pollable (DBusSocket s) { return s; }
307
308 static inline SOCKET
309_dbus_pollable_printable (DBusPollable p) { return p.sock; }
310
311 static inline dbus_bool_t
312_dbus_pollable_is_valid (DBusPollable p) { return _dbus_socket_is_valid (p); }
313
314 static inline void
315_dbus_pollable_invalidate (DBusPollable *p) { _dbus_socket_invalidate (p); }
316
317 static inline dbus_bool_t
318_dbus_pollable_equals (DBusPollable a, DBusPollable b) { return a.sock == b.sock; }
319
320#else /* !DBUS_WIN */
321
322/* On Unix, you can poll sockets, pipes, etc., and we must put exactly
323 * "int" in DBusPollFD because we're relying on its layout exactly matching
324 * struct pollfd. (This is silly, and one day we should use a better
325 * abstraction.)
326 */
327 typedef int DBusPollable;
328# define DBUS_POLLABLE_FORMAT "d"
329
330 static inline DBusPollable
331_dbus_socket_get_pollable (DBusSocket s) { return s.fd; }
332
333 static inline int
334_dbus_pollable_printable (DBusPollable p) { return p; }
335
336 static inline dbus_bool_t
337_dbus_pollable_is_valid (DBusPollable p) { return p >= 0; }
338
339 static inline void
340_dbus_pollable_invalidate (DBusPollable *p) { *p = -1; }
341
342 static inline dbus_bool_t
343_dbus_pollable_equals (DBusPollable a, DBusPollable b) { return a == b; }
344
345#endif /* !DBUS_WIN */
346
347#if defined(HAVE_POLL) && !defined(BROKEN_POLL)
352 typedef struct pollfd DBusPollFD;
353
355#define _DBUS_POLLIN POLLIN
357#define _DBUS_POLLPRI POLLPRI
359#define _DBUS_POLLOUT POLLOUT
361#define _DBUS_POLLERR POLLERR
363#define _DBUS_POLLHUP POLLHUP
365#define _DBUS_POLLNVAL POLLNVAL
366#else
367/* Emulate poll() via select(). Because we aren't really going to call
368 * poll(), any similarly-shaped struct is acceptable, and any power of 2
369 * will do for the events/revents; these values happen to match Linux
370 * and *BSD. */
371 typedef struct
372{
373 DBusPollable fd;
374 short events;
375 short revents;
376} DBusPollFD;
377
379#define _DBUS_POLLIN 0x0001
381#define _DBUS_POLLPRI 0x0002
383#define _DBUS_POLLOUT 0x0004
385#define _DBUS_POLLERR 0x0008
387#define _DBUS_POLLHUP 0x0010
389#define _DBUS_POLLNVAL 0x0020
390#endif
391
392DBUS_PRIVATE_EXPORT
393 int _dbus_poll (DBusPollFD *fds,
394 int n_fds,
395 int timeout_milliseconds);
396
397DBUS_PRIVATE_EXPORT
398 void _dbus_sleep_milliseconds (int milliseconds);
399
400DBUS_PRIVATE_EXPORT
401 void _dbus_get_monotonic_time (long *tv_sec,
402 long *tv_usec);
403
404DBUS_PRIVATE_EXPORT
405 void _dbus_get_real_time (long *tv_sec,
406 long *tv_usec);
407
411DBUS_PRIVATE_EXPORT
412 dbus_bool_t _dbus_create_directory (const DBusString *filename,
413 DBusError *error);
414DBUS_PRIVATE_EXPORT
415 dbus_bool_t _dbus_ensure_directory (const DBusString *filename,
416 DBusError *error);
417DBUS_PRIVATE_EXPORT
418 dbus_bool_t _dbus_delete_directory (const DBusString *filename,
419 DBusError *error);
420
421DBUS_PRIVATE_EXPORT
422 dbus_bool_t _dbus_concat_dir_and_file (DBusString *dir,
423 const DBusString *next_component);
424 dbus_bool_t _dbus_string_get_dirname (const DBusString *filename,
425 DBusString *dirname);
426DBUS_PRIVATE_EXPORT
427 dbus_bool_t _dbus_path_is_absolute (const DBusString *filename);
428
429 dbus_bool_t _dbus_get_standard_session_servicedirs (DBusList **dirs);
430 dbus_bool_t _dbus_get_standard_system_servicedirs (DBusList **dirs);
431 dbus_bool_t _dbus_set_up_transient_session_servicedirs (DBusList **dirs,
432 DBusError *error);
433
434 dbus_bool_t _dbus_get_system_config_file (DBusString *str);
435 dbus_bool_t _dbus_get_session_config_file (DBusString *str);
436
438 typedef struct DBusDirIter DBusDirIter;
439
440 DBusDirIter* _dbus_directory_open (const DBusString *filename,
441 DBusError *error);
442 dbus_bool_t _dbus_directory_get_next_file (DBusDirIter *iter,
443 DBusString *filename,
444 DBusError *error);
445 void _dbus_directory_close (DBusDirIter *iter);
446
447 dbus_bool_t _dbus_check_dir_is_private_to_user (DBusString *dir,
448 DBusError *error);
449
450DBUS_PRIVATE_EXPORT
451 const char* _dbus_get_tmpdir (void);
452
456_DBUS_GNUC_WARN_UNUSED_RESULT
457 dbus_bool_t _dbus_generate_random_bytes_buffer (char *buffer,
458 int n_bytes,
459 DBusError *error);
460 dbus_bool_t _dbus_generate_random_bytes (DBusString *str,
461 int n_bytes,
462 DBusError *error);
463DBUS_PRIVATE_EXPORT
464 dbus_bool_t _dbus_generate_random_ascii (DBusString *str,
465 int n_bytes,
466 DBusError *error);
467
468DBUS_PRIVATE_EXPORT
469 const char* _dbus_error_from_errno (int error_number);
470DBUS_PRIVATE_EXPORT
471 const char* _dbus_error_from_system_errno (void);
472
473 int _dbus_save_socket_errno (void);
474 void _dbus_restore_socket_errno (int saved_errno);
475 void _dbus_set_errno_to_zero (void);
476 dbus_bool_t _dbus_get_is_errno_eagain_or_ewouldblock (int e);
477 dbus_bool_t _dbus_get_is_errno_enomem (int e);
478 dbus_bool_t _dbus_get_is_errno_eintr (int e);
479 dbus_bool_t _dbus_get_is_errno_epipe (int e);
480 dbus_bool_t _dbus_get_is_errno_etoomanyrefs (int e);
481DBUS_PRIVATE_EXPORT
482 const char* _dbus_strerror_from_errno (void);
483
484 void _dbus_disable_sigpipe (void);
485
486DBUS_PRIVATE_EXPORT
487 void _dbus_exit (int code) _DBUS_GNUC_NORETURN;
488
489DBUS_PRIVATE_EXPORT
490 int _dbus_printf_string_upper_bound (const char *format,
491 va_list args) _DBUS_GNUC_PRINTF (1, 0);
492
493#ifdef DBUS_ENABLE_VERBOSE_MODE
494DBUS_PRIVATE_EXPORT
495 void _dbus_print_thread (void);
496#endif
497
501 typedef struct
502{
503 unsigned long mode;
504 unsigned long nlink;
505 dbus_uid_t uid;
506 dbus_gid_t gid;
507 unsigned long size;
508 unsigned long atime;
509 unsigned long mtime;
510 unsigned long ctime;
511} DBusStat;
512
513 dbus_bool_t _dbus_stat (const DBusString *filename,
514 DBusStat *statbuf,
515 DBusError *error);
516DBUS_PRIVATE_EXPORT
517 dbus_bool_t _dbus_socketpair (DBusSocket *fd1,
518 DBusSocket *fd2,
519 dbus_bool_t blocking,
520 DBusError *error);
521
522DBUS_PRIVATE_EXPORT
523 void _dbus_print_backtrace (void);
524
525 dbus_bool_t _dbus_become_daemon (const DBusString *pidfile,
526 DBusPipe *print_pid_pipe,
527 DBusError *error,
528 dbus_bool_t keep_umask);
529
530 dbus_bool_t _dbus_verify_daemon_user (const char *user);
531 dbus_bool_t _dbus_change_to_daemon_user (const char *user,
532 DBusError *error);
533
534 dbus_bool_t _dbus_write_pid_to_file_and_pipe (const DBusString *pidfile,
535 DBusPipe *print_pid_pipe,
536 dbus_pid_t pid_to_write,
537 DBusError *error);
538
539 dbus_bool_t _dbus_command_for_pid (unsigned long pid,
540 DBusString *str,
541 int max_len,
542 DBusError *error);
543
544 dbus_bool_t _dbus_user_at_console (const char *username,
545 DBusError *error);
546
547 typedef enum {
548 DBUS_LOG_FLAGS_STDERR = (1 << 0),
549 DBUS_LOG_FLAGS_SYSTEM_LOG = (1 << 1)
550} DBusLogFlags;
551
552DBUS_PRIVATE_EXPORT
553 void _dbus_init_system_log (const char *tag,
554 DBusLogFlags flags);
555
556 typedef enum {
557 DBUS_SYSTEM_LOG_INFO,
558 DBUS_SYSTEM_LOG_WARNING,
559 DBUS_SYSTEM_LOG_SECURITY,
560 DBUS_SYSTEM_LOG_ERROR
561} DBusSystemLogSeverity;
562
563DBUS_PRIVATE_EXPORT
564 void _dbus_log (DBusSystemLogSeverity severity,
565 const char *msg,
566 ...) _DBUS_GNUC_PRINTF (2, 3);
567DBUS_PRIVATE_EXPORT
568 void _dbus_logv (DBusSystemLogSeverity severity,
569 const char *msg,
570 va_list args) _DBUS_GNUC_PRINTF (2, 0);
571
572/* Define DBUS_VA_COPY() to do the right thing for copying va_list variables.
573 * config.h may have already defined DBUS_VA_COPY as va_copy or __va_copy.
574 */
575#if !defined (DBUS_VA_COPY)
576# if defined (__GNUC__) && defined (__PPC__) && (defined (_CALL_SYSV) || defined (_WIN32))
577# define DBUS_VA_COPY(ap1, ap2) (*(ap1) = *(ap2))
578# elif defined (DBUS_VA_COPY_AS_ARRAY)
579# define DBUS_VA_COPY(ap1, ap2) memcpy ((ap1), (ap2), sizeof (va_list))
580# else /* va_list is a pointer */
581# define DBUS_VA_COPY(ap1, ap2) ((ap1) = (ap2))
582# endif /* va_list is a pointer */
583#endif /* !DBUS_VA_COPY */
584
585
590#define _DBUS_BYTE_OF_PRIMITIVE(p, i) \
591 (((const char*)&(p))[(i)])
597#define _DBUS_DOUBLES_BITWISE_EQUAL(a, b) \
598 (_DBUS_BYTE_OF_PRIMITIVE (a, 0) == _DBUS_BYTE_OF_PRIMITIVE (b, 0) && \
599 _DBUS_BYTE_OF_PRIMITIVE (a, 1) == _DBUS_BYTE_OF_PRIMITIVE (b, 1) && \
600 _DBUS_BYTE_OF_PRIMITIVE (a, 2) == _DBUS_BYTE_OF_PRIMITIVE (b, 2) && \
601 _DBUS_BYTE_OF_PRIMITIVE (a, 3) == _DBUS_BYTE_OF_PRIMITIVE (b, 3) && \
602 _DBUS_BYTE_OF_PRIMITIVE (a, 4) == _DBUS_BYTE_OF_PRIMITIVE (b, 4) && \
603 _DBUS_BYTE_OF_PRIMITIVE (a, 5) == _DBUS_BYTE_OF_PRIMITIVE (b, 5) && \
604 _DBUS_BYTE_OF_PRIMITIVE (a, 6) == _DBUS_BYTE_OF_PRIMITIVE (b, 6) && \
605 _DBUS_BYTE_OF_PRIMITIVE (a, 7) == _DBUS_BYTE_OF_PRIMITIVE (b, 7))
606
607 dbus_bool_t _dbus_get_autolaunch_address (const char *scope,
608 DBusString *address,
609 DBusError *error);
610
611 dbus_bool_t _dbus_lookup_session_address (dbus_bool_t *supported,
612 DBusString *address,
613 DBusError *error);
614
618 typedef union DBusGUID DBusGUID;
619
620DBUS_PRIVATE_EXPORT
621 dbus_bool_t _dbus_read_local_machine_uuid (DBusGUID *machine_id,
622 dbus_bool_t create_if_not_found,
623 DBusError *error);
624
630 dbus_bool_t _dbus_threads_init_platform_specific (void);
631
635 void _dbus_threads_lock_platform_specific (void);
636
640 void _dbus_threads_unlock_platform_specific (void);
641
642DBUS_PRIVATE_EXPORT
643 dbus_bool_t _dbus_split_paths_and_append (DBusString *dirs,
644 const char *suffix,
645 DBusList **dir_list);
646
647 unsigned long _dbus_pid_for_log (void);
648
649/* FIXME move back to dbus-sysdeps-unix.h probably -
650 * the PID file handling just needs a little more abstraction
651 * in the bus daemon first.
652 */
653DBUS_PRIVATE_EXPORT
654 dbus_pid_t _dbus_getpid (void);
655
656DBUS_PRIVATE_EXPORT
657 dbus_uid_t _dbus_getuid (void);
658
659DBUS_PRIVATE_EXPORT
660 void _dbus_flush_caches (void);
661
662 dbus_bool_t _dbus_replace_install_prefix (DBusString *path);
663
664/* Do not set this too high: it is a denial-of-service risk.
665 * See <https://bugs.freedesktop.org/show_bug.cgi?id=82820>
666 *
667 * (This needs to be in the non-Unix-specific header so that
668 * the config-parser can use it.)
669 */
670#define DBUS_DEFAULT_MESSAGE_UNIX_FDS 16
671
672 typedef struct DBusRLimit DBusRLimit;
673
674DBusRLimit *_dbus_rlimit_save_fd_limit (DBusError *error);
675 dbus_bool_t _dbus_rlimit_raise_fd_limit_if_privileged (unsigned int desired,
676 DBusError *error);
677 dbus_bool_t _dbus_rlimit_restore_fd_limit (DBusRLimit *saved,
678 DBusError *error);
679 void _dbus_rlimit_free (DBusRLimit *lim);
680
683 DBUS_END_DECLS
684
685
686#ifdef DBUS_WIN
687#include "dbus-sysdeps-win.h"
688#endif
689
690#endif /* DBUS_SYSDEPS_H */
DBUS_BEGIN_DECLS
#define DBUS_BEGIN_DECLS
Macro used prior to declaring functions in the D-Bus header files.
DBUS_END_DECLS
#define DBUS_END_DECLS
Macro used after declaring functions in the D-Bus header files.
_dbus_logv
DBUS_PRIVATE_EXPORT void _dbus_logv(DBusSystemLogSeverity severity, const char *msg, va_list args)
Log a message to the system log file (e.g.
Definition: dbus-sysdeps-unix.c:4619
_dbus_stat
dbus_bool_t _dbus_stat(const DBusString *filename, DBusStat *statbuf, DBusError *error)
stat() wrapper.
Definition: dbus-sysdeps-util-unix.c:612
_dbus_read_local_machine_uuid
DBUS_PRIVATE_EXPORT 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:3903
_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:1369
_dbus_get_is_errno_epipe
dbus_bool_t _dbus_get_is_errno_epipe(int e)
See if errno is EPIPE.
Definition: dbus-sysdeps.c:727
_dbus_get_is_errno_etoomanyrefs
dbus_bool_t _dbus_get_is_errno_etoomanyrefs(int e)
See if errno is ETOOMANYREFS.
Definition: dbus-sysdeps.c:737
_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:230
_dbus_directory_close
void _dbus_directory_close(DBusDirIter *iter)
Closes a directory iteration.
Definition: dbus-sysdeps-util-unix.c:756
dbus_uid_t
unsigned long dbus_uid_t
A user ID.
Definition: dbus-sysdeps.h:108
_dbus_get_is_errno_eagain_or_ewouldblock
dbus_bool_t _dbus_get_is_errno_eagain_or_ewouldblock(int e)
See if errno is EAGAIN or EWOULDBLOCK (this has to be done differently for Winsock so is abstracted)
Definition: dbus-sysdeps-unix.c:4303
_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:2693
_dbus_get_session_config_file
dbus_bool_t _dbus_get_session_config_file(DBusString *str)
Get the absolute path of the session.conf file.
Definition: dbus-sysdeps-util-unix.c:1509
_dbus_clearenv
dbus_bool_t _dbus_clearenv(void)
Wrapper for clearenv().
Definition: dbus-sysdeps.c:203
dbus_pid_t
unsigned long dbus_pid_t
A process ID.
Definition: dbus-sysdeps.h:106
_dbus_read_socket
DBUS_PRIVATE_EXPORT int _dbus_read_socket(DBusSocket fd, DBusString *buffer, int count)
Like _dbus_read(), but only works on sockets so is available on Windows.
Definition: dbus-sysdeps-unix.c:302
_dbus_exit
DBUS_PRIVATE_EXPORT void _dbus_exit(int code) _DBUS_GNUC_NORETURN
Exit the process, returning the given value.
Definition: dbus-sysdeps-unix.c:3150
_dbus_socket_can_pass_unix_fd
dbus_bool_t _dbus_socket_can_pass_unix_fd(DBusSocket fd)
Checks whether file descriptors may be passed via the socket.
Definition: dbus-sysdeps-unix.c:4344
_dbus_write_socket
DBUS_PRIVATE_EXPORT int _dbus_write_socket(DBusSocket 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:320
_dbus_socketpair
DBUS_PRIVATE_EXPORT dbus_bool_t _dbus_socketpair(DBusSocket *fd1, DBusSocket *fd2, dbus_bool_t blocking, DBusError *error)
Creates pair of connect sockets (as in socketpair()).
Definition: dbus-sysdeps-unix.c:3371
dbus_gid_t
unsigned long dbus_gid_t
A group ID.
Definition: dbus-sysdeps.h:110
_dbus_read_socket_with_unix_fds
int _dbus_read_socket_with_unix_fds(DBusSocket fd, DBusString *buffer, int count, int *fds, unsigned int *n_fds)
Like _dbus_read_socket() but also tries to read unix fds from the socket.
Definition: dbus-sysdeps-unix.c:358
_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:548
_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:1114
_dbus_get_system_config_file
dbus_bool_t _dbus_get_system_config_file(DBusString *str)
Get the absolute path of the system.conf file (there is no system bus on Windows so this can just ret...
Definition: dbus-sysdeps-util-unix.c:1495
_dbus_directory_open
DBusDirIter * _dbus_directory_open(const DBusString *filename, DBusError *error)
Open a directory to iterate over.
Definition: dbus-sysdeps-util-unix.c:660
_dbus_set_up_transient_session_servicedirs
dbus_bool_t _dbus_set_up_transient_session_servicedirs(DBusList **dirs, DBusError *error)
Returns the standard directories for a session bus to look for transient service activation files.
Definition: dbus-sysdeps-util-unix.c:1272
_dbus_generate_random_bytes_buffer
_DBUS_GNUC_WARN_UNUSED_RESULT dbus_bool_t _dbus_generate_random_bytes_buffer(char *buffer, int n_bytes, DBusError *error)
Random numbers.
Definition: dbus-sysdeps.c:518
_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:4215
_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:51
_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:941
_dbus_atomic_dec
DBUS_PRIVATE_EXPORT dbus_int32_t _dbus_atomic_dec(DBusAtomic *atomic)
Atomically decrement an integer.
Definition: dbus-sysdeps-unix.c:2777
_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:304
_dbus_close_socket
DBUS_PRIVATE_EXPORT dbus_bool_t _dbus_close_socket(DBusSocket fd, DBusError *error)
Closes a socket.
Definition: dbus-sysdeps-unix.c:286
_dbus_read_credentials_socket
dbus_bool_t _dbus_read_credentials_socket(DBusSocket 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:1886
_dbus_getenv
const char * _dbus_getenv(const char *varname)
Wrapper for getenv().
Definition: dbus-sysdeps.c:187
_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:1461
_dbus_getpid
DBUS_PRIVATE_EXPORT dbus_pid_t _dbus_getpid(void)
Gets our process ID.
Definition: dbus-sysdeps-unix.c:2663
_dbus_atomic_get
DBUS_PRIVATE_EXPORT dbus_int32_t _dbus_atomic_get(DBusAtomic *atomic)
Atomically get the value of an integer.
Definition: dbus-sysdeps-unix.c:2801
_dbus_set_socket_nonblocking
dbus_bool_t _dbus_set_socket_nonblocking(DBusSocket fd, DBusError *error)
Sets a file descriptor to be nonblocking.
Definition: dbus-sysdeps-unix.c:3284
_dbus_error_from_system_errno
DBUS_PRIVATE_EXPORT const char * _dbus_error_from_system_errno(void)
Converts the current system errno value into a DBusError name.
Definition: dbus-sysdeps.c:684
_dbus_connect_tcp_socket
DBusSocket _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:1337
_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:294
_dbus_disable_sigpipe
void _dbus_disable_sigpipe(void)
signal (SIGPIPE, SIG_IGN);
Definition: dbus-sysdeps-unix.c:3179
_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:4443
_dbus_sleep_milliseconds
DBUS_PRIVATE_EXPORT void _dbus_sleep_milliseconds(int milliseconds)
Sleeps the given number of milliseconds.
Definition: dbus-sysdeps-unix.c:3065
_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:974
_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:324
_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:1006
_dbus_strerror_from_errno
DBUS_PRIVATE_EXPORT const char * _dbus_strerror_from_errno(void)
Get error message from errno.
Definition: dbus-sysdeps.c:751
_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:2276
_dbus_log
DBUS_PRIVATE_EXPORT void _dbus_log(DBusSystemLogSeverity severity, const char *msg,...)
Log a message to the system log file (e.g.
Definition: dbus-sysdeps.c:763
_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:1019
_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:957
_dbus_threads_unlock_platform_specific
void _dbus_threads_unlock_platform_specific(void)
Undo _dbus_threads_lock_platform_specific().
Definition: dbus-sysdeps-pthread.c:300
_dbus_send_credentials_socket
dbus_bool_t _dbus_send_credentials_socket(DBusSocket server_fd, DBusError *error)
Sends a single nul byte with our UNIX credentials as ancillary data.
Definition: dbus-sysdeps-unix.c:2200
_dbus_getuid
DBUS_PRIVATE_EXPORT dbus_uid_t _dbus_getuid(void)
Gets our UID.
Definition: dbus-sysdeps-unix.c:2672
_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:2622
_dbus_atomic_inc
DBUS_PRIVATE_EXPORT dbus_int32_t _dbus_atomic_inc(DBusAtomic *atomic)
Atomically increments an integer.
Definition: dbus-sysdeps-unix.c:2754
_dbus_generate_random_bytes
dbus_bool_t _dbus_generate_random_bytes(DBusString *str, int n_bytes, DBusError *error)
Generates the given number of securely random bytes, using the best mechanism we can come up with.
Definition: dbus-sysdeps-unix.c:3095
_dbus_printf_string_upper_bound
DBUS_PRIVATE_EXPORT 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:3446
_dbus_get_monotonic_time
DBUS_PRIVATE_EXPORT void _dbus_get_monotonic_time(long *tv_sec, long *tv_usec)
Get current time, as in gettimeofday().
Definition: dbus-sysdeps-unix.c:2904
_dbus_delete_directory
DBUS_PRIVATE_EXPORT dbus_bool_t _dbus_delete_directory(const DBusString *filename, DBusError *error)
Removes a directory; Directory must be empty.
Definition: dbus-sysdeps-unix.c:4316
_dbus_error_from_errno
DBUS_PRIVATE_EXPORT 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:592
_dbus_get_real_time
DBUS_PRIVATE_EXPORT void _dbus_get_real_time(long *tv_sec, long *tv_usec)
Get current time, as in gettimeofday().
Definition: dbus-sysdeps-unix.c:2935
_dbus_abort
void _dbus_abort(void)
Aborts the program with SIGABRT (dumping core).
Definition: dbus-sysdeps.c:79
_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:708
_dbus_poll
DBUS_PRIVATE_EXPORT int _dbus_poll(DBusPollFD *fds, int n_fds, int timeout_milliseconds)
Wrapper for poll().
Definition: dbus-sysdeps-unix.c:2826
_dbus_generate_random_ascii
DBUS_PRIVATE_EXPORT dbus_bool_t _dbus_generate_random_ascii(DBusString *str, int n_bytes, DBusError *error)
Generates the given number of random bytes, where the bytes are chosen from the alphanumeric ASCII su...
Definition: dbus-sysdeps.c:552
_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:3784
_dbus_write_socket_two
int _dbus_write_socket_two(DBusSocket 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:631
_dbus_concat_dir_and_file
DBUS_PRIVATE_EXPORT 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:3020
_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:82
_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:2067
_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:228
_dbus_print_backtrace
DBUS_PRIVATE_EXPORT void _dbus_print_backtrace(void)
On GNU libc systems, print a crude backtrace to stderr.
Definition: dbus-sysdeps-unix.c:3329
_dbus_init_system_log
DBUS_PRIVATE_EXPORT void _dbus_init_system_log(const char *tag, DBusLogFlags flags)
Initialize the system log.
Definition: dbus-sysdeps-unix.c:4594
_dbus_replace_install_prefix
dbus_bool_t _dbus_replace_install_prefix(DBusString *path)
Replace the DBUS_PREFIX in the given path, in-place, by the current D-Bus installation directory.
Definition: dbus-sysdeps-util-unix.c:1190
_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:4164
_dbus_accept
DBusSocket _dbus_accept(DBusSocket listen_fd)
Accepts a connection on a listening socket.
Definition: dbus-sysdeps-unix.c:2221
_dbus_append_user_from_current_process
DBUS_PRIVATE_EXPORT 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:2652
_dbus_flush_caches
DBUS_PRIVATE_EXPORT 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:4196
_dbus_get_is_errno_eintr
dbus_bool_t _dbus_get_is_errno_eintr(int e)
See if errno is EINTR.
Definition: dbus-sysdeps.c:717
_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:279
_dbus_listen_tcp_socket
int _dbus_listen_tcp_socket(const char *host, const char *port, const char *family, DBusString *retport, DBusSocket **fds_p, DBusError *error)
Creates a socket and binds it to the given path, then listens on the socket.
Definition: dbus-sysdeps-unix.c:1462
_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:991
_dbus_set_errno_to_zero
void _dbus_set_errno_to_zero(void)
Assign 0 to the global errno variable.
Definition: dbus-sysdeps.c:693
_dbus_get_tmpdir
DBUS_PRIVATE_EXPORT const char * _dbus_get_tmpdir(void)
Gets the temporary files directory by inspecting the environment variables TMPDIR,...
Definition: dbus-sysdeps-unix.c:3516
_dbus_ensure_directory
DBUS_PRIVATE_EXPORT dbus_bool_t _dbus_ensure_directory(const DBusString *filename, DBusError *error)
Creates a directory; succeeds if the directory is created or already existed.
Definition: dbus-sysdeps-unix.c:2957
_dbus_get_is_errno_enomem
dbus_bool_t _dbus_get_is_errno_enomem(int e)
See if errno is ENOMEM.
Definition: dbus-sysdeps.c:707
_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:1038
_dbus_path_is_absolute
DBUS_PRIVATE_EXPORT dbus_bool_t _dbus_path_is_absolute(const DBusString *filename)
Checks whether the filename is an absolute path.
Definition: dbus-sysdeps-util-unix.c:595
_dbus_create_directory
DBUS_PRIVATE_EXPORT dbus_bool_t _dbus_create_directory(const DBusString *filename, DBusError *error)
directory interface
Definition: dbus-sysdeps-unix.c:2989
dbus_bool_t
dbus_uint32_t dbus_bool_t
A boolean, valid values are TRUE and FALSE.
Definition: dbus-types.h:35
dbus_int32_t
int dbus_int32_t
A 32-bit signed integer on all platforms.
Definition: dbus-arch-deps.h:42
DBusAtomic
An atomic integer safe to increment or decrement from multiple threads.
Definition: dbus-sysdeps.h:281
DBusAtomic::value
volatile dbus_int32_t value
Value of the atomic integer.
Definition: dbus-sysdeps.h:285
DBusCredentials
Definition: dbus-credentials.c:48
DBusDirIter
Internals of directory iterator.
Definition: dbus-sysdeps-util-unix.c:647
DBusError
Object representing an exception.
Definition: dbus-errors.h:49
DBusList
A node in a linked list.
Definition: dbus-list.h:35
DBusPipe
Definition: dbus-pipe.h:41
DBusPollFD
Definition: dbus-sysdeps.h:372
DBusPollFD::events
short events
Events to poll for.
Definition: dbus-sysdeps.h:374
DBusPollFD::revents
short revents
Events that occurred.
Definition: dbus-sysdeps.h:375
DBusPollFD::fd
DBusPollable fd
File descriptor.
Definition: dbus-sysdeps.h:373
DBusSocket
Socket interface.
Definition: dbus-sysdeps.h:149
DBusStat
Portable struct with stat() results.
Definition: dbus-sysdeps.h:502
DBusStat::nlink
unsigned long nlink
Number of hard links.
Definition: dbus-sysdeps.h:504
DBusStat::size
unsigned long size
Size of file.
Definition: dbus-sysdeps.h:507
DBusStat::uid
dbus_uid_t uid
User owning file.
Definition: dbus-sysdeps.h:505
DBusStat::mode
unsigned long mode
File mode.
Definition: dbus-sysdeps.h:503
DBusStat::gid
dbus_gid_t gid
Group owning file.
Definition: dbus-sysdeps.h:506
DBusStat::atime
unsigned long atime
Access time.
Definition: dbus-sysdeps.h:508
DBusStat::ctime
unsigned long ctime
Creation time.
Definition: dbus-sysdeps.h:510
DBusStat::mtime
unsigned long mtime
Modify time.
Definition: dbus-sysdeps.h:509
DBusString
Definition: dbus-string.h:43
DBusGUID
A globally unique ID ; we have one for each DBusServer, and also one for each machine with libdbus in...
Definition: dbus-internals.h:395