D-Bus 1.6.12
|
00001 /* -*- mode: C; c-file-style: "gnu"; indent-tabs-mode: nil; -*- */ 00002 /* dbus-marshal-validate.h Validation routines for marshaled data 00003 * 00004 * Copyright (C) 2005 Red Hat, Inc. 00005 * 00006 * Licensed under the Academic Free License version 2.1 00007 * 00008 * This program is free software; you can redistribute it and/or modify 00009 * it under the terms of the GNU General Public License as published by 00010 * the Free Software Foundation; either version 2 of the License, or 00011 * (at your option) any later version. 00012 * 00013 * This program is distributed in the hope that it will be useful, 00014 * but WITHOUT ANY WARRANTY; without even the implied warranty of 00015 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the 00016 * GNU General Public License for more details. 00017 * 00018 * You should have received a copy of the GNU General Public License 00019 * along with this program; if not, write to the Free Software 00020 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA 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, /* this one is impossible right now since 00060 * you can't put a too-long value in a byte 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_bus_namespace (const DBusString *str, 00148 int start, 00149 int len); 00150 dbus_bool_t _dbus_validate_signature (const DBusString *str, 00151 int start, 00152 int len); 00153 /* just to have a name consistent with the above: */ 00154 #define _dbus_validate_utf8(s,b,e) _dbus_string_validate_utf8 (s, b, e) 00155 00156 #ifdef DBUS_DISABLE_CHECKS 00157 00158 /* Be sure they don't exist, since we don't want to use them outside of checks 00159 * and so we want the compile failure. 00160 */ 00161 #define DECLARE_DBUS_NAME_CHECK(what) 00162 #define DEFINE_DBUS_NAME_CHECK(what) 00163 00164 #else /* !DBUS_DISABLE_CHECKS */ 00165 00169 #define DECLARE_DBUS_NAME_CHECK(what) \ 00170 dbus_bool_t _dbus_check_is_valid_##what (const char *name) 00171 00174 #define DEFINE_DBUS_NAME_CHECK(what) \ 00175 dbus_bool_t \ 00176 _dbus_check_is_valid_##what (const char *name) \ 00177 { \ 00178 DBusString str; \ 00179 \ 00180 if (name == NULL) \ 00181 return FALSE; \ 00182 \ 00183 _dbus_string_init_const (&str, name); \ 00184 return _dbus_validate_##what (&str, 0, \ 00185 _dbus_string_get_length (&str)); \ 00186 } 00187 #endif /* !DBUS_DISABLE_CHECKS */ 00188 00190 DECLARE_DBUS_NAME_CHECK(path); 00192 DECLARE_DBUS_NAME_CHECK(interface); 00194 DECLARE_DBUS_NAME_CHECK(member); 00196 DECLARE_DBUS_NAME_CHECK(error_name); 00198 DECLARE_DBUS_NAME_CHECK(bus_name); 00200 DECLARE_DBUS_NAME_CHECK(signature); 00202 DECLARE_DBUS_NAME_CHECK(utf8); 00203 00206 #endif /* DBUS_MARSHAL_VALIDATE_H */