wpabuf.h 4.1 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164
  1. /*
  2. * Dynamic data buffer
  3. * Copyright (c) 2007-2012, Jouni Malinen <j@w1.fi>
  4. *
  5. * This software may be distributed under the terms of the BSD license.
  6. * See README for more details.
  7. */
  8. #ifndef WPABUF_H
  9. #define WPABUF_H
  10. /* wpabuf::buf is a pointer to external data */
  11. #define WPABUF_FLAG_EXT_DATA BIT(0)
  12. /*
  13. * Internal data structure for wpabuf. Please do not touch this directly from
  14. * elsewhere. This is only defined in header file to allow inline functions
  15. * from this file to access data.
  16. */
  17. struct wpabuf {
  18. size_t size; /* total size of the allocated buffer */
  19. size_t used; /* length of data in the buffer */
  20. u8 *buf; /* pointer to the head of the buffer */
  21. unsigned int flags;
  22. /* optionally followed by the allocated buffer */
  23. };
  24. int wpabuf_resize(struct wpabuf **buf, size_t add_len);
  25. struct wpabuf * wpabuf_alloc(size_t len);
  26. struct wpabuf * wpabuf_alloc_ext_data(u8 *data, size_t len);
  27. struct wpabuf * wpabuf_alloc_copy(const void *data, size_t len);
  28. struct wpabuf * wpabuf_dup(const struct wpabuf *src);
  29. void wpabuf_free(struct wpabuf *buf);
  30. void wpabuf_clear_free(struct wpabuf *buf);
  31. void * wpabuf_put(struct wpabuf *buf, size_t len);
  32. struct wpabuf * wpabuf_concat(struct wpabuf *a, struct wpabuf *b);
  33. struct wpabuf * wpabuf_zeropad(struct wpabuf *buf, size_t len);
  34. void wpabuf_printf(struct wpabuf *buf, char *fmt, ...) PRINTF_FORMAT(2, 3);
  35. struct wpabuf * wpabuf_parse_bin(const char *buf);
  36. /**
  37. * wpabuf_size - Get the currently allocated size of a wpabuf buffer
  38. * @buf: wpabuf buffer
  39. * Returns: Currently allocated size of the buffer
  40. */
  41. static inline size_t wpabuf_size(const struct wpabuf *buf)
  42. {
  43. return buf->size;
  44. }
  45. /**
  46. * wpabuf_len - Get the current length of a wpabuf buffer data
  47. * @buf: wpabuf buffer
  48. * Returns: Currently used length of the buffer
  49. */
  50. static inline size_t wpabuf_len(const struct wpabuf *buf)
  51. {
  52. return buf->used;
  53. }
  54. /**
  55. * wpabuf_tailroom - Get size of available tail room in the end of the buffer
  56. * @buf: wpabuf buffer
  57. * Returns: Tail room (in bytes) of available space in the end of the buffer
  58. */
  59. static inline size_t wpabuf_tailroom(const struct wpabuf *buf)
  60. {
  61. return buf->size - buf->used;
  62. }
  63. /**
  64. * wpabuf_head - Get pointer to the head of the buffer data
  65. * @buf: wpabuf buffer
  66. * Returns: Pointer to the head of the buffer data
  67. */
  68. static inline const void * wpabuf_head(const struct wpabuf *buf)
  69. {
  70. return buf->buf;
  71. }
  72. static inline const u8 * wpabuf_head_u8(const struct wpabuf *buf)
  73. {
  74. return (const u8 *) wpabuf_head(buf);
  75. }
  76. /**
  77. * wpabuf_mhead - Get modifiable pointer to the head of the buffer data
  78. * @buf: wpabuf buffer
  79. * Returns: Pointer to the head of the buffer data
  80. */
  81. static inline void * wpabuf_mhead(struct wpabuf *buf)
  82. {
  83. return buf->buf;
  84. }
  85. static inline u8 * wpabuf_mhead_u8(struct wpabuf *buf)
  86. {
  87. return (u8 *) wpabuf_mhead(buf);
  88. }
  89. static inline void wpabuf_put_u8(struct wpabuf *buf, u8 data)
  90. {
  91. u8 *pos = (u8 *) wpabuf_put(buf, 1);
  92. *pos = data;
  93. }
  94. static inline void wpabuf_put_le16(struct wpabuf *buf, u16 data)
  95. {
  96. u8 *pos = (u8 *) wpabuf_put(buf, 2);
  97. WPA_PUT_LE16(pos, data);
  98. }
  99. static inline void wpabuf_put_le32(struct wpabuf *buf, u32 data)
  100. {
  101. u8 *pos = (u8 *) wpabuf_put(buf, 4);
  102. WPA_PUT_LE32(pos, data);
  103. }
  104. static inline void wpabuf_put_be16(struct wpabuf *buf, u16 data)
  105. {
  106. u8 *pos = (u8 *) wpabuf_put(buf, 2);
  107. WPA_PUT_BE16(pos, data);
  108. }
  109. static inline void wpabuf_put_be24(struct wpabuf *buf, u32 data)
  110. {
  111. u8 *pos = (u8 *) wpabuf_put(buf, 3);
  112. WPA_PUT_BE24(pos, data);
  113. }
  114. static inline void wpabuf_put_be32(struct wpabuf *buf, u32 data)
  115. {
  116. u8 *pos = (u8 *) wpabuf_put(buf, 4);
  117. WPA_PUT_BE32(pos, data);
  118. }
  119. static inline void wpabuf_put_data(struct wpabuf *buf, const void *data,
  120. size_t len)
  121. {
  122. if (data)
  123. os_memcpy(wpabuf_put(buf, len), data, len);
  124. }
  125. static inline void wpabuf_put_buf(struct wpabuf *dst,
  126. const struct wpabuf *src)
  127. {
  128. wpabuf_put_data(dst, wpabuf_head(src), wpabuf_len(src));
  129. }
  130. static inline void wpabuf_set(struct wpabuf *buf, const void *data, size_t len)
  131. {
  132. buf->buf = (u8 *) data;
  133. buf->flags = WPABUF_FLAG_EXT_DATA;
  134. buf->size = buf->used = len;
  135. }
  136. static inline void wpabuf_put_str(struct wpabuf *dst, const char *str)
  137. {
  138. wpabuf_put_data(dst, str, os_strlen(str));
  139. }
  140. #endif /* WPABUF_H */