Go to main content

man pages section 1: User Commands

Exit Print View

Updated: Thursday, June 13, 2019
 
 

agentxtrap (1)

Name

agentxtrap - send an AgentX NotifyPDU to an AgentX master agent

Synopsis

agentxtrap [OPTIONS] trap-oid [OID TYPE VALUE...]

Description

AGENTXTRAP(1)                      Net-SNMP                      AGENTXTRAP(1)



NAME
       agentxtrap - send an AgentX NotifyPDU to an AgentX master agent

SYNOPSIS
       agentxtrap [OPTIONS] trap-oid [OID TYPE VALUE...]

DESCRIPTION
       agentxtrap  issues  an  AgentX NotifyPDU to a master agent. One or more
       object identifiers (OIDs) can be given  as  arguments  on  the  command
       line.   A type and a value must accompany each object identifier.  Each
       variable name is given in the format specified in variables(5).

OPTIONS
       -c contextName
             if the -c option is present then the notification is sent in  the
             nondefault name context.
       -U uptime
             if  the -U option is present then that value, parsed as centisec-
             onds, is taken to be the sysUpTime field of the application.
       -x ADDRESS
             if the -x option is present then contact  the  AgentX  master  at
             ADDRESS and not the default one.

       Additionally  all  the  options  described  in snmpcmd(1) under the MIB
       PARSING OPTIONS, LOGGING OPTIONS and INPUT OPTIONS headers as  well  as
       the -d, -D, -m and -M options are supported.

       In  OID  TYPE VALUE the parsing of the VALUE field is controlled by the
       TYPE field. The possible values for the TYPE field is one of  the  fol-
       lowing characters:
              =  Let OID decide how VALUE should be interpreted
              i  INTEGER
              u  Unsigned
              c  Counter32
              s  OCTET STRING of chaacters
              x  OCTET STRING, entered as a sequence of optionally space sepa-
                 rated hexadecimal digit pairs
              d  OCTET STRING, entered as a sequence of space separated  deci-
                 mal digits in the range 0 - 255
              n  NULL
              o  OBJECT IDENTIFIER
              t  TimeTicks
              a  IpAddress
              b  BITS
       which are handled in the same way as the snmpset command.

EXAMPLES
       To  send  a generic linkUp trap to the manager for interface 1 the fol-
       lowing command can be used:

       agentxtrap netSnmp.0.3 ifindex.1 i 1

ATTRIBUTES
       See attributes(7) for descriptions of the following attributes:


       +---------------+-----------------------------------------------+
       |ATTRIBUTE TYPE |               ATTRIBUTE VALUE                 |
       +---------------+-----------------------------------------------+
       |Availability   | system/management/snmp/net-snmp/documentation |
       +---------------+-----------------------------------------------+
       |Stability      | Volatile                                      |
       +---------------+-----------------------------------------------+
SEE ALSO
       snmpcmd(1), snmpset(1), variables(5), RFC 2741



NOTES
       This    software    was    built    from    source     available     at
       https://github.com/oracle/solaris-userland.    The  original  community
       source  was  downloaded  from   http://ftp.ntua.gr/mirror/net-snmp/net-
       snmp/5.7.3/net-snmp-5.7.3.tar.gz

       Further information about this software can be found on the open source
       community website at http://www.net-snmp.org/.



V5.7.3                            20 Dec 2009                    AGENTXTRAP(1)