Linux Manuals session 3

ne_get_response_header, ne_response_header_iterate – functions to access response headers Synopsis #include <ne_request.h> const char *ne_get_response_header(ne_request *request, const char *name); void *ne_response_header_iterate(ne_request *request, void *cursor, const char **name, const char **value); Description To retrieve the value of a response header field, the ne_get_response_header function can be used, and is given the name of the header to return….

ne_set_request_flag, ne_get_request_flag – set and retrieve per-request flags Synopsis #include <ne_request.h> void ne_set_request_flag(ne_request *req, ne_request_flag flag, int value); int ne_get_request_flag(ne_request *req, ne_request_flag flag); Description The ne_set_request_flag function enables or disables a per-request flag. Passing a non-zero value argument enables the flag, and zero disables it. The following flags are defined: NE_REQFLAG_EXPECT100 enable this flag to…

ne_get_error, ne_set_error – error handling for HTTP sessions Synopsis #include <ne_session.h> const char *ne_get_error(ne_sesssion *session); void ne_set_error(ne_sesssion *session, const char *format, …); Description The session error string is used to store any human-readable error information associated with any errors which occur whilst using the HTTP session. The ne_get_error function returns the current session error string….

ne_set_server_auth, ne_set_proxy_auth, ne_forget_auth – register authentication callbacks Synopsis #include <ne_auth.h> typedef int (*ne_auth_creds)(void *userdata, const char *realm, int attempt, char *username, char *password); void ne_set_server_auth(ne_session *session, ne_auth_creds callback, void *userdata); void ne_set_proxy_auth(ne_session *session, ne_auth_creds callback, void *userdata); void ne_forget_auth(ne_session *session); Description The ne_auth_creds function type defines a callback which is invoked when a server or…

ne_session_create, ne_close_connection, ne_session_destroy – set up HTTP sessions Synopsis #include <ne_session.h> ne_session *ne_session_create(const char *scheme, const char *hostname, unsigned int port); void ne_close_connection(ne_session *session); void ne_session_destroy(ne_session *session); Description An ne_session object represents an HTTP session – a logical grouping of a sequence of HTTP requests made to a certain server. Any requests made using the…

ne_malloc, ne_calloc, ne_realloc, ne_strdup, ne_strndup, ne_oom_callback – memory allocation wrappers Synopsis #include <ne_alloc.h> void *ne_malloc(size_t size); void *ne_calloc(size_t size); void *ne_realloc(void *size, size_t len); char *ne_strdup(const char *s); char *ne_strndup(const char *s, size_t size); void ne_oom_callback(void (*callback)(void)); Description The functions ne_malloc, ne_calloc, ne_realloc, ne_strdup and ne_strdnup provide wrappers for the equivalent functions in the standard…

ne_buffer_append, ne_buffer_zappend, ne_buffer_concat – append data to a string buffer Synopsis #include <ne_string.h> void ne_buffer_append(ne_buffer *buf, const char *string, size_t len); void ne_buffer_zappend(ne_buffer *buf, const char *string); void ne_buffer_concat(ne_buffer *buf, const char *str, …); Description The ne_buffer_append and ne_buffer_zappend functions append a string to the end of a buffer; extending the buffer as necessary. The…

ne_buffer_create, ne_buffer_ncreate – create a string buffer Synopsis #include <ne_alloc.h> ne_buffer *ne_buffer_create(void); ne_buffer *ne_buffer_ncreate(size_t size); Description ne_buffer_create creates a new buffer object, with an implementation-defined initial size. ne_buffer_ncreate creates an ne_buffer where the minimum initial size is given in the size parameter. The buffer created will contain the empty string (""). Return Value Both functions…

ne_buffer_clear, ne_buffer_grow, ne_buffer_altered – clear, grow, or mark as altered a string buffer Synopsis #include <ne_string.h> void ne_buffer_clear(ne_buffer *buf); void ne_buffer_altered(ne_buffer *buf); void ne_buffer_grow(ne_buffer *buf, size_t size); Description The ne_buffer_clear function sets the string stored in buf to be the empty string (""). The ne_buffer_altered function must be used after the string stored in the…

ne_buffer_destroy, ne_buffer_finish – destroy a buffer object Synopsis #include <ne_string.h> void ne_buffer_destroy(ne_buffer *buf); char *ne_buffer_finish(ne_buffer *buf); Description ne_buffer_destroy frees all memory associated with the buffer. ne_buffer_finish frees the buffer structure, but not the actual string stored in the buffer, which is returned and must be free()d by the caller. Any use of the buffer object…

ne_buffer_destroy, ne_buffer_finish – destroy a buffer object Synopsis #include <ne_string.h> void ne_buffer_destroy(ne_buffer *buf); char *ne_buffer_finish(ne_buffer *buf); Description ne_buffer_destroy frees all memory associated with the buffer. ne_buffer_finish frees the buffer structure, but not the actual string stored in the buffer, which is returned and must be free()d by the caller. Any use of the buffer object…

ne_buffer_create, ne_buffer_ncreate – create a string buffer Synopsis #include <ne_alloc.h> ne_buffer *ne_buffer_create(void); ne_buffer *ne_buffer_ncreate(size_t size); Description ne_buffer_create creates a new buffer object, with an implementation-defined initial size. ne_buffer_ncreate creates an ne_buffer where the minimum initial size is given in the size parameter. The buffer created will contain the empty string (""). Return Value Both functions…

ne_buffer_append, ne_buffer_zappend, ne_buffer_concat – append data to a string buffer Synopsis #include <ne_string.h> void ne_buffer_append(ne_buffer *buf, const char *string, size_t len); void ne_buffer_zappend(ne_buffer *buf, const char *string); void ne_buffer_concat(ne_buffer *buf, const char *str, …); Description The ne_buffer_append and ne_buffer_zappend functions append a string to the end of a buffer; extending the buffer as necessary. The…

ne_buffer_clear, ne_buffer_grow, ne_buffer_altered – clear, grow, or mark as altered a string buffer Synopsis #include <ne_string.h> void ne_buffer_clear(ne_buffer *buf); void ne_buffer_altered(ne_buffer *buf); void ne_buffer_grow(ne_buffer *buf, size_t size); Description The ne_buffer_clear function sets the string stored in buf to be the empty string (""). The ne_buffer_altered function must be used after the string stored in the…

ne_buffer_append, ne_buffer_zappend, ne_buffer_concat – append data to a string buffer Synopsis #include <ne_string.h> void ne_buffer_append(ne_buffer *buf, const char *string, size_t len); void ne_buffer_zappend(ne_buffer *buf, const char *string); void ne_buffer_concat(ne_buffer *buf, const char *str, …); Description The ne_buffer_append and ne_buffer_zappend functions append a string to the end of a buffer; extending the buffer as necessary. The…

ne_buffer_clear, ne_buffer_grow, ne_buffer_altered – clear, grow, or mark as altered a string buffer Synopsis #include <ne_string.h> void ne_buffer_clear(ne_buffer *buf); void ne_buffer_altered(ne_buffer *buf); void ne_buffer_grow(ne_buffer *buf, size_t size); Description The ne_buffer_clear function sets the string stored in buf to be the empty string (""). The ne_buffer_altered function must be used after the string stored in the…

ne_buffer – string buffer handling Synopsis #include <ne_string.h> typedef struct { char *data; size_t used; size_t length; } ne_buffer; Description The ne_buffer type represents an expandable memory buffer for holding NUL-terminated strings. The data field points to the beginnning of the string, the length of which is given by the used field. The current size…

ne_addr_resolve, ne_addr_result, ne_addr_first, ne_addr_next, ne_addr_error, ne_addr_destroy – functions to resolve hostnames to addresses Synopsis #include <ne_socket.h> ne_sock_addr *ne_addr_resolve(const char *hostname, int flags); int ne_addr_result(const ne_sock_addr *addr); const ne_inet_addr *ne_addr_first(ne_sock_addr *addr); const ne_inet_addr *ne_addr_next(ne_sock_addr *addr); char *ne_addr_error(const ne_sock_addr *addr, char *buffer, size_t bufsiz); void ne_addr_destroy(ne_sock_addr *addr); Description The ne_addr_resolve function resolves the given hostname, returning an…

ne_addr_resolve, ne_addr_result, ne_addr_first, ne_addr_next, ne_addr_error, ne_addr_destroy – functions to resolve hostnames to addresses Synopsis #include <ne_socket.h> ne_sock_addr *ne_addr_resolve(const char *hostname, int flags); int ne_addr_result(const ne_sock_addr *addr); const ne_inet_addr *ne_addr_first(ne_sock_addr *addr); const ne_inet_addr *ne_addr_next(ne_sock_addr *addr); char *ne_addr_error(const ne_sock_addr *addr, char *buffer, size_t bufsiz); void ne_addr_destroy(ne_sock_addr *addr); Description The ne_addr_resolve function resolves the given hostname, returning an…

ne_addr_resolve, ne_addr_result, ne_addr_first, ne_addr_next, ne_addr_error, ne_addr_destroy – functions to resolve hostnames to addresses Synopsis #include <ne_socket.h> ne_sock_addr *ne_addr_resolve(const char *hostname, int flags); int ne_addr_result(const ne_sock_addr *addr); const ne_inet_addr *ne_addr_first(ne_sock_addr *addr); const ne_inet_addr *ne_addr_next(ne_sock_addr *addr); char *ne_addr_error(const ne_sock_addr *addr, char *buffer, size_t bufsiz); void ne_addr_destroy(ne_sock_addr *addr); Description The ne_addr_resolve function resolves the given hostname, returning an…