AN_NEW_CONNECTION
Section: Antinat Programmer's Manual (3)Updated: 2005-01-03
Index Return to Main Contents
NAME
an_new_connection - create a socket handle
SYNOPSIS
#include <antinat.h>
DESCRIPTION
The an_new_connection(3) function is used to create a new connection handle, performing any allocation and initialisation necessary. Any successfully created connection must be cleaned up when it is no longer required with the an_destroy(3) function. After the connection handle has been created, it should be initialised with whatever proxy settings are required, then connected or bound as required. After the connection has been closed, the connection handle can be reused, and will remember all of the proxy setting information associated with it.
A freshly created connection handle will be created with default proxy information. By default, the handle will not be associated with any proxy server, and will not contain any credentials, and will be a blocking connection. However, if the AN_PROXY environment variable is declared, it can contain a url specifying the proxy server that should be used. In addition, the AN_USER and AN_PASS variables can specify the username and password respectively, if the specified proxy server requires authentication. By default, any available authentication scheme can be used.
RETURN VALUE
This call returns a valid connection handle, or NULL if a connection handle could not be created.
ERRORS
If an error occurs, the return value will be NULL. This is most likely an out of memory condition.
SEE ALSO
an_destroy(3), an_set_credentials(3), an_set_proxy_url(3)
AUTHOR
Malcolm Smith <[email protected]>
Index
Time: 14:19:44 GMT, January 09, 2005