admsnmpcommunity(1M)             DG/UX 5.4.2            admsnmpcommunity(1M)


NAME
       admsnmpcommunity - manage the SNMP community database

SYNOPSIS
       admsnmpcommunity -o add -a access -h host|any community

       admsnmpcommunity -o delete [ -h host|any ] community

       admsnmpcommunity -o modify [ -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.communities file.
       Each entry in the file defines a community that the SNMP agent,
       snmpd, will recognize.  Each entry consists of a community name, host
       name, and a level of access.  Specify the community and host fields
       so that they uniquely identify the entry.

       add       Add a new entry to the database.  Specify the access as one
                 of the following: read, write, or none.  Specify the host
                 argument as either a hostname, Internet address, or the
                 keyword any.  The keyword any indicates that the Internet
                 address 0.0.0.0 should be used, which allows all hosts to
                 use this community name.

       delete    Remove the entry for community from the database.  If
                 multiple entries for community exist, and the -h option is
                 not used to qualify which entry to delete, all matching
                 entries are deleted.

       modify    Change the existing entry for community in the database.
                 If multiple entries for community exist, you should use the
                 -h option to qualify which entry to modify.

       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 qualify the community on which to
                 perform the operation should there be multiple entries with
                 the same community name.  host may be specifed as the
                 keyword any to indicate the wildcard address 0.0.0.0, which



Licensed material--property of copyright holder(s)                         1

admsnmpcommunity(1M)             DG/UX 5.4.2            admsnmpcommunity(1M)


                 means any Internet address.

       -A new-access
                 Use the new-access option to specify the access level to be
                 assigned to the community after the modification is
                 complete.  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 to be
                 assigned to the 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 community name
                 to be assigned to the community after the modification is
                 complete.

       -H new-host
                 Use the new-host option to specify the host name to be
                 assigned to the community after the modification is
                 complete.

       -q        Specify 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 option is enabled by
                 default.

FILES
       /etc/snmpd.communities        the communities database.

DIAGNOSTICS
   Warnings
        -  If the agent can not be sent a SIGHUP signal to request
           reconfiguration.

        -  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.



Licensed material--property of copyright holder(s)                         2

admsnmpcommunity(1M)             DG/UX 5.4.2            admsnmpcommunity(1M)


        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.communities 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.communities file.  Generally, everyone has this access.

SEE ALSO
       snmpd(1M), snmpd.communities(4M), sysadm(1M).












































Licensed material--property of copyright holder(s)                         3