mirror of
https://gitlab.torproject.org/tpo/core/tor.git
synced 2024-11-13 14:43:46 +01:00
c1359b32a4
This is to avoid having two sendme.{c|h} in the repository since the subsystem
is implemented in src/core/or/sendme.{c|h}.
Fixes #30769
Signed-off-by: David Goulet <dgoulet@torproject.org>
996 lines
47 KiB
C
996 lines
47 KiB
C
/* socks5.h -- generated by Trunnel v1.5.3.
|
|
* https://gitweb.torproject.org/trunnel.git
|
|
* You probably shouldn't edit this file.
|
|
*/
|
|
#ifndef TRUNNEL_SOCKS5_H
|
|
#define TRUNNEL_SOCKS5_H
|
|
|
|
#include <stdint.h>
|
|
#include "trunnel.h"
|
|
|
|
#define CMD_CONNECT 1
|
|
#define CMD_BIND 2
|
|
#define CMD_UDP_ASSOCIATE 3
|
|
#define CMD_RESOLVE 240
|
|
#define CMD_RESOLVE_PTR 241
|
|
#define ATYPE_IPV4 1
|
|
#define ATYPE_IPV6 4
|
|
#define ATYPE_DOMAINNAME 3
|
|
#if !defined(TRUNNEL_OPAQUE) && !defined(TRUNNEL_OPAQUE_DOMAINNAME)
|
|
struct domainname_st {
|
|
uint8_t len;
|
|
trunnel_string_t name;
|
|
uint8_t trunnel_error_code_;
|
|
};
|
|
#endif
|
|
typedef struct domainname_st domainname_t;
|
|
#if !defined(TRUNNEL_OPAQUE) && !defined(TRUNNEL_OPAQUE_SOCKS4_CLIENT_REQUEST)
|
|
struct socks4_client_request_st {
|
|
uint8_t version;
|
|
uint8_t command;
|
|
uint16_t port;
|
|
uint32_t addr;
|
|
char *username;
|
|
char *socks4a_addr_hostname;
|
|
uint8_t trunnel_error_code_;
|
|
};
|
|
#endif
|
|
typedef struct socks4_client_request_st socks4_client_request_t;
|
|
#if !defined(TRUNNEL_OPAQUE) && !defined(TRUNNEL_OPAQUE_SOCKS4_SERVER_REPLY)
|
|
struct socks4_server_reply_st {
|
|
uint8_t version;
|
|
uint8_t status;
|
|
uint16_t port;
|
|
uint32_t addr;
|
|
uint8_t trunnel_error_code_;
|
|
};
|
|
#endif
|
|
typedef struct socks4_server_reply_st socks4_server_reply_t;
|
|
#if !defined(TRUNNEL_OPAQUE) && !defined(TRUNNEL_OPAQUE_SOCKS5_CLIENT_USERPASS_AUTH)
|
|
struct socks5_client_userpass_auth_st {
|
|
uint8_t version;
|
|
uint8_t username_len;
|
|
trunnel_string_t username;
|
|
uint8_t passwd_len;
|
|
trunnel_string_t passwd;
|
|
uint8_t trunnel_error_code_;
|
|
};
|
|
#endif
|
|
typedef struct socks5_client_userpass_auth_st socks5_client_userpass_auth_t;
|
|
#if !defined(TRUNNEL_OPAQUE) && !defined(TRUNNEL_OPAQUE_SOCKS5_CLIENT_VERSION)
|
|
struct socks5_client_version_st {
|
|
uint8_t version;
|
|
uint8_t n_methods;
|
|
TRUNNEL_DYNARRAY_HEAD(, uint8_t) methods;
|
|
uint8_t trunnel_error_code_;
|
|
};
|
|
#endif
|
|
typedef struct socks5_client_version_st socks5_client_version_t;
|
|
#if !defined(TRUNNEL_OPAQUE) && !defined(TRUNNEL_OPAQUE_SOCKS5_SERVER_METHOD)
|
|
struct socks5_server_method_st {
|
|
uint8_t version;
|
|
uint8_t method;
|
|
uint8_t trunnel_error_code_;
|
|
};
|
|
#endif
|
|
typedef struct socks5_server_method_st socks5_server_method_t;
|
|
#if !defined(TRUNNEL_OPAQUE) && !defined(TRUNNEL_OPAQUE_SOCKS5_SERVER_USERPASS_AUTH)
|
|
struct socks5_server_userpass_auth_st {
|
|
uint8_t version;
|
|
uint8_t status;
|
|
uint8_t trunnel_error_code_;
|
|
};
|
|
#endif
|
|
typedef struct socks5_server_userpass_auth_st socks5_server_userpass_auth_t;
|
|
#if !defined(TRUNNEL_OPAQUE) && !defined(TRUNNEL_OPAQUE_SOCKS5_CLIENT_REQUEST)
|
|
struct socks5_client_request_st {
|
|
uint8_t version;
|
|
uint8_t command;
|
|
uint8_t reserved;
|
|
uint8_t atype;
|
|
uint32_t dest_addr_ipv4;
|
|
uint8_t dest_addr_ipv6[16];
|
|
struct domainname_st *dest_addr_domainname;
|
|
uint16_t dest_port;
|
|
uint8_t trunnel_error_code_;
|
|
};
|
|
#endif
|
|
typedef struct socks5_client_request_st socks5_client_request_t;
|
|
#if !defined(TRUNNEL_OPAQUE) && !defined(TRUNNEL_OPAQUE_SOCKS5_SERVER_REPLY)
|
|
struct socks5_server_reply_st {
|
|
uint8_t version;
|
|
uint8_t reply;
|
|
uint8_t reserved;
|
|
uint8_t atype;
|
|
uint32_t bind_addr_ipv4;
|
|
uint8_t bind_addr_ipv6[16];
|
|
struct domainname_st *bind_addr_domainname;
|
|
uint16_t bind_port;
|
|
uint8_t trunnel_error_code_;
|
|
};
|
|
#endif
|
|
typedef struct socks5_server_reply_st socks5_server_reply_t;
|
|
/** Return a newly allocated domainname with all elements set to zero.
|
|
*/
|
|
domainname_t *domainname_new(void);
|
|
/** Release all storage held by the domainname in 'victim'. (Do
|
|
* nothing if 'victim' is NULL.)
|
|
*/
|
|
void domainname_free(domainname_t *victim);
|
|
/** Try to parse a domainname from the buffer in 'input', using up to
|
|
* 'len_in' bytes from the input buffer. On success, return the number
|
|
* of bytes consumed and set *output to the newly allocated
|
|
* domainname_t. On failure, return -2 if the input appears truncated,
|
|
* and -1 if the input is otherwise invalid.
|
|
*/
|
|
ssize_t domainname_parse(domainname_t **output, const uint8_t *input, const size_t len_in);
|
|
/** Return the number of bytes we expect to need to encode the
|
|
* domainname in 'obj'. On failure, return a negative value. Note that
|
|
* this value may be an overestimate, and can even be an underestimate
|
|
* for certain unencodeable objects.
|
|
*/
|
|
ssize_t domainname_encoded_len(const domainname_t *obj);
|
|
/** Try to encode the domainname from 'input' into the buffer at
|
|
* 'output', using up to 'avail' bytes of the output buffer. On
|
|
* success, return the number of bytes used. On failure, return -2 if
|
|
* the buffer was not long enough, and -1 if the input was invalid.
|
|
*/
|
|
ssize_t domainname_encode(uint8_t *output, size_t avail, const domainname_t *input);
|
|
/** Check whether the internal state of the domainname in 'obj' is
|
|
* consistent. Return NULL if it is, and a short message if it is not.
|
|
*/
|
|
const char *domainname_check(const domainname_t *obj);
|
|
/** Clear any errors that were set on the object 'obj' by its setter
|
|
* functions. Return true iff errors were cleared.
|
|
*/
|
|
int domainname_clear_errors(domainname_t *obj);
|
|
/** Return the value of the len field of the domainname_t in 'inp'
|
|
*/
|
|
uint8_t domainname_get_len(const domainname_t *inp);
|
|
/** Set the value of the len field of the domainname_t in 'inp' to
|
|
* 'val'. Return 0 on success; return -1 and set the error code on
|
|
* 'inp' on failure.
|
|
*/
|
|
int domainname_set_len(domainname_t *inp, uint8_t val);
|
|
/** Return the length of the dynamic array holding the name field of
|
|
* the domainname_t in 'inp'.
|
|
*/
|
|
size_t domainname_getlen_name(const domainname_t *inp);
|
|
/** Return the element at position 'idx' of the dynamic array field
|
|
* name of the domainname_t in 'inp'.
|
|
*/
|
|
char domainname_get_name(domainname_t *inp, size_t idx);
|
|
/** As domainname_get_name, but take and return a const pointer
|
|
*/
|
|
char domainname_getconst_name(const domainname_t *inp, size_t idx);
|
|
/** Change the element at position 'idx' of the dynamic array field
|
|
* name of the domainname_t in 'inp', so that it will hold the value
|
|
* 'elt'.
|
|
*/
|
|
int domainname_set_name(domainname_t *inp, size_t idx, char elt);
|
|
/** Append a new element 'elt' to the dynamic array field name of the
|
|
* domainname_t in 'inp'.
|
|
*/
|
|
int domainname_add_name(domainname_t *inp, char elt);
|
|
/** Return a pointer to the variable-length array field name of 'inp'.
|
|
*/
|
|
char * domainname_getarray_name(domainname_t *inp);
|
|
/** As domainname_get_name, but take and return a const pointer
|
|
*/
|
|
const char * domainname_getconstarray_name(const domainname_t *inp);
|
|
/** Change the length of the variable-length array field name of 'inp'
|
|
* to 'newlen'.Fill extra elements with 0. Return 0 on success; return
|
|
* -1 and set the error code on 'inp' on failure.
|
|
*/
|
|
int domainname_setlen_name(domainname_t *inp, size_t newlen);
|
|
/** Return the value of the name field of a domainname_t as a NUL-
|
|
* terminated string.
|
|
*/
|
|
const char * domainname_getstr_name(domainname_t *inp);
|
|
/** Set the value of the name field of a domainname_t to a given
|
|
* string of length 'len'. Return 0 on success; return -1 and set the
|
|
* error code on 'inp' on failure.
|
|
*/
|
|
int domainname_setstr0_name(domainname_t *inp, const char *val, size_t len);
|
|
/** Set the value of the name field of a domainname_t to a given NUL-
|
|
* terminated string. Return 0 on success; return -1 and set the error
|
|
* code on 'inp' on failure.
|
|
*/
|
|
int domainname_setstr_name(domainname_t *inp, const char *val);
|
|
/** Return a newly allocated socks4_client_request with all elements
|
|
* set to zero.
|
|
*/
|
|
socks4_client_request_t *socks4_client_request_new(void);
|
|
/** Release all storage held by the socks4_client_request in 'victim'.
|
|
* (Do nothing if 'victim' is NULL.)
|
|
*/
|
|
void socks4_client_request_free(socks4_client_request_t *victim);
|
|
/** Try to parse a socks4_client_request from the buffer in 'input',
|
|
* using up to 'len_in' bytes from the input buffer. On success,
|
|
* return the number of bytes consumed and set *output to the newly
|
|
* allocated socks4_client_request_t. On failure, return -2 if the
|
|
* input appears truncated, and -1 if the input is otherwise invalid.
|
|
*/
|
|
ssize_t socks4_client_request_parse(socks4_client_request_t **output, const uint8_t *input, const size_t len_in);
|
|
/** Return the number of bytes we expect to need to encode the
|
|
* socks4_client_request in 'obj'. On failure, return a negative
|
|
* value. Note that this value may be an overestimate, and can even be
|
|
* an underestimate for certain unencodeable objects.
|
|
*/
|
|
ssize_t socks4_client_request_encoded_len(const socks4_client_request_t *obj);
|
|
/** Try to encode the socks4_client_request from 'input' into the
|
|
* buffer at 'output', using up to 'avail' bytes of the output buffer.
|
|
* On success, return the number of bytes used. On failure, return -2
|
|
* if the buffer was not long enough, and -1 if the input was invalid.
|
|
*/
|
|
ssize_t socks4_client_request_encode(uint8_t *output, size_t avail, const socks4_client_request_t *input);
|
|
/** Check whether the internal state of the socks4_client_request in
|
|
* 'obj' is consistent. Return NULL if it is, and a short message if
|
|
* it is not.
|
|
*/
|
|
const char *socks4_client_request_check(const socks4_client_request_t *obj);
|
|
/** Clear any errors that were set on the object 'obj' by its setter
|
|
* functions. Return true iff errors were cleared.
|
|
*/
|
|
int socks4_client_request_clear_errors(socks4_client_request_t *obj);
|
|
/** Return the value of the version field of the
|
|
* socks4_client_request_t in 'inp'
|
|
*/
|
|
uint8_t socks4_client_request_get_version(const socks4_client_request_t *inp);
|
|
/** Set the value of the version field of the socks4_client_request_t
|
|
* in 'inp' to 'val'. Return 0 on success; return -1 and set the error
|
|
* code on 'inp' on failure.
|
|
*/
|
|
int socks4_client_request_set_version(socks4_client_request_t *inp, uint8_t val);
|
|
/** Return the value of the command field of the
|
|
* socks4_client_request_t in 'inp'
|
|
*/
|
|
uint8_t socks4_client_request_get_command(const socks4_client_request_t *inp);
|
|
/** Set the value of the command field of the socks4_client_request_t
|
|
* in 'inp' to 'val'. Return 0 on success; return -1 and set the error
|
|
* code on 'inp' on failure.
|
|
*/
|
|
int socks4_client_request_set_command(socks4_client_request_t *inp, uint8_t val);
|
|
/** Return the value of the port field of the socks4_client_request_t
|
|
* in 'inp'
|
|
*/
|
|
uint16_t socks4_client_request_get_port(const socks4_client_request_t *inp);
|
|
/** Set the value of the port field of the socks4_client_request_t in
|
|
* 'inp' to 'val'. Return 0 on success; return -1 and set the error
|
|
* code on 'inp' on failure.
|
|
*/
|
|
int socks4_client_request_set_port(socks4_client_request_t *inp, uint16_t val);
|
|
/** Return the value of the addr field of the socks4_client_request_t
|
|
* in 'inp'
|
|
*/
|
|
uint32_t socks4_client_request_get_addr(const socks4_client_request_t *inp);
|
|
/** Set the value of the addr field of the socks4_client_request_t in
|
|
* 'inp' to 'val'. Return 0 on success; return -1 and set the error
|
|
* code on 'inp' on failure.
|
|
*/
|
|
int socks4_client_request_set_addr(socks4_client_request_t *inp, uint32_t val);
|
|
/** Return the value of the username field of the
|
|
* socks4_client_request_t in 'inp'
|
|
*/
|
|
const char * socks4_client_request_get_username(const socks4_client_request_t *inp);
|
|
/** Set the value of the username field of the socks4_client_request_t
|
|
* in 'inp' to 'val'. Free the old value if any. Does not steal the
|
|
* reference to 'val'.Return 0 on success; return -1 and set the error
|
|
* code on 'inp' on failure.
|
|
*/
|
|
int socks4_client_request_set_username(socks4_client_request_t *inp, const char *val);
|
|
/** Return the value of the socks4a_addr_hostname field of the
|
|
* socks4_client_request_t in 'inp'
|
|
*/
|
|
const char * socks4_client_request_get_socks4a_addr_hostname(const socks4_client_request_t *inp);
|
|
/** Set the value of the socks4a_addr_hostname field of the
|
|
* socks4_client_request_t in 'inp' to 'val'. Free the old value if
|
|
* any. Does not steal the reference to 'val'.Return 0 on success;
|
|
* return -1 and set the error code on 'inp' on failure.
|
|
*/
|
|
int socks4_client_request_set_socks4a_addr_hostname(socks4_client_request_t *inp, const char *val);
|
|
/** Return a newly allocated socks4_server_reply with all elements set
|
|
* to zero.
|
|
*/
|
|
socks4_server_reply_t *socks4_server_reply_new(void);
|
|
/** Release all storage held by the socks4_server_reply in 'victim'.
|
|
* (Do nothing if 'victim' is NULL.)
|
|
*/
|
|
void socks4_server_reply_free(socks4_server_reply_t *victim);
|
|
/** Try to parse a socks4_server_reply from the buffer in 'input',
|
|
* using up to 'len_in' bytes from the input buffer. On success,
|
|
* return the number of bytes consumed and set *output to the newly
|
|
* allocated socks4_server_reply_t. On failure, return -2 if the input
|
|
* appears truncated, and -1 if the input is otherwise invalid.
|
|
*/
|
|
ssize_t socks4_server_reply_parse(socks4_server_reply_t **output, const uint8_t *input, const size_t len_in);
|
|
/** Return the number of bytes we expect to need to encode the
|
|
* socks4_server_reply in 'obj'. On failure, return a negative value.
|
|
* Note that this value may be an overestimate, and can even be an
|
|
* underestimate for certain unencodeable objects.
|
|
*/
|
|
ssize_t socks4_server_reply_encoded_len(const socks4_server_reply_t *obj);
|
|
/** Try to encode the socks4_server_reply from 'input' into the buffer
|
|
* at 'output', using up to 'avail' bytes of the output buffer. On
|
|
* success, return the number of bytes used. On failure, return -2 if
|
|
* the buffer was not long enough, and -1 if the input was invalid.
|
|
*/
|
|
ssize_t socks4_server_reply_encode(uint8_t *output, size_t avail, const socks4_server_reply_t *input);
|
|
/** Check whether the internal state of the socks4_server_reply in
|
|
* 'obj' is consistent. Return NULL if it is, and a short message if
|
|
* it is not.
|
|
*/
|
|
const char *socks4_server_reply_check(const socks4_server_reply_t *obj);
|
|
/** Clear any errors that were set on the object 'obj' by its setter
|
|
* functions. Return true iff errors were cleared.
|
|
*/
|
|
int socks4_server_reply_clear_errors(socks4_server_reply_t *obj);
|
|
/** Return the value of the version field of the socks4_server_reply_t
|
|
* in 'inp'
|
|
*/
|
|
uint8_t socks4_server_reply_get_version(const socks4_server_reply_t *inp);
|
|
/** Set the value of the version field of the socks4_server_reply_t in
|
|
* 'inp' to 'val'. Return 0 on success; return -1 and set the error
|
|
* code on 'inp' on failure.
|
|
*/
|
|
int socks4_server_reply_set_version(socks4_server_reply_t *inp, uint8_t val);
|
|
/** Return the value of the status field of the socks4_server_reply_t
|
|
* in 'inp'
|
|
*/
|
|
uint8_t socks4_server_reply_get_status(const socks4_server_reply_t *inp);
|
|
/** Set the value of the status field of the socks4_server_reply_t in
|
|
* 'inp' to 'val'. Return 0 on success; return -1 and set the error
|
|
* code on 'inp' on failure.
|
|
*/
|
|
int socks4_server_reply_set_status(socks4_server_reply_t *inp, uint8_t val);
|
|
/** Return the value of the port field of the socks4_server_reply_t in
|
|
* 'inp'
|
|
*/
|
|
uint16_t socks4_server_reply_get_port(const socks4_server_reply_t *inp);
|
|
/** Set the value of the port field of the socks4_server_reply_t in
|
|
* 'inp' to 'val'. Return 0 on success; return -1 and set the error
|
|
* code on 'inp' on failure.
|
|
*/
|
|
int socks4_server_reply_set_port(socks4_server_reply_t *inp, uint16_t val);
|
|
/** Return the value of the addr field of the socks4_server_reply_t in
|
|
* 'inp'
|
|
*/
|
|
uint32_t socks4_server_reply_get_addr(const socks4_server_reply_t *inp);
|
|
/** Set the value of the addr field of the socks4_server_reply_t in
|
|
* 'inp' to 'val'. Return 0 on success; return -1 and set the error
|
|
* code on 'inp' on failure.
|
|
*/
|
|
int socks4_server_reply_set_addr(socks4_server_reply_t *inp, uint32_t val);
|
|
/** Return a newly allocated socks5_client_userpass_auth with all
|
|
* elements set to zero.
|
|
*/
|
|
socks5_client_userpass_auth_t *socks5_client_userpass_auth_new(void);
|
|
/** Release all storage held by the socks5_client_userpass_auth in
|
|
* 'victim'. (Do nothing if 'victim' is NULL.)
|
|
*/
|
|
void socks5_client_userpass_auth_free(socks5_client_userpass_auth_t *victim);
|
|
/** Try to parse a socks5_client_userpass_auth from the buffer in
|
|
* 'input', using up to 'len_in' bytes from the input buffer. On
|
|
* success, return the number of bytes consumed and set *output to the
|
|
* newly allocated socks5_client_userpass_auth_t. On failure, return
|
|
* -2 if the input appears truncated, and -1 if the input is otherwise
|
|
* invalid.
|
|
*/
|
|
ssize_t socks5_client_userpass_auth_parse(socks5_client_userpass_auth_t **output, const uint8_t *input, const size_t len_in);
|
|
/** Return the number of bytes we expect to need to encode the
|
|
* socks5_client_userpass_auth in 'obj'. On failure, return a negative
|
|
* value. Note that this value may be an overestimate, and can even be
|
|
* an underestimate for certain unencodeable objects.
|
|
*/
|
|
ssize_t socks5_client_userpass_auth_encoded_len(const socks5_client_userpass_auth_t *obj);
|
|
/** Try to encode the socks5_client_userpass_auth from 'input' into
|
|
* the buffer at 'output', using up to 'avail' bytes of the output
|
|
* buffer. On success, return the number of bytes used. On failure,
|
|
* return -2 if the buffer was not long enough, and -1 if the input
|
|
* was invalid.
|
|
*/
|
|
ssize_t socks5_client_userpass_auth_encode(uint8_t *output, size_t avail, const socks5_client_userpass_auth_t *input);
|
|
/** Check whether the internal state of the
|
|
* socks5_client_userpass_auth in 'obj' is consistent. Return NULL if
|
|
* it is, and a short message if it is not.
|
|
*/
|
|
const char *socks5_client_userpass_auth_check(const socks5_client_userpass_auth_t *obj);
|
|
/** Clear any errors that were set on the object 'obj' by its setter
|
|
* functions. Return true iff errors were cleared.
|
|
*/
|
|
int socks5_client_userpass_auth_clear_errors(socks5_client_userpass_auth_t *obj);
|
|
/** Return the value of the version field of the
|
|
* socks5_client_userpass_auth_t in 'inp'
|
|
*/
|
|
uint8_t socks5_client_userpass_auth_get_version(const socks5_client_userpass_auth_t *inp);
|
|
/** Set the value of the version field of the
|
|
* socks5_client_userpass_auth_t in 'inp' to 'val'. Return 0 on
|
|
* success; return -1 and set the error code on 'inp' on failure.
|
|
*/
|
|
int socks5_client_userpass_auth_set_version(socks5_client_userpass_auth_t *inp, uint8_t val);
|
|
/** Return the value of the username_len field of the
|
|
* socks5_client_userpass_auth_t in 'inp'
|
|
*/
|
|
uint8_t socks5_client_userpass_auth_get_username_len(const socks5_client_userpass_auth_t *inp);
|
|
/** Set the value of the username_len field of the
|
|
* socks5_client_userpass_auth_t in 'inp' to 'val'. Return 0 on
|
|
* success; return -1 and set the error code on 'inp' on failure.
|
|
*/
|
|
int socks5_client_userpass_auth_set_username_len(socks5_client_userpass_auth_t *inp, uint8_t val);
|
|
/** Return the length of the dynamic array holding the username field
|
|
* of the socks5_client_userpass_auth_t in 'inp'.
|
|
*/
|
|
size_t socks5_client_userpass_auth_getlen_username(const socks5_client_userpass_auth_t *inp);
|
|
/** Return the element at position 'idx' of the dynamic array field
|
|
* username of the socks5_client_userpass_auth_t in 'inp'.
|
|
*/
|
|
char socks5_client_userpass_auth_get_username(socks5_client_userpass_auth_t *inp, size_t idx);
|
|
/** As socks5_client_userpass_auth_get_username, but take and return a
|
|
* const pointer
|
|
*/
|
|
char socks5_client_userpass_auth_getconst_username(const socks5_client_userpass_auth_t *inp, size_t idx);
|
|
/** Change the element at position 'idx' of the dynamic array field
|
|
* username of the socks5_client_userpass_auth_t in 'inp', so that it
|
|
* will hold the value 'elt'.
|
|
*/
|
|
int socks5_client_userpass_auth_set_username(socks5_client_userpass_auth_t *inp, size_t idx, char elt);
|
|
/** Append a new element 'elt' to the dynamic array field username of
|
|
* the socks5_client_userpass_auth_t in 'inp'.
|
|
*/
|
|
int socks5_client_userpass_auth_add_username(socks5_client_userpass_auth_t *inp, char elt);
|
|
/** Return a pointer to the variable-length array field username of
|
|
* 'inp'.
|
|
*/
|
|
char * socks5_client_userpass_auth_getarray_username(socks5_client_userpass_auth_t *inp);
|
|
/** As socks5_client_userpass_auth_get_username, but take and return a
|
|
* const pointer
|
|
*/
|
|
const char * socks5_client_userpass_auth_getconstarray_username(const socks5_client_userpass_auth_t *inp);
|
|
/** Change the length of the variable-length array field username of
|
|
* 'inp' to 'newlen'.Fill extra elements with 0. Return 0 on success;
|
|
* return -1 and set the error code on 'inp' on failure.
|
|
*/
|
|
int socks5_client_userpass_auth_setlen_username(socks5_client_userpass_auth_t *inp, size_t newlen);
|
|
/** Return the value of the username field of a
|
|
* socks5_client_userpass_auth_t as a NUL-terminated string.
|
|
*/
|
|
const char * socks5_client_userpass_auth_getstr_username(socks5_client_userpass_auth_t *inp);
|
|
/** Set the value of the username field of a
|
|
* socks5_client_userpass_auth_t to a given string of length 'len'.
|
|
* Return 0 on success; return -1 and set the error code on 'inp' on
|
|
* failure.
|
|
*/
|
|
int socks5_client_userpass_auth_setstr0_username(socks5_client_userpass_auth_t *inp, const char *val, size_t len);
|
|
/** Set the value of the username field of a
|
|
* socks5_client_userpass_auth_t to a given NUL-terminated string.
|
|
* Return 0 on success; return -1 and set the error code on 'inp' on
|
|
* failure.
|
|
*/
|
|
int socks5_client_userpass_auth_setstr_username(socks5_client_userpass_auth_t *inp, const char *val);
|
|
/** Return the value of the passwd_len field of the
|
|
* socks5_client_userpass_auth_t in 'inp'
|
|
*/
|
|
uint8_t socks5_client_userpass_auth_get_passwd_len(const socks5_client_userpass_auth_t *inp);
|
|
/** Set the value of the passwd_len field of the
|
|
* socks5_client_userpass_auth_t in 'inp' to 'val'. Return 0 on
|
|
* success; return -1 and set the error code on 'inp' on failure.
|
|
*/
|
|
int socks5_client_userpass_auth_set_passwd_len(socks5_client_userpass_auth_t *inp, uint8_t val);
|
|
/** Return the length of the dynamic array holding the passwd field of
|
|
* the socks5_client_userpass_auth_t in 'inp'.
|
|
*/
|
|
size_t socks5_client_userpass_auth_getlen_passwd(const socks5_client_userpass_auth_t *inp);
|
|
/** Return the element at position 'idx' of the dynamic array field
|
|
* passwd of the socks5_client_userpass_auth_t in 'inp'.
|
|
*/
|
|
char socks5_client_userpass_auth_get_passwd(socks5_client_userpass_auth_t *inp, size_t idx);
|
|
/** As socks5_client_userpass_auth_get_passwd, but take and return a
|
|
* const pointer
|
|
*/
|
|
char socks5_client_userpass_auth_getconst_passwd(const socks5_client_userpass_auth_t *inp, size_t idx);
|
|
/** Change the element at position 'idx' of the dynamic array field
|
|
* passwd of the socks5_client_userpass_auth_t in 'inp', so that it
|
|
* will hold the value 'elt'.
|
|
*/
|
|
int socks5_client_userpass_auth_set_passwd(socks5_client_userpass_auth_t *inp, size_t idx, char elt);
|
|
/** Append a new element 'elt' to the dynamic array field passwd of
|
|
* the socks5_client_userpass_auth_t in 'inp'.
|
|
*/
|
|
int socks5_client_userpass_auth_add_passwd(socks5_client_userpass_auth_t *inp, char elt);
|
|
/** Return a pointer to the variable-length array field passwd of
|
|
* 'inp'.
|
|
*/
|
|
char * socks5_client_userpass_auth_getarray_passwd(socks5_client_userpass_auth_t *inp);
|
|
/** As socks5_client_userpass_auth_get_passwd, but take and return a
|
|
* const pointer
|
|
*/
|
|
const char * socks5_client_userpass_auth_getconstarray_passwd(const socks5_client_userpass_auth_t *inp);
|
|
/** Change the length of the variable-length array field passwd of
|
|
* 'inp' to 'newlen'.Fill extra elements with 0. Return 0 on success;
|
|
* return -1 and set the error code on 'inp' on failure.
|
|
*/
|
|
int socks5_client_userpass_auth_setlen_passwd(socks5_client_userpass_auth_t *inp, size_t newlen);
|
|
/** Return the value of the passwd field of a
|
|
* socks5_client_userpass_auth_t as a NUL-terminated string.
|
|
*/
|
|
const char * socks5_client_userpass_auth_getstr_passwd(socks5_client_userpass_auth_t *inp);
|
|
/** Set the value of the passwd field of a
|
|
* socks5_client_userpass_auth_t to a given string of length 'len'.
|
|
* Return 0 on success; return -1 and set the error code on 'inp' on
|
|
* failure.
|
|
*/
|
|
int socks5_client_userpass_auth_setstr0_passwd(socks5_client_userpass_auth_t *inp, const char *val, size_t len);
|
|
/** Set the value of the passwd field of a
|
|
* socks5_client_userpass_auth_t to a given NUL-terminated string.
|
|
* Return 0 on success; return -1 and set the error code on 'inp' on
|
|
* failure.
|
|
*/
|
|
int socks5_client_userpass_auth_setstr_passwd(socks5_client_userpass_auth_t *inp, const char *val);
|
|
/** Return a newly allocated socks5_client_version with all elements
|
|
* set to zero.
|
|
*/
|
|
socks5_client_version_t *socks5_client_version_new(void);
|
|
/** Release all storage held by the socks5_client_version in 'victim'.
|
|
* (Do nothing if 'victim' is NULL.)
|
|
*/
|
|
void socks5_client_version_free(socks5_client_version_t *victim);
|
|
/** Try to parse a socks5_client_version from the buffer in 'input',
|
|
* using up to 'len_in' bytes from the input buffer. On success,
|
|
* return the number of bytes consumed and set *output to the newly
|
|
* allocated socks5_client_version_t. On failure, return -2 if the
|
|
* input appears truncated, and -1 if the input is otherwise invalid.
|
|
*/
|
|
ssize_t socks5_client_version_parse(socks5_client_version_t **output, const uint8_t *input, const size_t len_in);
|
|
/** Return the number of bytes we expect to need to encode the
|
|
* socks5_client_version in 'obj'. On failure, return a negative
|
|
* value. Note that this value may be an overestimate, and can even be
|
|
* an underestimate for certain unencodeable objects.
|
|
*/
|
|
ssize_t socks5_client_version_encoded_len(const socks5_client_version_t *obj);
|
|
/** Try to encode the socks5_client_version from 'input' into the
|
|
* buffer at 'output', using up to 'avail' bytes of the output buffer.
|
|
* On success, return the number of bytes used. On failure, return -2
|
|
* if the buffer was not long enough, and -1 if the input was invalid.
|
|
*/
|
|
ssize_t socks5_client_version_encode(uint8_t *output, size_t avail, const socks5_client_version_t *input);
|
|
/** Check whether the internal state of the socks5_client_version in
|
|
* 'obj' is consistent. Return NULL if it is, and a short message if
|
|
* it is not.
|
|
*/
|
|
const char *socks5_client_version_check(const socks5_client_version_t *obj);
|
|
/** Clear any errors that were set on the object 'obj' by its setter
|
|
* functions. Return true iff errors were cleared.
|
|
*/
|
|
int socks5_client_version_clear_errors(socks5_client_version_t *obj);
|
|
/** Return the value of the version field of the
|
|
* socks5_client_version_t in 'inp'
|
|
*/
|
|
uint8_t socks5_client_version_get_version(const socks5_client_version_t *inp);
|
|
/** Set the value of the version field of the socks5_client_version_t
|
|
* in 'inp' to 'val'. Return 0 on success; return -1 and set the error
|
|
* code on 'inp' on failure.
|
|
*/
|
|
int socks5_client_version_set_version(socks5_client_version_t *inp, uint8_t val);
|
|
/** Return the value of the n_methods field of the
|
|
* socks5_client_version_t in 'inp'
|
|
*/
|
|
uint8_t socks5_client_version_get_n_methods(const socks5_client_version_t *inp);
|
|
/** Set the value of the n_methods field of the
|
|
* socks5_client_version_t in 'inp' to 'val'. Return 0 on success;
|
|
* return -1 and set the error code on 'inp' on failure.
|
|
*/
|
|
int socks5_client_version_set_n_methods(socks5_client_version_t *inp, uint8_t val);
|
|
/** Return the length of the dynamic array holding the methods field
|
|
* of the socks5_client_version_t in 'inp'.
|
|
*/
|
|
size_t socks5_client_version_getlen_methods(const socks5_client_version_t *inp);
|
|
/** Return the element at position 'idx' of the dynamic array field
|
|
* methods of the socks5_client_version_t in 'inp'.
|
|
*/
|
|
uint8_t socks5_client_version_get_methods(socks5_client_version_t *inp, size_t idx);
|
|
/** As socks5_client_version_get_methods, but take and return a const
|
|
* pointer
|
|
*/
|
|
uint8_t socks5_client_version_getconst_methods(const socks5_client_version_t *inp, size_t idx);
|
|
/** Change the element at position 'idx' of the dynamic array field
|
|
* methods of the socks5_client_version_t in 'inp', so that it will
|
|
* hold the value 'elt'.
|
|
*/
|
|
int socks5_client_version_set_methods(socks5_client_version_t *inp, size_t idx, uint8_t elt);
|
|
/** Append a new element 'elt' to the dynamic array field methods of
|
|
* the socks5_client_version_t in 'inp'.
|
|
*/
|
|
int socks5_client_version_add_methods(socks5_client_version_t *inp, uint8_t elt);
|
|
/** Return a pointer to the variable-length array field methods of
|
|
* 'inp'.
|
|
*/
|
|
uint8_t * socks5_client_version_getarray_methods(socks5_client_version_t *inp);
|
|
/** As socks5_client_version_get_methods, but take and return a const
|
|
* pointer
|
|
*/
|
|
const uint8_t * socks5_client_version_getconstarray_methods(const socks5_client_version_t *inp);
|
|
/** Change the length of the variable-length array field methods of
|
|
* 'inp' to 'newlen'.Fill extra elements with 0. Return 0 on success;
|
|
* return -1 and set the error code on 'inp' on failure.
|
|
*/
|
|
int socks5_client_version_setlen_methods(socks5_client_version_t *inp, size_t newlen);
|
|
/** Return a newly allocated socks5_server_method with all elements
|
|
* set to zero.
|
|
*/
|
|
socks5_server_method_t *socks5_server_method_new(void);
|
|
/** Release all storage held by the socks5_server_method in 'victim'.
|
|
* (Do nothing if 'victim' is NULL.)
|
|
*/
|
|
void socks5_server_method_free(socks5_server_method_t *victim);
|
|
/** Try to parse a socks5_server_method from the buffer in 'input',
|
|
* using up to 'len_in' bytes from the input buffer. On success,
|
|
* return the number of bytes consumed and set *output to the newly
|
|
* allocated socks5_server_method_t. On failure, return -2 if the
|
|
* input appears truncated, and -1 if the input is otherwise invalid.
|
|
*/
|
|
ssize_t socks5_server_method_parse(socks5_server_method_t **output, const uint8_t *input, const size_t len_in);
|
|
/** Return the number of bytes we expect to need to encode the
|
|
* socks5_server_method in 'obj'. On failure, return a negative value.
|
|
* Note that this value may be an overestimate, and can even be an
|
|
* underestimate for certain unencodeable objects.
|
|
*/
|
|
ssize_t socks5_server_method_encoded_len(const socks5_server_method_t *obj);
|
|
/** Try to encode the socks5_server_method from 'input' into the
|
|
* buffer at 'output', using up to 'avail' bytes of the output buffer.
|
|
* On success, return the number of bytes used. On failure, return -2
|
|
* if the buffer was not long enough, and -1 if the input was invalid.
|
|
*/
|
|
ssize_t socks5_server_method_encode(uint8_t *output, size_t avail, const socks5_server_method_t *input);
|
|
/** Check whether the internal state of the socks5_server_method in
|
|
* 'obj' is consistent. Return NULL if it is, and a short message if
|
|
* it is not.
|
|
*/
|
|
const char *socks5_server_method_check(const socks5_server_method_t *obj);
|
|
/** Clear any errors that were set on the object 'obj' by its setter
|
|
* functions. Return true iff errors were cleared.
|
|
*/
|
|
int socks5_server_method_clear_errors(socks5_server_method_t *obj);
|
|
/** Return the value of the version field of the
|
|
* socks5_server_method_t in 'inp'
|
|
*/
|
|
uint8_t socks5_server_method_get_version(const socks5_server_method_t *inp);
|
|
/** Set the value of the version field of the socks5_server_method_t
|
|
* in 'inp' to 'val'. Return 0 on success; return -1 and set the error
|
|
* code on 'inp' on failure.
|
|
*/
|
|
int socks5_server_method_set_version(socks5_server_method_t *inp, uint8_t val);
|
|
/** Return the value of the method field of the socks5_server_method_t
|
|
* in 'inp'
|
|
*/
|
|
uint8_t socks5_server_method_get_method(const socks5_server_method_t *inp);
|
|
/** Set the value of the method field of the socks5_server_method_t in
|
|
* 'inp' to 'val'. Return 0 on success; return -1 and set the error
|
|
* code on 'inp' on failure.
|
|
*/
|
|
int socks5_server_method_set_method(socks5_server_method_t *inp, uint8_t val);
|
|
/** Return a newly allocated socks5_server_userpass_auth with all
|
|
* elements set to zero.
|
|
*/
|
|
socks5_server_userpass_auth_t *socks5_server_userpass_auth_new(void);
|
|
/** Release all storage held by the socks5_server_userpass_auth in
|
|
* 'victim'. (Do nothing if 'victim' is NULL.)
|
|
*/
|
|
void socks5_server_userpass_auth_free(socks5_server_userpass_auth_t *victim);
|
|
/** Try to parse a socks5_server_userpass_auth from the buffer in
|
|
* 'input', using up to 'len_in' bytes from the input buffer. On
|
|
* success, return the number of bytes consumed and set *output to the
|
|
* newly allocated socks5_server_userpass_auth_t. On failure, return
|
|
* -2 if the input appears truncated, and -1 if the input is otherwise
|
|
* invalid.
|
|
*/
|
|
ssize_t socks5_server_userpass_auth_parse(socks5_server_userpass_auth_t **output, const uint8_t *input, const size_t len_in);
|
|
/** Return the number of bytes we expect to need to encode the
|
|
* socks5_server_userpass_auth in 'obj'. On failure, return a negative
|
|
* value. Note that this value may be an overestimate, and can even be
|
|
* an underestimate for certain unencodeable objects.
|
|
*/
|
|
ssize_t socks5_server_userpass_auth_encoded_len(const socks5_server_userpass_auth_t *obj);
|
|
/** Try to encode the socks5_server_userpass_auth from 'input' into
|
|
* the buffer at 'output', using up to 'avail' bytes of the output
|
|
* buffer. On success, return the number of bytes used. On failure,
|
|
* return -2 if the buffer was not long enough, and -1 if the input
|
|
* was invalid.
|
|
*/
|
|
ssize_t socks5_server_userpass_auth_encode(uint8_t *output, size_t avail, const socks5_server_userpass_auth_t *input);
|
|
/** Check whether the internal state of the
|
|
* socks5_server_userpass_auth in 'obj' is consistent. Return NULL if
|
|
* it is, and a short message if it is not.
|
|
*/
|
|
const char *socks5_server_userpass_auth_check(const socks5_server_userpass_auth_t *obj);
|
|
/** Clear any errors that were set on the object 'obj' by its setter
|
|
* functions. Return true iff errors were cleared.
|
|
*/
|
|
int socks5_server_userpass_auth_clear_errors(socks5_server_userpass_auth_t *obj);
|
|
/** Return the value of the version field of the
|
|
* socks5_server_userpass_auth_t in 'inp'
|
|
*/
|
|
uint8_t socks5_server_userpass_auth_get_version(const socks5_server_userpass_auth_t *inp);
|
|
/** Set the value of the version field of the
|
|
* socks5_server_userpass_auth_t in 'inp' to 'val'. Return 0 on
|
|
* success; return -1 and set the error code on 'inp' on failure.
|
|
*/
|
|
int socks5_server_userpass_auth_set_version(socks5_server_userpass_auth_t *inp, uint8_t val);
|
|
/** Return the value of the status field of the
|
|
* socks5_server_userpass_auth_t in 'inp'
|
|
*/
|
|
uint8_t socks5_server_userpass_auth_get_status(const socks5_server_userpass_auth_t *inp);
|
|
/** Set the value of the status field of the
|
|
* socks5_server_userpass_auth_t in 'inp' to 'val'. Return 0 on
|
|
* success; return -1 and set the error code on 'inp' on failure.
|
|
*/
|
|
int socks5_server_userpass_auth_set_status(socks5_server_userpass_auth_t *inp, uint8_t val);
|
|
/** Return a newly allocated socks5_client_request with all elements
|
|
* set to zero.
|
|
*/
|
|
socks5_client_request_t *socks5_client_request_new(void);
|
|
/** Release all storage held by the socks5_client_request in 'victim'.
|
|
* (Do nothing if 'victim' is NULL.)
|
|
*/
|
|
void socks5_client_request_free(socks5_client_request_t *victim);
|
|
/** Try to parse a socks5_client_request from the buffer in 'input',
|
|
* using up to 'len_in' bytes from the input buffer. On success,
|
|
* return the number of bytes consumed and set *output to the newly
|
|
* allocated socks5_client_request_t. On failure, return -2 if the
|
|
* input appears truncated, and -1 if the input is otherwise invalid.
|
|
*/
|
|
ssize_t socks5_client_request_parse(socks5_client_request_t **output, const uint8_t *input, const size_t len_in);
|
|
/** Return the number of bytes we expect to need to encode the
|
|
* socks5_client_request in 'obj'. On failure, return a negative
|
|
* value. Note that this value may be an overestimate, and can even be
|
|
* an underestimate for certain unencodeable objects.
|
|
*/
|
|
ssize_t socks5_client_request_encoded_len(const socks5_client_request_t *obj);
|
|
/** Try to encode the socks5_client_request from 'input' into the
|
|
* buffer at 'output', using up to 'avail' bytes of the output buffer.
|
|
* On success, return the number of bytes used. On failure, return -2
|
|
* if the buffer was not long enough, and -1 if the input was invalid.
|
|
*/
|
|
ssize_t socks5_client_request_encode(uint8_t *output, size_t avail, const socks5_client_request_t *input);
|
|
/** Check whether the internal state of the socks5_client_request in
|
|
* 'obj' is consistent. Return NULL if it is, and a short message if
|
|
* it is not.
|
|
*/
|
|
const char *socks5_client_request_check(const socks5_client_request_t *obj);
|
|
/** Clear any errors that were set on the object 'obj' by its setter
|
|
* functions. Return true iff errors were cleared.
|
|
*/
|
|
int socks5_client_request_clear_errors(socks5_client_request_t *obj);
|
|
/** Return the value of the version field of the
|
|
* socks5_client_request_t in 'inp'
|
|
*/
|
|
uint8_t socks5_client_request_get_version(const socks5_client_request_t *inp);
|
|
/** Set the value of the version field of the socks5_client_request_t
|
|
* in 'inp' to 'val'. Return 0 on success; return -1 and set the error
|
|
* code on 'inp' on failure.
|
|
*/
|
|
int socks5_client_request_set_version(socks5_client_request_t *inp, uint8_t val);
|
|
/** Return the value of the command field of the
|
|
* socks5_client_request_t in 'inp'
|
|
*/
|
|
uint8_t socks5_client_request_get_command(const socks5_client_request_t *inp);
|
|
/** Set the value of the command field of the socks5_client_request_t
|
|
* in 'inp' to 'val'. Return 0 on success; return -1 and set the error
|
|
* code on 'inp' on failure.
|
|
*/
|
|
int socks5_client_request_set_command(socks5_client_request_t *inp, uint8_t val);
|
|
/** Return the value of the reserved field of the
|
|
* socks5_client_request_t in 'inp'
|
|
*/
|
|
uint8_t socks5_client_request_get_reserved(const socks5_client_request_t *inp);
|
|
/** Set the value of the reserved field of the socks5_client_request_t
|
|
* in 'inp' to 'val'. Return 0 on success; return -1 and set the error
|
|
* code on 'inp' on failure.
|
|
*/
|
|
int socks5_client_request_set_reserved(socks5_client_request_t *inp, uint8_t val);
|
|
/** Return the value of the atype field of the socks5_client_request_t
|
|
* in 'inp'
|
|
*/
|
|
uint8_t socks5_client_request_get_atype(const socks5_client_request_t *inp);
|
|
/** Set the value of the atype field of the socks5_client_request_t in
|
|
* 'inp' to 'val'. Return 0 on success; return -1 and set the error
|
|
* code on 'inp' on failure.
|
|
*/
|
|
int socks5_client_request_set_atype(socks5_client_request_t *inp, uint8_t val);
|
|
/** Return the value of the dest_addr_ipv4 field of the
|
|
* socks5_client_request_t in 'inp'
|
|
*/
|
|
uint32_t socks5_client_request_get_dest_addr_ipv4(const socks5_client_request_t *inp);
|
|
/** Set the value of the dest_addr_ipv4 field of the
|
|
* socks5_client_request_t in 'inp' to 'val'. Return 0 on success;
|
|
* return -1 and set the error code on 'inp' on failure.
|
|
*/
|
|
int socks5_client_request_set_dest_addr_ipv4(socks5_client_request_t *inp, uint32_t val);
|
|
/** Return the (constant) length of the array holding the
|
|
* dest_addr_ipv6 field of the socks5_client_request_t in 'inp'.
|
|
*/
|
|
size_t socks5_client_request_getlen_dest_addr_ipv6(const socks5_client_request_t *inp);
|
|
/** Return the element at position 'idx' of the fixed array field
|
|
* dest_addr_ipv6 of the socks5_client_request_t in 'inp'.
|
|
*/
|
|
uint8_t socks5_client_request_get_dest_addr_ipv6(socks5_client_request_t *inp, size_t idx);
|
|
/** As socks5_client_request_get_dest_addr_ipv6, but take and return a
|
|
* const pointer
|
|
*/
|
|
uint8_t socks5_client_request_getconst_dest_addr_ipv6(const socks5_client_request_t *inp, size_t idx);
|
|
/** Change the element at position 'idx' of the fixed array field
|
|
* dest_addr_ipv6 of the socks5_client_request_t in 'inp', so that it
|
|
* will hold the value 'elt'.
|
|
*/
|
|
int socks5_client_request_set_dest_addr_ipv6(socks5_client_request_t *inp, size_t idx, uint8_t elt);
|
|
/** Return a pointer to the 16-element array field dest_addr_ipv6 of
|
|
* 'inp'.
|
|
*/
|
|
uint8_t * socks5_client_request_getarray_dest_addr_ipv6(socks5_client_request_t *inp);
|
|
/** As socks5_client_request_get_dest_addr_ipv6, but take and return a
|
|
* const pointer
|
|
*/
|
|
const uint8_t * socks5_client_request_getconstarray_dest_addr_ipv6(const socks5_client_request_t *inp);
|
|
/** Return the value of the dest_addr_domainname field of the
|
|
* socks5_client_request_t in 'inp'
|
|
*/
|
|
struct domainname_st * socks5_client_request_get_dest_addr_domainname(socks5_client_request_t *inp);
|
|
/** As socks5_client_request_get_dest_addr_domainname, but take and
|
|
* return a const pointer
|
|
*/
|
|
const struct domainname_st * socks5_client_request_getconst_dest_addr_domainname(const socks5_client_request_t *inp);
|
|
/** Set the value of the dest_addr_domainname field of the
|
|
* socks5_client_request_t in 'inp' to 'val'. Free the old value if
|
|
* any. Steals the referenceto 'val'.Return 0 on success; return -1
|
|
* and set the error code on 'inp' on failure.
|
|
*/
|
|
int socks5_client_request_set_dest_addr_domainname(socks5_client_request_t *inp, struct domainname_st *val);
|
|
/** As socks5_client_request_set_dest_addr_domainname, but does not
|
|
* free the previous value.
|
|
*/
|
|
int socks5_client_request_set0_dest_addr_domainname(socks5_client_request_t *inp, struct domainname_st *val);
|
|
/** Return the value of the dest_port field of the
|
|
* socks5_client_request_t in 'inp'
|
|
*/
|
|
uint16_t socks5_client_request_get_dest_port(const socks5_client_request_t *inp);
|
|
/** Set the value of the dest_port field of the
|
|
* socks5_client_request_t in 'inp' to 'val'. Return 0 on success;
|
|
* return -1 and set the error code on 'inp' on failure.
|
|
*/
|
|
int socks5_client_request_set_dest_port(socks5_client_request_t *inp, uint16_t val);
|
|
/** Return a newly allocated socks5_server_reply with all elements set
|
|
* to zero.
|
|
*/
|
|
socks5_server_reply_t *socks5_server_reply_new(void);
|
|
/** Release all storage held by the socks5_server_reply in 'victim'.
|
|
* (Do nothing if 'victim' is NULL.)
|
|
*/
|
|
void socks5_server_reply_free(socks5_server_reply_t *victim);
|
|
/** Try to parse a socks5_server_reply from the buffer in 'input',
|
|
* using up to 'len_in' bytes from the input buffer. On success,
|
|
* return the number of bytes consumed and set *output to the newly
|
|
* allocated socks5_server_reply_t. On failure, return -2 if the input
|
|
* appears truncated, and -1 if the input is otherwise invalid.
|
|
*/
|
|
ssize_t socks5_server_reply_parse(socks5_server_reply_t **output, const uint8_t *input, const size_t len_in);
|
|
/** Return the number of bytes we expect to need to encode the
|
|
* socks5_server_reply in 'obj'. On failure, return a negative value.
|
|
* Note that this value may be an overestimate, and can even be an
|
|
* underestimate for certain unencodeable objects.
|
|
*/
|
|
ssize_t socks5_server_reply_encoded_len(const socks5_server_reply_t *obj);
|
|
/** Try to encode the socks5_server_reply from 'input' into the buffer
|
|
* at 'output', using up to 'avail' bytes of the output buffer. On
|
|
* success, return the number of bytes used. On failure, return -2 if
|
|
* the buffer was not long enough, and -1 if the input was invalid.
|
|
*/
|
|
ssize_t socks5_server_reply_encode(uint8_t *output, size_t avail, const socks5_server_reply_t *input);
|
|
/** Check whether the internal state of the socks5_server_reply in
|
|
* 'obj' is consistent. Return NULL if it is, and a short message if
|
|
* it is not.
|
|
*/
|
|
const char *socks5_server_reply_check(const socks5_server_reply_t *obj);
|
|
/** Clear any errors that were set on the object 'obj' by its setter
|
|
* functions. Return true iff errors were cleared.
|
|
*/
|
|
int socks5_server_reply_clear_errors(socks5_server_reply_t *obj);
|
|
/** Return the value of the version field of the socks5_server_reply_t
|
|
* in 'inp'
|
|
*/
|
|
uint8_t socks5_server_reply_get_version(const socks5_server_reply_t *inp);
|
|
/** Set the value of the version field of the socks5_server_reply_t in
|
|
* 'inp' to 'val'. Return 0 on success; return -1 and set the error
|
|
* code on 'inp' on failure.
|
|
*/
|
|
int socks5_server_reply_set_version(socks5_server_reply_t *inp, uint8_t val);
|
|
/** Return the value of the reply field of the socks5_server_reply_t
|
|
* in 'inp'
|
|
*/
|
|
uint8_t socks5_server_reply_get_reply(const socks5_server_reply_t *inp);
|
|
/** Set the value of the reply field of the socks5_server_reply_t in
|
|
* 'inp' to 'val'. Return 0 on success; return -1 and set the error
|
|
* code on 'inp' on failure.
|
|
*/
|
|
int socks5_server_reply_set_reply(socks5_server_reply_t *inp, uint8_t val);
|
|
/** Return the value of the reserved field of the
|
|
* socks5_server_reply_t in 'inp'
|
|
*/
|
|
uint8_t socks5_server_reply_get_reserved(const socks5_server_reply_t *inp);
|
|
/** Set the value of the reserved field of the socks5_server_reply_t
|
|
* in 'inp' to 'val'. Return 0 on success; return -1 and set the error
|
|
* code on 'inp' on failure.
|
|
*/
|
|
int socks5_server_reply_set_reserved(socks5_server_reply_t *inp, uint8_t val);
|
|
/** Return the value of the atype field of the socks5_server_reply_t
|
|
* in 'inp'
|
|
*/
|
|
uint8_t socks5_server_reply_get_atype(const socks5_server_reply_t *inp);
|
|
/** Set the value of the atype field of the socks5_server_reply_t in
|
|
* 'inp' to 'val'. Return 0 on success; return -1 and set the error
|
|
* code on 'inp' on failure.
|
|
*/
|
|
int socks5_server_reply_set_atype(socks5_server_reply_t *inp, uint8_t val);
|
|
/** Return the value of the bind_addr_ipv4 field of the
|
|
* socks5_server_reply_t in 'inp'
|
|
*/
|
|
uint32_t socks5_server_reply_get_bind_addr_ipv4(const socks5_server_reply_t *inp);
|
|
/** Set the value of the bind_addr_ipv4 field of the
|
|
* socks5_server_reply_t in 'inp' to 'val'. Return 0 on success;
|
|
* return -1 and set the error code on 'inp' on failure.
|
|
*/
|
|
int socks5_server_reply_set_bind_addr_ipv4(socks5_server_reply_t *inp, uint32_t val);
|
|
/** Return the (constant) length of the array holding the
|
|
* bind_addr_ipv6 field of the socks5_server_reply_t in 'inp'.
|
|
*/
|
|
size_t socks5_server_reply_getlen_bind_addr_ipv6(const socks5_server_reply_t *inp);
|
|
/** Return the element at position 'idx' of the fixed array field
|
|
* bind_addr_ipv6 of the socks5_server_reply_t in 'inp'.
|
|
*/
|
|
uint8_t socks5_server_reply_get_bind_addr_ipv6(socks5_server_reply_t *inp, size_t idx);
|
|
/** As socks5_server_reply_get_bind_addr_ipv6, but take and return a
|
|
* const pointer
|
|
*/
|
|
uint8_t socks5_server_reply_getconst_bind_addr_ipv6(const socks5_server_reply_t *inp, size_t idx);
|
|
/** Change the element at position 'idx' of the fixed array field
|
|
* bind_addr_ipv6 of the socks5_server_reply_t in 'inp', so that it
|
|
* will hold the value 'elt'.
|
|
*/
|
|
int socks5_server_reply_set_bind_addr_ipv6(socks5_server_reply_t *inp, size_t idx, uint8_t elt);
|
|
/** Return a pointer to the 16-element array field bind_addr_ipv6 of
|
|
* 'inp'.
|
|
*/
|
|
uint8_t * socks5_server_reply_getarray_bind_addr_ipv6(socks5_server_reply_t *inp);
|
|
/** As socks5_server_reply_get_bind_addr_ipv6, but take and return a
|
|
* const pointer
|
|
*/
|
|
const uint8_t * socks5_server_reply_getconstarray_bind_addr_ipv6(const socks5_server_reply_t *inp);
|
|
/** Return the value of the bind_addr_domainname field of the
|
|
* socks5_server_reply_t in 'inp'
|
|
*/
|
|
struct domainname_st * socks5_server_reply_get_bind_addr_domainname(socks5_server_reply_t *inp);
|
|
/** As socks5_server_reply_get_bind_addr_domainname, but take and
|
|
* return a const pointer
|
|
*/
|
|
const struct domainname_st * socks5_server_reply_getconst_bind_addr_domainname(const socks5_server_reply_t *inp);
|
|
/** Set the value of the bind_addr_domainname field of the
|
|
* socks5_server_reply_t in 'inp' to 'val'. Free the old value if any.
|
|
* Steals the referenceto 'val'.Return 0 on success; return -1 and set
|
|
* the error code on 'inp' on failure.
|
|
*/
|
|
int socks5_server_reply_set_bind_addr_domainname(socks5_server_reply_t *inp, struct domainname_st *val);
|
|
/** As socks5_server_reply_set_bind_addr_domainname, but does not free
|
|
* the previous value.
|
|
*/
|
|
int socks5_server_reply_set0_bind_addr_domainname(socks5_server_reply_t *inp, struct domainname_st *val);
|
|
/** Return the value of the bind_port field of the
|
|
* socks5_server_reply_t in 'inp'
|
|
*/
|
|
uint16_t socks5_server_reply_get_bind_port(const socks5_server_reply_t *inp);
|
|
/** Set the value of the bind_port field of the socks5_server_reply_t
|
|
* in 'inp' to 'val'. Return 0 on success; return -1 and set the error
|
|
* code on 'inp' on failure.
|
|
*/
|
|
int socks5_server_reply_set_bind_port(socks5_server_reply_t *inp, uint16_t val);
|
|
|
|
|
|
#endif
|