dbus-sysdeps.h 19.4 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
#include <dbus/dbus-errors.h>
29
#include <dbus/dbus-file.h>
30
#include <dbus/dbus-string.h>
31
#include <dbus/dbus-pipe.h>
32 33 34 35 36

/* 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
37 38
#include <stdarg.h>

39 40 41 42 43 44 45 46 47
 
/* 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

48 49 50 51 52 53
#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

54
DBUS_BEGIN_DECLS
55

56 57 58 59 60 61
#ifdef DBUS_WIN
#define _DBUS_PATH_SEPARATOR ";"
#else
#define _DBUS_PATH_SEPARATOR ":"
#endif

62 63 64 65 66 67
/* Forward declarations */


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

68 69 70
/** Object that contains a list of credentials such as UNIX or Windows user ID */
typedef struct DBusCredentials DBusCredentials;

71 72 73 74 75 76
/**
 * @addtogroup DBusSysdeps
 *
 * @{
 */

77
void _dbus_abort (void) _DBUS_GNUC_NORETURN;
78 79

const char* _dbus_getenv (const char *varname);
80 81
dbus_bool_t _dbus_setenv (const char *varname,
			  const char *value);
82
dbus_bool_t _dbus_clearenv (void);
83
char **     _dbus_get_environment (void);
84

85
/** A process ID */
86
typedef unsigned long dbus_pid_t;
87
/** A user ID */
88
typedef unsigned long dbus_uid_t;
89
/** A group ID */
90 91
typedef unsigned long dbus_gid_t;

92
/** an invalid PID used to represent an uninitialized dbus_pid_t field */
93
#define DBUS_PID_UNSET ((dbus_pid_t) -1)
94
/** an invalid UID used to represent an uninitialized dbus_uid_t field */
95
#define DBUS_UID_UNSET ((dbus_uid_t) -1)
96
/** an invalid GID used to represent an uninitialized dbus_gid_t field */
97 98
#define DBUS_GID_UNSET ((dbus_gid_t) -1)

99
/** an appropriate printf format for dbus_pid_t */
100
#define DBUS_PID_FORMAT "%lu"
101
/** an appropriate printf format for dbus_uid_t */
102
#define DBUS_UID_FORMAT "%lu"
103
/** an appropriate printf format for dbus_gid_t */
104 105
#define DBUS_GID_FORMAT "%lu"

106

107
/**
108 109 110 111 112 113 114
 * 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.
 * 
115
 */
116

117 118
dbus_bool_t _dbus_open_tcp_socket  (int              *fd,
                                    DBusError        *error);
119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134
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);
135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156

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);

157 158
dbus_bool_t _dbus_socket_is_invalid (int              fd);

159
int _dbus_connect_tcp_socket  (const char     *host,
160 161
                               const char     *port,
                               const char     *family,
162
                               DBusError      *error);
Frank Osterfeld's avatar
Frank Osterfeld committed
163 164 165 166 167
int _dbus_connect_tcp_socket_with_nonce  (const char     *host,
                                          const char     *port,
                                          const char     *family,
                                          const char     *noncefile,
                                          DBusError      *error);
168
int _dbus_listen_tcp_socket   (const char     *host,
169 170 171 172
                               const char     *port,
                               const char     *family,
                               DBusString     *retport,
                               int           **fds_p,
173
                               DBusError      *error);
174 175
int _dbus_accept              (int             listen_fd);

176

177 178 179 180 181
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);
182

183
dbus_bool_t _dbus_credentials_add_from_user            (DBusCredentials  *credentials,
184 185
                                                        const DBusString *username);
dbus_bool_t _dbus_credentials_add_from_current_process (DBusCredentials  *credentials);
186
dbus_bool_t _dbus_append_user_from_current_process     (DBusString        *str);
187

188 189 190 191 192 193 194 195 196 197 198 199
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);

200 201
dbus_bool_t _dbus_append_keyring_directory_for_credentials (DBusString      *directory,
                                                            DBusCredentials *credentials);
202

Frank Osterfeld's avatar
Frank Osterfeld committed
203 204 205 206
void _dbus_daemon_publish_session_bus_address (const char* address);

void _dbus_daemon_unpublish_session_bus_address (void);

207 208
dbus_bool_t _dbus_socket_can_pass_unix_fd(int fd);

209 210 211
/** Opaque type representing an atomically-modifiable integer
 * that can be used from multiple threads.
 */
212
typedef struct DBusAtomic DBusAtomic;
213 214

/**
215
 * An atomic integer safe to increment or decrement from multiple threads.
216
 */
217 218
struct DBusAtomic
{
219 220 221
#ifdef DBUS_WIN
  volatile long value; /**< Value of the atomic integer. */
#else
222
  volatile dbus_int32_t value; /**< Value of the atomic integer. */
223
#endif
224
};
225

226 227 228 229 230 231 232 233 234 235
/* 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

236 237
dbus_int32_t _dbus_atomic_inc (DBusAtomic *atomic);
dbus_int32_t _dbus_atomic_dec (DBusAtomic *atomic);
238

239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254

/* 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
255 256 257 258 259 260 261 262 263 264 265 266 267
#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
268
#else
269 270 271 272 273 274 275 276 277 278 279 280
/** 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
281
#endif
282

283 284 285
/**
 * A portable struct pollfd wrapper. 
 */
286 287
typedef struct
{
288 289 290
  int fd;            /**< File descriptor */
  short events;      /**< Events to poll for */
  short revents;     /**< Events that occurred */
291 292 293 294 295 296 297 298
} DBusPollFD;

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

void _dbus_sleep_milliseconds (int milliseconds);

299 300 301
void _dbus_get_current_time (long *tv_sec,
                             long *tv_usec);

302
/**
303
 * directory interface
304
 */
305 306
dbus_bool_t    _dbus_create_directory        (const DBusString *filename,
                                              DBusError        *error);
307 308
dbus_bool_t    _dbus_delete_directory        (const DBusString *filename,
					      DBusError        *error);
309

310 311
dbus_bool_t _dbus_concat_dir_and_file (DBusString       *dir,
                                       const DBusString *next_component);
312 313 314
dbus_bool_t _dbus_string_get_dirname  (const DBusString *filename,
                                       DBusString       *dirname);
dbus_bool_t _dbus_path_is_absolute    (const DBusString *filename);
315

316
dbus_bool_t _dbus_get_standard_session_servicedirs (DBusList **dirs);
317
dbus_bool_t _dbus_get_standard_system_servicedirs (DBusList **dirs);
318

319 320 321
dbus_bool_t _dbus_append_system_config_file  (DBusString *str);
dbus_bool_t _dbus_append_session_config_file (DBusString *str);

322
/** Opaque type for reading a directory listing */
323 324 325
typedef struct DBusDirIter DBusDirIter;

DBusDirIter* _dbus_directory_open          (const DBusString *filename,
326
                                            DBusError        *error);
327 328
dbus_bool_t  _dbus_directory_get_next_file (DBusDirIter      *iter,
                                            DBusString       *filename,
329
                                            DBusError        *error);
330 331
void         _dbus_directory_close         (DBusDirIter      *iter);

John Palmieri's avatar
John Palmieri committed
332 333
dbus_bool_t  _dbus_check_dir_is_private_to_user    (DBusString *dir,
                                                    DBusError *error);
334

335 336 337 338 339 340 341
void _dbus_fd_set_close_on_exec (int fd);

const char* _dbus_get_tmpdir      (void);

/**
 * Random numbers 
 */
342 343
void        _dbus_generate_pseudorandom_bytes_buffer (char *buffer,
                                                      int   n_bytes);
344 345 346 347 348 349
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);
350

351
const char* _dbus_error_from_errno (int error_number);
352
const char* _dbus_error_from_system_errno (void);
353

354 355 356 357 358
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);
359
dbus_bool_t _dbus_get_is_errno_epipe                 (void);
360 361
const char* _dbus_strerror_from_errno                (void);

362 363
void _dbus_disable_sigpipe (void);

Anders Carlsson's avatar
Anders Carlsson committed
364

365
void _dbus_exit (int code) _DBUS_GNUC_NORETURN;
366

John Palmieri's avatar
John Palmieri committed
367 368
int _dbus_printf_string_upper_bound (const char *format,
                                     va_list args);
John Palmieri's avatar
John Palmieri committed
369 370


371 372 373
/**
 * Portable struct with stat() results
 */
374 375
typedef struct
{
376 377 378 379 380 381 382 383
  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 */
384 385
} DBusStat;

386 387 388 389 390
dbus_bool_t _dbus_stat             (const DBusString *filename,
                                    DBusStat         *statbuf,
                                    DBusError        *error);
dbus_bool_t _dbus_full_duplex_pipe (int              *fd1,
                                    int              *fd2,
391
                                    dbus_bool_t       blocking,
392
                                    DBusError        *error);
393

394 395
void        _dbus_print_backtrace  (void);

396
dbus_bool_t _dbus_become_daemon   (const DBusString *pidfile,
397
                                   DBusPipe         *print_pid_pipe,
398 399
                                   DBusError        *error,
                                   dbus_bool_t       keep_umask);
400

401 402 403
dbus_bool_t _dbus_verify_daemon_user    (const char *user);
dbus_bool_t _dbus_change_to_daemon_user (const char *user,
                                         DBusError  *error);
404

405 406 407 408 409
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);

410 411 412 413 414
dbus_bool_t _dbus_command_for_pid (unsigned long  pid,
                                   DBusString    *str,
                                   int            max_len,
                                   DBusError     *error);

415
/** A UNIX signal handler */
416 417 418 419 420
typedef void (* DBusSignalHandler) (int sig);

void _dbus_set_signal_handler (int               sig,
                               DBusSignalHandler handler);

John Palmieri's avatar
John Palmieri committed
421 422
dbus_bool_t _dbus_user_at_console (const char *username,
                                   DBusError  *error);
423

424 425
void _dbus_init_system_log (void);

426 427
typedef enum {
  DBUS_SYSTEM_LOG_INFO,
428 429
  DBUS_SYSTEM_LOG_SECURITY,
  DBUS_SYSTEM_LOG_FATAL
430 431
} DBusSystemLogSeverity;

432
void _dbus_system_log (DBusSystemLogSeverity severity, const char *msg, ...) _DBUS_GNUC_PRINTF (2, 3);
433 434 435 436
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.
437 438 439 440 441 442 443 444 445 446 447
 */
#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 */

448 449 450 451

/**
 * Casts a primitive C type to a byte array and then indexes
 * a particular byte of the array.
452 453 454
 */
#define _DBUS_BYTE_OF_PRIMITIVE(p, i) \
    (((const char*)&(p))[(i)])
455 456 457 458 459
/** 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.
 */
460 461 462 463 464 465 466 467 468
#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))
469

470 471 472
dbus_bool_t _dbus_get_autolaunch_address (DBusString *address, 
					  DBusError *error);

473 474 475 476
dbus_bool_t _dbus_lookup_session_address (dbus_bool_t *supported,
                                          DBusString  *address,
                                          DBusError   *error);

477 478 479
/** Type representing a universally unique ID
 * @todo rename to UUID instead of GUID
 */
480 481 482 483 484 485
typedef union DBusGUID DBusGUID;

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

486 487 488 489 490 491
/**
 * 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);
492

493 494 495 496
dbus_bool_t _dbus_split_paths_and_append (DBusString *dirs, 
                                          const char *suffix, 
                                          DBusList **dir_list);

497 498
unsigned long _dbus_pid_for_log (void);

499 500 501 502 503 504
/* 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);

505 506 507
dbus_bool_t _dbus_change_to_daemon_user (const char *user,
                                         DBusError  *error);

508 509
void _dbus_flush_caches (void);

510 511
/** @} */

512
DBUS_END_DECLS
513 514

#endif /* DBUS_SYSDEPS_H */