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 "public".

       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 program to crash inexplicably.

SEE ALSO

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

GNU snmpkit 0.4                                   November 2000                                   snmpsession(3)