Man page - ne_set_useragent(3)
Packages contas this manual
- neon(3)
- ne_session_proxy(3)
- ne_buffer_append(3)
- ne_request_destroy(3)
- ne_redirect_register(3)
- ne_has_support(3)
- ne_set_request_body_provider(3)
- ne_get_error(3)
- ne_ssl_clicert_decrypt(3)
- ne_malloc(3)
- ne_get_server_hostport(3)
- ne_ssl_clicert_encrypted(3)
- ne_session_socks_proxy(3)
- ne_realloc(3)
- ne_set_useragent(3)
- ne_buffer_ncreate(3)
- ne_buffer_create(3)
- ne_set_connect_timeout(3)
- ne_iaddr_parse(3)
- ne_strdup(3)
- ne_calloc(3)
- ne_get_request_flag(3)
- ne_ssl_cert_free(3)
- ne_ssl_readable_dname(3)
- ne_version_string(3)
- ne_ssl_cert_signedby(3)
- ne_set_error(3)
- neon-config(1)
- ne_close_connection(3)
- ne_print_request_header(3)
- ne_ssl_trust_default_ca(3)
- ne_buffer_concat(3)
- ne_strparam(3)
- ne_ssl_cert_write(3)
- ne_sock_exit(3)
- ne_iaddr_make(3)
- ne_set_request_flag(3)
- ne_buffer_grow(3)
- ne_ssl_set_protovers(3)
- ne_iaddr_typeof(3)
- ne_i18n_init(3)
- ne_forget_auth(3)
- ne_buffer_destroy(3)
- ne_iaddr_reverse(3)
- ne_iaddr_raw(3)
- ne_ssl_set_verify(3)
- ne_vstrhash(3)
- ne_ssl_clicert_owner(3)
- ne_set_session_flag(3)
- ne_ssl_clicert_read(3)
- ne_sock_init(3)
- ne_buffer_zappend(3)
- ne_set_addrlist(3)
- ne_addr_result(3)
- ne_xml_destroy(3)
- ne_ssl_cert_issuer(3)
- ne_request_create(3)
- ne_redirect_location(3)
- ne_set_request_body_fd(3)
- ne_oom_callback(3)
- ne_ssl_cert_subject(3)
- ne_addr_resolve(3)
- ne_session_destroy(3)
- ne_buffer_finish(3)
- ne_status(3)
- ne_ssl_trust_cert(3)
- ne_get_response_header(3)
- ne_ssl_cert_export(3)
- ne_buffer_clear(3)
- ne_session_system_proxy(3)
- ne_buffer_altered(3)
- ne_request_dispatch(3)
- ne_get_session_flag(3)
- ne_addr_next(3)
- ne_addr_error(3)
- ne_token(3)
- ne_iaddr_print(3)
- ne_shave(3)
- ne_addr_first(3)
- ne_set_request_body_buffer(3)
- ne_ssl_cert_read(3)
- ne_get_status(3)
- ne_ssl_cert_import(3)
- ne_strhash(3)
- ne_addr_destroy(3)
- ne_set_read_timeout(3)
- ne_buffer(3)
- ne_add_request_header(3)
- ne_set_server_auth(3)
- ne_get_request_target(3)
- ne_strndup(3)
- ne_session_create(3)
- ne_response_header_iterate(3)
- ne_version_match(3)
- ne_get_response_location(3)
- ne_ssl_dname_cmp(3)
- ne_ssl_clicert_name(3)
- ne_qtoken(3)
- ne_ssl_clicert_free(3)
- ne_ssl_cert_cmp(3)
- ne_xml_create(3)
- ne_get_scheme(3)
- ne_ssl_proto_name(3)
- ne_set_proxy_auth(3)
- ne_ssl_cert_identity(3)
- ne_iaddr_cmp(3)
- ne_iaddr_free(3)
- neon(3)
- ne_session_proxy(3)
- ne_buffer_append(3)
- ne_request_destroy(3)
- ne_redirect_register(3)
- ne_has_support(3)
- ne_set_request_body_provider(3)
- ne_get_error(3)
- ne_ssl_clicert_decrypt(3)
- ne_malloc(3)
- ne_get_server_hostport(3)
- ne_ssl_clicert_encrypted(3)
- ne_session_socks_proxy(3)
- ne_realloc(3)
- ne_set_useragent(3)
- ne_buffer_ncreate(3)
- ne_buffer_create(3)
- ne_set_connect_timeout(3)
- ne_iaddr_parse(3)
- ne_strdup(3)
- ne_calloc(3)
- ne_get_request_flag(3)
- ne_ssl_cert_free(3)
- ne_ssl_readable_dname(3)
- ne_version_string(3)
- ne_ssl_cert_signedby(3)
- ne_set_error(3)
- neon-config(1)
- ne_close_connection(3)
- ne_print_request_header(3)
- ne_ssl_trust_default_ca(3)
- ne_buffer_concat(3)
- ne_strparam(3)
- ne_ssl_cert_write(3)
- ne_sock_exit(3)
- ne_iaddr_make(3)
- ne_set_request_flag(3)
- ne_buffer_grow(3)
- ne_ssl_set_protovers(3)
- ne_iaddr_typeof(3)
- ne_i18n_init(3)
- ne_forget_auth(3)
- ne_buffer_destroy(3)
- ne_iaddr_reverse(3)
- ne_iaddr_raw(3)
- ne_ssl_set_verify(3)
- ne_vstrhash(3)
- ne_ssl_clicert_owner(3)
- ne_set_session_flag(3)
- ne_ssl_clicert_read(3)
- ne_sock_init(3)
- ne_buffer_zappend(3)
- ne_set_addrlist(3)
- ne_addr_result(3)
- ne_xml_destroy(3)
- ne_ssl_cert_issuer(3)
- ne_request_create(3)
- ne_redirect_location(3)
- ne_set_request_body_fd(3)
- ne_oom_callback(3)
- ne_ssl_cert_subject(3)
- ne_addr_resolve(3)
- ne_session_destroy(3)
- ne_buffer_finish(3)
- ne_status(3)
- ne_ssl_trust_cert(3)
- ne_get_response_header(3)
- ne_ssl_cert_export(3)
- ne_buffer_clear(3)
- ne_session_system_proxy(3)
- ne_buffer_altered(3)
- ne_request_dispatch(3)
- ne_get_session_flag(3)
- ne_addr_next(3)
- ne_addr_error(3)
- ne_token(3)
- ne_iaddr_print(3)
- ne_shave(3)
- ne_addr_first(3)
- ne_set_request_body_buffer(3)
- ne_ssl_cert_read(3)
- ne_get_status(3)
- ne_ssl_cert_import(3)
- ne_strhash(3)
- ne_addr_destroy(3)
- ne_set_read_timeout(3)
- ne_buffer(3)
- ne_add_request_header(3)
- ne_set_server_auth(3)
- ne_get_request_target(3)
- ne_strndup(3)
- ne_session_create(3)
- ne_response_header_iterate(3)
- ne_version_match(3)
- ne_get_response_location(3)
- ne_ssl_dname_cmp(3)
- ne_ssl_clicert_name(3)
- ne_qtoken(3)
- ne_ssl_clicert_free(3)
- ne_ssl_cert_cmp(3)
- ne_xml_create(3)
- ne_get_scheme(3)
- ne_ssl_proto_name(3)
- ne_set_proxy_auth(3)
- ne_ssl_cert_identity(3)
- ne_iaddr_cmp(3)
- ne_iaddr_free(3)
apt-get install libneon27-dev
apt-get install libneon27-gnutls-dev
Manual
| NE_SET_USERAGENT(3) | neon API reference | NE_SET_USERAGENT(3) |
NAME
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 or debugging purposes. neon does not send a User-Agent header unless a call is made to the ne_set_useragent. ne_set_useragent must be passed a product string conforming to RFC2616's product token grammar; of the form "Product/Version".
When neon reads from a socket, by default the read operation will time out after 60 seconds, and the request will fail giving an NE_TIMEOUT error. To configure this timeout interval, call ne_set_read_timeout giving the desired number of seconds as the timeout parameter.
When a connection is being established to a server, normally only the system's TCP timeout handling will apply. To configure a specific (and probably shorter) timeout, the ne_set_connect_timeout can be used, giving the desired number of seconds as the timeout parameter. If 0 is passed, then the default behaviour of using the system TCP timeout will be used.
The scheme used to initially create the session will be returned by ne_get_scheme.
The hostport pair with which the session is associated will be returned by the ne_get_server_hostport; for example www.example.com:8080. Note that the :port will be omitted if the default port for the scheme is used.
EXAMPLES
Set a user-agent string:
ne_session *sess = ne_session_create(...); ne_set_useragent(sess, "MyApplication/2.1");
Set a 30 second read timeout:
ne_session *sess = ne_session_create(...); ne_set_read_timeout(sess, 30);
SEE ALSO
ne_session_create, ne_set_session_flag.
COPYRIGHT
Copyright © 2001-2024 Joe Orton
| 15 April 2025 | neon 0.34.2 |