snmp_send()

send SNMP messages

Synopsis:

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

extern int snmp_errno

int snmp_send( struct snmp_session *session,
               struct snmp_pdu *pdu)

Description:

This function sends the PDU on the session provided. If necessary, some of the snmp_pdu structure data is set from the session defaults. A request corresponding to this PDU is added to the list of outstanding requests on this session and then the packet is sent.

This function frees pdu unless an error occurs.

Returns:

The request ID of the generated packet, if applicable. If not applicable, this function returns 1. If an error occurs, 0 is returned and snmp_errno is set.

Errors:

If an error occurred, snmp_errno could contain one of the following:

SNMPERR_BAD_ADDRESS
A necessary entity in the pdu structure was omitted. These include:
SNMPERR_BAD_SESSION
The specified session wasn't open.
SNMPERR_GENERR
An error occurred forming the packet.

Classification:

SNMP

Safety:
Interrupt handler No
Signal handler No
Thread No

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)