D-Bus  1.13.16
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 #if !defined(BROKEN_POLL) && (defined(__APPLE__) || defined(__INTERIX))
52  /* Following libcurl's example, we blacklist poll() on Darwin
53  * (macOS, iOS, etc.) and Interix due to a history of implementation
54  * issues.
55  * https://github.com/curl/curl/blob/master/m4/curl-functions.m4
56  *
57  * On unspecified older macOS versions, poll() failed if given a
58  * device node to poll.
59  *
60  * On macOS < 10.9, poll() with nfds=0 failed instead of waiting for
61  * the timeout and then succeeding.
62  *
63  * On macOS >= 10.12, poll() with nfds=0 succeeded immediately
64  * instead of waiting for the timeout, resulting in busy-looping.
65  *
66  * On Interix, poll() apparently only works for files in /proc.
67  *
68  * The "legacy" build flavour in our CI machinery defines BROKEN_POLL
69  * on whatever platform is in use (normally Linux) to force use of the
70  * same select()-based poll() emulation that we use for macOS, Interix,
71  * and any platform that lacks a real poll(), so that we can test it
72  * more regularly.
73  */
74 # define BROKEN_POLL
75 #endif
76 
77 /* Normally we'd only include this in dbus-sysdeps-unix.c.
78  * However, the member names in DBusPollFD are (deliberately) the same as
79  * in POSIX struct pollfd, and AIX's poll() implementation is known to
80  * do things like "#define events reqevents", which would break that approach.
81  * Defend against that by ensuring that if it's renamed anywhere, it's renamed
82  * everywhere.
83  */
84 #ifdef HAVE_POLL
85 #include <poll.h>
86 #endif
87 
88 #ifdef DBUS_WINCE
89 /* Windows CE lacks some system functions (such as errno and clock).
90  We bring them in here. */
91 #include "dbus-sysdeps-wince-glue.h"
92 #endif
93 
94 #ifdef DBUS_WIN
95 #include <ws2tcpip.h>
96 #endif
97 
99 
100 #ifdef DBUS_WIN
101 #define _DBUS_PATH_SEPARATOR ";"
102 #else
103 #define _DBUS_PATH_SEPARATOR ":"
104 #endif
105 
106 /* Forward declarations */
107 
108 
110 typedef struct DBusList DBusList;
111 
113 typedef struct DBusCredentials DBusCredentials;
114 
116 typedef struct DBusPipe DBusPipe;
117 
124 DBUS_PRIVATE_EXPORT
125 void _dbus_abort (void) _DBUS_GNUC_NORETURN;
126 
128 DBUS_PRIVATE_EXPORT
129 const char* _dbus_getenv (const char *varname);
130 DBUS_PRIVATE_EXPORT
132 char ** _dbus_get_environment (void);
133 
135 typedef unsigned long dbus_pid_t;
137 typedef unsigned long dbus_uid_t;
139 typedef unsigned long dbus_gid_t;
140 
142 #define DBUS_PID_UNSET ((dbus_pid_t) -1)
143 
144 #define DBUS_UID_UNSET ((dbus_uid_t) -1)
145 
146 #define DBUS_GID_UNSET ((dbus_gid_t) -1)
147 
149 #define DBUS_PID_FORMAT "%lu"
150 
151 #define DBUS_UID_FORMAT "%lu"
152 
153 #define DBUS_GID_FORMAT "%lu"
154 
158 #ifdef DBUS_WIN
159 
160 typedef struct { SOCKET sock; } DBusSocket;
161 # define DBUS_SOCKET_FORMAT "Iu"
162 # define DBUS_SOCKET_INIT { INVALID_SOCKET }
163 
164 _DBUS_WARN_UNUSED_RESULT
165 static inline SOCKET
166 _dbus_socket_printable (DBusSocket s) { return s.sock; }
167 
168 _DBUS_WARN_UNUSED_RESULT
169 static inline dbus_bool_t
170 _dbus_socket_is_valid (DBusSocket s) { return s.sock != INVALID_SOCKET; }
171 
172 static inline void
173 _dbus_socket_invalidate (DBusSocket *s) { s->sock = INVALID_SOCKET; }
174 
175 _DBUS_WARN_UNUSED_RESULT
176 static inline int
177 _dbus_socket_get_int (DBusSocket s) { return (int)s.sock; }
178 
179 #else /* not DBUS_WIN */
180 
181 typedef struct { int fd; } DBusSocket;
182 # define DBUS_SOCKET_FORMAT "d"
183 # define DBUS_SOCKET_INIT { -1 }
184 
185 _DBUS_WARN_UNUSED_RESULT
186 static inline int
187 _dbus_socket_printable (DBusSocket s) { return s.fd; }
188 
189 _DBUS_WARN_UNUSED_RESULT
190 static inline dbus_bool_t
191 _dbus_socket_is_valid (DBusSocket s) { return s.fd >= 0; }
192 
193 static inline void
194 _dbus_socket_invalidate (DBusSocket *s) { s->fd = -1; }
195 
196 _DBUS_WARN_UNUSED_RESULT
197 static inline int
198 _dbus_socket_get_int (DBusSocket s) { return s.fd; }
199 
200 #endif /* not DBUS_WIN */
201 
202 _DBUS_WARN_UNUSED_RESULT
203 static inline DBusSocket
204 _dbus_socket_get_invalid (void)
205 {
206  DBusSocket s = DBUS_SOCKET_INIT;
207 
208  return s;
209 }
210 
212  DBusError *error);
213 
214 DBUS_PRIVATE_EXPORT
216  DBusError *error);
217 DBUS_PRIVATE_EXPORT
219  DBusString *buffer,
220  int count);
221 DBUS_PRIVATE_EXPORT
223  const DBusString *buffer,
224  int start,
225  int len);
227  const DBusString *buffer1,
228  int start1,
229  int len1,
230  const DBusString *buffer2,
231  int start2,
232  int len2);
233 
235  DBusString *buffer,
236  int count,
237  int *fds,
238  unsigned int *n_fds);
239 DBUS_PRIVATE_EXPORT
240 int _dbus_write_socket_with_unix_fds (DBusSocket fd,
241  const DBusString *buffer,
242  int start,
243  int len,
244  const int *fds,
245  int n_fds);
246 int _dbus_write_socket_with_unix_fds_two (DBusSocket fd,
247  const DBusString *buffer1,
248  int start1,
249  int len1,
250  const DBusString *buffer2,
251  int start2,
252  int len2,
253  const int *fds,
254  int n_fds);
255 
256 DBusSocket _dbus_connect_tcp_socket (const char *host,
257  const char *port,
258  const char *family,
259  DBusError *error);
260 DBusSocket _dbus_connect_tcp_socket_with_nonce (const char *host,
261  const char *port,
262  const char *family,
263  const char *noncefile,
264  DBusError *error);
265 int _dbus_listen_tcp_socket (const char *host,
266  const char *port,
267  const char *family,
268  DBusString *retport,
269  const char **retfamily,
270  DBusSocket **fds_p,
271  DBusError *error);
273 
275  DBusCredentials *credentials,
276  DBusError *error);
278  DBusError *error);
279 
280 typedef enum
281 {
282  DBUS_CREDENTIALS_ADD_FLAGS_USER_DATABASE = (1 << 0),
283  DBUS_CREDENTIALS_ADD_FLAGS_NONE = 0
284 } DBusCredentialsAddFlags;
285 
287  const DBusString *username,
288  DBusCredentialsAddFlags flags,
289  DBusError *error);
290 
292 DBUS_PRIVATE_EXPORT
294 
296  dbus_uid_t *uid_p);
298  dbus_gid_t *gid_p);
300  dbus_gid_t **group_ids,
301  int *n_group_ids);
303  DBusError *error);
305 dbus_bool_t _dbus_windows_user_is_process_owner (const char *windows_sid);
306 
308  DBusCredentials *credentials);
309 
310 dbus_bool_t _dbus_daemon_is_session_bus_address_published (const char *scope);
311 
312 dbus_bool_t _dbus_daemon_publish_session_bus_address (const char* address, const char* shm_name);
313 
314 void _dbus_daemon_unpublish_session_bus_address (void);
315 
317 
321 typedef struct DBusAtomic DBusAtomic;
322 
327 {
328 #ifdef DBUS_WIN
329  volatile long value;
330 #else
331  volatile dbus_int32_t value;
332 #endif
333 };
334 
335 DBUS_PRIVATE_EXPORT
336 dbus_int32_t _dbus_atomic_inc (DBusAtomic *atomic);
337 DBUS_PRIVATE_EXPORT
338 dbus_int32_t _dbus_atomic_dec (DBusAtomic *atomic);
339 DBUS_PRIVATE_EXPORT
340 dbus_int32_t _dbus_atomic_get (DBusAtomic *atomic);
341 DBUS_PRIVATE_EXPORT
342 void _dbus_atomic_set_zero (DBusAtomic *atomic);
343 DBUS_PRIVATE_EXPORT
344 void _dbus_atomic_set_nonzero (DBusAtomic *atomic);
345 
346 #ifdef DBUS_WIN
347 
348 /* On Windows, you can only poll sockets. We emulate Unix poll() using
349  * select(), so it doesn't matter what precise type we put in DBusPollFD;
350  * use DBusSocket so that the compiler can check we are doing it right.
351  */
352 typedef DBusSocket DBusPollable;
353 # define DBUS_POLLABLE_FORMAT "Iu"
354 
355 static inline DBusPollable
356 _dbus_socket_get_pollable (DBusSocket s) { return s; }
357 
358 static inline SOCKET
359 _dbus_pollable_printable (DBusPollable p) { return p.sock; }
360 
361 static inline dbus_bool_t
362 _dbus_pollable_is_valid (DBusPollable p) { return _dbus_socket_is_valid (p); }
363 
364 static inline void
365 _dbus_pollable_invalidate (DBusPollable *p) { _dbus_socket_invalidate (p); }
366 
367 static inline dbus_bool_t
368 _dbus_pollable_equals (DBusPollable a, DBusPollable b) { return a.sock == b.sock; }
369 
370 #else /* !DBUS_WIN */
371 
372 /* On Unix, you can poll sockets, pipes, etc., and we must put exactly
373  * "int" in DBusPollFD because we're relying on its layout exactly matching
374  * struct pollfd. (This is silly, and one day we should use a better
375  * abstraction.)
376  */
377 typedef int DBusPollable;
378 # define DBUS_POLLABLE_FORMAT "d"
379 
380 static inline DBusPollable
381 _dbus_socket_get_pollable (DBusSocket s) { return s.fd; }
382 
383 static inline int
384 _dbus_pollable_printable (DBusPollable p) { return p; }
385 
386 static inline dbus_bool_t
387 _dbus_pollable_is_valid (DBusPollable p) { return p >= 0; }
388 
389 static inline void
390 _dbus_pollable_invalidate (DBusPollable *p) { *p = -1; }
391 
392 static inline dbus_bool_t
393 _dbus_pollable_equals (DBusPollable a, DBusPollable b) { return a == b; }
394 
395 #endif /* !DBUS_WIN */
396 
397 #if defined(HAVE_POLL) && !defined(BROKEN_POLL)
398 
402 typedef struct pollfd DBusPollFD;
403 
405 #define _DBUS_POLLIN POLLIN
406 
407 #define _DBUS_POLLPRI POLLPRI
408 
409 #define _DBUS_POLLOUT POLLOUT
410 
411 #define _DBUS_POLLERR POLLERR
412 
413 #define _DBUS_POLLHUP POLLHUP
414 
415 #define _DBUS_POLLNVAL POLLNVAL
416 #else
417 /* Emulate poll() via select(). Because we aren't really going to call
418  * poll(), any similarly-shaped struct is acceptable, and any power of 2
419  * will do for the events/revents; these values happen to match Linux
420  * and *BSD. */
421 typedef struct
422 {
423  DBusPollable fd;
424  short events;
425  short revents;
426 } DBusPollFD;
427 
429 #define _DBUS_POLLIN 0x0001
430 
431 #define _DBUS_POLLPRI 0x0002
432 
433 #define _DBUS_POLLOUT 0x0004
434 
435 #define _DBUS_POLLERR 0x0008
436 
437 #define _DBUS_POLLHUP 0x0010
438 
439 #define _DBUS_POLLNVAL 0x0020
440 #endif
441 
442 DBUS_PRIVATE_EXPORT
443 int _dbus_poll (DBusPollFD *fds,
444  int n_fds,
445  int timeout_milliseconds);
446 
447 DBUS_PRIVATE_EXPORT
448 void _dbus_sleep_milliseconds (int milliseconds);
449 
450 DBUS_PRIVATE_EXPORT
451 void _dbus_get_monotonic_time (long *tv_sec,
452  long *tv_usec);
453 
454 DBUS_PRIVATE_EXPORT
455 void _dbus_get_real_time (long *tv_sec,
456  long *tv_usec);
457 
461 DBUS_PRIVATE_EXPORT
463  DBusError *error);
464 DBUS_PRIVATE_EXPORT
466  DBusError *error);
467 DBUS_PRIVATE_EXPORT
469  DBusError *error);
470 
471 DBUS_PRIVATE_EXPORT
473  const DBusString *next_component);
475  DBusString *dirname);
476 DBUS_PRIVATE_EXPORT
478 
482  DBusError *error);
483 
486 
488 typedef struct DBusDirIter DBusDirIter;
489 
491  DBusError *error);
493  DBusString *filename,
494  DBusError *error);
496 
498  DBusError *error);
499 
500 DBUS_PRIVATE_EXPORT
501 const char* _dbus_get_tmpdir (void);
502 
506 _DBUS_WARN_UNUSED_RESULT
508  int n_bytes,
509  DBusError *error);
511  int n_bytes,
512  DBusError *error);
513 DBUS_PRIVATE_EXPORT
515  int n_bytes,
516  DBusError *error);
517 
518 DBUS_PRIVATE_EXPORT
519 const char* _dbus_error_from_errno (int error_number);
520 DBUS_PRIVATE_EXPORT
521 const char* _dbus_error_from_system_errno (void);
522 
523 int _dbus_get_low_level_socket_errno (void);
524 
525 int _dbus_save_socket_errno (void);
526 void _dbus_restore_socket_errno (int saved_errno);
527 void _dbus_set_errno_to_zero (void);
533 DBUS_PRIVATE_EXPORT
534 const char* _dbus_strerror_from_errno (void);
535 
536 void _dbus_disable_sigpipe (void);
537 
538 DBUS_PRIVATE_EXPORT
539 void _dbus_exit (int code) _DBUS_GNUC_NORETURN;
540 
541 DBUS_PRIVATE_EXPORT
542 int _dbus_printf_string_upper_bound (const char *format,
543  va_list args) _DBUS_GNUC_PRINTF (1, 0);
544 
545 #ifdef DBUS_ENABLE_VERBOSE_MODE
546 DBUS_PRIVATE_EXPORT
547 void _dbus_print_thread (void);
548 #endif
549 
553 typedef struct
554 {
555  unsigned long mode;
556  unsigned long nlink;
559  unsigned long size;
560  unsigned long atime;
561  unsigned long mtime;
562  unsigned long ctime;
563 } DBusStat;
564 
565 dbus_bool_t _dbus_stat (const DBusString *filename,
566  DBusStat *statbuf,
567  DBusError *error);
568 DBUS_PRIVATE_EXPORT
570  DBusSocket *fd2,
571  dbus_bool_t blocking,
572  DBusError *error);
573 
574 DBUS_PRIVATE_EXPORT
575 void _dbus_print_backtrace (void);
576 
578  DBusPipe *print_pid_pipe,
579  DBusError *error,
580  dbus_bool_t keep_umask);
581 
582 dbus_bool_t _dbus_verify_daemon_user (const char *user);
583 dbus_bool_t _dbus_change_to_daemon_user (const char *user,
584  DBusError *error);
585 
587  DBusPipe *print_pid_pipe,
588  dbus_pid_t pid_to_write,
589  DBusError *error);
590 
591 dbus_bool_t _dbus_command_for_pid (unsigned long pid,
592  DBusString *str,
593  int max_len,
594  DBusError *error);
595 
596 dbus_bool_t _dbus_user_at_console (const char *username,
597  DBusError *error);
598 
599 typedef enum {
600  DBUS_LOG_FLAGS_STDERR = (1 << 0),
601  DBUS_LOG_FLAGS_SYSTEM_LOG = (1 << 1)
602 } DBusLogFlags;
603 
604 DBUS_PRIVATE_EXPORT
605 void _dbus_init_system_log (const char *tag,
606  DBusLogFlags flags);
607 
608 typedef enum {
609  DBUS_SYSTEM_LOG_INFO,
610  DBUS_SYSTEM_LOG_WARNING,
611  DBUS_SYSTEM_LOG_SECURITY,
612  DBUS_SYSTEM_LOG_ERROR
613 } DBusSystemLogSeverity;
614 
615 DBUS_PRIVATE_EXPORT
616 void _dbus_log (DBusSystemLogSeverity severity,
617  const char *msg,
618  ...) _DBUS_GNUC_PRINTF (2, 3);
619 DBUS_PRIVATE_EXPORT
620 void _dbus_logv (DBusSystemLogSeverity severity,
621  const char *msg,
622  va_list args) _DBUS_GNUC_PRINTF (2, 0);
623 
628 #define _DBUS_BYTE_OF_PRIMITIVE(p, i) \
629  (((const char*)&(p))[(i)])
630 
635 #define _DBUS_DOUBLES_BITWISE_EQUAL(a, b) \
636  (_DBUS_BYTE_OF_PRIMITIVE (a, 0) == _DBUS_BYTE_OF_PRIMITIVE (b, 0) && \
637  _DBUS_BYTE_OF_PRIMITIVE (a, 1) == _DBUS_BYTE_OF_PRIMITIVE (b, 1) && \
638  _DBUS_BYTE_OF_PRIMITIVE (a, 2) == _DBUS_BYTE_OF_PRIMITIVE (b, 2) && \
639  _DBUS_BYTE_OF_PRIMITIVE (a, 3) == _DBUS_BYTE_OF_PRIMITIVE (b, 3) && \
640  _DBUS_BYTE_OF_PRIMITIVE (a, 4) == _DBUS_BYTE_OF_PRIMITIVE (b, 4) && \
641  _DBUS_BYTE_OF_PRIMITIVE (a, 5) == _DBUS_BYTE_OF_PRIMITIVE (b, 5) && \
642  _DBUS_BYTE_OF_PRIMITIVE (a, 6) == _DBUS_BYTE_OF_PRIMITIVE (b, 6) && \
643  _DBUS_BYTE_OF_PRIMITIVE (a, 7) == _DBUS_BYTE_OF_PRIMITIVE (b, 7))
644 
645 dbus_bool_t _dbus_get_autolaunch_address (const char *scope,
646  DBusString *address,
647  DBusError *error);
648 
650  DBusString *address,
651  DBusError *error);
652 
656 typedef union DBusGUID DBusGUID;
657 
658 DBUS_PRIVATE_EXPORT
660  dbus_bool_t create_if_not_found,
661  DBusError *error);
662 
669 
674 
679 
680 DBUS_PRIVATE_EXPORT
682  const char *suffix,
683  DBusList **dir_list);
684 
685 unsigned long _dbus_pid_for_log (void);
686 
687 /* FIXME move back to dbus-sysdeps-unix.h probably -
688  * the PID file handling just needs a little more abstraction
689  * in the bus daemon first.
690  */
691 DBUS_PRIVATE_EXPORT
692 dbus_pid_t _dbus_getpid (void);
693 
694 DBUS_PRIVATE_EXPORT
695 dbus_uid_t _dbus_getuid (void);
696 
697 DBUS_PRIVATE_EXPORT
698 void _dbus_flush_caches (void);
699 
701 
702 /* Do not set this too high: it is a denial-of-service risk.
703  * See <https://bugs.freedesktop.org/show_bug.cgi?id=82820>
704  *
705  * (This needs to be in the non-Unix-specific header so that
706  * the config-parser can use it.)
707  */
708 #define DBUS_DEFAULT_MESSAGE_UNIX_FDS 16
709 
710 typedef struct DBusRLimit DBusRLimit;
711 
712 DBusRLimit *_dbus_rlimit_save_fd_limit (DBusError *error);
713 dbus_bool_t _dbus_rlimit_raise_fd_limit (DBusError *error);
714 dbus_bool_t _dbus_rlimit_restore_fd_limit (DBusRLimit *saved,
715  DBusError *error);
716 void _dbus_rlimit_free (DBusRLimit *lim);
717 
718 void _dbus_daemon_report_ready (void);
720 void _dbus_daemon_report_reloaded (void);
721 void _dbus_daemon_report_stopping (void);
722 
723 dbus_bool_t _dbus_inet_sockaddr_to_string (const void *sockaddr_pointer,
724  size_t len,
725  char *string,
726  size_t string_len,
727  const char **family_name,
728  dbus_uint16_t *port,
729  DBusError *error);
730 void _dbus_set_error_with_inet_sockaddr (DBusError *error,
731  const void *sockaddr_pointer,
732  size_t len,
733  const char *description,
734  int saved_errno);
735 void _dbus_combine_tcp_errors (DBusList **sources,
736  const char *summary,
737  const char *host,
738  const char *port,
739  DBusError *dest);
740 
744 
745 
746 #ifdef DBUS_WIN
747 #include "dbus-sysdeps-win.h"
748 #endif
749 
750 #endif /* DBUS_SYSDEPS_H */
_dbus_atomic_dec
DBUS_PRIVATE_EXPORT dbus_int32_t _dbus_atomic_dec(DBusAtomic *atomic)
Atomically decrement an integer.
Definition: dbus-sysdeps-unix.c:3038
_dbus_create_directory
DBUS_PRIVATE_EXPORT dbus_bool_t _dbus_create_directory(const DBusString *filename, DBusError *error)
directory interface
Definition: dbus-sysdeps-unix.c:3286
_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:315
_dbus_getuid
DBUS_PRIVATE_EXPORT dbus_uid_t _dbus_getuid(void)
Gets our UID.
Definition: dbus-sysdeps-unix.c:2973
_dbus_daemon_report_ready
void _dbus_daemon_report_ready(void)
Report to a service manager that the daemon calling this function is ready for use.
Definition: dbus-sysdeps-util-unix.c:1556
_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:1544
_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:3317
_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_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
DBusAtomic::value
volatile dbus_int32_t value
Value of the atomic integer.
Definition: dbus-sysdeps.h:331
_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:1307
_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:1530
DBusPollFD::revents
short revents
Events that occurred.
Definition: dbus-sysdeps.h:425
_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:1058
_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:1039
_dbus_accept
DBusSocket _dbus_accept(DBusSocket listen_fd)
Accepts a connection on a listening socket.
Definition: dbus-sysdeps-unix.c:2522
_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:1011
_dbus_credentials_add_from_current_process
dbus_bool_t _dbus_credentials_add_from_current_process(DBusCredentials *credentials)
Adds the most important credentials of the current process (the uid and pid) to the passed-in credent...
Definition: dbus-sysdeps-unix.c:2923
DBusStat::uid
dbus_uid_t uid
User owning file.
Definition: dbus-sysdeps.h:557
_dbus_atomic_set_nonzero
DBUS_PRIVATE_EXPORT void _dbus_atomic_set_nonzero(DBusAtomic *atomic)
Atomically set the value of an integer to something nonzero.
Definition: dbus-sysdeps-unix.c:3102
_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:1496
_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:4119
_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:87
_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:1225
_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:994
_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:3617
_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:571
DBusStat
Portable struct with stat() results.
Definition: dbus-sysdeps.h:553
_dbus_disable_sigpipe
void _dbus_disable_sigpipe(void)
signal (SIGPIPE, SIG_IGN);
Definition: dbus-sysdeps-unix.c:3490
_dbus_daemon_report_reloading
void _dbus_daemon_report_reloading(void)
Report to a service manager that the daemon calling this function is reloading configuration.
Definition: dbus-sysdeps-util-unix.c:1568
_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:241
_dbus_stat
dbus_bool_t _dbus_stat(const DBusString *filename, DBusStat *statbuf, DBusError *error)
stat() wrapper.
Definition: dbus-sysdeps-util-unix.c:635
_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:4531
_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:5018
DBusPollFD::events
short events
Events to poll for.
Definition: dbus-sysdeps.h:424
_dbus_directory_close
void _dbus_directory_close(DBusDirIter *iter)
Closes a directory iteration.
Definition: dbus-sysdeps-util-unix.c:779
_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:4499
_dbus_atomic_set_zero
DBUS_PRIVATE_EXPORT void _dbus_atomic_set_zero(DBusAtomic *atomic)
Atomically set the value of an integer to 0.
Definition: dbus-sysdeps-unix.c:3084
_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:4550
_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:3201
DBusPipe
Definition: dbus-pipe.h:41
_dbus_get_is_errno_eintr
dbus_bool_t _dbus_get_is_errno_eintr(int e)
See if errno is EINTR.
Definition: dbus-sysdeps.c:724
DBusStat::ctime
unsigned long ctime
Creation time.
Definition: dbus-sysdeps.h:562
DBUS_END_DECLS
#define DBUS_END_DECLS
DBusGUID
A globally unique ID ; we have one for each DBusServer, and also one for each machine with libdbus in...
Definition: dbus-internals.h:432
_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:961
_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:3392
_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:53
_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:1402
dbus_gid_t
unsigned long dbus_gid_t
A group ID.
Definition: dbus-sysdeps.h:139
_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:3062
_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:770
_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:335
_dbus_get_is_errno_epipe
dbus_bool_t _dbus_get_is_errno_epipe(int e)
See if errno is EPIPE.
Definition: dbus-sysdeps.c:734
_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:4993
_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_listen_tcp_socket
int _dbus_listen_tcp_socket(const char *host, const char *port, const char *family, DBusString *retport, const char **retfamily, 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:1563
DBusStat::atime
unsigned long atime
Access time.
Definition: dbus-sysdeps.h:560
_dbus_directory_open
DBusDirIter * _dbus_directory_open(const DBusString *filename, DBusError *error)
Open a directory to iterate over.
Definition: dbus-sysdeps-util-unix.c:683
DBUS_BEGIN_DECLS
#define DBUS_BEGIN_DECLS
_dbus_strerror_from_errno
const DBUS_PRIVATE_EXPORT char * _dbus_strerror_from_errno(void)
Get error message from errno.
Definition: dbus-sysdeps.c:758
_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:4687
_dbus_sleep_milliseconds
DBUS_PRIVATE_EXPORT void _dbus_sleep_milliseconds(int milliseconds)
Sleeps the given number of milliseconds.
Definition: dbus-sysdeps-unix.c:3362
_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:559
_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:3461
_dbus_set_errno_to_zero
void _dbus_set_errno_to_zero(void)
Assign 0 to the global errno variable.
Definition: dbus-sysdeps.c:700
DBusString
Definition: dbus-string.h:42
DBusStat::mode
unsigned long mode
File mode.
Definition: dbus-sysdeps.h:555
_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:4812
_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:731
DBusPollFD::fd
DBusPollable fd
File descriptor.
Definition: dbus-sysdeps.h:423
DBusSocket
Socket interface.
Definition: dbus-sysdeps.h:181
_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:3779
_dbus_clearenv
dbus_bool_t _dbus_clearenv(void)
Wrapper for clearenv().
Definition: dbus-sysdeps.c:211
DBusCredentials
Definition: dbus-credentials.c:49
_dbus_get_is_errno_enomem
dbus_bool_t _dbus_get_is_errno_enomem(int e)
See if errno is ENOMEM.
Definition: dbus-sysdeps.c:714
dbus_pid_t
unsigned long dbus_pid_t
A process ID.
Definition: dbus-sysdeps.h:135
_dbus_get_is_errno_etoomanyrefs
dbus_bool_t _dbus_get_is_errno_etoomanyrefs(int e)
See if errno is ETOOMANYREFS.
Definition: dbus-sysdeps.c:744
_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:236
dbus_uid_t
unsigned long dbus_uid_t
A user ID.
Definition: dbus-sysdeps.h:137
_dbus_daemon_report_reloaded
void _dbus_daemon_report_reloaded(void)
Report to a service manager that the daemon calling this function is reloading configuration.
Definition: dbus-sysdeps-util-unix.c:1580
DBusPollFD
Definition: dbus-sysdeps.h:421
DBusStat::nlink
unsigned long nlink
Number of hard links.
Definition: dbus-sysdeps.h:556
_dbus_error_from_errno
const DBUS_PRIVATE_EXPORT 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:599
_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_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:2577
_dbus_get_tmpdir
const DBUS_PRIVATE_EXPORT char * _dbus_get_tmpdir(void)
Gets the temporary files directory by inspecting the environment variables TMPDIR,...
Definition: dbus-sysdeps-unix.c:3849
_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:2501
_dbus_abort
void _dbus_abort(void)
Aborts the program with SIGABRT (dumping core).
Definition: dbus-sysdeps.c:87
_dbus_poll
DBUS_PRIVATE_EXPORT int _dbus_poll(DBusPollFD *fds, int n_fds, int timeout_milliseconds)
Wrapper for poll().
Definition: dbus-sysdeps-unix.c:3123
_dbus_generate_random_bytes_buffer
_DBUS_WARN_UNUSED_RESULT dbus_bool_t _dbus_generate_random_bytes_buffer(char *buffer, int n_bytes, DBusError *error)
Random numbers.
Definition: dbus-sysdeps.c:525
_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:618
DBusStat::mtime
unsigned long mtime
Modify time.
Definition: dbus-sysdeps.h:561
_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_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
DBusStat::gid
dbus_gid_t gid
Group owning file.
Definition: dbus-sysdeps.h:558
_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:1149
DBusAtomic
An atomic integer safe to increment or decrement from multiple threads.
Definition: dbus-sysdeps.h:326
_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_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:3232
_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:1404
_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:3704
_dbus_getenv
const char * _dbus_getenv(const char *varname)
Wrapper for getenv().
Definition: dbus-sysdeps.c:195
_dbus_getpid
DBUS_PRIVATE_EXPORT dbus_pid_t _dbus_getpid(void)
Gets our process ID.
Definition: dbus-sysdeps-unix.c:2964
DBusError
Object representing an exception.
Definition: dbus-errors.h:48
_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:3662
DBusList
Definition: dbus-list.h:34
_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:2953
_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:3254
_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:977
_dbus_credentials_add_from_user
dbus_bool_t _dbus_credentials_add_from_user(DBusCredentials *credentials, const DBusString *username, DBusCredentialsAddFlags flags, DBusError *error)
Adds the credentials corresponding to the given username.
Definition: dbus-sysdeps-win.c:2252
_dbus_atomic_inc
DBUS_PRIVATE_EXPORT dbus_int32_t _dbus_atomic_inc(DBusAtomic *atomic)
Atomically increments an integer.
Definition: dbus-sysdeps-unix.c:3015
_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:1026
_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:4238
DBusDirIter
Internals of directory iterator.
Definition: dbus-sysdeps-util-unix.c:669
_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:4659
_dbus_error_from_system_errno
const DBUS_PRIVATE_EXPORT char * _dbus_error_from_system_errno(void)
Converts the current system errno value into a DBusError name.
Definition: dbus-sysdeps.c:691
_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:4638
_dbus_daemon_report_stopping
void _dbus_daemon_report_stopping(void)
Report to a service manager that the daemon calling this function is shutting down.
Definition: dbus-sysdeps-util-unix.c:1593
_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:639
_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:2994
DBusStat::size
unsigned long size
Size of file.
Definition: dbus-sysdeps.h:559
_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:2171
dbus_bool_t
dbus_uint32_t dbus_bool_t
Definition: dbus-types.h:35