| |

|

|

|

Module nanohttp from libxml2

|

|

|

|

|

|

| API Menu | |

• Main Menu
• Developer Menu
• Code Examples
• API Menu
• Parser API
• Tree API
• Reader API
• XML Guidelines
• ChangeLog

|

| API Indexes | |

• Alphabetic
• Constructors
• Functions/Types
• Modules
• Symbols

|

| Related links | |

• Mail archive
• XSLT libxslt
• DOM gdome2
• XML-DSig xmlsec
• FTP
• Windows binaries
• Solaris binaries
• MacOsX binaries
• lxml Python bindings
• Perl bindings
• C++ bindings
• PHP bindings
• Pascal bindings
• Ruby bindings
• Tcl bindings
• Bug Tracker

|

|

|

|

|

|

| | nanoftp | | API documentation | | The XML C parser and toolkit of Gnome | parser | |

minimal HTTP implementation allowing to fetch resources like external subset.

Table of Contents

const char *[xmlNanoHTTPAuthHeader](#xmlNanoHTTPAuthHeader)(void * ctx)

void[xmlNanoHTTPCleanup](#xmlNanoHTTPCleanup)(void)

void[xmlNanoHTTPClose](#xmlNanoHTTPClose)(void * ctx)

int[xmlNanoHTTPContentLength](#xmlNanoHTTPContentLength)(void * ctx)

const char *[xmlNanoHTTPEncoding](#xmlNanoHTTPEncoding)(void * ctx)

int[xmlNanoHTTPFetch](#xmlNanoHTTPFetch)(const char * URL,
const char * filename,
char ** contentType)

void[xmlNanoHTTPInit](#xmlNanoHTTPInit)(void)

void *[xmlNanoHTTPMethod](#xmlNanoHTTPMethod)(const char * URL,
const char * method,
const char * input,
char ** contentType,
const char * headers,
int ilen)

void *[xmlNanoHTTPMethodRedir](#xmlNanoHTTPMethodRedir)(const char * URL,
const char * method,
const char * input,
char ** contentType,
char ** redir,
const char * headers,
int ilen)

const char *[xmlNanoHTTPMimeType](#xmlNanoHTTPMimeType)(void * ctx)

void *[xmlNanoHTTPOpen](#xmlNanoHTTPOpen)(const char * URL,
char ** contentType)

void *[xmlNanoHTTPOpenRedir](#xmlNanoHTTPOpenRedir)(const char * URL,
char ** contentType,
char ** redir)

int[xmlNanoHTTPRead](#xmlNanoHTTPRead)(void * ctx,
void * dest,
int len)

const char *[xmlNanoHTTPRedir](#xmlNanoHTTPRedir)(void * ctx)

int[xmlNanoHTTPReturnCode](#xmlNanoHTTPReturnCode)(void * ctx)

int[xmlNanoHTTPSave](#xmlNanoHTTPSave)(void * ctxt,
const char * filename)

void[xmlNanoHTTPScanProxy](#xmlNanoHTTPScanProxy)(const char * URL)

Description

Function: xmlNanoHTTPAuthHeader

const char *	xmlNanoHTTPAuthHeader	(void * ctx)

Get the authentication header of an HTTP context

| ctx: | the HTTP context | | Returns: | the stashed value of the WWW-Authenticate or Proxy-Authenticate header. |

Function: xmlNanoHTTPCleanup

void	xmlNanoHTTPCleanup (void)

Cleanup the HTTP protocol layer.

Function: xmlNanoHTTPClose

void	xmlNanoHTTPClose (void * ctx)

This function closes an HTTP context, it ends up the connection and free all data related to it.

| ctx: | the HTTP context |

Function: xmlNanoHTTPContentLength

int	xmlNanoHTTPContentLength	(void * ctx)

Provides the specified content length from the HTTP header.

| ctx: | the HTTP context | | Returns: | the specified content length from the HTTP header. Note that a value of -1 indicates that the content length element was not included in the response header. |

Function: xmlNanoHTTPEncoding

const char *	xmlNanoHTTPEncoding	(void * ctx)

Provides the specified encoding if specified in the HTTP headers.

| ctx: | the HTTP context | | Returns: | the specified encoding or NULL if not available |

Function: xmlNanoHTTPFetch

int	xmlNanoHTTPFetch (const char * URL,
const char * filename,
char ** contentType)

This function try to fetch the indicated resource via HTTP GET and save it's content in the file.

| URL: | The URL to load | | filename: | the filename where the content should be saved | | contentType: | if available the Content-Type information will be returned at that location | | Returns: | -1 in case of failure, 0 incase of success. The contentType, if provided must be freed by the caller |

Function: xmlNanoHTTPInit

void	xmlNanoHTTPInit (void)

Initialize the HTTP protocol layer. Currently it just checks for proxy informations

Function: xmlNanoHTTPMethod

void *	xmlNanoHTTPMethod (const char * URL,
const char * method,
const char * input,
char ** contentType,
const char * headers,
int ilen)

This function try to open a connection to the indicated resource via HTTP using the given @method, adding the given extra headers and the input buffer for the request content.

| URL: | The URL to load | | method: | the HTTP method to use | | input: | the input string if any | | contentType: | the Content-Type information IN and OUT | | headers: | the extra headers | | ilen: | input length | | Returns: | NULL in case of failure, otherwise a request handler. The contentType, if provided must be freed by the caller |

Function: xmlNanoHTTPMethodRedir

void *	xmlNanoHTTPMethodRedir (const char * URL,
const char * method,
const char * input,
char ** contentType,
char ** redir,
const char * headers,
int ilen)

This function try to open a connection to the indicated resource via HTTP using the given @method, adding the given extra headers and the input buffer for the request content.

| URL: | The URL to load | | method: | the HTTP method to use | | input: | the input string if any | | contentType: | the Content-Type information IN and OUT | | redir: | the redirected URL OUT | | headers: | the extra headers | | ilen: | input length | | Returns: | NULL in case of failure, otherwise a request handler. The contentType, or redir, if provided must be freed by the caller |

Function: xmlNanoHTTPMimeType

const char *	xmlNanoHTTPMimeType	(void * ctx)

Provides the specified Mime-Type if specified in the HTTP headers.

| ctx: | the HTTP context | | Returns: | the specified Mime-Type or NULL if not available |

Function: xmlNanoHTTPOpen

void *	xmlNanoHTTPOpen (const char * URL,
char ** contentType)

This function try to open a connection to the indicated resource via HTTP GET.

| URL: | The URL to load | | contentType: | if available the Content-Type information will be returned at that location | | Returns: | NULL in case of failure, otherwise a request handler. The contentType, if provided must be freed by the caller |

Function: xmlNanoHTTPOpenRedir

void *	xmlNanoHTTPOpenRedir (const char * URL,
char ** contentType,
char ** redir)

This function try to open a connection to the indicated resource via HTTP GET.

| URL: | The URL to load | | contentType: | if available the Content-Type information will be returned at that location | | redir: | if available the redirected URL will be returned | | Returns: | NULL in case of failure, otherwise a request handler. The contentType, if provided must be freed by the caller |

Function: xmlNanoHTTPRead

int	xmlNanoHTTPRead (void * ctx,
void * dest,
int len)

This function tries to read @len bytes from the existing HTTP connection and saves them in @dest. This is a blocking call.

| ctx: | the HTTP context | | dest: | a buffer | | len: | the buffer length | | Returns: | the number of byte read. 0 is an indication of an end of connection. -1 indicates a parameter error. |

Function: xmlNanoHTTPRedir

const char *	xmlNanoHTTPRedir	(void * ctx)

Provides the specified redirection URL if available from the HTTP header.

| ctx: | the HTTP context | | Returns: | the specified redirection URL or NULL if not redirected. |

Function: xmlNanoHTTPReturnCode

int	xmlNanoHTTPReturnCode (void * ctx)

Get the latest HTTP return code received

| ctx: | the HTTP context | | Returns: | the HTTP return code for the request. |

Function: xmlNanoHTTPSave

int	xmlNanoHTTPSave (void * ctxt,
const char * filename)

This function saves the output of the HTTP transaction to a file It closes and free the context at the end

| ctxt: | the HTTP context | | filename: | the filename where the content should be saved | | Returns: | -1 in case of failure, 0 incase of success. |

Function: xmlNanoHTTPScanProxy

void	xmlNanoHTTPScanProxy (const char * URL)

(Re)Initialize the HTTP Proxy context by parsing the URL and finding the protocol host port it indicates. Should be like http://myproxy/ or http://myproxy:3128/ A NULL URL cleans up proxy informations.

| URL: | The proxy URL used to initialize the proxy context |

Daniel Veillard

|

|

|

|

|