admsnmptrap(1M) DG/UX 5.4.2 admsnmptrap(1M)
NAME
admsnmptrap - manage the SNMP traps database
SYNOPSIS
admsnmptrap -o add -p port|default -c community host
admsnmptrap -o delete [ -c community ] host
admsnmptrap -o modify [ -P new-port|default ] [ -C new-community ] [
-H new-host ] [ -c community ] host
admsnmptrap -o list [ -q|v ] [ -c community ] [ all|host ... ]
admsnmptrap -o search [ -c community ] host
DESCRIPTION
Use admsnmptrap to manage the SNMP traps database. The traps
database is located in the /etc/snmpd.trapcommunities file. The
SNMP agent, snmpd, will send traps to the hosts specified in the
traps database. Each entry consists of a community name, host name,
and a port number. Specify the community and host pair so that they
uniquely identify an entry in the file.
add Add a new entry to the database. Specify the port as
either an integer value or the keyword default, which will
set the port number to 162. Specify the community as an
ASCII string of 64 or fewer characters. Specify the host
as either a hostname or Internet address indicating where
the agent should send the traps.
delete Remove the entry for host from the database. If multiple
entries for host exist, and the -c option is not used to
qualify which entry to delete, all matching entries are
deleted.
modify Change the existing entry for host in the database. If
multiple entries for host exist, you should use the -c
option to qualify which entry to modify.
list List the entry for host from the database. If no host is
specified or the keyword all is used then all the entries
in the database are displayed.
search Search for an entry for host in the database. If the entry
is found, it is written to stdout, otherwise the operation
exits with an error code.
Options
-c community
You can use the community option to qualify the host on
which to perform the operation should there be multiple
entries for the host in the database.
Licensed material--property of copyright holder(s) 1
admsnmptrap(1M) DG/UX 5.4.2 admsnmptrap(1M)
-P new-port
Use the new-port option to specify the port number to be
assigned to the host entry after the modification is
complete.
-p port Use the port option to specify the port number to be
assigned to the host entry. You can specify the keyword
default which will set the port number to 162.
-C new-community
Use the new-community option to specify the community name
to be assigned to the host entry after the modification is
complete.
-H new-host
Use the new-host option to specify the host name to be
assigned to the existing host entry after the modification
is complete.
-q Use the "Quiet" option to produce an unformatted listing
(that is, no headers)
-v Use the "Verbose" option to produce a formatted listing
with headers and aligned columns. This is the default.
FILES
/etc/snmpd.trapcommunities the traps database.
DIAGNOSTICS
Warnings
- If the agent can not be sent a SIGHUP signal to request
reconfiguration.
- If you request the delete or modify operation and the community-
host pair does not exist.
Errors
- If you request the add operation and the community-host pair
already exists.
- If you request the modify operation and the community-host pair
is not unique.
Exit Codes
0 The operation was successful.
1 The operation was unsuccessful.
2 The operation failed due to access restrictions.
3 There was an error in the command line.
SEE ALSO
snmpd(1M), sysadm(1M), snmpd.trapcommunities(4M).
Licensed material--property of copyright holder(s) 2
admsnmptrap(1M) DG/UX 5.4.2 admsnmptrap(1M)
NOTES
Access to the add, delete, and modify operations is granted based
upon write access to the /etc/snmpd.trapcommunities file.
Generally, only the system administrator has this access. Access to
the list and search operation is granted based upon read access to
the /etc/snmpd.trapcommunities file. Generally, everyone has this
access.
Licensed material--property of copyright holder(s) 3