SNMP_API_ERRORS(3)

NAME
snmp_api_error, snmp_api_errno - Deal with SNMP API Errors

SYNOPSIS
cc [ flag ... ] file ... -lsnmp [ library ... ]

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

char *snmp_api_error(int errno);

int snmp_api_errno(void);

DESCRIPTION
snmp_api_errno() returns the current SNMP API error status.

snmp_api_error() returns a string describing what the error represents.

ERROR VALUES
The possible error values are:

SNMPERR_GENERR
    A generic occured.

SNMPERR_BAD_LOCPORT

SNMPERR_BAD_ADDRESS

SNMPERR_BAD_SESSION

SNMPERR_TOO_LONG
    Data too long for provided buffer

SNMPERR_ASN_ENCODE
    There was a problem encoding the ASN1/BER stream.

SNMPERR_ASN_DECODE
    There was a problem decoding the ASN1/BER stream.

SNMPERR_PDU_TRANSLATION
    Unable to translate the specified PDU.

SNMPERR_OS_ERR
    An OS error occured. Most likely a failed malloc.

SNMPERR_INVALID_TXTOID
    The textual oid usaed was invalid

SNMPERR_UNABLE_TO_FIX
    Unable to fix this PDU. Caused by the PDU not being a response, not containing an error, or the errindex being invalid.

SNMPERR_UNSUPPORTED_TYPE
    An unsupported OID type was encountered.

SNMPERR_PDU_PARSE
    The PDU was decoded, but it contained something unexpected.

SNMPERR_PACKET_ERR

SNMPERR_NO_RESPONSE

NOTES
The error message is stored in the data segment of the library. Do not attempt to free()
 it.

RFCS
Related RFCs: 1065, 1066, 1067
Related SNMPv2 RFCs: 1901, 1902, 1902, 1904, 1905, 1906, 1907, 1908, 1909

RELATED URLS
CMU Networking Group: http://www.net.cmu.edu/
CMU SNMP Home Page: http://www.net.cmu.edu/projects/snmp

SEE ALSO
snmp_api(3), snmp_api_errors(3), snmp_client(3), snmp_coexistance(3), snmp_error(3), snmp_extra(3), snmp_mib(3), snmp_mibii(3), snmp_mini_client(3), snmp_msg(3), snmp_packet_dump(3), snmp_pdu(3), snmp_sess_api(3), snmp_vars(3), snmp_version_info(3), snmp_oid(5) snmp(3)