Linux Manuals session 3

ne_set_useragent, ne_set_read_timeout, ne_set_connect_timeout, ne_get_scheme, ne_get_server_hostport – common properties for HTTP sessions Synopsis #include <ne_session.h> void ne_set_useragent(ne_session *session, const char *product); void ne_set_read_timeout(ne_session *session, int timeout); void ne_set_connect_timeout(ne_session *session, int timeout); const char *ne_get_scheme(ne_sesssion *session); const char *ne_get_server_hostport(ne_sesssion *session); Description The User-Agent request header is used to identify the software which generated the request for statistical…

ne_set_session_flag, ne_get_session_flag – set and retrieve session flags Synopsis #include <ne_request.h> void ne_set_session_flag(ne_session *sess, ne_session_flag flag, int value); int ne_get_session_flag(ne_session *sess, ne_session_flag flag); Description The ne_set_session_flag function enables or disables a session flag. Passing a non-zero value argument enables the flag, and zero disables it. The following flags are defined: NE_SESSFLAG_PERSIST disable this flag to…

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_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_set_request_body_buffer, ne_set_request_body_fd, ne_set_request_body_fd64 – include a message body with a request Synopsis #include <ne_request.h> void ne_set_request_body_buffer(ne_request *req, const char *buf, size_t count); int ne_set_request_body_fd(ne_request *req, int fd, off_t begin, off_t length); Description The ne_set_request_body_buffer function specifies that a message body should be included with the body, which is stored in the count bytes buffer buf….

ne_set_request_body_buffer, ne_set_request_body_fd, ne_set_request_body_fd64 – include a message body with a request Synopsis #include <ne_request.h> void ne_set_request_body_buffer(ne_request *req, const char *buf, size_t count); int ne_set_request_body_fd(ne_request *req, int fd, off_t begin, off_t length); Description The ne_set_request_body_buffer function specifies that a message body should be included with the body, which is stored in the count bytes buffer buf….

ne_set_request_body_buffer, ne_set_request_body_fd, ne_set_request_body_fd64 – include a message body with a request Synopsis #include <ne_request.h> void ne_set_request_body_buffer(ne_request *req, const char *buf, size_t count); int ne_set_request_body_fd(ne_request *req, int fd, off_t begin, off_t length); Description The ne_set_request_body_buffer function specifies that a message body should be included with the body, which is stored in the count bytes buffer buf….

ne_set_useragent, ne_set_read_timeout, ne_set_connect_timeout, ne_get_scheme, ne_get_server_hostport – common properties for HTTP sessions Synopsis #include <ne_session.h> void ne_set_useragent(ne_session *session, const char *product); void ne_set_read_timeout(ne_session *session, int timeout); void ne_set_connect_timeout(ne_session *session, int timeout); const char *ne_get_scheme(ne_sesssion *session); const char *ne_get_server_hostport(ne_sesssion *session); Description The User-Agent request header is used to identify the software which generated the request for statistical…

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_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_useragent, ne_set_read_timeout, ne_set_connect_timeout, ne_get_scheme, ne_get_server_hostport – common properties for HTTP sessions Synopsis #include <ne_session.h> void ne_set_useragent(ne_session *session, const char *product); void ne_set_read_timeout(ne_session *session, int timeout); void ne_set_connect_timeout(ne_session *session, int timeout); const char *ne_get_scheme(ne_sesssion *session); const char *ne_get_server_hostport(ne_sesssion *session); Description The User-Agent request header is used to identify the software which generated the request for statistical…

ne_session_proxy, ne_session_socks_proxy, ne_session_system_proxy, ne_set_addrlist – configure proxy servers Synopsis #include <ne_session.h> void ne_session_proxy(ne_session *session, const char *hostname, unsigned int port); void ne_session_system_proxy(ne_session *session, unsigned int flags); void ne_session_socks_proxy(ne_session *session, enum ne_sock_sversion version, const char *hostname, unsigned int port, const char *username, const char *password); void ne_set_addrlist(ne_session *session, const ne_inet_addr **addrlist, size_t count); Description One (and…

ne_session_proxy, ne_session_socks_proxy, ne_session_system_proxy, ne_set_addrlist – configure proxy servers Synopsis #include <ne_session.h> void ne_session_proxy(ne_session *session, const char *hostname, unsigned int port); void ne_session_system_proxy(ne_session *session, unsigned int flags); void ne_session_socks_proxy(ne_session *session, enum ne_sock_sversion version, const char *hostname, unsigned int port, const char *username, const char *password); void ne_set_addrlist(ne_session *session, const ne_inet_addr **addrlist, size_t count); Description One (and…

ne_session_proxy, ne_session_socks_proxy, ne_session_system_proxy, ne_set_addrlist – configure proxy servers Synopsis #include <ne_session.h> void ne_session_proxy(ne_session *session, const char *hostname, unsigned int port); void ne_session_system_proxy(ne_session *session, unsigned int flags); void ne_session_socks_proxy(ne_session *session, enum ne_sock_sversion version, const char *hostname, unsigned int port, const char *username, const char *password); void ne_set_addrlist(ne_session *session, const ne_inet_addr **addrlist, size_t count); Description One (and…

ne_session_proxy, ne_session_socks_proxy, ne_session_system_proxy, ne_set_addrlist – configure proxy servers Synopsis #include <ne_session.h> void ne_session_proxy(ne_session *session, const char *hostname, unsigned int port); void ne_session_system_proxy(ne_session *session, unsigned int flags); void ne_session_socks_proxy(ne_session *session, enum ne_sock_sversion version, const char *hostname, unsigned int port, const char *username, const char *password); void ne_set_addrlist(ne_session *session, const ne_inet_addr **addrlist, size_t count); Description One (and…

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_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_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_request_create, ne_request_dispatch, ne_request_destroy – low-level HTTP request handling Synopsis #include <ne_request.h> ne_request *ne_request_create(ne_session *session, const char *method, const char *path); int ne_request_dispatch(ne_request *req); void ne_request_destroy(ne_request *req); Description The ne_request object represents an HTTP request and the associated response. The ne_request_create function creates a new request object for the given session. The target resource for the…

ne_request_create, ne_request_dispatch, ne_request_destroy – low-level HTTP request handling Synopsis #include <ne_request.h> ne_request *ne_request_create(ne_session *session, const char *method, const char *path); int ne_request_dispatch(ne_request *req); void ne_request_destroy(ne_request *req); Description The ne_request object represents an HTTP request and the associated response. The ne_request_create function creates a new request object for the given session. The target resource for the…