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:

snmp3r.lib, snmp3s.lib

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:

SNMP

See also:

<snmp_api.h>, snmp_close(), snmp_open(), snmp_pdu, snmp_read(), snmp_select_info(), snmp_send(), snmp_session, snmp_timeout()

select() in the C Library Reference

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)