1#ifndef HEADER_CURL_DYNBUF_H
2#define HEADER_CURL_DYNBUF_H
3/***************************************************************************
4 * _ _ ____ _
5 * Project ___| | | | _ \| |
6 * / __| | | | |_) | |
7 * | (__| |_| | _ <| |___
8 * \___|\___/|_| \_\_____|
9 *
10 * Copyright (C) 2020 - 2022, Daniel Stenberg, <[email protected]>, et al.
11 *
12 * This software is licensed as described in the file COPYING, which
13 * you should have received as part of this distribution. The terms
14 * are also available at https://curl.se/docs/copyright.html.
15 *
16 * You may opt to use, copy, modify, merge, publish, distribute and/or sell
17 * copies of the Software, and permit persons to whom the Software is
18 * furnished to do so, under the terms of the COPYING file.
19 *
20 * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
21 * KIND, either express or implied.
22 *
23 * SPDX-License-Identifier: curl
24 *
25 ***************************************************************************/
26
27#ifndef BUILDING_LIBCURL
28/* this renames the functions so that the tool code can use the same code
29 without getting symbol collisions */
30#define Curl_dyn_init(a,b) curlx_dyn_init(a,b)
31#define Curl_dyn_add(a,b) curlx_dyn_add(a,b)
32#define Curl_dyn_addn(a,b,c) curlx_dyn_addn(a,b,c)
33#define Curl_dyn_addf curlx_dyn_addf
34#define Curl_dyn_vaddf curlx_dyn_vaddf
35#define Curl_dyn_free(a) curlx_dyn_free(a)
36#define Curl_dyn_ptr(a) curlx_dyn_ptr(a)
37#define Curl_dyn_uptr(a) curlx_dyn_uptr(a)
38#define Curl_dyn_len(a) curlx_dyn_len(a)
39#define Curl_dyn_reset(a) curlx_dyn_reset(a)
40#define Curl_dyn_tail(a,b) curlx_dyn_tail(a,b)
41#define curlx_dynbuf dynbuf /* for the struct name */
42#endif
43
44struct dynbuf {
45 char *bufr; /* point to a null-terminated allocated buffer */
46 size_t leng; /* number of bytes *EXCLUDING* the zero terminator */
47 size_t allc; /* size of the current allocation */
48 size_t toobig; /* size limit for the buffer */
49#ifdef DEBUGBUILD
50 int init; /* detect API usage mistakes */
51#endif
52};
53
54void Curl_dyn_init(struct dynbuf *s, size_t toobig);
55void Curl_dyn_free(struct dynbuf *s);
56CURLcode Curl_dyn_addn(struct dynbuf *s, const void *mem, size_t len)
57 WARN_UNUSED_RESULT;
58CURLcode Curl_dyn_add(struct dynbuf *s, const char *str)
59 WARN_UNUSED_RESULT;
60CURLcode Curl_dyn_addf(struct dynbuf *s, const char *fmt, ...)
61 WARN_UNUSED_RESULT;
62CURLcode Curl_dyn_vaddf(struct dynbuf *s, const char *fmt, va_list ap)
63 WARN_UNUSED_RESULT;
64void Curl_dyn_reset(struct dynbuf *s);
65CURLcode Curl_dyn_tail(struct dynbuf *s, size_t trail);
66char *Curl_dyn_ptr(const struct dynbuf *s);
67unsigned char *Curl_dyn_uptr(const struct dynbuf *s);
68size_t Curl_dyn_len(const struct dynbuf *s);
69
70/* returns 0 on success, -1 on error */
71/* The implementation of this function exists in mprintf.c */
72int Curl_dyn_vprintf(struct dynbuf *dyn, const char *format, va_list ap_save);
73
74/* Dynamic buffer max sizes */
75#define DYN_DOH_RESPONSE 3000
76#define DYN_DOH_CNAME 256
77#define DYN_PAUSE_BUFFER (64 * 1024 * 1024)
78#define DYN_HAXPROXY 2048
79#define DYN_HTTP_REQUEST (1024*1024)
80#define DYN_H2_HEADERS (128*1024)
81#define DYN_H2_TRAILERS (128*1024)
82#define DYN_APRINTF 8000000
83#define DYN_RTSP_REQ_HEADER (64*1024)
84#define DYN_TRAILERS (64*1024)
85#define DYN_PROXY_CONNECT_HEADERS 16384
86#define DYN_QLOG_NAME 1024
87#define DYN_H1_TRAILER 4096
88#define DYN_PINGPPONG_CMD (64*1024)
89#define DYN_IMAP_CMD (64*1024)
90#endif
91