snmpsession(3)						     Library Functions Manual						    snmpsession(3)

NAME

       snmpsession - snmpkit functions dealing with a particular snmpsession.

SYNOPSIS

       #include <snmpkit.h>
       SNMPSESSION *sk_new_session(char *host, void *(start_routine)(SNMPSESSION*), const char *community);

DESCRIPTION

       A snmpsession is an opaque data structure which specifies a

       The  new_snmpsession()  creates	a  new session. The SNMPSOCK should have previously created by the application using, new_snmpsock().  The
       host should will be looked up using gethostbyname() and the community string is something like a password in SNMP lingo but it doesn't have
       a  username  associated	with  it  and  it  is transmitted in clear text within the packets. In most cases, there are a couple of community
       strings. One is only allowed to read and the other is allowed to both read and write. The default read-only community name is "public".	If
       set the community name to NULL, the community name will default to public.

       The  new_snmpsession_quick()  function is very similar to the new_snmpsession() function except the community name always defaults to "pub-
       lic".

       The delete_snmpsock() function is the opposite of the new_snmpsession() function. It frees all memory and resources currently being used by
       the SNMPSESSION structure.

RETURN VALUE

       The new_snmpsock() and the new_snmpsock_quick() both return a pointer to the newly created snmpsock or NULL if there was an error.

AUTHOR

       Ben Woodard <ben@users.sourceforge.net>

BUGS

       The library can possibly throw different kinds of C++ exceptions that won't be caught by the glue code and therefore it can cause your pro-
       gram to crash inexplicably.

SEE ALSO

       libsnmpkit(3), snmpsock(3), snmpstructfiller(3), snmptable(3), gethostbyname(3)

GNU snmpkit 0.4 						   November 2000						    snmpsession(3)