|
Tor 0.4.9.0-alpha-dev
|
Header file for buffers.c. More...
#include "lib/cc/compat_compiler.h"#include "lib/cc/torint.h"#include "lib/testsupport/testsupport.h"#include <stdarg.h>Go to the source code of this file.
Macros | |
| #define | buf_free(b) FREE_AND_NULL(buf_t, buf_free_, (b)) |
| #define | BUF_MAX_LEN (INT_MAX - 1) |
| #define | PEEK_BUF_STARTSWITH_MAX 16 |
Typedefs | |
| typedef struct buf_t | buf_t |
Functions | |
| buf_t * | buf_new (void) |
| buf_t * | buf_new_with_capacity (size_t size) |
| size_t | buf_get_default_chunk_size (const buf_t *buf) |
| void | buf_free_ (buf_t *buf) |
| void | buf_clear (buf_t *buf) |
| buf_t * | buf_copy (const buf_t *buf) |
| size_t | buf_datalen (const buf_t *buf) |
| size_t | buf_allocation (const buf_t *buf) |
| size_t | buf_slack (const buf_t *buf) |
| uint32_t | buf_get_oldest_chunk_timestamp (const buf_t *buf, uint32_t now) |
| size_t | buf_get_total_allocation (void) |
| int | buf_add (buf_t *buf, const char *string, size_t string_len) |
| void | buf_add_string (buf_t *buf, const char *string) |
| void | buf_add_printf (buf_t *buf, const char *format,...) |
| void | buf_add_vprintf (buf_t *buf, const char *format, va_list args) |
| int | buf_move_to_buf (buf_t *buf_out, buf_t *buf_in, size_t *buf_flushlen) |
| size_t | buf_move_all (buf_t *buf_out, buf_t *buf_in) |
| void | buf_peek (const buf_t *buf, char *string, size_t string_len) |
| void | buf_drain (buf_t *buf, size_t n) |
| int | buf_get_bytes (buf_t *buf, char *string, size_t string_len) |
| int | buf_get_line (buf_t *buf, char *data_out, size_t *data_len) |
| int | buf_peek_startswith (const buf_t *buf, const char *cmd) |
| int | buf_set_to_copy (buf_t **output, const buf_t *input) |
| void | buf_assert_ok (buf_t *buf) |
| int | buf_find_string_offset (const buf_t *buf, const char *s, size_t n) |
| void | buf_pullup (buf_t *buf, size_t bytes, const char **head_out, size_t *len_out) |
| char * | buf_extract (buf_t *buf, size_t *sz_out) |
| #define BUF_MAX_LEN (INT_MAX - 1) |
| int buf_add | ( | buf_t * | buf, |
| const char * | string, | ||
| size_t | string_len | ||
| ) |
Append string_len bytes from string to the end of buf.
Return the new length of the buffer on success, -1 on failure.
Definition at line 527 of file buffers.c.
Referenced by buf_add_string(), buf_add_vprintf(), connection_write_to_buf_impl_(), and process_write().
| void buf_add_printf | ( | buf_t * | buf, |
| const char * | format, | ||
| ... | |||
| ) |
As tor_snprintf, but write the results into a buf_t
Definition at line 568 of file buffers.c.
Referenced by prometheus_format_store_entry().
| void buf_add_string | ( | buf_t * | buf, |
| const char * | string | ||
| ) |
| void buf_add_vprintf | ( | buf_t * | buf, |
| const char * | format, | ||
| va_list | args | ||
| ) |
As tor_vsnprintf, but write the results into a buf_t.
Definition at line 578 of file buffers.c.
Referenced by buf_add_printf().
| size_t buf_allocation | ( | const buf_t * | buf | ) |
| void buf_assert_ok | ( | buf_t * | buf | ) |
| void buf_clear | ( | buf_t * | buf | ) |
Remove all data from buf.
Definition at line 381 of file buffers.c.
Referenced by buf_free_(), and fetch_from_buf_socks_client().
| buf_t * buf_copy | ( | const buf_t * | buf | ) |
| size_t buf_datalen | ( | const buf_t * | buf | ) |
Return the number of bytes stored in buf
Definition at line 394 of file buffers.c.
Referenced by buf_extract(), buf_move_all(), connection_bucket_write_limit(), connection_buf_add_buf(), connection_buf_read_from_socket(), connection_handle_read_impl(), connection_should_read_from_linked_conn(), fetch_ext_or_command_from_buf(), fetch_from_buf_http(), fetch_from_buf_socks(), fetch_from_buf_socks_client(), peek_buf_has_control0_command(), and process_unix_write().
| void buf_drain | ( | buf_t * | buf, |
| size_t | n | ||
| ) |
Remove the first n bytes from buf.
Definition at line 330 of file buffers.c.
Referenced by fetch_ext_or_command_from_buf(), fetch_from_buf_socks_client(), and flush_chunk_tls().
| char * buf_extract | ( | buf_t * | buf, |
| size_t * | sz_out | ||
| ) |
Return a heap-allocated string containing the contents of buf, plus a NUL byte. If sz_out is provided, set *sz_out to the length of the returned string, not including the terminating NUL.
Definition at line 592 of file buffers.c.
Referenced by bwhist_get_bandwidth_lines().
| int buf_find_string_offset | ( | const buf_t * | buf, |
| const char * | s, | ||
| size_t | n | ||
| ) |
Return the first position in buf at which the n-character string s occurs, or -1 if it does not occur.
Definition at line 815 of file buffers.c.
Referenced by fetch_from_buf_http().
| void buf_free_ | ( | buf_t * | buf | ) |
| int buf_get_bytes | ( | buf_t * | buf, |
| char * | string, | ||
| size_t | string_len | ||
| ) |
Remove string_len bytes from the front of buf, and store them into string. Return the new buffer size. string_len must be <= the number of bytes on the buffer.
Definition at line 637 of file buffers.c.
Referenced by buf_get_line(), connection_buf_get_bytes(), and fetch_ext_or_command_from_buf().
| int buf_get_line | ( | buf_t * | buf, |
| char * | data_out, | ||
| size_t * | data_len | ||
| ) |
Try to read a single LF-terminated line from buf, and write it (including the LF), NUL-terminated, into the *data_len byte buffer at data_out. Set *data_len to the number of bytes in the line, not counting the terminating NUL. Return 1 if we read a whole line, return 0 if we don't have a whole line yet, and return -1 if the line length exceeds *data_len.
Definition at line 874 of file buffers.c.
Referenced by connection_buf_get_line().
| uint32_t buf_get_oldest_chunk_timestamp | ( | const buf_t * | buf, |
| uint32_t | now | ||
| ) |
Return the age of the oldest chunk in the buffer buf, in timestamp units. Requires the current monotonic timestamp as its input now.
Definition at line 506 of file buffers.c.
Referenced by conn_get_buffer_age().
| size_t buf_move_all | ( | buf_t * | buf_out, |
| buf_t * | buf_in | ||
| ) |
Moves all data from buf_in to buf_out, without copying. Return the number of bytes that were moved.
Definition at line 691 of file buffers.c.
Referenced by connection_buf_add_buf().
| int buf_move_to_buf | ( | buf_t * | buf_out, |
| buf_t * | buf_in, | ||
| size_t * | buf_flushlen | ||
| ) |
| buf_t * buf_new | ( | void | ) |
Allocate and return a new buffer with default capacity.
Definition at line 365 of file buffers.c.
Referenced by buf_copy(), buf_new_with_capacity(), bwhist_get_bandwidth_lines(), and metrics_get_output().
| buf_t * buf_new_with_capacity | ( | size_t | size | ) |
| void buf_peek | ( | const buf_t * | buf, |
| char * | string, | ||
| size_t | string_len | ||
| ) |
Helper: copy the first string_len bytes from buf onto string.
Definition at line 610 of file buffers.c.
Referenced by fetch_ext_or_command_from_buf(), and peek_buf_has_control0_command().
| int buf_peek_startswith | ( | const buf_t * | buf, |
| const char * | cmd | ||
| ) |
Return 1 iff buf starts with cmd. cmd must be a null terminated string, of no more than PEEK_BUF_STARTSWITH_MAX bytes.
Definition at line 834 of file buffers.c.
Referenced by peek_buf_has_http_command().
| void buf_pullup | ( | buf_t * | buf, |
| size_t | bytes, | ||
| const char ** | head_out, | ||
| size_t * | len_out | ||
| ) |
Collapse data from the first N chunks from buf into buf->head, growing it as necessary, until buf->head has the first bytes bytes of data from the buffer, or until buf->head has all the data in buf.
Set *head_out to point to the first byte of available data, and *len_out to the number of bytes of data available at *head_out. Note that *len_out may be more or less than bytes, depending on the number of bytes available.
Definition at line 211 of file buffers.c.
Referenced by fetch_from_buf_socks_client().
| int buf_set_to_copy | ( | buf_t ** | output, |
| const buf_t * | input | ||
| ) |
| size_t buf_slack | ( | const buf_t * | buf | ) |
Return the number of bytes that can be added to buf without performing any additional allocation.
Definition at line 414 of file buffers.c.
Referenced by connection_buf_read_from_socket().
1.9.4