netsnmp_example_scalar_int(3) [redhat man page]

example_scalar_int: instantiates a few example scalars.(3)   Library Functions Manual	example_scalar_int: instantiates a few example scalars.(3)

NAME

       example_scalar_int: instantiates a few example scalars. - This example merely creates some scalar registrations that allows some simple
       variables to be accessed via SNMP.  More...

   Functions
       void init_scalar_int (void)

DETAILED DESCRIPTION

       This example merely creates some scalar registrations that allows some simple variables to be accessed via SNMP.

       In a more realistic example, it is likely that these variables would also be manipulated in other ways outside of SNMP gets/sets.

       If this module is compiled into an agent, you should be able to issue snmp commands that look something like (authentication information
       not shown in these commands):

       snmpget localhost netSnmpExampleInteger.0 netSnmpExampleScalars = 42

       snmpset localhost netSnmpExampleInteger.0 = 1234 netSnmpExampleScalars = 1234

       snmpget localhost netSnmpExampleInteger.0 netSnmpExampleScalars = 1234

net-snmp							    6 Mar 2002		example_scalar_int: instantiates a few example scalars.(3)

SNMPGET(1)							     Net-SNMP								SNMPGET(1)

NAME

       snmpget - communicates with a network entity using SNMP GET requests

SYNOPSIS

       snmpget [COMMON OPTIONS] [-Cf] OID [OID]...

DESCRIPTION

       snmpget is an SNMP application that uses the SNMP GET request to query for information on a network entity.  One or more object identifiers
       (OIDs) may be given as arguments on the command line.  Each variable name is given in the format specified in variables(5).

OPTIONS

       -Cf     If -Cf is not specified, some applications (snmpdelta, snmpget, snmpgetnext and snmpstatus) will try to fix errors returned by  the
	       agent  that  you were talking to and resend the request.  The only time this is really useful is if you specified a OID that didn't
	       exist in your request and you're using SNMPv1 which requires "all or nothing" kinds of requests.

       In addition to this option, snmpget REQUIRES options and agent arguments, as described in the snmpcmd(1) manual page.

EXAMPLES

       The command:

	   snmpget -c public zeus system.sysDescr.0

       will retrieve the variable system.sysDescr.0 from the host zeus using the community string public :

	   system.sysDescr.0 = "SunOS zeus.net.cmu.edu 4.1.3_U1 1 sun4m"

       If the network entity has an error processing the request packet, an error packet will be returned and a message will be shown, helping	to
       pinpoint  in  what way the request was malformed.  If there were other variables in the request, the request will be resent without the bad
       variable.

       Here is another example. The -c and -v options are defined in the snmpcmd(1) manual page. (Note that system.sysUpTime is an incomplete OID,
       as it needs the .0 index appended to it):

	   snmpget -v1 -Cf -c public localhost system.sysUpTime system.sysContact.0

       This example will return the following:

	   Error in packet
	   Reason: (noSuchName) There is no such variable name in this MIB.
	   This name doesn't exist: system.sysUpTime

       Similarly, the command:
	   snmpget -v1 -c public localhost system.sysUpTime system.sysContact.0

       Will return:

	   Error in packet
	   Reason: (noSuchName) There is no such variable name in this MIB.
	   This name doesn't exist: system.sysUpTime

	   system.sysContact.0 = STRING: root@localhost

       With the -Cf flag specified the application will not try to fix the PDU for you.

SEE ALSO

       snmpcmd(1), snmpwalk(1), variables(5).

4th Berkeley Distribution					    08 Feb 2002 							SNMPGET(1)