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
00036 typedef enum
00037 {
00038 DBUS_VALIDATION_MODE_WE_TRUST_THIS_DATA_ABSOLUTELY,
00039 DBUS_VALIDATION_MODE_DATA_IS_UNTRUSTED
00040 } DBusValidationMode;
00041
00049 typedef enum
00050 {
00051 #define _DBUS_NEGATIVE_VALIDITY_COUNT 4
00052 DBUS_VALIDITY_UNKNOWN_OOM_ERROR = -4,
00053 DBUS_INVALID_FOR_UNKNOWN_REASON = -3,
00054 DBUS_VALID_BUT_INCOMPLETE = -2,
00055 DBUS_VALIDITY_UNKNOWN = -1,
00056 DBUS_VALID = 0,
00057 DBUS_INVALID_UNKNOWN_TYPECODE = 1,
00058 DBUS_INVALID_MISSING_ARRAY_ELEMENT_TYPE = 2,
00059 DBUS_INVALID_SIGNATURE_TOO_LONG = 3,
00060
00061
00062 DBUS_INVALID_EXCEEDED_MAXIMUM_ARRAY_RECURSION = 4,
00063 DBUS_INVALID_EXCEEDED_MAXIMUM_STRUCT_RECURSION = 5,
00064 DBUS_INVALID_STRUCT_ENDED_BUT_NOT_STARTED = 6,
00065 DBUS_INVALID_STRUCT_STARTED_BUT_NOT_ENDED = 7,
00066 DBUS_INVALID_STRUCT_HAS_NO_FIELDS = 8,
00067 DBUS_INVALID_ALIGNMENT_PADDING_NOT_NUL = 9,
00068 DBUS_INVALID_BOOLEAN_NOT_ZERO_OR_ONE = 10,
00069 DBUS_INVALID_NOT_ENOUGH_DATA = 11,
00070 DBUS_INVALID_TOO_MUCH_DATA = 12,
00071 DBUS_INVALID_BAD_BYTE_ORDER = 13,
00072 DBUS_INVALID_BAD_PROTOCOL_VERSION = 14,
00073 DBUS_INVALID_BAD_MESSAGE_TYPE = 15,
00074 DBUS_INVALID_BAD_SERIAL = 16,
00075 DBUS_INVALID_INSANE_FIELDS_ARRAY_LENGTH = 17,
00076 DBUS_INVALID_INSANE_BODY_LENGTH = 18,
00077 DBUS_INVALID_MESSAGE_TOO_LONG = 19,
00078 DBUS_INVALID_HEADER_FIELD_CODE = 20,
00079 DBUS_INVALID_HEADER_FIELD_HAS_WRONG_TYPE = 21,
00080 DBUS_INVALID_USES_LOCAL_INTERFACE = 22,
00081 DBUS_INVALID_USES_LOCAL_PATH = 23,
00082 DBUS_INVALID_HEADER_FIELD_APPEARS_TWICE = 24,
00083 DBUS_INVALID_BAD_DESTINATION = 25,
00084 DBUS_INVALID_BAD_INTERFACE = 26,
00085 DBUS_INVALID_BAD_MEMBER = 27,
00086 DBUS_INVALID_BAD_ERROR_NAME = 28,
00087 DBUS_INVALID_BAD_SENDER = 29,
00088 DBUS_INVALID_MISSING_PATH = 30,
00089 DBUS_INVALID_MISSING_INTERFACE = 31,
00090 DBUS_INVALID_MISSING_MEMBER = 32,
00091 DBUS_INVALID_MISSING_ERROR_NAME = 33,
00092 DBUS_INVALID_MISSING_REPLY_SERIAL = 34,
00093 DBUS_INVALID_LENGTH_OUT_OF_BOUNDS = 35,
00094 DBUS_INVALID_ARRAY_LENGTH_EXCEEDS_MAXIMUM = 36,
00095 DBUS_INVALID_BAD_PATH = 37,
00096 DBUS_INVALID_SIGNATURE_LENGTH_OUT_OF_BOUNDS = 38,
00097 DBUS_INVALID_BAD_UTF8_IN_STRING = 39,
00098 DBUS_INVALID_ARRAY_LENGTH_INCORRECT = 40,
00099 DBUS_INVALID_VARIANT_SIGNATURE_LENGTH_OUT_OF_BOUNDS = 41,
00100 DBUS_INVALID_VARIANT_SIGNATURE_BAD = 42,
00101 DBUS_INVALID_VARIANT_SIGNATURE_EMPTY = 43,
00102 DBUS_INVALID_VARIANT_SIGNATURE_SPECIFIES_MULTIPLE_VALUES = 44,
00103 DBUS_INVALID_VARIANT_SIGNATURE_MISSING_NUL = 45,
00104 DBUS_INVALID_STRING_MISSING_NUL = 46,
00105 DBUS_INVALID_SIGNATURE_MISSING_NUL = 47,
00106 DBUS_INVALID_EXCEEDED_MAXIMUM_DICT_ENTRY_RECURSION = 48,
00107 DBUS_INVALID_DICT_ENTRY_ENDED_BUT_NOT_STARTED = 49,
00108 DBUS_INVALID_DICT_ENTRY_STARTED_BUT_NOT_ENDED = 50,
00109 DBUS_INVALID_DICT_ENTRY_HAS_NO_FIELDS = 51,
00110 DBUS_INVALID_DICT_ENTRY_HAS_ONLY_ONE_FIELD = 52,
00111 DBUS_INVALID_DICT_ENTRY_HAS_TOO_MANY_FIELDS = 53,
00112 DBUS_INVALID_DICT_ENTRY_NOT_INSIDE_ARRAY = 54,
00113 DBUS_INVALID_DICT_KEY_MUST_BE_BASIC_TYPE = 55,
00114 DBUS_INVALID_MISSING_UNIX_FDS = 56,
00115 DBUS_INVALID_NESTED_TOO_DEEPLY = 57,
00116 DBUS_VALIDITY_LAST
00117 } DBusValidity;
00118
00119 DBusValidity _dbus_validate_signature_with_reason (const DBusString *type_str,
00120 int type_pos,
00121 int len);
00122 DBusValidity _dbus_validate_body_with_reason (const DBusString *expected_signature,
00123 int expected_signature_start,
00124 int byte_order,
00125 int *bytes_remaining,
00126 const DBusString *value_str,
00127 int value_pos,
00128 int len);
00129
00130 const char *_dbus_validity_to_error_message (DBusValidity validity);
00131
00132 dbus_bool_t _dbus_validate_path (const DBusString *str,
00133 int start,
00134 int len);
00135 dbus_bool_t _dbus_validate_interface (const DBusString *str,
00136 int start,
00137 int len);
00138 dbus_bool_t _dbus_validate_member (const DBusString *str,
00139 int start,
00140 int len);
00141 dbus_bool_t _dbus_validate_error_name (const DBusString *str,
00142 int start,
00143 int len);
00144 dbus_bool_t _dbus_validate_bus_name (const DBusString *str,
00145 int start,
00146 int len);
00147 dbus_bool_t _dbus_validate_signature (const DBusString *str,
00148 int start,
00149 int len);
00150
00151 #ifdef DBUS_DISABLE_CHECKS
00152
00153
00154
00155
00156 #define DECLARE_DBUS_NAME_CHECK(what)
00157 #define DEFINE_DBUS_NAME_CHECK(what)
00158
00159 #else
00160
00164 #define DECLARE_DBUS_NAME_CHECK(what) \
00165 dbus_bool_t _dbus_check_is_valid_##what (const char *name)
00166
00169 #define DEFINE_DBUS_NAME_CHECK(what) \
00170 dbus_bool_t \
00171 _dbus_check_is_valid_##what (const char *name) \
00172 { \
00173 DBusString str; \
00174 \
00175 if (name == NULL) \
00176 return FALSE; \
00177 \
00178 _dbus_string_init_const (&str, name); \
00179 return _dbus_validate_##what (&str, 0, \
00180 _dbus_string_get_length (&str)); \
00181 }
00182 #endif
00183
00185 DECLARE_DBUS_NAME_CHECK(path);
00187 DECLARE_DBUS_NAME_CHECK(interface);
00189 DECLARE_DBUS_NAME_CHECK(member);
00191 DECLARE_DBUS_NAME_CHECK(error_name);
00193 DECLARE_DBUS_NAME_CHECK(bus_name);
00195 DECLARE_DBUS_NAME_CHECK(signature);
00196
00199 #endif