vcs.maemo.org Git - monky/blob - src/dbus/dbus-sysdeps-unix.h

   1 /* -*- mode: C; c-file-style: "gnu"; indent-tabs-mode: nil; -*- */
   2 /* dbus-sysdeps-unix.h UNIX-specific wrappers around system/libc features (internal to D-Bus implementation)
   3  *
   4  * Copyright (C) 2002, 2003, 2006  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., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
  22  *
  23  */
  24
  25 #ifndef DBUS_SYSDEPS_UNIX_H
  26 #define DBUS_SYSDEPS_UNIX_H
  27
  28 #include <config.h>
  29 #include <dbus/dbus-sysdeps.h>
  30
  31 #ifdef DBUS_WIN
  32 #error "Don't include this on Windows"
  33 #endif
  34
  35 DBUS_BEGIN_DECLS
  36
  37 /**
  38  * @defgroup DBusSysdepsUnix UNIX-specific internal API
  39  * @ingroup DBusInternals
  40  * @brief Internal system-dependent API available on UNIX only
  41  * @{
  42  */
  43
  44 dbus_bool_t
  45 _dbus_close     (int               fd,
  46                  DBusError        *error);
  47 int
  48 _dbus_read      (int               fd,
  49                  DBusString       *buffer,
  50                  int               count);
  51 int
  52 _dbus_write     (int               fd,
  53                  const DBusString *buffer,
  54                  int               start,
  55                  int               len);
  56 int
  57 _dbus_write_two (int               fd,
  58                  const DBusString *buffer1,
  59                  int               start1,
  60                  int               len1,
  61                  const DBusString *buffer2,
  62                  int               start2,
  63                  int               len2);
  64
  65 dbus_bool_t _dbus_open_unix_socket (int              *fd,
  66                                     DBusError        *error);
  67 int _dbus_connect_unix_socket (const char     *path,
  68                                dbus_bool_t     abstract,
  69                                DBusError      *error);
  70 int _dbus_listen_unix_socket  (const char     *path,
  71                                dbus_bool_t     abstract,
  72                                DBusError      *error);
  73
  74 dbus_bool_t _dbus_read_credentials (int               client_fd,
  75                                     DBusCredentials  *credentials,
  76                                     DBusError        *error);
  77 dbus_bool_t _dbus_send_credentials (int              server_fd,
  78                                     DBusError       *error);
  79
  80 /** Information about a UNIX user */
  81 typedef struct DBusUserInfo  DBusUserInfo;
  82 /** Information about a UNIX group */
  83 typedef struct DBusGroupInfo DBusGroupInfo;
  84
  85 /**
  86  * Information about a UNIX user
  87  */
  88 struct DBusUserInfo
  89 {
  90   dbus_uid_t  uid;            /**< UID */
  91   dbus_gid_t  primary_gid;    /**< GID */
  92   dbus_gid_t *group_ids;      /**< Groups IDs, *including* above primary group */
  93   int         n_group_ids;    /**< Size of group IDs array */
  94   char       *username;       /**< Username */
  95   char       *homedir;        /**< Home directory */
  96 };
  97
  98 /**
  99  * Information about a UNIX group
 100  */
 101 struct DBusGroupInfo
 102 {
 103   dbus_gid_t  gid;            /**< GID */
 104   char       *groupname;      /**< Group name */
 105 };
 106
 107 dbus_bool_t _dbus_user_info_fill     (DBusUserInfo     *info,
 108                                       const DBusString *username,
 109                                       DBusError        *error);
 110 dbus_bool_t _dbus_user_info_fill_uid (DBusUserInfo     *info,
 111                                       dbus_uid_t        uid,
 112                                       DBusError        *error);
 113 void        _dbus_user_info_free     (DBusUserInfo     *info);
 114
 115 dbus_bool_t _dbus_group_info_fill     (DBusGroupInfo    *info,
 116                                        const DBusString *groupname,
 117                                        DBusError        *error);
 118 dbus_bool_t _dbus_group_info_fill_gid (DBusGroupInfo    *info,
 119                                        dbus_gid_t        gid,
 120                                        DBusError        *error);
 121 void        _dbus_group_info_free     (DBusGroupInfo    *info);
 122
 123 dbus_uid_t    _dbus_getuid (void);
 124 dbus_uid_t    _dbus_geteuid (void);
 125 dbus_gid_t    _dbus_getgid (void);
 126
 127 dbus_bool_t _dbus_parse_uid (const DBusString  *uid_str,
 128                              dbus_uid_t        *uid);
 129
 130 /** @} */
 131
 132 DBUS_END_DECLS
 133
 134 #endif /* DBUS_SYSDEPS_UNIX_H */