Blame apps/snmpbulkwalk.c

Packit fcad23
/*
Packit fcad23
 * snmpbulkwalk.c - send SNMPv2 Bulk requests to a network entity, walking a
Packit fcad23
 * subtree.
Packit fcad23
 *
Packit fcad23
 */
Packit fcad23
/*********************************************************************
Packit fcad23
	Copyright 1988, 1989, 1991, 1992 by Carnegie Mellon University
Packit fcad23
Packit fcad23
                      All Rights Reserved
Packit fcad23
Packit fcad23
Permission to use, copy, modify, and distribute this software and its 
Packit fcad23
documentation for any purpose and without fee is hereby granted, 
Packit fcad23
provided that the above copyright notice appear in all copies and that
Packit fcad23
both that copyright notice and this permission notice appear in 
Packit fcad23
supporting documentation, and that the name of CMU not be
Packit fcad23
used in advertising or publicity pertaining to distribution of the
Packit fcad23
software without specific, written prior permission.  
Packit fcad23
Packit fcad23
CMU DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE, INCLUDING
Packit fcad23
ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO EVENT SHALL
Packit fcad23
CMU BE LIABLE FOR ANY SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR
Packit fcad23
ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS,
Packit fcad23
WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION,
Packit fcad23
ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS
Packit fcad23
SOFTWARE.
Packit fcad23
**********************************************************************/
Packit fcad23
#include <net-snmp/net-snmp-config.h>
Packit fcad23
Packit fcad23
#if HAVE_STDLIB_H
Packit fcad23
#include <stdlib.h>
Packit fcad23
#endif
Packit fcad23
#if HAVE_UNISTD_H
Packit fcad23
#include <unistd.h>
Packit fcad23
#endif
Packit fcad23
#if HAVE_STRING_H
Packit fcad23
#include <string.h>
Packit fcad23
#else
Packit fcad23
#include <strings.h>
Packit fcad23
#endif
Packit fcad23
#include <sys/types.h>
Packit fcad23
#if HAVE_NETINET_IN_H
Packit fcad23
#include <netinet/in.h>
Packit fcad23
#endif
Packit fcad23
#if TIME_WITH_SYS_TIME
Packit fcad23
# include <sys/time.h>
Packit fcad23
# include <time.h>
Packit fcad23
#else
Packit fcad23
# if HAVE_SYS_TIME_H
Packit fcad23
#  include <sys/time.h>
Packit fcad23
# else
Packit fcad23
#  include <time.h>
Packit fcad23
# endif
Packit fcad23
#endif
Packit fcad23
#if HAVE_SYS_SELECT_H
Packit fcad23
#include <sys/select.h>
Packit fcad23
#endif
Packit fcad23
#include <stdio.h>
Packit fcad23
#include <ctype.h>
Packit fcad23
#if HAVE_NETDB_H
Packit fcad23
#include <netdb.h>
Packit fcad23
#endif
Packit fcad23
#if HAVE_ARPA_INET_H
Packit fcad23
#include <arpa/inet.h>
Packit fcad23
#endif
Packit fcad23
Packit fcad23
#include <net-snmp/net-snmp-includes.h>
Packit fcad23
Packit fcad23
#define NETSNMP_DS_WALK_INCLUDE_REQUESTED		1
Packit fcad23
#define NETSNMP_DS_WALK_PRINT_STATISTICS		2
Packit fcad23
#define NETSNMP_DS_WALK_DONT_CHECK_LEXICOGRAPHIC	3
Packit fcad23
Packit fcad23
oid             objid_mib[] = { 1, 3, 6, 1, 2, 1 };
Packit fcad23
int             numprinted = 0;
Packit fcad23
int             reps = 10, non_reps = 0;
Packit fcad23
Packit fcad23
void
Packit fcad23
usage(void)
Packit fcad23
{
Packit fcad23
    fprintf(stderr, "USAGE: snmpbulkwalk ");
Packit fcad23
    snmp_parse_args_usage(stderr);
Packit fcad23
    fprintf(stderr, " [OID]\n\n");
Packit fcad23
    snmp_parse_args_descriptions(stderr);
Packit fcad23
    fprintf(stderr,
Packit fcad23
            "  -C APPOPTS\t\tSet various application specific behaviours:\n");
Packit fcad23
    fprintf(stderr,
Packit fcad23
            "\t\t\t  c:       do not check returned OIDs are increasing\n");
Packit fcad23
    fprintf(stderr,
Packit fcad23
            "\t\t\t  i:       include given OIDs in the search range\n");
Packit fcad23
    fprintf(stderr, "\t\t\t  n<NUM>:  set non-repeaters to <NUM>\n");
Packit fcad23
    fprintf(stderr,
Packit fcad23
            "\t\t\t  p:       print the number of variables found\n");
Packit fcad23
    fprintf(stderr, "\t\t\t  r<NUM>:  set max-repeaters to <NUM>\n");
Packit fcad23
}
Packit fcad23
Packit fcad23
static void
Packit fcad23
snmp_get_and_print(netsnmp_session * ss, oid * theoid, size_t theoid_len)
Packit fcad23
{
Packit fcad23
    netsnmp_pdu    *pdu, *response;
Packit fcad23
    netsnmp_variable_list *vars;
Packit fcad23
    int             status;
Packit fcad23
Packit fcad23
    pdu = snmp_pdu_create(SNMP_MSG_GET);
Packit fcad23
    snmp_add_null_var(pdu, theoid, theoid_len);
Packit fcad23
Packit fcad23
    status = snmp_synch_response(ss, pdu, &response);
Packit fcad23
    if (status == STAT_SUCCESS && response->errstat == SNMP_ERR_NOERROR) {
Packit fcad23
        for (vars = response->variables; vars; vars = vars->next_variable) {
Packit fcad23
            numprinted++;
Packit fcad23
            print_variable(vars->name, vars->name_length, vars);
Packit fcad23
        }
Packit fcad23
    }
Packit fcad23
    if (response) {
Packit fcad23
        snmp_free_pdu(response);
Packit fcad23
    }
Packit fcad23
}
Packit fcad23
Packit fcad23
static
Packit fcad23
    void
Packit fcad23
optProc(int argc, char *const *argv, int opt)
Packit fcad23
{
Packit fcad23
    char           *endptr = NULL;
Packit fcad23
Packit fcad23
    switch (opt) {
Packit fcad23
    case 'C':
Packit fcad23
        while (*optarg) {
Packit fcad23
            switch (*optarg++) {
Packit fcad23
            case 'c':
Packit fcad23
                netsnmp_ds_toggle_boolean(NETSNMP_DS_APPLICATION_ID,
Packit fcad23
				     NETSNMP_DS_WALK_DONT_CHECK_LEXICOGRAPHIC);
Packit fcad23
                break;
Packit fcad23
Packit fcad23
            case 'i':
Packit fcad23
                netsnmp_ds_toggle_boolean(NETSNMP_DS_APPLICATION_ID,
Packit fcad23
					  NETSNMP_DS_WALK_INCLUDE_REQUESTED);
Packit fcad23
                break;
Packit fcad23
Packit fcad23
            case 'n':
Packit fcad23
            case 'r':
Packit fcad23
                if (*(optarg - 1) == 'r') {
Packit fcad23
                    reps = strtol(optarg, &endptr, 0);
Packit fcad23
                } else {
Packit fcad23
                    non_reps = strtol(optarg, &endptr, 0);
Packit fcad23
                }
Packit fcad23
Packit fcad23
                if (endptr == optarg) {
Packit fcad23
                    /*
Packit fcad23
                     * No number given -- error.  
Packit fcad23
                     */
Packit fcad23
                    usage();
Packit fcad23
                    exit(1);
Packit fcad23
                } else {
Packit fcad23
                    optarg = endptr;
Packit fcad23
                    if (isspace((unsigned char)(*optarg))) {
Packit fcad23
                        return;
Packit fcad23
                    }
Packit fcad23
                }
Packit fcad23
                break;
Packit fcad23
Packit fcad23
            case 'p':
Packit fcad23
                netsnmp_ds_toggle_boolean(NETSNMP_DS_APPLICATION_ID,
Packit fcad23
					  NETSNMP_DS_WALK_PRINT_STATISTICS);
Packit fcad23
                break;
Packit fcad23
Packit fcad23
            default:
Packit fcad23
                fprintf(stderr, "Unknown flag passed to -C: %c\n",
Packit fcad23
                        optarg[-1]);
Packit fcad23
                exit(1);
Packit fcad23
            }
Packit fcad23
        }
Packit fcad23
        break;
Packit fcad23
    }
Packit fcad23
}
Packit fcad23
Packit fcad23
int
Packit fcad23
main(int argc, char *argv[])
Packit fcad23
{
Packit fcad23
    netsnmp_session session, *ss;
Packit fcad23
    netsnmp_pdu    *pdu, *response;
Packit fcad23
    netsnmp_variable_list *vars;
Packit fcad23
    int             arg;
Packit fcad23
    oid             name[MAX_OID_LEN];
Packit fcad23
    size_t          name_length;
Packit fcad23
    oid             root[MAX_OID_LEN];
Packit fcad23
    size_t          rootlen;
Packit fcad23
    int             count;
Packit fcad23
    int             running;
Packit fcad23
    int             status = STAT_ERROR;
Packit fcad23
    int             check;
Packit fcad23
    int             exitval = 1;
Packit fcad23
Packit fcad23
    SOCK_STARTUP;
Packit fcad23
Packit fcad23
    netsnmp_ds_register_config(ASN_BOOLEAN, "snmpwalk", "includeRequested",
Packit fcad23
			       NETSNMP_DS_APPLICATION_ID, 
Packit fcad23
			       NETSNMP_DS_WALK_INCLUDE_REQUESTED);
Packit fcad23
    netsnmp_ds_register_config(ASN_BOOLEAN, "snmpwalk", "printStatistics",
Packit fcad23
			       NETSNMP_DS_APPLICATION_ID, 
Packit fcad23
			       NETSNMP_DS_WALK_PRINT_STATISTICS);
Packit fcad23
    netsnmp_ds_register_config(ASN_BOOLEAN, "snmpwalk", "dontCheckOrdering",
Packit fcad23
			       NETSNMP_DS_APPLICATION_ID,
Packit fcad23
			       NETSNMP_DS_WALK_DONT_CHECK_LEXICOGRAPHIC);
Packit fcad23
Packit fcad23
    /*
Packit fcad23
     * get the common command line arguments 
Packit fcad23
     */
Packit fcad23
    switch (arg = snmp_parse_args(argc, argv, &session, "C:", optProc)) {
Packit fcad23
    case NETSNMP_PARSE_ARGS_ERROR:
Packit fcad23
        goto out;
Packit fcad23
    case NETSNMP_PARSE_ARGS_SUCCESS_EXIT:
Packit fcad23
        exitval = 0;
Packit fcad23
        goto out;
Packit fcad23
    case NETSNMP_PARSE_ARGS_ERROR_USAGE:
Packit fcad23
        usage();
Packit fcad23
        goto out;
Packit fcad23
    default:
Packit fcad23
        break;
Packit fcad23
    }
Packit fcad23
Packit fcad23
    /*
Packit fcad23
     * get the initial object and subtree 
Packit fcad23
     */
Packit fcad23
    if (arg < argc) {
Packit fcad23
        /*
Packit fcad23
         * specified on the command line 
Packit fcad23
         */
Packit fcad23
        rootlen = MAX_OID_LEN;
Packit fcad23
        if (snmp_parse_oid(argv[arg], root, &rootlen) == NULL) {
Packit fcad23
            snmp_perror(argv[arg]);
Packit fcad23
            goto out;
Packit fcad23
        }
Packit fcad23
    } else {
Packit fcad23
        /*
Packit fcad23
         * use default value 
Packit fcad23
         */
Packit fcad23
        memmove(root, objid_mib, sizeof(objid_mib));
Packit fcad23
        rootlen = sizeof(objid_mib) / sizeof(oid);
Packit fcad23
    }
Packit fcad23
Packit fcad23
    /*
Packit fcad23
     * open an SNMP session 
Packit fcad23
     */
Packit fcad23
    ss = snmp_open(&session);
Packit fcad23
    if (ss == NULL) {
Packit fcad23
        /*
Packit fcad23
         * diagnose snmp_open errors with the input netsnmp_session pointer 
Packit fcad23
         */
Packit fcad23
        snmp_sess_perror("snmpbulkwalk", &session);
Packit fcad23
        goto out;
Packit fcad23
    }
Packit fcad23
Packit fcad23
    /*
Packit fcad23
     * setup initial object name 
Packit fcad23
     */
Packit fcad23
    memmove(name, root, rootlen * sizeof(oid));
Packit fcad23
    name_length = rootlen;
Packit fcad23
Packit fcad23
    running = 1;
Packit fcad23
Packit fcad23
    check = !netsnmp_ds_get_boolean(NETSNMP_DS_APPLICATION_ID,
Packit fcad23
				    NETSNMP_DS_WALK_DONT_CHECK_LEXICOGRAPHIC);
Packit fcad23
    if (netsnmp_ds_get_boolean(NETSNMP_DS_APPLICATION_ID,
Packit fcad23
			       NETSNMP_DS_WALK_INCLUDE_REQUESTED)) {
Packit fcad23
        snmp_get_and_print(ss, root, rootlen);
Packit fcad23
    }
Packit fcad23
Packit fcad23
    exitval = 0;
Packit fcad23
Packit fcad23
    while (running) {
Packit fcad23
        /*
Packit fcad23
         * create PDU for GETBULK request and add object name to request 
Packit fcad23
         */
Packit fcad23
        pdu = snmp_pdu_create(SNMP_MSG_GETBULK);
Packit fcad23
        pdu->non_repeaters = non_reps;
Packit fcad23
        pdu->max_repetitions = reps;    /* fill the packet */
Packit fcad23
        snmp_add_null_var(pdu, name, name_length);
Packit fcad23
Packit fcad23
        /*
Packit fcad23
         * do the request 
Packit fcad23
         */
Packit fcad23
        status = snmp_synch_response(ss, pdu, &response);
Packit fcad23
        if (status == STAT_SUCCESS) {
Packit fcad23
            if (response->errstat == SNMP_ERR_NOERROR) {
Packit fcad23
                /*
Packit fcad23
                 * check resulting variables 
Packit fcad23
                 */
Packit fcad23
                for (vars = response->variables; vars;
Packit fcad23
                     vars = vars->next_variable) {
Packit fcad23
                    if ((vars->name_length < rootlen)
Packit fcad23
                        || (memcmp(root, vars->name, rootlen * sizeof(oid))
Packit fcad23
                            != 0)) {
Packit fcad23
                        /*
Packit fcad23
                         * not part of this subtree 
Packit fcad23
                         */
Packit fcad23
                        running = 0;
Packit fcad23
                        continue;
Packit fcad23
                    }
Packit fcad23
                    numprinted++;
Packit fcad23
                    print_variable(vars->name, vars->name_length, vars);
Packit fcad23
                    if ((vars->type != SNMP_ENDOFMIBVIEW) &&
Packit fcad23
                        (vars->type != SNMP_NOSUCHOBJECT) &&
Packit fcad23
                        (vars->type != SNMP_NOSUCHINSTANCE)) {
Packit fcad23
                        /*
Packit fcad23
                         * not an exception value 
Packit fcad23
                         */
Packit fcad23
                        if (check
Packit fcad23
                            && snmp_oid_compare(name, name_length,
Packit fcad23
                                                vars->name,
Packit fcad23
                                                vars->name_length) >= 0) {
Packit fcad23
                            fprintf(stderr, "Error: OID not increasing: ");
Packit fcad23
                            fprint_objid(stderr, name, name_length);
Packit fcad23
                            fprintf(stderr, " >= ");
Packit fcad23
                            fprint_objid(stderr, vars->name,
Packit fcad23
                                         vars->name_length);
Packit fcad23
                            fprintf(stderr, "\n");
Packit fcad23
                            running = 0;
Packit fcad23
                            exitval = 1;
Packit fcad23
                        }
Packit fcad23
                        /*
Packit fcad23
                         * Check if last variable, and if so, save for next request.  
Packit fcad23
                         */
Packit fcad23
                        if (vars->next_variable == NULL) {
Packit fcad23
                            memmove(name, vars->name,
Packit fcad23
                                    vars->name_length * sizeof(oid));
Packit fcad23
                            name_length = vars->name_length;
Packit fcad23
                        }
Packit fcad23
                    } else {
Packit fcad23
                        /*
Packit fcad23
                         * an exception value, so stop 
Packit fcad23
                         */
Packit fcad23
                        running = 0;
Packit fcad23
                    }
Packit fcad23
                }
Packit fcad23
            } else {
Packit fcad23
                /*
Packit fcad23
                 * error in response, print it 
Packit fcad23
                 */
Packit fcad23
                running = 0;
Packit fcad23
                if (response->errstat == SNMP_ERR_NOSUCHNAME) {
Packit fcad23
                    printf("End of MIB\n");
Packit fcad23
                } else {
Packit fcad23
                    fprintf(stderr, "Error in packet.\nReason: %s\n",
Packit fcad23
                            snmp_errstring(response->errstat));
Packit fcad23
                    if (response->errindex != 0) {
Packit fcad23
                        fprintf(stderr, "Failed object: ");
Packit fcad23
                        for (count = 1, vars = response->variables;
Packit fcad23
                             vars && count != response->errindex;
Packit fcad23
                             vars = vars->next_variable, count++)
Packit fcad23
                            /*EMPTY*/;
Packit fcad23
                        if (vars)
Packit fcad23
                            fprint_objid(stderr, vars->name,
Packit fcad23
                                         vars->name_length);
Packit fcad23
                        fprintf(stderr, "\n");
Packit fcad23
                    }
Packit fcad23
                    exitval = 2;
Packit fcad23
                }
Packit fcad23
            }
Packit fcad23
        } else if (status == STAT_TIMEOUT) {
Packit fcad23
            fprintf(stderr, "Timeout: No Response from %s\n",
Packit fcad23
                    session.peername);
Packit fcad23
            running = 0;
Packit fcad23
            exitval = 1;
Packit fcad23
        } else {                /* status == STAT_ERROR */
Packit fcad23
            snmp_sess_perror("snmpbulkwalk", ss);
Packit fcad23
            running = 0;
Packit fcad23
            exitval = 1;
Packit fcad23
        }
Packit fcad23
        if (response)
Packit fcad23
            snmp_free_pdu(response);
Packit fcad23
    }
Packit fcad23
Packit fcad23
    if (numprinted == 0 && status == STAT_SUCCESS) {
Packit fcad23
        /*
Packit fcad23
         * no printed successful results, which may mean we were
Packit fcad23
         * pointed at an only existing instance.  Attempt a GET, just
Packit fcad23
         * for get measure. 
Packit fcad23
         */
Packit fcad23
        snmp_get_and_print(ss, root, rootlen);
Packit fcad23
    }
Packit fcad23
    snmp_close(ss);
Packit fcad23
Packit fcad23
    if (netsnmp_ds_get_boolean(NETSNMP_DS_APPLICATION_ID, 
Packit fcad23
			       NETSNMP_DS_WALK_PRINT_STATISTICS)) {
Packit fcad23
        printf("Variables found: %d\n", numprinted);
Packit fcad23
    }
Packit fcad23
Packit fcad23
out:
Packit fcad23
    SOCK_CLEANUP;
Packit fcad23
    return exitval;
Packit fcad23
}