AN_NEW_CONNECTIONSection: Antinat Programmer's Manual (3)
Index Return to Main Contents
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.
Malcolm Smith <firstname.lastname@example.org>
Time: 14:19:44 GMT, January 09, 2005