admsnmpcommunity(1M) DG/UX R4.11MU05 admsnmpcommunity(1M)
NAME
admsnmpcommunity - manage the SNMP community database
SYNOPSIS
admsnmpcommunity -o add [ -qn ] -a access -h host|any community
admsnmpcommunity -o delete [ -qn ] [ -h host|any ] community
admsnmpcommunity -o modify [ -qn ] [ -A new-access ] [ -C new-
community ] [ -H new-host|any ] [ -h host|any ] community
admsnmpcommunity -o list [ -q|v ] [ -h host|any ] [ all|community ...
]
admsnmpcommunity -o search [ -h host|any ] community
DESCRIPTION
Use admsnmpcommunity to manage the SNMP community database. The
community database is located in the /etc/snmpd.conf file. Each
community entry in the file defines a community that snmpd, will
recognize. Each community entry consists of a keyword community, the
community name, host name, and a level of access. Specify the
community and host fields so they uniquely identify the entry.
add Add a new community record to the database.
delete Remove the entry for community from the database.
modify Change the existing entry for community in the database.
list List the entry for community from the database. If no
community is specified or the keyword all is given, all
entries in the database are displayed.
search Search for the community in the database. If the entry is
found, it is written to stdout, otherwise the operation
exits with an error code.
Options
-h host|any
Use the host option to specify the host for an add
operation or to qualify a specific community for the delete
and modify operations. The keyword all may be used to
specify the address 0.0.0.0, which means any Internet
address.
-A new-access
Use the new-access option to specify the new access level
for community. new-access should be specified as one of
the following: read, write, or none.
-a access Use the access option to specify the access level for
community. access should be specified as one of the
following: read, write, or none.
-C new-community
Use the new-community option to specify the new community
name for community.
-H new-host
Use the new-host option to specify the new host name for
community.
-q For the list operation this produces an unformatted
listing. (i.e., no headers). For the add,delete, and
modify operations it suppresses confirmation messages.
-v Use the verbose option to produce a formatted listing with
headers and aligned columns. This option is enabled by
default.
-n Use this option to make changes to the database without
reconfiguring the agent.
FILES
/etc/snmpd.conf the SNMP agent configuration file.
DIAGNOSTICS
Warnings
- If the agent can not reconfigure the agent.
- If the delete or modify operation is requested and the community-
host pair does not exist.
Errors
- If the add operation is requested and the community-host pair
already exists.
- If the add operation is requested and the access is not one of
the following: read, write, or none.
- If the modify operation is requested and the new-access is not
one of the following: read, write, or none.
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.
NOTES
Access to the add, delete, and modify operations is granted based on
write access to the /etc/snmpd.conf file. Access to the list and
search operation is granted based upon read access to the
/etc/snmpd.conf file.
SEE ALSO
snmpd(1M), snmpd.conf(4M), sysadm(1M).
Licensed material--property of copyright holder(s)