MQTTProperties.c 15 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517
  1. /*******************************************************************************
  2. * Copyright (c) 2017, 2019 IBM Corp.
  3. *
  4. * All rights reserved. This program and the accompanying materials
  5. * are made available under the terms of the Eclipse Public License v1.0
  6. * and Eclipse Distribution License v1.0 which accompany this distribution.
  7. *
  8. * The Eclipse Public License is available at
  9. * http://www.eclipse.org/legal/epl-v10.html
  10. * and the Eclipse Distribution License is available at
  11. * http://www.eclipse.org/org/documents/edl-v10.php.
  12. *
  13. * Contributors:
  14. * Ian Craggs - initial API and implementation and/or initial documentation
  15. *******************************************************************************/
  16. #include "MQTTProperties.h"
  17. #include "MQTTPacket.h"
  18. #include "MQTTProtocolClient.h"
  19. #include "Heap.h"
  20. #include "StackTrace.h"
  21. #include <memory.h>
  22. #define ARRAY_SIZE(a) (sizeof(a) / sizeof(a[0]))
  23. static struct nameToType
  24. {
  25. enum MQTTPropertyCodes name;
  26. enum MQTTPropertyTypes type;
  27. } namesToTypes[] =
  28. {
  29. {MQTTPROPERTY_CODE_PAYLOAD_FORMAT_INDICATOR, MQTTPROPERTY_TYPE_BYTE},
  30. {MQTTPROPERTY_CODE_MESSAGE_EXPIRY_INTERVAL, MQTTPROPERTY_TYPE_FOUR_BYTE_INTEGER},
  31. {MQTTPROPERTY_CODE_CONTENT_TYPE, MQTTPROPERTY_TYPE_UTF_8_ENCODED_STRING},
  32. {MQTTPROPERTY_CODE_RESPONSE_TOPIC, MQTTPROPERTY_TYPE_UTF_8_ENCODED_STRING},
  33. {MQTTPROPERTY_CODE_CORRELATION_DATA, MQTTPROPERTY_TYPE_BINARY_DATA},
  34. {MQTTPROPERTY_CODE_SUBSCRIPTION_IDENTIFIER, MQTTPROPERTY_TYPE_VARIABLE_BYTE_INTEGER},
  35. {MQTTPROPERTY_CODE_SESSION_EXPIRY_INTERVAL, MQTTPROPERTY_TYPE_FOUR_BYTE_INTEGER},
  36. {MQTTPROPERTY_CODE_ASSIGNED_CLIENT_IDENTIFER, MQTTPROPERTY_TYPE_UTF_8_ENCODED_STRING},
  37. {MQTTPROPERTY_CODE_SERVER_KEEP_ALIVE, MQTTPROPERTY_TYPE_TWO_BYTE_INTEGER},
  38. {MQTTPROPERTY_CODE_AUTHENTICATION_METHOD, MQTTPROPERTY_TYPE_UTF_8_ENCODED_STRING},
  39. {MQTTPROPERTY_CODE_AUTHENTICATION_DATA, MQTTPROPERTY_TYPE_BINARY_DATA},
  40. {MQTTPROPERTY_CODE_REQUEST_PROBLEM_INFORMATION, MQTTPROPERTY_TYPE_BYTE},
  41. {MQTTPROPERTY_CODE_WILL_DELAY_INTERVAL, MQTTPROPERTY_TYPE_FOUR_BYTE_INTEGER},
  42. {MQTTPROPERTY_CODE_REQUEST_RESPONSE_INFORMATION, MQTTPROPERTY_TYPE_BYTE},
  43. {MQTTPROPERTY_CODE_RESPONSE_INFORMATION, MQTTPROPERTY_TYPE_UTF_8_ENCODED_STRING},
  44. {MQTTPROPERTY_CODE_SERVER_REFERENCE, MQTTPROPERTY_TYPE_UTF_8_ENCODED_STRING},
  45. {MQTTPROPERTY_CODE_REASON_STRING, MQTTPROPERTY_TYPE_UTF_8_ENCODED_STRING},
  46. {MQTTPROPERTY_CODE_RECEIVE_MAXIMUM, MQTTPROPERTY_TYPE_TWO_BYTE_INTEGER},
  47. {MQTTPROPERTY_CODE_TOPIC_ALIAS_MAXIMUM, MQTTPROPERTY_TYPE_TWO_BYTE_INTEGER},
  48. {MQTTPROPERTY_CODE_TOPIC_ALIAS, MQTTPROPERTY_TYPE_TWO_BYTE_INTEGER},
  49. {MQTTPROPERTY_CODE_MAXIMUM_QOS, MQTTPROPERTY_TYPE_BYTE},
  50. {MQTTPROPERTY_CODE_RETAIN_AVAILABLE, MQTTPROPERTY_TYPE_BYTE},
  51. {MQTTPROPERTY_CODE_USER_PROPERTY, MQTTPROPERTY_TYPE_UTF_8_STRING_PAIR},
  52. {MQTTPROPERTY_CODE_MAXIMUM_PACKET_SIZE, MQTTPROPERTY_TYPE_FOUR_BYTE_INTEGER},
  53. {MQTTPROPERTY_CODE_WILDCARD_SUBSCRIPTION_AVAILABLE, MQTTPROPERTY_TYPE_BYTE},
  54. {MQTTPROPERTY_CODE_SUBSCRIPTION_IDENTIFIERS_AVAILABLE, MQTTPROPERTY_TYPE_BYTE},
  55. {MQTTPROPERTY_CODE_SHARED_SUBSCRIPTION_AVAILABLE, MQTTPROPERTY_TYPE_BYTE}
  56. };
  57. static char* datadup(const MQTTLenString* str)
  58. {
  59. char* temp = malloc(str->len);
  60. memcpy(temp, str->data, str->len);
  61. return temp;
  62. }
  63. int MQTTProperty_getType(enum MQTTPropertyCodes value)
  64. {
  65. int i, rc = -1;
  66. for (i = 0; i < ARRAY_SIZE(namesToTypes); ++i)
  67. {
  68. if (namesToTypes[i].name == value)
  69. {
  70. rc = namesToTypes[i].type;
  71. break;
  72. }
  73. }
  74. return rc;
  75. }
  76. int MQTTProperties_len(MQTTProperties* props)
  77. {
  78. /* properties length is an mbi */
  79. return (props == NULL) ? 1 : props->length + MQTTPacket_VBIlen(props->length);
  80. }
  81. int MQTTProperties_add(MQTTProperties* props, const MQTTProperty* prop)
  82. {
  83. int rc = 0, type;
  84. if ((type = MQTTProperty_getType(prop->identifier)) < 0)
  85. {
  86. /*StackTrace_printStack(stdout);*/
  87. rc = MQTT_INVALID_PROPERTY_ID;
  88. goto exit;
  89. }
  90. else if (props->array == NULL)
  91. {
  92. props->max_count = 10;
  93. props->array = malloc(sizeof(MQTTProperty) * props->max_count);
  94. }
  95. else if (props->count == props->max_count)
  96. {
  97. props->max_count += 10;
  98. props->array = realloc(props->array, sizeof(MQTTProperty) * props->max_count);
  99. }
  100. if (props->array)
  101. {
  102. int len = 0;
  103. props->array[props->count++] = *prop;
  104. /* calculate length */
  105. switch (type)
  106. {
  107. case MQTTPROPERTY_TYPE_BYTE:
  108. len = 1;
  109. break;
  110. case MQTTPROPERTY_TYPE_TWO_BYTE_INTEGER:
  111. len = 2;
  112. break;
  113. case MQTTPROPERTY_TYPE_FOUR_BYTE_INTEGER:
  114. len = 4;
  115. break;
  116. case MQTTPROPERTY_TYPE_VARIABLE_BYTE_INTEGER:
  117. len = MQTTPacket_VBIlen(prop->value.integer4);
  118. break;
  119. case MQTTPROPERTY_TYPE_BINARY_DATA:
  120. case MQTTPROPERTY_TYPE_UTF_8_ENCODED_STRING:
  121. case MQTTPROPERTY_TYPE_UTF_8_STRING_PAIR:
  122. len = 2 + prop->value.data.len;
  123. props->array[props->count-1].value.data.data = datadup(&prop->value.data);
  124. if (type == MQTTPROPERTY_TYPE_UTF_8_STRING_PAIR)
  125. {
  126. len += 2 + prop->value.value.len;
  127. props->array[props->count-1].value.value.data = datadup(&prop->value.value);
  128. }
  129. break;
  130. }
  131. props->length += len + 1; /* add identifier byte */
  132. }
  133. exit:
  134. return rc;
  135. }
  136. int MQTTProperty_write(char** pptr, MQTTProperty* prop)
  137. {
  138. int rc = -1,
  139. type = -1;
  140. type = MQTTProperty_getType(prop->identifier);
  141. if (type >= MQTTPROPERTY_TYPE_BYTE && type <= MQTTPROPERTY_TYPE_UTF_8_STRING_PAIR)
  142. {
  143. writeChar(pptr, prop->identifier);
  144. switch (type)
  145. {
  146. case MQTTPROPERTY_TYPE_BYTE:
  147. writeChar(pptr, prop->value.byte);
  148. rc = 1;
  149. break;
  150. case MQTTPROPERTY_TYPE_TWO_BYTE_INTEGER:
  151. writeInt(pptr, prop->value.integer2);
  152. rc = 2;
  153. break;
  154. case MQTTPROPERTY_TYPE_FOUR_BYTE_INTEGER:
  155. writeInt4(pptr, prop->value.integer4);
  156. rc = 4;
  157. break;
  158. case MQTTPROPERTY_TYPE_VARIABLE_BYTE_INTEGER:
  159. rc = MQTTPacket_encode(*pptr, prop->value.integer4);
  160. *pptr += rc;
  161. break;
  162. case MQTTPROPERTY_TYPE_BINARY_DATA:
  163. case MQTTPROPERTY_TYPE_UTF_8_ENCODED_STRING:
  164. writeMQTTLenString(pptr, prop->value.data);
  165. rc = prop->value.data.len + 2; /* include length field */
  166. break;
  167. case MQTTPROPERTY_TYPE_UTF_8_STRING_PAIR:
  168. writeMQTTLenString(pptr, prop->value.data);
  169. writeMQTTLenString(pptr, prop->value.value);
  170. rc = prop->value.data.len + prop->value.value.len + 4; /* include length fields */
  171. break;
  172. }
  173. }
  174. return rc + 1; /* include identifier byte */
  175. }
  176. int MQTTProperties_write(char** pptr, const MQTTProperties* properties)
  177. {
  178. int rc = -1;
  179. int i = 0, len = 0;
  180. /* write the entire property list length first */
  181. if (properties == NULL)
  182. {
  183. *pptr += MQTTPacket_encode(*pptr, 0);
  184. rc = 1;
  185. }
  186. else
  187. {
  188. *pptr += MQTTPacket_encode(*pptr, properties->length);
  189. len = rc = 1;
  190. for (i = 0; i < properties->count; ++i)
  191. {
  192. rc = MQTTProperty_write(pptr, &properties->array[i]);
  193. if (rc < 0)
  194. break;
  195. else
  196. len += rc;
  197. }
  198. if (rc >= 0)
  199. rc = len;
  200. }
  201. return rc;
  202. }
  203. int MQTTProperty_read(MQTTProperty* prop, char** pptr, char* enddata)
  204. {
  205. int type = -1,
  206. len = 0;
  207. prop->identifier = readChar(pptr);
  208. type = MQTTProperty_getType(prop->identifier);
  209. if (type >= MQTTPROPERTY_TYPE_BYTE && type <= MQTTPROPERTY_TYPE_UTF_8_STRING_PAIR)
  210. {
  211. switch (type)
  212. {
  213. case MQTTPROPERTY_TYPE_BYTE:
  214. prop->value.byte = readChar(pptr);
  215. len = 1;
  216. break;
  217. case MQTTPROPERTY_TYPE_TWO_BYTE_INTEGER:
  218. prop->value.integer2 = readInt(pptr);
  219. len = 2;
  220. break;
  221. case MQTTPROPERTY_TYPE_FOUR_BYTE_INTEGER:
  222. prop->value.integer4 = readInt4(pptr);
  223. len = 4;
  224. break;
  225. case MQTTPROPERTY_TYPE_VARIABLE_BYTE_INTEGER:
  226. len = MQTTPacket_decodeBuf(*pptr, &prop->value.integer4);
  227. *pptr += len;
  228. break;
  229. case MQTTPROPERTY_TYPE_BINARY_DATA:
  230. case MQTTPROPERTY_TYPE_UTF_8_ENCODED_STRING:
  231. case MQTTPROPERTY_TYPE_UTF_8_STRING_PAIR:
  232. len = MQTTLenStringRead(&prop->value.data, pptr, enddata);
  233. prop->value.data.data = datadup(&prop->value.data);
  234. if (type == MQTTPROPERTY_TYPE_UTF_8_STRING_PAIR)
  235. {
  236. len += MQTTLenStringRead(&prop->value.value, pptr, enddata);
  237. prop->value.value.data = datadup(&prop->value.value);
  238. }
  239. break;
  240. }
  241. }
  242. return len + 1; /* 1 byte for identifier */
  243. }
  244. int MQTTProperties_read(MQTTProperties* properties, char** pptr, char* enddata)
  245. {
  246. int rc = 0;
  247. unsigned int remlength = 0;
  248. FUNC_ENTRY;
  249. /* we assume an initialized properties structure */
  250. if (enddata - (*pptr) > 0) /* enough length to read the VBI? */
  251. {
  252. *pptr += MQTTPacket_decodeBuf(*pptr, &remlength);
  253. properties->length = remlength;
  254. while (remlength > 0)
  255. {
  256. if (properties->count == properties->max_count)
  257. {
  258. properties->max_count += 10;
  259. if (properties->max_count == 10)
  260. properties->array = malloc(sizeof(MQTTProperty) * properties->max_count);
  261. else
  262. properties->array = realloc(properties->array, sizeof(MQTTProperty) * properties->max_count);
  263. }
  264. remlength -= MQTTProperty_read(&properties->array[properties->count], pptr, enddata);
  265. properties->count++;
  266. }
  267. if (remlength == 0)
  268. rc = 1; /* data read successfully */
  269. }
  270. if (rc != 1 && properties->array != NULL)
  271. {
  272. free(properties->array);
  273. properties->array = NULL;
  274. properties->max_count = properties->count = 0;
  275. }
  276. FUNC_EXIT_RC(rc);
  277. return rc;
  278. }
  279. struct {
  280. enum MQTTPropertyCodes value;
  281. const char* name;
  282. } nameToString[] =
  283. {
  284. {MQTTPROPERTY_CODE_PAYLOAD_FORMAT_INDICATOR, "PAYLOAD_FORMAT_INDICATOR"},
  285. {MQTTPROPERTY_CODE_MESSAGE_EXPIRY_INTERVAL, "MESSAGE_EXPIRY_INTERVAL"},
  286. {MQTTPROPERTY_CODE_CONTENT_TYPE, "CONTENT_TYPE"},
  287. {MQTTPROPERTY_CODE_RESPONSE_TOPIC, "RESPONSE_TOPIC"},
  288. {MQTTPROPERTY_CODE_CORRELATION_DATA, "CORRELATION_DATA"},
  289. {MQTTPROPERTY_CODE_SUBSCRIPTION_IDENTIFIER, "SUBSCRIPTION_IDENTIFIER"},
  290. {MQTTPROPERTY_CODE_SESSION_EXPIRY_INTERVAL, "SESSION_EXPIRY_INTERVAL"},
  291. {MQTTPROPERTY_CODE_ASSIGNED_CLIENT_IDENTIFER, "ASSIGNED_CLIENT_IDENTIFER"},
  292. {MQTTPROPERTY_CODE_SERVER_KEEP_ALIVE, "SERVER_KEEP_ALIVE"},
  293. {MQTTPROPERTY_CODE_AUTHENTICATION_METHOD, "AUTHENTICATION_METHOD"},
  294. {MQTTPROPERTY_CODE_AUTHENTICATION_DATA, "AUTHENTICATION_DATA"},
  295. {MQTTPROPERTY_CODE_REQUEST_PROBLEM_INFORMATION, "REQUEST_PROBLEM_INFORMATION"},
  296. {MQTTPROPERTY_CODE_WILL_DELAY_INTERVAL, "WILL_DELAY_INTERVAL"},
  297. {MQTTPROPERTY_CODE_REQUEST_RESPONSE_INFORMATION, "REQUEST_RESPONSE_INFORMATION"},
  298. {MQTTPROPERTY_CODE_RESPONSE_INFORMATION, "RESPONSE_INFORMATION"},
  299. {MQTTPROPERTY_CODE_SERVER_REFERENCE, "SERVER_REFERENCE"},
  300. {MQTTPROPERTY_CODE_REASON_STRING, "REASON_STRING"},
  301. {MQTTPROPERTY_CODE_RECEIVE_MAXIMUM, "RECEIVE_MAXIMUM"},
  302. {MQTTPROPERTY_CODE_TOPIC_ALIAS_MAXIMUM, "TOPIC_ALIAS_MAXIMUM"},
  303. {MQTTPROPERTY_CODE_TOPIC_ALIAS, "TOPIC_ALIAS"},
  304. {MQTTPROPERTY_CODE_MAXIMUM_QOS, "MAXIMUM_QOS"},
  305. {MQTTPROPERTY_CODE_RETAIN_AVAILABLE, "RETAIN_AVAILABLE"},
  306. {MQTTPROPERTY_CODE_USER_PROPERTY, "USER_PROPERTY"},
  307. {MQTTPROPERTY_CODE_MAXIMUM_PACKET_SIZE, "MAXIMUM_PACKET_SIZE"},
  308. {MQTTPROPERTY_CODE_WILDCARD_SUBSCRIPTION_AVAILABLE, "WILDCARD_SUBSCRIPTION_AVAILABLE"},
  309. {MQTTPROPERTY_CODE_SUBSCRIPTION_IDENTIFIERS_AVAILABLE, "SUBSCRIPTION_IDENTIFIERS_AVAILABLE"},
  310. {MQTTPROPERTY_CODE_SHARED_SUBSCRIPTION_AVAILABLE, "SHARED_SUBSCRIPTION_AVAILABLE"}
  311. };
  312. const char* MQTTPropertyName(enum MQTTPropertyCodes value)
  313. {
  314. int i = 0;
  315. const char* result = NULL;
  316. for (i = 0; i < ARRAY_SIZE(nameToString); ++i)
  317. {
  318. if (nameToString[i].value == value)
  319. {
  320. result = nameToString[i].name;
  321. break;
  322. }
  323. }
  324. return result;
  325. }
  326. DLLExport void MQTTProperties_free(MQTTProperties* props)
  327. {
  328. int i = 0;
  329. FUNC_ENTRY;
  330. if (props == NULL)
  331. goto exit;
  332. for (i = 0; i < props->count; ++i)
  333. {
  334. int id = props->array[i].identifier;
  335. int type = MQTTProperty_getType(id);
  336. switch (type)
  337. {
  338. case MQTTPROPERTY_TYPE_BINARY_DATA:
  339. case MQTTPROPERTY_TYPE_UTF_8_ENCODED_STRING:
  340. case MQTTPROPERTY_TYPE_UTF_8_STRING_PAIR:
  341. free(props->array[i].value.data.data);
  342. if (type == MQTTPROPERTY_TYPE_UTF_8_STRING_PAIR)
  343. free(props->array[i].value.value.data);
  344. break;
  345. }
  346. }
  347. if (props->array)
  348. free(props->array);
  349. memset(props, '\0', sizeof(MQTTProperties)); /* zero all fields */
  350. exit:
  351. FUNC_EXIT;
  352. }
  353. MQTTProperties MQTTProperties_copy(const MQTTProperties* props)
  354. {
  355. int i = 0;
  356. MQTTProperties result = MQTTProperties_initializer;
  357. FUNC_ENTRY;
  358. for (i = 0; i < props->count; ++i)
  359. {
  360. int rc = 0;
  361. if ((rc = MQTTProperties_add(&result, &props->array[i])) != 0)
  362. Log(LOG_ERROR, -1, "Error from MQTTProperties add %d", rc);
  363. }
  364. FUNC_EXIT;
  365. return result;
  366. }
  367. int MQTTProperties_hasProperty(MQTTProperties *props, enum MQTTPropertyCodes propid)
  368. {
  369. int i = 0;
  370. int found = 0;
  371. for (i = 0; i < props->count; ++i)
  372. {
  373. if (propid == props->array[i].identifier)
  374. {
  375. found = 1;
  376. break;
  377. }
  378. }
  379. return found;
  380. }
  381. int MQTTProperties_propertyCount(MQTTProperties *props, enum MQTTPropertyCodes propid)
  382. {
  383. int i = 0;
  384. int count = 0;
  385. for (i = 0; i < props->count; ++i)
  386. {
  387. if (propid == props->array[i].identifier)
  388. count++;
  389. }
  390. return count;
  391. }
  392. int MQTTProperties_getNumericValueAt(MQTTProperties *props, enum MQTTPropertyCodes propid, int index)
  393. {
  394. int i = 0;
  395. int rc = -9999999;
  396. int cur_index = 0;
  397. for (i = 0; i < props->count; ++i)
  398. {
  399. int id = props->array[i].identifier;
  400. if (id == propid)
  401. {
  402. if (cur_index < index)
  403. {
  404. cur_index++;
  405. continue;
  406. }
  407. switch (MQTTProperty_getType(id))
  408. {
  409. case MQTTPROPERTY_TYPE_BYTE:
  410. rc = props->array[i].value.byte;
  411. break;
  412. case MQTTPROPERTY_TYPE_TWO_BYTE_INTEGER:
  413. rc = props->array[i].value.integer2;
  414. break;
  415. case MQTTPROPERTY_TYPE_FOUR_BYTE_INTEGER:
  416. case MQTTPROPERTY_TYPE_VARIABLE_BYTE_INTEGER:
  417. rc = props->array[i].value.integer4;
  418. break;
  419. default:
  420. rc = -999999;
  421. break;
  422. }
  423. break;
  424. }
  425. }
  426. return rc;
  427. }
  428. int MQTTProperties_getNumericValue(MQTTProperties *props, enum MQTTPropertyCodes propid)
  429. {
  430. return MQTTProperties_getNumericValueAt(props, propid, 0);
  431. }
  432. MQTTProperty* MQTTProperties_getPropertyAt(MQTTProperties *props, enum MQTTPropertyCodes propid, int index)
  433. {
  434. int i = 0;
  435. MQTTProperty* result = NULL;
  436. int cur_index = 0;
  437. for (i = 0; i < props->count; ++i)
  438. {
  439. int id = props->array[i].identifier;
  440. if (id == propid)
  441. {
  442. if (cur_index == index)
  443. {
  444. result = &props->array[i];
  445. break;
  446. }
  447. else
  448. cur_index++;
  449. }
  450. }
  451. return result;
  452. }
  453. MQTTProperty* MQTTProperties_getProperty(MQTTProperties *props, enum MQTTPropertyCodes propid)
  454. {
  455. return MQTTProperties_getPropertyAt(props, propid, 0);
  456. }