dbus-sysdeps.h 20.8 KB
Newer Older
1
/* -*- mode: C; c-file-style: "gnu"; indent-tabs-mode: nil; -*- */
John Palmieri's avatar
John Palmieri committed
2
/* dbus-sysdeps.h Wrappers around system/libc features (internal to D-Bus implementation)
3
 * 
4 5
 * Copyright (C) 2002, 2003  Red Hat, Inc.
 * Copyright (C) 2003 CodeFactory AB
6
 *
7
 * Licensed under the Academic Free License version 2.1
8 9 10 11 12 13 14 15 16 17 18 19 20
 * 
 * This program is free software; you can redistribute it and/or modify
 * it under the terms of the GNU General Public License as published by
 * the Free Software Foundation; either version 2 of the License, or
 * (at your option) any later version.
 *
 * This program is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU General Public License for more details.
 * 
 * You should have received a copy of the GNU General Public License
 * 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 26 27
 *
 */

#ifndef DBUS_SYSDEPS_H
#define DBUS_SYSDEPS_H

28 29
#include "config.h"

30 31 32 33
#ifdef HAVE_STDINT_H
#include <stdint.h>
#endif

34 35 36 37
#ifdef HAVE_INTTYPES_H
#include <inttypes.h>
#endif

38
#include <dbus/dbus-errors.h>
39
#include <dbus/dbus-file.h>
40
#include <dbus/dbus-string.h>
41 42 43 44 45

/* this is perhaps bogus, but strcmp() etc. are faster if we use the
 * stuff straight out of string.h, so have this here for now.
 */
#include <string.h>
John Palmieri's avatar
John Palmieri committed
46 47
#include <stdarg.h>

48 49 50 51 52 53 54 55
/* AIX sys/poll.h does #define events reqevents, and other
 * wonderousness, so must include sys/poll before declaring
 * DBusPollFD
 */ 
#ifdef HAVE_POLL
#include <sys/poll.h>
#endif

56 57 58 59 60 61
#ifdef DBUS_WINCE
/* Windows CE lacks some system functions (such as errno and clock).
   We bring them in here.  */
#include "dbus-sysdeps-wince-glue.h"
#endif

62
DBUS_BEGIN_DECLS
63

64 65 66 67 68 69
#ifdef DBUS_WIN
#define _DBUS_PATH_SEPARATOR ";"
#else
#define _DBUS_PATH_SEPARATOR ":"
#endif

70 71 72 73 74 75
/* Forward declarations */


/** An opaque list type */
typedef struct DBusList DBusList;

76 77 78
/** Object that contains a list of credentials such as UNIX or Windows user ID */
typedef struct DBusCredentials DBusCredentials;

79 80 81
/** A wrapper around a pipe descriptor or handle */
typedef struct DBusPipe DBusPipe;

82 83 84 85 86 87
/**
 * @addtogroup DBusSysdeps
 *
 * @{
 */

88
void _dbus_abort (void) _DBUS_GNUC_NORETURN;
89

90
dbus_bool_t _dbus_check_setuid (void);
91
const char* _dbus_getenv (const char *varname);
92
dbus_bool_t _dbus_clearenv (void);
93
char **     _dbus_get_environment (void);
94

95
/** A process ID */
96
typedef unsigned long dbus_pid_t;
97
/** A user ID */
98
typedef unsigned long dbus_uid_t;
99
/** A group ID */
100 101
typedef unsigned long dbus_gid_t;

102
/** an invalid PID used to represent an uninitialized dbus_pid_t field */
103
#define DBUS_PID_UNSET ((dbus_pid_t) -1)
104
/** an invalid UID used to represent an uninitialized dbus_uid_t field */
105
#define DBUS_UID_UNSET ((dbus_uid_t) -1)
106
/** an invalid GID used to represent an uninitialized dbus_gid_t field */
107 108
#define DBUS_GID_UNSET ((dbus_gid_t) -1)

109
/** an appropriate printf format for dbus_pid_t */
110
#define DBUS_PID_FORMAT "%lu"
111
/** an appropriate printf format for dbus_uid_t */
112
#define DBUS_UID_FORMAT "%lu"
113
/** an appropriate printf format for dbus_gid_t */
114 115
#define DBUS_GID_FORMAT "%lu"

116

117
/**
118 119 120 121 122 123 124
 * Socket interface
 *
 *  @todo Use for the file descriptors a struct
 *           - struct DBusSocket{ int d; }; -
 *        instead of int to get type-safety which 
 *        will be checked by the compiler.
 * 
125
 */
126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142

dbus_bool_t _dbus_close_socket     (int               fd,
                                    DBusError        *error);
int         _dbus_read_socket      (int               fd,
                                    DBusString       *buffer,
                                    int               count);
int         _dbus_write_socket     (int               fd,
                                    const DBusString *buffer,
                                    int               start,
                                    int               len);
int         _dbus_write_socket_two (int               fd,
                                    const DBusString *buffer1,
                                    int               start1,
                                    int               len1,
                                    const DBusString *buffer2,
                                    int               start2,
                                    int               len2);
143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164

int _dbus_read_socket_with_unix_fds      (int               fd,
                                          DBusString       *buffer,
                                          int               count,
                                          int              *fds,
                                          int              *n_fds);
int _dbus_write_socket_with_unix_fds     (int               fd,
                                          const DBusString *buffer,
                                          int               start,
                                          int               len,
                                          const int        *fds,
                                          int               n_fds);
int _dbus_write_socket_with_unix_fds_two (int               fd,
                                          const DBusString *buffer1,
                                          int               start1,
                                          int               len1,
                                          const DBusString *buffer2,
                                          int               start2,
                                          int               len2,
                                          const int        *fds,
                                          int               n_fds);

165 166
dbus_bool_t _dbus_socket_is_invalid (int              fd);

167
int _dbus_connect_tcp_socket  (const char     *host,
168 169
                               const char     *port,
                               const char     *family,
170
                               DBusError      *error);
Frank Osterfeld's avatar
Frank Osterfeld committed
171 172 173 174 175
int _dbus_connect_tcp_socket_with_nonce  (const char     *host,
                                          const char     *port,
                                          const char     *family,
                                          const char     *noncefile,
                                          DBusError      *error);
176
int _dbus_listen_tcp_socket   (const char     *host,
177 178 179 180
                               const char     *port,
                               const char     *family,
                               DBusString     *retport,
                               int           **fds_p,
181
                               DBusError      *error);
182 183
int _dbus_accept              (int             listen_fd);

184

185 186 187 188 189
dbus_bool_t _dbus_read_credentials_socket (int               client_fd,
                                           DBusCredentials  *credentials,
                                           DBusError        *error);
dbus_bool_t _dbus_send_credentials_socket (int              server_fd,
                                           DBusError       *error);
190

191
dbus_bool_t _dbus_credentials_add_from_user            (DBusCredentials  *credentials,
192 193
                                                        const DBusString *username);
dbus_bool_t _dbus_credentials_add_from_current_process (DBusCredentials  *credentials);
194
dbus_bool_t _dbus_append_user_from_current_process     (DBusString        *str);
195

196 197 198 199 200 201 202 203 204 205 206 207
dbus_bool_t _dbus_parse_unix_user_from_config   (const DBusString  *username,
                                                 dbus_uid_t        *uid_p);
dbus_bool_t _dbus_parse_unix_group_from_config  (const DBusString  *groupname,
                                                 dbus_gid_t        *gid_p);
dbus_bool_t _dbus_unix_groups_from_uid          (dbus_uid_t         uid,
                                                 dbus_gid_t       **group_ids,
                                                 int               *n_group_ids);
dbus_bool_t _dbus_unix_user_is_at_console       (dbus_uid_t         uid,
                                                 DBusError         *error);
dbus_bool_t _dbus_unix_user_is_process_owner    (dbus_uid_t         uid);
dbus_bool_t _dbus_windows_user_is_process_owner (const char        *windows_sid);

208 209
dbus_bool_t _dbus_append_keyring_directory_for_credentials (DBusString      *directory,
                                                            DBusCredentials *credentials);
210

211 212 213
dbus_bool_t _dbus_daemon_is_session_bus_address_published (const char *scope);

dbus_bool_t _dbus_daemon_publish_session_bus_address (const char* address, const char* shm_name);
Frank Osterfeld's avatar
Frank Osterfeld committed
214 215 216

void _dbus_daemon_unpublish_session_bus_address (void);

217 218
dbus_bool_t _dbus_socket_can_pass_unix_fd(int fd);

219 220 221
/** Opaque type representing an atomically-modifiable integer
 * that can be used from multiple threads.
 */
222
typedef struct DBusAtomic DBusAtomic;
223 224

/**
225
 * An atomic integer safe to increment or decrement from multiple threads.
226
 */
227 228
struct DBusAtomic
{
229 230 231
#ifdef DBUS_WIN
  volatile long value; /**< Value of the atomic integer. */
#else
232
  volatile dbus_int32_t value; /**< Value of the atomic integer. */
233
#endif
234
};
235

236 237 238 239 240 241 242 243 244 245
/* The value we get from autofoo is in the form of a cpp expression;
 * convert that to a conventional defined/undef switch. (We can't get
 * the conventional defined/undef because of multiarch builds only running
 * ./configure once, on Darwin.) */
#if DBUS_HAVE_ATOMIC_INT_COND
#   define DBUS_HAVE_ATOMIC_INT 1
#else
#   undef DBUS_HAVE_ATOMIC_INT
#endif

246 247
dbus_int32_t _dbus_atomic_inc (DBusAtomic *atomic);
dbus_int32_t _dbus_atomic_dec (DBusAtomic *atomic);
248
dbus_int32_t _dbus_atomic_get (DBusAtomic *atomic);
249

250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265

/* AIX uses different values for poll */

#ifdef _AIX
/** There is data to read */
#define _DBUS_POLLIN      0x0001
/** There is urgent data to read */
#define _DBUS_POLLPRI     0x0004
/** Writing now will not block */
#define _DBUS_POLLOUT     0x0002
/** Error condition */
#define _DBUS_POLLERR     0x4000
/** Hung up */
#define _DBUS_POLLHUP     0x2000
/** Invalid request: fd not open */
#define _DBUS_POLLNVAL    0x8000
266 267 268 269 270 271 272 273 274 275 276 277 278
#elif defined(__HAIKU__)
/** There is data to read */
#define _DBUS_POLLIN      0x0001
/** Writing now will not block */
#define _DBUS_POLLOUT     0x0002
/** Error condition */
#define _DBUS_POLLERR     0x0004
/** There is urgent data to read */
#define _DBUS_POLLPRI     0x0020
/** Hung up */
#define _DBUS_POLLHUP     0x0080
/** Invalid request: fd not open */
#define _DBUS_POLLNVAL    0x1000
Matt Fischer's avatar
Matt Fischer committed
279 280 281 282 283 284 285 286 287 288 289 290 291
#elif defined(__QNX__)
/** Writing now will not block */
#define _DBUS_POLLOUT     0x0002
/** There is data to read */
#define _DBUS_POLLIN      0x0005
/** There is urgent data to read */
#define _DBUS_POLLPRI     0x0008
/** Error condition */
#define _DBUS_POLLERR     0x0020
/** Hung up */
#define _DBUS_POLLHUP     0x0040
/** Invalid request: fd not open */
#define _DBUS_POLLNVAL    0x1000
292
#else
293 294 295 296 297 298 299 300 301 302 303 304
/** There is data to read */
#define _DBUS_POLLIN      0x0001
/** There is urgent data to read */
#define _DBUS_POLLPRI     0x0002
/** Writing now will not block */
#define _DBUS_POLLOUT     0x0004
/** Error condition */
#define _DBUS_POLLERR     0x0008
/** Hung up */
#define _DBUS_POLLHUP     0x0010
/** Invalid request: fd not open */
#define _DBUS_POLLNVAL    0x0020
305
#endif
306

307 308 309
/**
 * A portable struct pollfd wrapper. 
 */
310 311
typedef struct
{
312 313 314
  int fd;            /**< File descriptor */
  short events;      /**< Events to poll for */
  short revents;     /**< Events that occurred */
315 316 317 318 319 320 321 322
} DBusPollFD;

int _dbus_poll (DBusPollFD *fds,
                int         n_fds,
                int         timeout_milliseconds);

void _dbus_sleep_milliseconds (int milliseconds);

323 324
void _dbus_get_monotonic_time (long *tv_sec,
                               long *tv_usec);
325

326 327
void _dbus_get_real_time (long *tv_sec,
                          long *tv_usec);
328

329
/**
330
 * directory interface
331
 */
332 333
dbus_bool_t    _dbus_create_directory        (const DBusString *filename,
                                              DBusError        *error);
334 335
dbus_bool_t    _dbus_delete_directory        (const DBusString *filename,
					      DBusError        *error);
336

337 338
dbus_bool_t _dbus_concat_dir_and_file (DBusString       *dir,
                                       const DBusString *next_component);
339 340 341
dbus_bool_t _dbus_string_get_dirname  (const DBusString *filename,
                                       DBusString       *dirname);
dbus_bool_t _dbus_path_is_absolute    (const DBusString *filename);
342

343
dbus_bool_t _dbus_get_standard_session_servicedirs (DBusList **dirs);
344
dbus_bool_t _dbus_get_standard_system_servicedirs (DBusList **dirs);
345

346 347 348
dbus_bool_t _dbus_append_system_config_file  (DBusString *str);
dbus_bool_t _dbus_append_session_config_file (DBusString *str);

349
/** Opaque type for reading a directory listing */
350 351 352
typedef struct DBusDirIter DBusDirIter;

DBusDirIter* _dbus_directory_open          (const DBusString *filename,
353
                                            DBusError        *error);
354 355
dbus_bool_t  _dbus_directory_get_next_file (DBusDirIter      *iter,
                                            DBusString       *filename,
356
                                            DBusError        *error);
357 358
void         _dbus_directory_close         (DBusDirIter      *iter);

John Palmieri's avatar
John Palmieri committed
359 360
dbus_bool_t  _dbus_check_dir_is_private_to_user    (DBusString *dir,
                                                    DBusError *error);
361

362
void _dbus_fd_set_close_on_exec (intptr_t fd);
363 364 365 366 367 368

const char* _dbus_get_tmpdir      (void);

/**
 * Random numbers 
 */
369 370
void        _dbus_generate_pseudorandom_bytes_buffer (char *buffer,
                                                      int   n_bytes);
371 372 373 374 375 376
void        _dbus_generate_random_bytes_buffer (char       *buffer,
                                                int         n_bytes);
dbus_bool_t _dbus_generate_random_bytes        (DBusString *str,
                                                int         n_bytes);
dbus_bool_t _dbus_generate_random_ascii        (DBusString *str,
                                                int         n_bytes);
377

378
const char* _dbus_error_from_errno (int error_number);
379
const char* _dbus_error_from_system_errno (void);
380

381 382 383 384 385
void        _dbus_set_errno_to_zero                  (void);
dbus_bool_t _dbus_get_is_errno_nonzero               (void);
dbus_bool_t _dbus_get_is_errno_eagain_or_ewouldblock (void);
dbus_bool_t _dbus_get_is_errno_enomem                (void);
dbus_bool_t _dbus_get_is_errno_eintr                 (void);
386
dbus_bool_t _dbus_get_is_errno_epipe                 (void);
387 388
const char* _dbus_strerror_from_errno                (void);

389 390
void _dbus_disable_sigpipe (void);

Anders Carlsson's avatar
Anders Carlsson committed
391

392
void _dbus_exit (int code) _DBUS_GNUC_NORETURN;
393

John Palmieri's avatar
John Palmieri committed
394 395
int _dbus_printf_string_upper_bound (const char *format,
                                     va_list args);
John Palmieri's avatar
John Palmieri committed
396 397


398 399 400
/**
 * Portable struct with stat() results
 */
401 402
typedef struct
{
403 404 405 406 407 408 409 410
  unsigned long mode;  /**< File mode */
  unsigned long nlink; /**< Number of hard links */
  dbus_uid_t    uid;   /**< User owning file */
  dbus_gid_t    gid;   /**< Group owning file */
  unsigned long size;  /**< Size of file */
  unsigned long atime; /**< Access time */
  unsigned long mtime; /**< Modify time */
  unsigned long ctime; /**< Creation time */
411 412
} DBusStat;

413 414 415 416 417
dbus_bool_t _dbus_stat             (const DBusString *filename,
                                    DBusStat         *statbuf,
                                    DBusError        *error);
dbus_bool_t _dbus_full_duplex_pipe (int              *fd1,
                                    int              *fd2,
418
                                    dbus_bool_t       blocking,
419
                                    DBusError        *error);
420

421 422
void        _dbus_print_backtrace  (void);

423
dbus_bool_t _dbus_become_daemon   (const DBusString *pidfile,
424
                                   DBusPipe         *print_pid_pipe,
425 426
                                   DBusError        *error,
                                   dbus_bool_t       keep_umask);
427

428 429 430
dbus_bool_t _dbus_verify_daemon_user    (const char *user);
dbus_bool_t _dbus_change_to_daemon_user (const char *user,
                                         DBusError  *error);
431

432 433 434 435 436
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);

437 438 439 440 441
dbus_bool_t _dbus_command_for_pid (unsigned long  pid,
                                   DBusString    *str,
                                   int            max_len,
                                   DBusError     *error);

442
/** A UNIX signal handler */
443 444 445 446 447
typedef void (* DBusSignalHandler) (int sig);

void _dbus_set_signal_handler (int               sig,
                               DBusSignalHandler handler);

John Palmieri's avatar
John Palmieri committed
448 449
dbus_bool_t _dbus_user_at_console (const char *username,
                                   DBusError  *error);
450

451
void _dbus_init_system_log (dbus_bool_t is_daemon);
452

453 454
typedef enum {
  DBUS_SYSTEM_LOG_INFO,
455 456
  DBUS_SYSTEM_LOG_SECURITY,
  DBUS_SYSTEM_LOG_FATAL
457 458
} DBusSystemLogSeverity;

459
void _dbus_system_log (DBusSystemLogSeverity severity, const char *msg, ...) _DBUS_GNUC_PRINTF (2, 3);
460 461 462 463
void _dbus_system_logv (DBusSystemLogSeverity severity, const char *msg, va_list args);

/* Define DBUS_VA_COPY() to do the right thing for copying va_list variables.
 * config.h may have already defined DBUS_VA_COPY as va_copy or __va_copy.
464 465 466 467 468 469 470 471 472 473 474
 */
#if !defined (DBUS_VA_COPY)
#  if defined (__GNUC__) && defined (__PPC__) && (defined (_CALL_SYSV) || defined (_WIN32))
#    define DBUS_VA_COPY(ap1, ap2)   (*(ap1) = *(ap2))
#  elif defined (DBUS_VA_COPY_AS_ARRAY)
#    define DBUS_VA_COPY(ap1, ap2)   memcpy ((ap1), (ap2), sizeof (va_list))
#  else /* va_list is a pointer */
#    define DBUS_VA_COPY(ap1, ap2)   ((ap1) = (ap2))
#  endif /* va_list is a pointer */
#endif /* !DBUS_VA_COPY */

475 476 477 478

/**
 * Casts a primitive C type to a byte array and then indexes
 * a particular byte of the array.
479 480 481
 */
#define _DBUS_BYTE_OF_PRIMITIVE(p, i) \
    (((const char*)&(p))[(i)])
482 483 484 485 486
/** On x86 there is an 80-bit FPU, and if you do "a == b" it may have a
 * or b in an 80-bit register, thus failing to compare the two 64-bit
 * doubles for bitwise equality. So this macro compares the two doubles
 * bitwise.
 */
487 488 489 490 491 492 493 494 495
#define _DBUS_DOUBLES_BITWISE_EQUAL(a, b)                                       \
     (_DBUS_BYTE_OF_PRIMITIVE (a, 0) == _DBUS_BYTE_OF_PRIMITIVE (b, 0) &&       \
      _DBUS_BYTE_OF_PRIMITIVE (a, 1) == _DBUS_BYTE_OF_PRIMITIVE (b, 1) &&       \
      _DBUS_BYTE_OF_PRIMITIVE (a, 2) == _DBUS_BYTE_OF_PRIMITIVE (b, 2) &&       \
      _DBUS_BYTE_OF_PRIMITIVE (a, 3) == _DBUS_BYTE_OF_PRIMITIVE (b, 3) &&       \
      _DBUS_BYTE_OF_PRIMITIVE (a, 4) == _DBUS_BYTE_OF_PRIMITIVE (b, 4) &&       \
      _DBUS_BYTE_OF_PRIMITIVE (a, 5) == _DBUS_BYTE_OF_PRIMITIVE (b, 5) &&       \
      _DBUS_BYTE_OF_PRIMITIVE (a, 6) == _DBUS_BYTE_OF_PRIMITIVE (b, 6) &&       \
      _DBUS_BYTE_OF_PRIMITIVE (a, 7) == _DBUS_BYTE_OF_PRIMITIVE (b, 7))
496

497 498 499
dbus_bool_t _dbus_get_autolaunch_address (const char *scope,
                                          DBusString *address,
					                      DBusError  *error);
500

501 502 503 504
dbus_bool_t _dbus_lookup_session_address (dbus_bool_t *supported,
                                          DBusString  *address,
                                          DBusError   *error);

505 506 507
/** Type representing a universally unique ID
 * @todo rename to UUID instead of GUID
 */
508 509 510 511 512 513
typedef union DBusGUID DBusGUID;

dbus_bool_t _dbus_read_local_machine_uuid   (DBusGUID         *machine_id,
                                             dbus_bool_t       create_if_not_found,
                                             DBusError        *error);

514 515 516 517 518 519
/**
 * Initialize threads as in dbus_threads_init_default(), appropriately
 * for the platform.
 * @returns #FALSE if no memory
 */
dbus_bool_t _dbus_threads_init_platform_specific (void);
520 521 522 523 524 525 526 527 528 529

/**
 * Lock a static mutex used to protect _dbus_threads_init_platform_specific().
 */
void _dbus_threads_lock_platform_specific (void);

/**
 * Undo _dbus_threads_lock_platform_specific().
 */
void _dbus_threads_unlock_platform_specific (void);
530

531 532 533 534
dbus_bool_t _dbus_split_paths_and_append (DBusString *dirs, 
                                          const char *suffix, 
                                          DBusList **dir_list);

535 536
unsigned long _dbus_pid_for_log (void);

537 538 539 540 541 542
/* FIXME move back to dbus-sysdeps-unix.h probably -
 * the PID file handling just needs a little more abstraction
 * in the bus daemon first.
 */
dbus_pid_t    _dbus_getpid (void);

543 544 545
dbus_bool_t _dbus_change_to_daemon_user (const char *user,
                                         DBusError  *error);

546 547
void _dbus_flush_caches (void);

548 549
void _dbus_request_file_descriptor_limit (unsigned int limit);

550 551 552 553 554 555 556 557 558 559
/*
 * replaces the term DBUS_PREFIX in configure_time_path by the
 * current dbus installation directory. On unix this function is a noop
 *
 * @param configure_time_path
 * @return real path
 */
const char *
_dbus_replace_install_prefix (const char *configure_time_path);

560 561
/** @} */

562
DBUS_END_DECLS
563

564 565 566 567 568

#ifdef DBUS_WIN
#include "dbus-sysdeps-win.h"
#endif

569
#endif /* DBUS_SYSDEPS_H */