The OpenNET Project / Index page

[ новости /+++ | форум | wiki | теги | ]

Интерактивная система просмотра системных руководств (man-ов)

 ТемаНаборКатегория 
 
 [Cписок руководств | Печать]

snmptrapd (1)
  • >> snmptrapd (1) ( Solaris man: Команды и прикладные программы пользовательского уровня )
  • snmptrapd (8) ( Разные man: Команды системного администрирования )
  •  

    NAME

    snmptrapd - receive and log SNMP trap messages
     
    

    SYNOPSIS

    /usr/sfw/sbin/snmptrapd [options] [listening addresses]  

    DESCRIPTION

    The snmptrapd utility is an SNMP application that receives and logs SNMP TRAP and INFORM messages.

    The default is to listen on UDP port 162 on all IPv4 interfaces. Because 162 is a privileged port, snmptrapd must be be run as root.  

    OPTIONS

    This command supports the following options:

    -a

    Ignore authenticationFailure traps.

    -c file

    Read file as a configuration file.

    -C

    Do not read any configuration files except the one optionally specified by the -c option.

    -d

    Dump (in hexadecimal) the sent and received SNMP packets.

    -D token[,...]

    Turn on debugging output for the specified token(s). Use ALL for extremely verbose output.

    -e

    Print event numbers (rising/falling alarm, and so forth).

    -f

    Do not call fork() from the calling shell.

    -F format

    When logging to standard output, use the format in the string format. See Format Specifications below for more details.

    -h, --help

    Display a brief usage message and then exit.

    -H

    Display a list of configuration file directives understood by the trap daemon and then exit.

    -l d | 0-7

    Specifies the syslog(3C) facility to use when logging to syslog. d means LOG_DAEMON; 0 through 7 means LOG_LOCAL0 through LOG_LOCAL7. LOG_LOCAL0 is the default.

    -m miblist

    Specifies a colon-separated list of MIB modules to load for this application. This overrides the environment variable MIBS.

    -M dirlist

    Specifies a colon-separated list of directories to search for MIBs. This overrides the environment variable MIBDIRS.

    -n

    Do not attempt to translate source addresses of incoming packets into host names.

    -o file

    Log formatted incoming traps to file. Upon receipt of a SIGHUP, the daemon will close and reopen the log file. This feature is useful when rotating the log file with other utilities such as logrotate.

    -P

    Print formatted incoming traps to stderr.

    -s

    Log formatted incoming traps to syslog(3C). These syslog messages are sent with a level of LOG_WARNING and facility as determined by the -l flag (LOG_LOCAL0 by default). This is the default unless you use the -o or -P flag.

    -u file

    Save the process ID of the trap daemon in file.

    -v, --version

    Print version information for the trap daemon and then exit.

    In addition to the preceding options, snmptrapd takes the same output formatting options as the other Net-SNMP commands. See the section OUTPUT OPTIONS in snmpcmd(1M).

    For extensibility and configuration information, see snmptrapd.conf(4).  

    Format Specifications

    snmptrapd interprets format strings similarly to printf(3C). It interprets the following formatting sequences:

    %%

    A literal percent sign(%).

    %t

    Decimal number of seconds since the operating system's epoch, as returned by time(2).

    %y

    Current year on the local system.

    %m

    Current (numeric) month on the local system.

    %l

    Current day of month on the local system.

    %h

    Current hour on the local system.

    %j

    Current minute on the local system.

    %k

    Current second on the local system.

    %T

    The value of the sysUpTime.0 varbind in seconds.

    %Y

    The year field from the sysUpTime.0 varbind.

    %M

    The numeric month field from the sysUpTime.0 varbind.

    %L

    The day of month field from the sysUpTime.0 varbind.

    %H

    The hour field from the sysUpTime.0 varbind.

    %J

    The minute field from the sysUpTime.0 varbind.

    %K

    The seconds field from the sysUpTime.0 varbind.

    %a

    The contents of the agent-addr field of the PDU (v1 TRAPs only).

    %A

    The hostname corresponding to the contents of the agent-addr field of the PDU, if available. Otherwise the contents of the agent-addr field of the PDU (v1 TRAPs only).

    %b

    PDU source address (note that this is not necessarily an IPv4 address).

    %B

    PDU source hostname if available, otherwise PDU source address (which is not necessarily an IPv4 address).

    %N

    Enterprise string.

    %w

    Trap type (numeric, in decimal).

    %W

    Trap description.

    %q

    Trap sub-type (numeric, in decimal).

    %P

    Security information from the PDU (community name for v1/v2c, user and context for v3).

    %v

    List of trap's variable-bindings.

    In addition to these values, you can also specify an optional field width and precision, just as in printf(3C), and a flag value. The following flags are valid:

    -

    left justify

    0

    use leading zeros

    #

    use alternate form

    The "use alternate form" flag changes the behavior of some format flags. Normally, the fields that display time information base it on the local timezone, but this flag tells them to use GMT instead. Also, the variable-binding list is normally a tab-separated list, but this flag changes it to a comma-separated one. The alternate form for the uptime is similar to "3 days, 0:14:34.65".  

    Listening Addresses

    By default, snmptrapd listens for incoming SNMP TRAP and INFORM packets on UDP port 162 on all IPv4 interfaces. However, it is possible to modify this behavior by specifying one or more listening addresses as arguments to snmptrapd. See snmpd(1M) for more information about the format of listening addresses.  

    NOTIFICATION-LOG-MIB Support

    As of Net-SNMP 5.0, the snmptrapd application supports the NOTIFICATION-LOG-MIB. It does this by opening an AgentX subagent connection to the master snmpd agent and registering the notification log tables. As long as the snmpd application is started first, it will attach itself to it. Thus you should be able to view the last recorded notifications by means of the nlmLogTable and nlmLogVariableTable. See snmptrapd.conf(4) and the dontRetainLogs token for turning off this support. See the NOTIFICATION-LOG-MIB for more details about the MIB itself.  

    EXAMPLES

    Example 1: Using snmptrapd

    To get a message such as 14:03 TRAP3.1 from humpty.example.edu you can use a command similar to:

    # snmptrapd -P -F "%02.2h:%02.2j TRAP%w.%q from %A\n"
    

    If you want the same effect, but in GMT rather than local time, use:

    # snmptrapd -P -F "%#02.2h:%#02.2j TRAP%w.%q from %A\n"
    

    Example 2: Viewing Traps on the Host on Which You Invoke snmptrapd

    To view traps on the host from which you invoke snmptrapd, enter:

    # snmptrapd -P
    

    The preceding command sends output to stdout rather than to a log file.  

    EXIT STATUS

    0

    Successful completion.

    1

    A usage syntax error. A usage message is displayed. Also used for timeout errors.

     

    ATTRIBUTES

    See attributes(5) for descriptions of the following attributes:

    ATTRIBUTE TYPEATTRIBUTE VALUE
    AvailabilitySUNWsmagt
    Interface StabilityStable

     

    SEE ALSO

    snmpcmd(1M), snmpd(1M), printf(3C), syslog(3C), snmptrapd.conf(4), snmp_variables(4), attributes(5)


     

    Index

    NAME
    SYNOPSIS
    DESCRIPTION
    OPTIONS
    Format Specifications
    Listening Addresses
    NOTIFICATION-LOG-MIB Support
    EXAMPLES
    EXIT STATUS
    ATTRIBUTES
    SEE ALSO


    Поиск по тексту MAN-ов: 




    Спонсоры:
    Inferno Solutions
    Hosting by Hoster.ru
    Хостинг:

    Закладки на сайте
    Проследить за страницей
    Created 1996-2021 by Maxim Chirkov
    Добавить, Поддержать, Вебмастеру