Unix/Linux Go Back    

OpenSolaris 2009.06 - man page for ne_session_create (opensolaris section 3)

Linux & Unix Commands - Search Man Pages
Man Page or Keyword Search:   man
Select Man Page Set:       apropos Keyword Search (sections above)

NE_SESSION_CREATE(3)			neon API reference		     NE_SESSION_CREATE(3)

       ne_session_create, ne_close_connection, ne_session_proxy, ne_session_destroy - set up HTTP

       #include <ne_session.h>

       ne_session *ne_session_create (const char *scheme, const char *hostname,
				      unsigned int port);

       void ne_session_proxy (ne_session *session, const char *hostname, unsigned int port);

       void ne_close_connection (ne_session *session);

       void ne_session_destroy (ne_session *session);

       An ne_session object represents an HTTP session - a logical grouping of a sequence of HTTP
       requests made to a certain server. Any requests made using the session can use  a  persis-
       tent connection, share cached authentication credentials and any other common attributes.

       A new HTTP session is created using ne_session_create, giving the hostname and port of the
       server to use, along with the scheme used to contact the server (usually  "http").  Before
       the  first use of ne_session_create in a process, ne_sock_init(3) must have been called to
       perform any global initialization needed by any libraries used by neon.

       To enable SSL/TLS for the session, pass the string "https" as the  scheme  parameter,  and
       either  register  a  certificate verification function (see ne_ssl_set_verify(3)) or trust
       the appropriate certificate (see ne_ssl_trust_cert(3), ne_ssl_trust_default_ca(3)).

       If an HTTP proxy server should be used for the session, ne_session_proxy  must  be  called
       giving the hostname and port on which to contact the proxy.

       If  it  is  known  that	the  session  will  not be used for a significant period of time,
       ne_close_connection can be called to close the connection, if one  remains  open.  Use  of
       this function is entirely optional, but it must not be called if there is a request active
       using the session.

       Once a session has been completed, ne_session_destroy must be called to	destroy  the  re-
       sources	associated  with  the session. Any subsequent use of the session pointer produces
       undefined behaviour.

       The hostname passed to ne_session_create is resolved when the first request using the ses-
       sion  is dispatched; a DNS resolution failure can only be detected at that time (using the
       NE_LOOKUP error code); see ne_request_dispatch(3) for details.

       ne_session_create will return a pointer to a new session object (and never NULL).

       Create and destroy a session:

       ne_session *sess;
       sess = ne_session_create("http", "host.example.com", 80);
       /* ... use sess ... */

       ne_ssl_set_verify(3), ne_ssl_trust_cert(3), ne_sock_init(3)

       Joe Orton <neon@webdav.org>.

       See attributes(5) for descriptions of the following attributes:

       |Availability	    | SUNWneon	      |
       |Interface Stability | Volatile	      |
       Source for Neon is available on http://opensolaris.org.

neon 0.25.5				 20 January 2006		     NE_SESSION_CREATE(3)
Unix & Linux Commands & Man Pages : ©2000 - 2018 Unix and Linux Forums

All times are GMT -4. The time now is 02:56 AM.