neon HTTP/WebDAV client library

Joe Orton

Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.1 or any later version published by the Free Software Foundation; with no Invariant Sections, with no Front-Cover Texts, and with no Back-Cover Texts. A copy of the license is included in the section entitled "GNU Free Documentation License".


Table of Contents

1. Introduction
Feature list
How to use neon from your application
Protocol compliance
RFC 2518, HTTP Extensions for Distributed Authoring—WebDAV
RFC 2616, Hypertext Transfer Protocol—HTTP/1.1
RFC 2617, HTTP Authentication: Basic and Digest Access Authentication
2. The neon C language interface
Parsing XML
Introduction to SAX
Stacked SAX handlers
Maintaining state
XML namespaces
I. neon API reference
neon - HTTP and WebDAV client library
neon-config - script providing information about installed copy of neon library
ne_add_request_header - add headers to a request
ne_addr_resolve - functions to resolve hostnames to addresses
ne_buffer - string buffer handling
ne_buffer_append - append data to a string buffer
ne_buffer_clear - general purpose of group of functions
ne_buffer_create - general purpose of group of functions
ne_buffer_destroy - destroy a buffer object
ne_get_error - error handling for HTTP sessions
ne_get_status - retrieve HTTP response status for request
ne_iaddr_make - functions to manipulate and compare network addresses
ne_malloc - memory allocation wrappers
ne_request_create - low-level HTTP request handling
ne_session_create - set up HTTP sessions
ne_set_useragent - common settings for HTTP sessions
ne_set_request_body_buffer - include a message body with a request
ne_set_server_auth - register authentication callbacks
ne_shave - trim whitespace from a string
ne_sock_init - perform library initialization
ne_ssl_cert_identity - functions to access certificate properties
ne_ssl_cert_cmp - functions to operate on certificate objects
ne_ssl_cert_read - functions to read or write certificates to and from files or strings
ne_ssl_dname - SSL distinguished name handling
ne_ssl_trust_cert - functions to indicate that certificates are trusted
ne_ssl_set_verify - register an SSL certificate verification callback
ne_ssl_client_cert - SSL client certificate handling
ne_status - HTTP status structure
ne_token - string tokenizers
ne_version_match - library versioning
Bibliography
A. GNU Free Documentation License
0. PREAMBLE
1. APPLICABILITY AND DEFINITIONS
2. VERBATIM COPYING
3. COPYING IN QUANTITY
4. MODIFICATIONS
5. COMBINING DOCUMENTS
6. COLLECTIONS OF DOCUMENTS
7. AGGREGATION WITH INDEPENDENT WORKS
8. TRANSLATION
9. TERMINATION
10. FUTURE REVISIONS OF THIS LICENSE
How to use this License for your documents

List of Examples

2.1. An example XML document