bionic (3) snmpsession.3.gz

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)