buffers.h 4.1 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109
  1. /* Copyright (c) 2001 Matej Pfajfar.
  2. * Copyright (c) 2001-2004, Roger Dingledine.
  3. * Copyright (c) 2004-2006, Roger Dingledine, Nick Mathewson.
  4. * Copyright (c) 2007-2017, The Tor Project, Inc. */
  5. /* See LICENSE for licensing information */
  6. /**
  7. * \file buffers.h
  8. * \brief Header file for buffers.c.
  9. **/
  10. #ifndef TOR_BUFFERS_H
  11. #define TOR_BUFFERS_H
  12. #include "testsupport.h"
  13. buf_t *buf_new(void);
  14. buf_t *buf_new_with_capacity(size_t size);
  15. size_t buf_get_default_chunk_size(const buf_t *buf);
  16. void buf_free(buf_t *buf);
  17. void buf_clear(buf_t *buf);
  18. buf_t *buf_copy(const buf_t *buf);
  19. MOCK_DECL(size_t, buf_datalen, (const buf_t *buf));
  20. size_t buf_allocation(const buf_t *buf);
  21. size_t buf_slack(const buf_t *buf);
  22. uint32_t buf_get_oldest_chunk_timestamp(const buf_t *buf, uint32_t now);
  23. size_t buf_get_total_allocation(void);
  24. int read_to_buf(tor_socket_t s, size_t at_most, buf_t *buf, int *reached_eof,
  25. int *socket_error);
  26. int read_to_buf_tls(tor_tls_t *tls, size_t at_most, buf_t *buf);
  27. int flush_buf(tor_socket_t s, buf_t *buf, size_t sz, size_t *buf_flushlen);
  28. int flush_buf_tls(tor_tls_t *tls, buf_t *buf, size_t sz, size_t *buf_flushlen);
  29. int write_to_buf(const char *string, size_t string_len, buf_t *buf);
  30. int write_to_buf_zlib(buf_t *buf, tor_zlib_state_t *state,
  31. const char *data, size_t data_len, int done);
  32. int move_buf_to_buf(buf_t *buf_out, buf_t *buf_in, size_t *buf_flushlen);
  33. int fetch_from_buf(char *string, size_t string_len, buf_t *buf);
  34. int fetch_var_cell_from_buf(buf_t *buf, var_cell_t **out, int linkproto);
  35. int fetch_from_buf_http(buf_t *buf,
  36. char **headers_out, size_t max_headerlen,
  37. char **body_out, size_t *body_used, size_t max_bodylen,
  38. int force_complete);
  39. socks_request_t *socks_request_new(void);
  40. void socks_request_free(socks_request_t *req);
  41. int fetch_from_buf_socks(buf_t *buf, socks_request_t *req,
  42. int log_sockstype, int safe_socks);
  43. int fetch_from_buf_socks_client(buf_t *buf, int state, char **reason);
  44. int fetch_from_buf_line(buf_t *buf, char *data_out, size_t *data_len);
  45. int peek_buf_has_control0_command(buf_t *buf);
  46. int fetch_ext_or_command_from_buf(buf_t *buf, ext_or_cmd_t **out);
  47. int buf_set_to_copy(buf_t **output,
  48. const buf_t *input);
  49. void assert_buf_ok(buf_t *buf);
  50. #ifdef BUFFERS_PRIVATE
  51. STATIC int buf_find_string_offset(const buf_t *buf, const char *s, size_t n);
  52. STATIC void buf_pullup(buf_t *buf, size_t bytes);
  53. #ifdef TOR_UNIT_TESTS
  54. void buf_get_first_chunk_data(const buf_t *buf, const char **cp, size_t *sz);
  55. buf_t *buf_new_with_data(const char *cp, size_t sz);
  56. #endif
  57. STATIC size_t preferred_chunk_size(size_t target);
  58. #define DEBUG_CHUNK_ALLOC
  59. /** A single chunk on a buffer. */
  60. typedef struct chunk_t {
  61. struct chunk_t *next; /**< The next chunk on the buffer. */
  62. size_t datalen; /**< The number of bytes stored in this chunk */
  63. size_t memlen; /**< The number of usable bytes of storage in <b>mem</b>. */
  64. #ifdef DEBUG_CHUNK_ALLOC
  65. size_t DBG_alloc;
  66. #endif
  67. char *data; /**< A pointer to the first byte of data stored in <b>mem</b>. */
  68. uint32_t inserted_time; /**< Timestamp in truncated ms since epoch
  69. * when this chunk was inserted. */
  70. char mem[FLEXIBLE_ARRAY_MEMBER]; /**< The actual memory used for storage in
  71. * this chunk. */
  72. } chunk_t;
  73. /** Magic value for buf_t.magic, to catch pointer errors. */
  74. #define BUFFER_MAGIC 0xB0FFF312u
  75. /** A resizeable buffer, optimized for reading and writing. */
  76. struct buf_t {
  77. uint32_t magic; /**< Magic cookie for debugging: Must be set to
  78. * BUFFER_MAGIC. */
  79. size_t datalen; /**< How many bytes is this buffer holding right now? */
  80. size_t default_chunk_size; /**< Don't allocate any chunks smaller than
  81. * this for this buffer. */
  82. chunk_t *head; /**< First chunk in the list, or NULL for none. */
  83. chunk_t *tail; /**< Last chunk in the list, or NULL for none. */
  84. };
  85. #endif
  86. #ifdef BUFFERS_PRIVATE
  87. STATIC int buf_http_find_content_length(const char *headers, size_t headerlen,
  88. size_t *result_out);
  89. #endif
  90. #endif