snmp_open()

Open an SNMP session

Synopsis:

#include <sys/types.h>
#include <snmp/asn1.h>
#include <snmp/snmp_api.h>

extern int snmp_errno

struct snmp_session * snmp_open(
            struct snmp_session * session );

Library:

libsnmp

Description:

The snmp_open() function sets up an SNMP session with the information supplied by the application in the snmp_session structure pointed to by session. Next, snmp_open() opens and binds the necessary UDP port.

Returns:

A pointer to a snmp_session structure for the created session (which is different from the pointer passed to the function), or NULL if an error occurs (snmp_errno is set).

Errors:

SNMPERR_BAD_ADDRESS: Unknown host.
SNMPERR_BAD_LOCPORT: Couldn't bind to the specified port.
SNMPERR_GENERR: Couldn't open the socket.

Classification:

Safety:
Cancellation point	Yes
Interrupt handler	No
Signal handler	No
Thread	No

See also:

<snmp_api.h>

select(), snmp_close(), snmp_open(), snmp_pdu, snmp_read(), snmp_select_info(), snmp_send(), snmp_session, snmp_timeout()

RFC 1157, FAQ in Internet newsgroup comp.protocols.snmp

Marshall T. Rose, The Simple Book: An Introduction to Internet Management, Revised 2nd ed. (Prentice-Hall, 1996, ISBN 0-13-451659-1)