dbus/dbus-protocol.h

   1 /* -*- mode: C; c-file-style: "gnu" -*- */
   2 /* dbus-protocol.h  D-Bus protocol constants
   3  *
   4  * Copyright (C) 2002, 2003  CodeFactory AB
   5  *
   6  * Licensed under the Academic Free License version 1.2
   7  *
   8  * This program is free software; you can redistribute it and/or modify
   9  * it under the terms of the GNU General Public License as published by
  10  * the Free Software Foundation; either version 2 of the License, or
  11  * (at your option) any later version.
  12  *
  13  * This program is distributed in the hope that it will be useful,
  14  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  15  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  16  * GNU General Public License for more details.
  17  *
  18  * You should have received a copy of the GNU General Public License
  19  * along with this program; if not, write to the Free Software
  20  * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
  21  *
  22  */
  23
  24 #ifndef DBUS_PROTOCOL_H
  25 #define DBUS_PROTOCOL_H
  26
  27 /* Don't include anything in here from anywhere else. It's
  28  * intended for use by any random library.
  29  */
  30
  31 #ifdef  __cplusplus
  32 extern "C" {
  33 #endif
  34
  35 /* Message byte order */
  36 #define DBUS_LITTLE_ENDIAN ('l')  /* LSB first */
  37 #define DBUS_BIG_ENDIAN    ('B')  /* MSB first */
  38
  39 /* Protocol version */
  40 #define DBUS_MAJOR_PROTOCOL_VERSION 0
  41
  42 /* Data types */
  43 #define DBUS_TYPE_INVALID       0
  44 #define DBUS_TYPE_NIL           1
  45 #define DBUS_TYPE_BYTE          2
  46 #define DBUS_TYPE_BOOLEAN       3
  47 #define DBUS_TYPE_INT32         4
  48 #define DBUS_TYPE_UINT32        5
  49 #define DBUS_TYPE_INT64         6
  50 #define DBUS_TYPE_UINT64        7
  51 #define DBUS_TYPE_DOUBLE        8
  52 #define DBUS_TYPE_STRING        9
  53 #define DBUS_TYPE_NAMED         10
  54 #define DBUS_TYPE_ARRAY         11
  55 #define DBUS_TYPE_DICT          12
  56 #define DBUS_TYPE_OBJECT_ID     13
  57
  58 #define DBUS_TYPE_LAST DBUS_TYPE_OBJECT_ID
  59
  60 /* Max length in bytes of a service or message name */
  61 #define DBUS_MAXIMUM_NAME_LENGTH 256
  62
  63 /* Types of message */
  64 #define DBUS_MESSAGE_TYPE_METHOD_CALL   1
  65 #define DBUS_MESSAGE_TYPE_METHOD_RETURN 2
  66 #define DBUS_MESSAGE_TYPE_ERROR         3
  67 #define DBUS_MESSAGE_TYPE_SIGNAL        4
  68
  69 /* Header flags */
  70 #define DBUS_HEADER_FLAG_ERROR             0x1
  71 #define DBUS_HEADER_FLAG_NO_REPLY_EXPECTED 0x2
  72
  73 /* Header fields */
  74 #define DBUS_HEADER_FIELD_NAME    "name"
  75 #define DBUS_HEADER_FIELD_SERVICE "srvc"
  76 #define DBUS_HEADER_FIELD_REPLY   "rply"
  77 #define DBUS_HEADER_FIELD_SENDER  "sndr"
  78
  79 /* Services */
  80 #define DBUS_SERVICE_DBUS      "org.freedesktop.DBus"
  81 #define DBUS_SERVICE_BROADCAST "org.freedesktop.DBus.Broadcast"
  82
  83 /* Service owner flags */
  84 #define DBUS_SERVICE_FLAG_PROHIBIT_REPLACEMENT 0x1
  85 #define DBUS_SERVICE_FLAG_REPLACE_EXISTING     0x2
  86
  87 /* Service replies */
  88 #define DBUS_SERVICE_REPLY_PRIMARY_OWNER  0x1
  89 #define DBUS_SERVICE_REPLY_IN_QUEUE       0x2
  90 #define DBUS_SERVICE_REPLY_SERVICE_EXISTS 0x4
  91 #define DBUS_SERVICE_REPLY_ALREADY_OWNER  0x8
  92
  93 /* Activation replies */
  94 #define DBUS_ACTIVATION_REPLY_ACTIVATED      0x0
  95 #define DBUS_ACTIVATION_REPLY_ALREADY_ACTIVE 0x1
  96
  97 /* Messages */
  98 #define DBUS_MESSAGE_ACTIVATE_SERVICE      "org.freedesktop.DBus.ActivateService"
  99 #define DBUS_MESSAGE_SERVICE_EXISTS        "org.freedesktop.DBus.ServiceExists"
 100 #define DBUS_MESSAGE_HELLO                 "org.freedesktop.DBus.Hello"
 101 #define DBUS_MESSAGE_LIST_SERVICES         "org.freedesktop.DBus.ListServices"
 102 #define DBUS_MESSAGE_ACQUIRE_SERVICE       "org.freedesktop.DBus.AcquireService"
 103 #define DBUS_MESSAGE_SERVICE_ACQUIRED      "org.freedesktop.DBus.ServiceAcquired"
 104 #define DBUS_MESSAGE_SERVICE_CREATED       "org.freedesktop.DBus.ServiceCreated"
 105 #define DBUS_MESSAGE_SERVICE_DELETED       "org.freedesktop.DBus.ServiceDeleted"
 106 #define DBUS_MESSAGE_SERVICE_LOST          "org.freedesktop.DBus.ServiceLost"
 107
 108
 109 /* This namespace is reserved for locally-synthesized messages, you can't
 110  * send messages that have this namespace.
 111  */
 112 #define DBUS_NAMESPACE_LOCAL_MESSAGE       "org.freedesktop.Local."
 113 #define DBUS_MESSAGE_LOCAL_DISCONNECT      DBUS_NAMESPACE_LOCAL_MESSAGE"Disconnect"
 114
 115 #ifdef __cplusplus
 116 }
 117 #endif
 118
 119 #endif /* DBUS_PROTOCOL_H */