D-Bus  1.11.2
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 
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 
95 DBUS_PRIVATE_EXPORT
96 void _dbus_abort (void) _DBUS_GNUC_NORETURN;
97 
99 DBUS_PRIVATE_EXPORT
100 const char* _dbus_getenv (const char *varname);
101 DBUS_PRIVATE_EXPORT
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)
114 
115 #define DBUS_UID_UNSET ((dbus_uid_t) -1)
116 
117 #define DBUS_GID_UNSET ((dbus_gid_t) -1)
118 
120 #define DBUS_PID_FORMAT "%lu"
121 
122 #define DBUS_UID_FORMAT "%lu"
123 
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 
176  DBusError *error);
177 
178 DBUS_PRIVATE_EXPORT
180  DBusError *error);
181 DBUS_PRIVATE_EXPORT
183  DBusString *buffer,
184  int count);
185 DBUS_PRIVATE_EXPORT
187  const DBusString *buffer,
188  int start,
189  int len);
191  const DBusString *buffer1,
192  int start1,
193  int len1,
194  const DBusString *buffer2,
195  int start2,
196  int len2);
197 
199  DBusString *buffer,
200  int count,
201  int *fds,
202  unsigned int *n_fds);
203 DBUS_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);
236 
238  DBusCredentials *credentials,
239  DBusError *error);
241  DBusError *error);
242 
244  const DBusString *username);
246 DBUS_PRIVATE_EXPORT
248 
250  dbus_uid_t *uid_p);
252  dbus_gid_t *gid_p);
254  dbus_gid_t **group_ids,
255  int *n_group_ids);
257  DBusError *error);
259 dbus_bool_t _dbus_windows_user_is_process_owner (const char *windows_sid);
260 
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 
271 
275 typedef struct DBusAtomic DBusAtomic;
276 
281 {
282 #ifdef DBUS_WIN
283  volatile long value;
284 #else
285  volatile dbus_int32_t value;
286 #endif
287 };
288 
289 /* The value we get from autofoo is in the form of a cpp expression;
290  * convert that to a conventional defined/undef switch. (We can't get
291  * the conventional defined/undef because of multiarch builds only running
292  * ./configure once, on Darwin.) */
293 #if DBUS_HAVE_ATOMIC_INT_COND
294 # define DBUS_HAVE_ATOMIC_INT 1
295 #else
296 # undef DBUS_HAVE_ATOMIC_INT
297 #endif
298 
299 dbus_int32_t _dbus_atomic_inc (DBusAtomic *atomic);
300 dbus_int32_t _dbus_atomic_dec (DBusAtomic *atomic);
301 dbus_int32_t _dbus_atomic_get (DBusAtomic *atomic);
302 
303 #ifdef DBUS_WIN
304 
305 /* On Windows, you can only poll sockets. We emulate Unix poll() using
306  * select(), so it doesn't matter what precise type we put in DBusPollFD;
307  * use DBusSocket so that the compiler can check we are doing it right.
308  */
309 typedef DBusSocket DBusPollable;
310 # define DBUS_POLLABLE_FORMAT "Iu"
311 
312 static inline DBusPollable
313 _dbus_socket_get_pollable (DBusSocket s) { return s; }
314 
315 static inline SOCKET
316 _dbus_pollable_printable (DBusPollable p) { return p.sock; }
317 
318 static inline dbus_bool_t
319 _dbus_pollable_is_valid (DBusPollable p) { return _dbus_socket_is_valid (p); }
320 
321 static inline void
322 _dbus_pollable_invalidate (DBusPollable *p) { _dbus_socket_invalidate (p); }
323 
324 static inline dbus_bool_t
325 _dbus_pollable_equals (DBusPollable a, DBusPollable b) { return a.sock == b.sock; }
326 
327 #else /* !DBUS_WIN */
328 
329 /* On Unix, you can poll sockets, pipes, etc., and we must put exactly
330  * "int" in DBusPollFD because we're relying on its layout exactly matching
331  * struct pollfd. (This is silly, and one day we should use a better
332  * abstraction.)
333  */
334 typedef int DBusPollable;
335 # define DBUS_POLLABLE_FORMAT "d"
336 
337 static inline DBusPollable
338 _dbus_socket_get_pollable (DBusSocket s) { return s.fd; }
339 
340 static inline int
341 _dbus_pollable_printable (DBusPollable p) { return p; }
342 
343 static inline dbus_bool_t
344 _dbus_pollable_is_valid (DBusPollable p) { return p >= 0; }
345 
346 static inline void
347 _dbus_pollable_invalidate (DBusPollable *p) { *p = -1; }
348 
349 static inline dbus_bool_t
350 _dbus_pollable_equals (DBusPollable a, DBusPollable b) { return a == b; }
351 
352 #endif /* !DBUS_WIN */
353 
354 #if defined(HAVE_POLL) && !defined(BROKEN_POLL)
355 
359 typedef struct pollfd DBusPollFD;
360 
362 #define _DBUS_POLLIN POLLIN
363 
364 #define _DBUS_POLLPRI POLLPRI
365 
366 #define _DBUS_POLLOUT POLLOUT
367 
368 #define _DBUS_POLLERR POLLERR
369 
370 #define _DBUS_POLLHUP POLLHUP
371 
372 #define _DBUS_POLLNVAL POLLNVAL
373 #else
374 /* Emulate poll() via select(). Because we aren't really going to call
375  * poll(), any similarly-shaped struct is acceptable, and any power of 2
376  * will do for the events/revents; these values happen to match Linux
377  * and *BSD. */
378 typedef struct
379 {
380  DBusPollable fd;
381  short events;
382  short revents;
383 } DBusPollFD;
384 
386 #define _DBUS_POLLIN 0x0001
387 
388 #define _DBUS_POLLPRI 0x0002
389 
390 #define _DBUS_POLLOUT 0x0004
391 
392 #define _DBUS_POLLERR 0x0008
393 
394 #define _DBUS_POLLHUP 0x0010
395 
396 #define _DBUS_POLLNVAL 0x0020
397 #endif
398 
399 DBUS_PRIVATE_EXPORT
400 int _dbus_poll (DBusPollFD *fds,
401  int n_fds,
402  int timeout_milliseconds);
403 
404 DBUS_PRIVATE_EXPORT
405 void _dbus_sleep_milliseconds (int milliseconds);
406 
407 DBUS_PRIVATE_EXPORT
408 void _dbus_get_monotonic_time (long *tv_sec,
409  long *tv_usec);
410 
411 DBUS_PRIVATE_EXPORT
412 void _dbus_get_real_time (long *tv_sec,
413  long *tv_usec);
414 
418 DBUS_PRIVATE_EXPORT
420  DBusError *error);
421 DBUS_PRIVATE_EXPORT
423  DBusError *error);
424 
425 DBUS_PRIVATE_EXPORT
427  const DBusString *next_component);
429  DBusString *dirname);
430 DBUS_PRIVATE_EXPORT
432 
435 
438 
440 typedef struct DBusDirIter DBusDirIter;
441 
443  DBusError *error);
445  DBusString *filename,
446  DBusError *error);
448 
450  DBusError *error);
451 
452 DBUS_PRIVATE_EXPORT
453 const char* _dbus_get_tmpdir (void);
454 
458 _DBUS_GNUC_WARN_UNUSED_RESULT
460  int n_bytes,
461  DBusError *error);
463  int n_bytes,
464  DBusError *error);
465 DBUS_PRIVATE_EXPORT
467  int n_bytes,
468  DBusError *error);
469 
470 DBUS_PRIVATE_EXPORT
471 const char* _dbus_error_from_errno (int error_number);
472 DBUS_PRIVATE_EXPORT
473 const char* _dbus_error_from_system_errno (void);
474 
475 int _dbus_save_socket_errno (void);
476 void _dbus_restore_socket_errno (int saved_errno);
477 void _dbus_set_errno_to_zero (void);
483 DBUS_PRIVATE_EXPORT
484 const char* _dbus_strerror_from_errno (void);
485 
486 void _dbus_disable_sigpipe (void);
487 
488 DBUS_PRIVATE_EXPORT
489 void _dbus_exit (int code) _DBUS_GNUC_NORETURN;
490 
491 DBUS_PRIVATE_EXPORT
492 int _dbus_printf_string_upper_bound (const char *format,
493  va_list args);
494 
495 
499 typedef struct
500 {
501  unsigned long mode;
502  unsigned long nlink;
503  dbus_uid_t uid;
504  dbus_gid_t gid;
505  unsigned long size;
506  unsigned long atime;
507  unsigned long mtime;
508  unsigned long ctime;
509 } DBusStat;
510 
511 dbus_bool_t _dbus_stat (const DBusString *filename,
512  DBusStat *statbuf,
513  DBusError *error);
514 DBUS_PRIVATE_EXPORT
516  DBusSocket *fd2,
517  dbus_bool_t blocking,
518  DBusError *error);
519 
520 DBUS_PRIVATE_EXPORT
521 void _dbus_print_backtrace (void);
522 
524  DBusPipe *print_pid_pipe,
525  DBusError *error,
526  dbus_bool_t keep_umask);
527 
528 dbus_bool_t _dbus_verify_daemon_user (const char *user);
529 dbus_bool_t _dbus_change_to_daemon_user (const char *user,
530  DBusError *error);
531 
533  DBusPipe *print_pid_pipe,
534  dbus_pid_t pid_to_write,
535  DBusError *error);
536 
537 dbus_bool_t _dbus_command_for_pid (unsigned long pid,
538  DBusString *str,
539  int max_len,
540  DBusError *error);
541 
543 typedef void (* DBusSignalHandler) (int sig);
544 
545 void _dbus_set_signal_handler (int sig,
546  DBusSignalHandler handler);
547 
548 dbus_bool_t _dbus_user_at_console (const char *username,
549  DBusError *error);
550 
551 void _dbus_init_system_log (dbus_bool_t is_daemon);
552 
553 typedef enum {
554  DBUS_SYSTEM_LOG_INFO,
555  DBUS_SYSTEM_LOG_WARNING,
556  DBUS_SYSTEM_LOG_SECURITY,
557  DBUS_SYSTEM_LOG_FATAL
558 } DBusSystemLogSeverity;
559 
560 void _dbus_system_log (DBusSystemLogSeverity severity, const char *msg, ...) _DBUS_GNUC_PRINTF (2, 3);
561 void _dbus_system_logv (DBusSystemLogSeverity severity, const char *msg, va_list args);
562 
563 /* Define DBUS_VA_COPY() to do the right thing for copying va_list variables.
564  * config.h may have already defined DBUS_VA_COPY as va_copy or __va_copy.
565  */
566 #if !defined (DBUS_VA_COPY)
567 # if defined (__GNUC__) && defined (__PPC__) && (defined (_CALL_SYSV) || defined (_WIN32))
568 # define DBUS_VA_COPY(ap1, ap2) (*(ap1) = *(ap2))
569 # elif defined (DBUS_VA_COPY_AS_ARRAY)
570 # define DBUS_VA_COPY(ap1, ap2) memcpy ((ap1), (ap2), sizeof (va_list))
571 # else /* va_list is a pointer */
572 # define DBUS_VA_COPY(ap1, ap2) ((ap1) = (ap2))
573 # endif /* va_list is a pointer */
574 #endif /* !DBUS_VA_COPY */
575 
576 
581 #define _DBUS_BYTE_OF_PRIMITIVE(p, i) \
582  (((const char*)&(p))[(i)])
583 
588 #define _DBUS_DOUBLES_BITWISE_EQUAL(a, b) \
589  (_DBUS_BYTE_OF_PRIMITIVE (a, 0) == _DBUS_BYTE_OF_PRIMITIVE (b, 0) && \
590  _DBUS_BYTE_OF_PRIMITIVE (a, 1) == _DBUS_BYTE_OF_PRIMITIVE (b, 1) && \
591  _DBUS_BYTE_OF_PRIMITIVE (a, 2) == _DBUS_BYTE_OF_PRIMITIVE (b, 2) && \
592  _DBUS_BYTE_OF_PRIMITIVE (a, 3) == _DBUS_BYTE_OF_PRIMITIVE (b, 3) && \
593  _DBUS_BYTE_OF_PRIMITIVE (a, 4) == _DBUS_BYTE_OF_PRIMITIVE (b, 4) && \
594  _DBUS_BYTE_OF_PRIMITIVE (a, 5) == _DBUS_BYTE_OF_PRIMITIVE (b, 5) && \
595  _DBUS_BYTE_OF_PRIMITIVE (a, 6) == _DBUS_BYTE_OF_PRIMITIVE (b, 6) && \
596  _DBUS_BYTE_OF_PRIMITIVE (a, 7) == _DBUS_BYTE_OF_PRIMITIVE (b, 7))
597 
598 dbus_bool_t _dbus_get_autolaunch_address (const char *scope,
599  DBusString *address,
600  DBusError *error);
601 
603  DBusString *address,
604  DBusError *error);
605 
609 typedef union DBusGUID DBusGUID;
610 
612  dbus_bool_t create_if_not_found,
613  DBusError *error);
614 
621 
626 
631 
632 DBUS_PRIVATE_EXPORT
634  const char *suffix,
635  DBusList **dir_list);
636 
637 unsigned long _dbus_pid_for_log (void);
638 
639 /* FIXME move back to dbus-sysdeps-unix.h probably -
640  * the PID file handling just needs a little more abstraction
641  * in the bus daemon first.
642  */
643 DBUS_PRIVATE_EXPORT
644 dbus_pid_t _dbus_getpid (void);
645 
646 DBUS_PRIVATE_EXPORT
647 dbus_uid_t _dbus_getuid (void);
648 
649 dbus_bool_t _dbus_change_to_daemon_user (const char *user,
650  DBusError *error);
651 
652 DBUS_PRIVATE_EXPORT
653 void _dbus_flush_caches (void);
654 
656 
657 /* Do not set this too high: it is a denial-of-service risk.
658  * See <https://bugs.freedesktop.org/show_bug.cgi?id=82820>
659  *
660  * (This needs to be in the non-Unix-specific header so that
661  * the config-parser can use it.)
662  */
663 #define DBUS_DEFAULT_MESSAGE_UNIX_FDS 16
664 
665 typedef struct DBusRLimit DBusRLimit;
666 
667 DBusRLimit *_dbus_rlimit_save_fd_limit (DBusError *error);
668 dbus_bool_t _dbus_rlimit_raise_fd_limit_if_privileged (unsigned int desired,
669  DBusError *error);
670 dbus_bool_t _dbus_rlimit_restore_fd_limit (DBusRLimit *saved,
671  DBusError *error);
672 void _dbus_rlimit_free (DBusRLimit *lim);
673 
677 
678 
679 #ifdef DBUS_WIN
680 #include "dbus-sysdeps-win.h"
681 #endif
682 
683 #endif /* DBUS_SYSDEPS_H */
An atomic integer safe to increment or decrement from multiple threads.
Definition: dbus-sysdeps.h:280
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_int32_t _dbus_atomic_get(DBusAtomic *atomic)
Atomically get the value of an integer.
volatile dbus_int32_t value
Value of the atomic integer.
Definition: dbus-sysdeps.h:285
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.
dbus_bool_t _dbus_get_is_errno_enomem(int e)
See if errno is ENOMEM.
Definition: dbus-sysdeps.c:705
void _dbus_abort(void)
Aborts the program with SIGABRT (dumping core).
Definition: dbus-sysdeps.c:77
#define DBUS_BEGIN_DECLS
Macro used prior to declaring functions in the D-Bus header files.
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()).
Portable struct with stat() results.
Definition: dbus-sysdeps.h:499
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.
DBUS_PRIVATE_EXPORT dbus_bool_t _dbus_path_is_absolute(const DBusString *filename)
Checks whether the filename is an absolute path.
unsigned long atime
Access time.
Definition: dbus-sysdeps.h:506
dbus_bool_t _dbus_check_setuid(void)
NOTE: If you modify this function, please also consider making the corresponding change in GLib...
dbus_bool_t _dbus_threads_init_platform_specific(void)
Initialize threads as in dbus_threads_init_default(), appropriately for the platform.
dbus_bool_t _dbus_get_standard_session_servicedirs(DBusList **dirs)
Returns the standard directories for a session bus to look for service activation files...
A globally unique ID ; we have one for each DBusServer, and also one for each machine with libdbus in...
DBUS_PRIVATE_EXPORT dbus_pid_t _dbus_getpid(void)
Gets our process ID.
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.
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.
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.
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...
short events
Events to poll for.
Definition: dbus-sysdeps.h:381
dbus_bool_t _dbus_send_credentials_socket(DBusSocket server_fd, DBusError *error)
Sends a single nul byte with our UNIX credentials as ancillary data.
DBUS_PRIVATE_EXPORT dbus_bool_t _dbus_close_socket(DBusSocket fd, DBusError *error)
Closes a socket.
void(* DBusSignalHandler)(int sig)
A UNIX signal handler.
Definition: dbus-sysdeps.h:543
dbus_bool_t _dbus_get_autolaunch_address(const char *scope, DBusString *address, DBusError *error)
Returns the address of a new session bus.
dbus_bool_t _dbus_clearenv(void)
Wrapper for clearenv().
Definition: dbus-sysdeps.c:201
Internals of directory iterator.
dbus_bool_t _dbus_user_at_console(const char *username, DBusError *error)
Checks if user is at the console.
unsigned long mode
File mode.
Definition: dbus-sysdeps.h:501
unsigned long dbus_pid_t
A process ID.
Definition: dbus-sysdeps.h:106
Socket interface.
Definition: dbus-sysdeps.h:149
dbus_int32_t _dbus_atomic_dec(DBusAtomic *atomic)
Atomically decrement an integer.
void _dbus_threads_unlock_platform_specific(void)
Undo _dbus_threads_lock_platform_specific().
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...
void _dbus_threads_lock_platform_specific(void)
Lock a static mutex used to protect _dbus_threads_init_platform_specific().
dbus_gid_t gid
Group owning file.
Definition: dbus-sysdeps.h:504
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) ...
dbus_uint32_t dbus_bool_t
A boolean, valid values are TRUE and FALSE.
Definition: dbus-types.h:35
dbus_bool_t _dbus_get_session_config_file(DBusString *str)
Get the absolute path of the session.conf file.
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).
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.
DBusSocket _dbus_accept(DBusSocket listen_fd)
Accepts a connection on a listening socket.
DBUS_PRIVATE_EXPORT void _dbus_print_backtrace(void)
On GNU libc systems, print a crude backtrace to stderr.
dbus_bool_t _dbus_change_to_daemon_user(const char *user, DBusError *error)
Changes the user and group the bus is running as.
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.
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...
DBUS_PRIVATE_EXPORT dbus_bool_t _dbus_create_directory(const DBusString *filename, DBusError *error)
directory interface
dbus_bool_t _dbus_verify_daemon_user(const char *user)
Verify that after the fork we can successfully change to this user.
DBUS_PRIVATE_EXPORT dbus_bool_t _dbus_delete_directory(const DBusString *filename, DBusError *error)
Removes a directory; Directory must be empty.
Object representing an exception.
Definition: dbus-errors.h:48
void _dbus_set_signal_handler(int sig, DBusSignalHandler handler)
Installs a UNIX signal handler.
DBUS_PRIVATE_EXPORT void _dbus_get_monotonic_time(long *tv_sec, long *tv_usec)
Get current time, as in gettimeofday().
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.
void _dbus_disable_sigpipe(void)
signal (SIGPIPE, SIG_IGN);
dbus_bool_t _dbus_stat(const DBusString *filename, DBusStat *statbuf, DBusError *error)
stat() wrapper.
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.
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:682
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.
dbus_int32_t _dbus_atomic_inc(DBusAtomic *atomic)
Atomically increments an integer.
dbus_bool_t _dbus_string_get_dirname(const DBusString *filename, DBusString *dirname)
Get the directory name from a complete filename.
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.
void _dbus_system_logv(DBusSystemLogSeverity severity, const char *msg, va_list args)
Log a message to the system log file (e.g.
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.
unsigned long ctime
Creation time.
Definition: dbus-sysdeps.h:508
DBUS_PRIVATE_EXPORT void _dbus_flush_caches(void)
Called when the bus daemon is signaled to reload its configuration; any caches should be nuked...
DBUS_PRIVATE_EXPORT const char * _dbus_get_tmpdir(void)
Gets the temporary files directory by inspecting the environment variables TMPDIR, TMP, and TEMP in that order.
dbus_bool_t _dbus_credentials_add_from_current_process(DBusCredentials *credentials)
Adds the credentials of the current process to the passed-in credentials object.
unsigned long nlink
Number of hard links.
Definition: dbus-sysdeps.h:502
DBusPollable fd
File descriptor.
Definition: dbus-sysdeps.h:380
_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:516
dbus_uid_t uid
User owning file.
Definition: dbus-sysdeps.h:503
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.
void _dbus_system_log(DBusSystemLogSeverity severity, const char *msg,...)
Log a message to the system log file (e.g.
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:550
DBUS_PRIVATE_EXPORT void _dbus_exit(int code) _DBUS_GNUC_NORETURN
Exit the process, returning the given value.
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...
void _dbus_directory_close(DBusDirIter *iter)
Closes a directory iteration.
DBUS_PRIVATE_EXPORT const char * _dbus_strerror_from_errno(void)
Get error message from errno.
Definition: dbus-sysdeps.c:749
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.
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.
A node in a linked list.
Definition: dbus-list.h:34
DBUS_PRIVATE_EXPORT dbus_uid_t _dbus_getuid(void)
Gets our UID.
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...
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...
dbus_bool_t _dbus_set_socket_nonblocking(DBusSocket fd, DBusError *error)
Sets a file descriptor to be nonblocking.
char ** _dbus_get_environment(void)
Gets a NULL-terminated list of key=value pairs from the environment.
dbus_bool_t _dbus_get_is_errno_epipe(int e)
See if errno is EPIPE.
Definition: dbus-sysdeps.c:725
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. ...
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&#39;re running on from the dbus configuration.
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.
dbus_bool_t _dbus_get_is_errno_eintr(int e)
See if errno is EINTR.
Definition: dbus-sysdeps.c:715
unsigned long mtime
Modify time.
Definition: dbus-sysdeps.h:507
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.
DBusDirIter * _dbus_directory_open(const DBusString *filename, DBusError *error)
Open a directory to iterate over.
DBUS_PRIVATE_EXPORT void _dbus_sleep_milliseconds(int milliseconds)
Sleeps the given number of milliseconds.
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:590
unsigned long dbus_gid_t
A group ID.
Definition: dbus-sysdeps.h:110
unsigned long size
Size of file.
Definition: dbus-sysdeps.h:505
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...
dbus_bool_t _dbus_socket_can_pass_unix_fd(DBusSocket fd)
Checks whether file descriptors may be passed via the socket.
const char * _dbus_getenv(const char *varname)
Wrapper for getenv().
Definition: dbus-sysdeps.c:185
unsigned long dbus_uid_t
A user ID.
Definition: dbus-sysdeps.h:108
DBUS_PRIVATE_EXPORT int _dbus_poll(DBusPollFD *fds, int n_fds, int timeout_milliseconds)
Wrapper for poll().
short revents
Events that occurred.
Definition: dbus-sysdeps.h:382
dbus_bool_t _dbus_get_is_errno_etoomanyrefs(int e)
See if errno is ETOOMANYREFS.
Definition: dbus-sysdeps.c:735
void _dbus_set_errno_to_zero(void)
Assign 0 to the global errno variable.
Definition: dbus-sysdeps.c:691
dbus_bool_t _dbus_get_standard_system_servicedirs(DBusList **dirs)
Returns the standard directories for a system bus to look for service activation files.
dbus_bool_t _dbus_directory_get_next_file(DBusDirIter *iter, DBusString *filename, DBusError *error)
Get next file in the directory.
DBUS_PRIVATE_EXPORT void _dbus_get_real_time(long *tv_sec, long *tv_usec)
Get current time, as in gettimeofday().
dbus_bool_t _dbus_credentials_add_from_user(DBusCredentials *credentials, const DBusString *username)
Adds the credentials corresponding to the given username.
#define DBUS_END_DECLS
Macro used after declaring functions in the D-Bus header files.