snmp_open()

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 );

Arguments:

session: A pointer to a snmp_session structure that defines the SNMP session that you want to open.

Library:

libsnmp

Use the -l snmp option to qcc to link against this library.

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.

Based on:

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)

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:

If an error occurs, this function sets snmp_errno to one of:

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

Classification:

SNMP

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