00001
00002
00003
00004
00005
00006
00007
00008
00009
00010
00011
00012
00013
00014
00015
00016
00017
00018
00019
00020
00021
00022
00023
00024 #ifndef DBUS_MARSHAL_VALIDATE_H
00025 #define DBUS_MARSHAL_VALIDATE_H
00026
00027 #include <config.h>
00028
00029 #ifndef PACKAGE
00030 #error "config.h not included here"
00031 #endif
00032
00042 typedef enum
00043 {
00044 DBUS_VALIDATION_MODE_WE_TRUST_THIS_DATA_ABSOLUTELY,
00045 DBUS_VALIDATION_MODE_DATA_IS_UNTRUSTED
00046 } DBusValidationMode;
00047
00055 typedef enum
00056 {
00057 #define _DBUS_NEGATIVE_VALIDITY_COUNT 4
00058 DBUS_VALIDITY_UNKNOWN_OOM_ERROR = -4,
00059 DBUS_INVALID_FOR_UNKNOWN_REASON = -3,
00060 DBUS_VALID_BUT_INCOMPLETE = -2,
00061 DBUS_VALIDITY_UNKNOWN = -1,
00062 DBUS_VALID = 0,
00063 DBUS_INVALID_UNKNOWN_TYPECODE = 1,
00064 DBUS_INVALID_MISSING_ARRAY_ELEMENT_TYPE = 2,
00065 DBUS_INVALID_SIGNATURE_TOO_LONG = 3,
00066
00067
00068 DBUS_INVALID_EXCEEDED_MAXIMUM_ARRAY_RECURSION = 4,
00069 DBUS_INVALID_EXCEEDED_MAXIMUM_STRUCT_RECURSION = 5,
00070 DBUS_INVALID_STRUCT_ENDED_BUT_NOT_STARTED = 6,
00071 DBUS_INVALID_STRUCT_STARTED_BUT_NOT_ENDED = 7,
00072 DBUS_INVALID_STRUCT_HAS_NO_FIELDS = 8,
00073 DBUS_INVALID_ALIGNMENT_PADDING_NOT_NUL = 9,
00074 DBUS_INVALID_BOOLEAN_NOT_ZERO_OR_ONE = 10,
00075 DBUS_INVALID_NOT_ENOUGH_DATA = 11,
00076 DBUS_INVALID_TOO_MUCH_DATA = 12,
00077 DBUS_INVALID_BAD_BYTE_ORDER = 13,
00078 DBUS_INVALID_BAD_PROTOCOL_VERSION = 14,
00079 DBUS_INVALID_BAD_MESSAGE_TYPE = 15,
00080 DBUS_INVALID_BAD_SERIAL = 16,
00081 DBUS_INVALID_INSANE_FIELDS_ARRAY_LENGTH = 17,
00082 DBUS_INVALID_INSANE_BODY_LENGTH = 18,
00083 DBUS_INVALID_MESSAGE_TOO_LONG = 19,
00084 DBUS_INVALID_HEADER_FIELD_CODE = 20,
00085 DBUS_INVALID_HEADER_FIELD_HAS_WRONG_TYPE = 21,
00086 DBUS_INVALID_USES_LOCAL_INTERFACE = 22,
00087 DBUS_INVALID_USES_LOCAL_PATH = 23,
00088 DBUS_INVALID_HEADER_FIELD_APPEARS_TWICE = 24,
00089 DBUS_INVALID_BAD_DESTINATION = 25,
00090 DBUS_INVALID_BAD_INTERFACE = 26,
00091 DBUS_INVALID_BAD_MEMBER = 27,
00092 DBUS_INVALID_BAD_ERROR_NAME = 28,
00093 DBUS_INVALID_BAD_SENDER = 29,
00094 DBUS_INVALID_MISSING_PATH = 30,
00095 DBUS_INVALID_MISSING_INTERFACE = 31,
00096 DBUS_INVALID_MISSING_MEMBER = 32,
00097 DBUS_INVALID_MISSING_ERROR_NAME = 33,
00098 DBUS_INVALID_MISSING_REPLY_SERIAL = 34,
00099 DBUS_INVALID_LENGTH_OUT_OF_BOUNDS = 35,
00100 DBUS_INVALID_ARRAY_LENGTH_EXCEEDS_MAXIMUM = 36,
00101 DBUS_INVALID_BAD_PATH = 37,
00102 DBUS_INVALID_SIGNATURE_LENGTH_OUT_OF_BOUNDS = 38,
00103 DBUS_INVALID_BAD_UTF8_IN_STRING = 39,
00104 DBUS_INVALID_ARRAY_LENGTH_INCORRECT = 40,
00105 DBUS_INVALID_VARIANT_SIGNATURE_LENGTH_OUT_OF_BOUNDS = 41,
00106 DBUS_INVALID_VARIANT_SIGNATURE_BAD = 42,
00107 DBUS_INVALID_VARIANT_SIGNATURE_EMPTY = 43,
00108 DBUS_INVALID_VARIANT_SIGNATURE_SPECIFIES_MULTIPLE_VALUES = 44,
00109 DBUS_INVALID_VARIANT_SIGNATURE_MISSING_NUL = 45,
00110 DBUS_INVALID_STRING_MISSING_NUL = 46,
00111 DBUS_INVALID_SIGNATURE_MISSING_NUL = 47,
00112 DBUS_INVALID_EXCEEDED_MAXIMUM_DICT_ENTRY_RECURSION = 48,
00113 DBUS_INVALID_DICT_ENTRY_ENDED_BUT_NOT_STARTED = 49,
00114 DBUS_INVALID_DICT_ENTRY_STARTED_BUT_NOT_ENDED = 50,
00115 DBUS_INVALID_DICT_ENTRY_HAS_NO_FIELDS = 51,
00116 DBUS_INVALID_DICT_ENTRY_HAS_ONLY_ONE_FIELD = 52,
00117 DBUS_INVALID_DICT_ENTRY_HAS_TOO_MANY_FIELDS = 53,
00118 DBUS_INVALID_DICT_ENTRY_NOT_INSIDE_ARRAY = 54,
00119 DBUS_INVALID_DICT_KEY_MUST_BE_BASIC_TYPE = 55,
00120 DBUS_INVALID_MISSING_UNIX_FDS = 56,
00121 DBUS_INVALID_NESTED_TOO_DEEPLY = 57,
00122 DBUS_VALIDITY_LAST
00123 } DBusValidity;
00124
00125 DBusValidity _dbus_validate_signature_with_reason (const DBusString *type_str,
00126 int type_pos,
00127 int len);
00128 DBusValidity _dbus_validate_body_with_reason (const DBusString *expected_signature,
00129 int expected_signature_start,
00130 int byte_order,
00131 int *bytes_remaining,
00132 const DBusString *value_str,
00133 int value_pos,
00134 int len);
00135
00136 const char *_dbus_validity_to_error_message (DBusValidity validity);
00137
00138 dbus_bool_t _dbus_validate_path (const DBusString *str,
00139 int start,
00140 int len);
00141 dbus_bool_t _dbus_validate_interface (const DBusString *str,
00142 int start,
00143 int len);
00144 dbus_bool_t _dbus_validate_member (const DBusString *str,
00145 int start,
00146 int len);
00147 dbus_bool_t _dbus_validate_error_name (const DBusString *str,
00148 int start,
00149 int len);
00150 dbus_bool_t _dbus_validate_bus_name (const DBusString *str,
00151 int start,
00152 int len);
00153 dbus_bool_t _dbus_validate_signature (const DBusString *str,
00154 int start,
00155 int len);
00156
00157 #ifdef DBUS_DISABLE_CHECKS
00158
00159
00160
00161
00162 #define DECLARE_DBUS_NAME_CHECK(what)
00163 #define DEFINE_DBUS_NAME_CHECK(what)
00164
00165 #else
00166
00170 #define DECLARE_DBUS_NAME_CHECK(what) \
00171 dbus_bool_t _dbus_check_is_valid_##what (const char *name)
00172
00175 #define DEFINE_DBUS_NAME_CHECK(what) \
00176 dbus_bool_t \
00177 _dbus_check_is_valid_##what (const char *name) \
00178 { \
00179 DBusString str; \
00180 \
00181 if (name == NULL) \
00182 return FALSE; \
00183 \
00184 _dbus_string_init_const (&str, name); \
00185 return _dbus_validate_##what (&str, 0, \
00186 _dbus_string_get_length (&str)); \
00187 }
00188 #endif
00189
00191 DECLARE_DBUS_NAME_CHECK(path);
00193 DECLARE_DBUS_NAME_CHECK(interface);
00195 DECLARE_DBUS_NAME_CHECK(member);
00197 DECLARE_DBUS_NAME_CHECK(error_name);
00199 DECLARE_DBUS_NAME_CHECK(bus_name);
00201 DECLARE_DBUS_NAME_CHECK(signature);
00202
00205 #endif