*nix Documentation Project
·  Home
 +   man pages
·  Linux HOWTOs
·  FreeBSD Tips
·  *niX Forums

  man pages->HP-UX 11i man pages -> snmpdm (1m)              


 snmpd(1M)                                                         snmpd(1M)

 NAME    [Toc]    [Back]
      snmpd - snmpd, snmpdm  - Simple Network Management Protocol (SNMP)

 SYNOPSIS    [Toc]    [Back]
      snmpd  [-a] [-authfail] [-C contact] [-Contact contact] [-h]
       [-help] [-L location][-Location location] [-l logfile]
       [-logfile logfile] [-P portnum] [-Port portnum] [-m logmask]
       [-mask logmask] [-n] [-sys description]
       [-sysDescr description]

      snmpd [-e extendFile]

      snmpdm [-apall] [-aperror] [-aptrace] [-apwarn]
       [-a] [-authfail] [-C contact] [-Contact contact] [-h]
       [-help] [-L location] [-Location location] [-l logfile]
       [-logfile logfile] [-m logmask] [-mask logmask]
       [-log_format value] [-n] [-sys description]
       [-sysDescr description] [-tcpany ] [-tcplocal ] [-tcpnone ]

 DESCRIPTION    [Toc]    [Back]
      The master SNMP agent (snmpdm) and the collection of subagents
      (/usr/sbin/*agt) that have attached to the master agent,  collectively
      form a single SNMP agent.  The SNMP agent accepts SNMP Get, GetNext
      and Set requests from an SNMP Manager which cause it to read or write
      the Management Information Base (MIB).  The MIB objects are
      instrumented by the subagents.

      The master agent can bind to separate process subagents and to shared
      library subagents.

    Parameters    [Toc]    [Back]
      The master agent (snmpdm) and the manual startup script (snmpd)
      recognize the following options:

      -apall    Log all error messages, warning messages, and trace message.
                This option forces snmpdm to run in the foreground .

      -aperror  Log all error messages. This option can be used in
                conjunction with -aptrace and -apwarn.

      -aptrace  Log all trace messages. This option can be used in
                conjunction with -aperror and -apwarn.

      -apwarn   Log all warning messages. This option can be used in
                conjunction with -aperror and -aptrace.


      -authfail Suppress sending authentication failure traps.

 Hewlett-Packard CompanNNM Pre-Release1X.07.00 (Design-Proto-4): August 2003

 snmpd(1M)                                                         snmpd(1M)

      -Contact contact

      -C contact
                This option overrides the contact person specified in the
                master agent configuration file /etc/SnmpAgent.d/snmpd.conf.
                It does not alter the value in /etc/SnmpAgent.d/snmpd.conf.
                By default, the agent's contact is a blank string. To
                configure the agent's contact, add the contact to
                /etc/SnmpAgent.d/snmpd.conf or use the -C option.

      -e extendFile
                This option is provided for backward compatibility with the
                pre-emanate snmpd.ea extensible SNMP agent.  It is
                applicable only if the emanate extensible agent is
                installed.  It is installed if the file /usr/sbin/extsubagt
                exists.  This option causes the extsubagt to use extendFile
                instead of the default /etc/SnmpAgent.d/snmpd.extend file to
                add user defined MIB objects to the SNMP agent.


      -h        Display command line options and log mask values.

      -Location location

      -L location
                This option overrides the location specified in
                /etc/SnmpAgent.d/snmpd.conf. It does not alter the value in
                /etc/SnmpAgent.d/snmpd.conf. By default, the agent's
                location is a blank string. To configure the agent's
                location, add the location to /etc/SnmpAgent.d/snmpd.conf or
                use the -L option.

      -l logfile
                Use logfile for logging rather than the default logfile,
                /var/adm/snmpd.log. A value of - will direct logging to

      -mask logmask

      -m logmask
                See the SNMP Agent Logging section for valid values. This
                argument only takes effect as you are starting the agent. To
                change the mask of an agent that is already running use
                option -M.

      -log_format value
                The value can be 0 or 1. 0 means use traditional logging
                fomat for /var/adm/snmpd.log file. 1 means use new logging
                format. The new logging format gives the Log level,
                Timestamp, Program Name, File name, Line number and message

 Hewlett-Packard CompanNNM Pre-Release2X.07.00 (Design-Proto-4): August 2003

 snmpd(1M)                                                         snmpd(1M)

                in seperate lines.

      -n        Normally snmpdm puts itself into the background as if the
                command was terminated with an ampersand (&). This option
                inhibits that behavior.

      -Port portnum

      -P portnum
                Specify the UDP port number that the agent will listen on
                for SNMP requests. The default is port 161.  The value can
                also be specified in /etc/services. Only the superuser can
                start snmpdm and only one snmpdm can execute on a particular
                UDP port.

      -sysDescr description

      -sys description
                Allows the user to specify the value for the system.sysDescr
                MIB object. The format is a text string enclosed in quotes.
                This option overrides the sysDescr specified in

                For example, snmpdm -sys "nsmd1, test system"

      -tcpany   Allow Master agent to accept connections from any subagent.
                This is the default option.

      -tcplocal Allow Master agent to accept connections from local TCP

      -tcpnone  Do not allow master agent to accept connections from any TCP

    SNMPv1 Security    [Toc]    [Back]
      Each SNMP request is accompanied by a community name, which is
      essentially a password that enables SNMP access to MIB values on an
      agent. A manager can request to read a MIB value by issuing an SNMP
      GetRequest/GetNextRequest, or a manager may request to alter a MIB
      value by issuing an  SNMP SetRequest.

      By default, the agent does not respond to any SNMP requests,
      regardless of the community name used in the request.  To configure
      the agent to respond to SNMP GetRequests/GetNextRequests, add a getcommunity-name
 to /etc/SnmpAgent.d/snmpd.conf. See the snmpd.conf(4)
      manpage. To configure the agent to respond to SNMP SetRequests AND
      GetRequests/GetNextRequests, add a set-community-name to

    SNMPv2c    [Toc]    [Back]

 Hewlett-Packard CompanNNM Pre-Release3X.07.00 (Design-Proto-4): August 2003

 snmpd(1M)                                                         snmpd(1M)

      Simple Network Management Protocol Version 2 (SNMPv2c) is supported in
      this version of the SNMP agent.

    Traps    [Toc]    [Back]
      The agent also sends information to a manager without an explicit
      request from the manager. Such an operation is called a trap. By
      default, SNMP traps are not sent to any destination. To configure the
      agent to send traps to one or more specific destinations, add the trap
      destinations to /etc/SnmpAgent.d/snmpd.conf.

      The master agent (snmpdm) and the MIB-2 subagent (mib2agt) collaborate
      to send the following SNMP traps:

      coldStart Sends a coldStart trap when the SNMP agent is invoked.

      linkDown  Sends a linkDown trap when an interface goes down.

      linkUp    Sends a linkUp trap when an interface comes up

                Sends an authenticationFailure trap when an SNMP request is
                sent to the SNMP agent with a community name that does not
                match the community names specified in

    SNMP Agent Logging    [Toc]    [Back]
      The SNMP agent provides the capability to log various types of errors
      and events. There are three types of logging; traces, warnings, and

    Log Masks    [Toc]    [Back]
      Log masks enable the user to specify the particular classes of
      messages that should be logged to /var/adm/snmpd.log or the specified
      logfile. There are three different ways that you can specify the
      logmask that you want. They are; (1) decimal number, (2) hexadecimal
      number, or (3) text string. The three may not be used in combination.

      To select multiple output types do the following. For decimal or hex
      format simply add the individual logmask values together and enter
      that number. When entering strings, place multiple strings on the same
      line, space separated, without quotes.

                                       Log Mask Values   Function        Decimal
      Turn off logging                 0                 0x00000000      LOGGING_OFF
      Log factory trace messages       8388608           0x00800000      FACTORY_TRACE
      Log factory warning messages     268435456         0x10000000      FACTORY_WARN
      Log factory error messages       536870912         0x20000000      FACTORY_ERROR
      Log factory configure messages   65536             0x00010000      FACTORY_CONFIG
      Log factory packet messages      131072            0x00020000      FACTORY_PACKET
      Log factory trap messages        262144            0x00040000      FACTORY_TRAP
      Log factory access messages      524288            0x00080000      FACTORY_ACCESS

 Hewlett-Packard CompanNNM Pre-Release4X.07.00 (Design-Proto-4): August 2003

 snmpd(1M)                                                         snmpd(1M)

      Log factory emanate messages     1048576           0x00100000      FACTORY_EMANATE
      Log factory verbose messages     2097152           0x00200000      FACTORY_VERBOSE
      Log factory user messages        4194304           0x00400000      FACTORY_USER
      Log factory thread messages      1073741824        0x40000000      FACTORY_THREAD
      Log factory timer messages       2147483648        0x80000000      FACTORY_TIMER

      Turn on error logging messages:

      decimal format : snmpdm -m 536870912
      hex format      :snmpdm  -m 0x20000000
      string format   : snmpdm  -m FACTORY_ERROR

    Supported MIB Objects    [Toc]    [Back]
      The Management Information Base (MIB) is a conceptual database of
      values on the agent.  The master SNMP agent implements a small number
      of MIB objects but most MIB objects are implemented by subagents that
      have attached to the master agent.  See /var/opt/OV/share/snmp_mibs on
      systems with HP OpenView products installed for definitions of
      particular MIB objects.

      This version of the SNMP agent includes the subagents,
      /usr/sbin/mib2agt  and /usr/sbin/hp_unixagt  which implement the MIB-2
      and  HP UNIX MIBs respectively.  The MIB-II and HPUX  MIBs are
      described in /var/opt/OV/share/snmp_mibs/Standard/rfc1213-MIB-II and
      /var/opt/OV/share/snmp_mibs/Vendor/Hewlett-Packard/hp-unix on systems
      with HP OpenView products installed.

       It also includes the subagents /usr/sbin/trapdestagt and
      /usr/sbin/naaagt. The trapdestagt supports the MIB variables used for
      updating the trapdest entries in the snmpd.conf file. For details on
      the naaagt subagent please refer the naaagt manpage.

      The MIB-2 subagent supports most of the objects in RFC1213. The EGP
      group is not supported. The HP-UX subagent supports most of the
      objects in the HP-UX MIB.

    Deprecated MIBS    [Toc]    [Back]
      The ieee8023Mac MIB group corresponding to the following OID is no
      longer supported:


      This MIB group is replaced with the Ether-Like MIB group (RFC1398)
      which corresponds to OID:


    SNMP Agent Startup    [Toc]    [Back]
      The SNMP agent startup mechanism is built upon the System V.4 file
      system paradigm. The startup scripts /etc/netmanrc and /etc/netmgr,
      which were used in previous releases of the SNMP agent, are no longer

 Hewlett-Packard CompanNNM Pre-Release5X.07.00 (Design-Proto-4): August 2003

 snmpd(1M)                                                         snmpd(1M)

      used for starting the SNMP agent.

    Automatic Startup    [Toc]    [Back]
      As installed, the SNMP master agent and all subagents should startup
      automatically each time the system reboots or anytime the system
      transitions from run level 1 to run level 2. When the system enters
      run level 2 the operating system will execute /sbin/init.d/SnmpMaster
      which will startup the master agent. Similarly, /sbin/init.d/SnmpMib2
      and /sbin/init.d/SnmpHpunix  will startup the MIB2  and HP-UX
      subagents respectively immediately after the master agent is started.
      The trapdestagt and naaagt subagents are started by
      /sbin/init.d/SnmpTrpDst and /sbin/init.d/SnmpNaa.

      Prior to executing these startup scripts the system will examine all
      scripts in /etc/rc.config.d for environment variables which could
      potentially influence the startup of the master agent and each
      subagent. See the particular startup script or configuration file for
      details on supported environment variables.  The user should never
      modify scripts in /sbin/init.d. Instead the startup behavior should be
      controlled by adjusting values in the appropriate configuration script
      in /etc/rc.config.d.

      The interactions and relationships among these processes and files at
      invocation time is shown below.

      Solaris    [Toc]    [Back]
      /etc/rc2                    invokes      /etc/rc2.d/S98SnmpMaster
      /etc/rc2.d/S98SnmpMaster    invokes      /sbin/init.d/SnmpMaster
      /sbin/init.d/SnmpMaster     invokes      /usr/sbin/snmpdm
      /usr/sbin/snmpdm            reads        /etc/SnmpAgent.d/snmpd.conf

      /etc/rc2                    invokes      /etc/rc2.d/S97SnmpMib2
      /etc/rc2.d/S97SnmpMib2      invokes      /sbin/init.d/SnmpMib2
      /sbin/init.d/SnmpMib2       invokes      /usr/sbin/mib2agt

      /etc/rc2                    invokes      /etc/rc2.d/S97SnmpHpunix
      /etc/rc2.d/S97SnmpHpunix    invokes      /sbin/init.d/SnmpHpunix
      /sbin/init.d/SnmpHpunix     invokes      /usr/sbin/hp_unixagt

      /etc/rc2                    invokes      /etc/rc2.d/S97SnmpTrpDst
      /etc/rc2.d/S97SnmpTrpDst    invokes      /sbin/init.d/SnmpTrpDst
      /sbin/init.d/SnmpTrpDst     invokes      /usr/sbin/trapdestagt

      /etc/rc2                    invokes      /etc/rc2.d/S97Naa
      /etc/rc2.d/S97SnmpNaa       invokes      /sbin/init.d/SnmpNaa
      /sbin/init.d/SnmpNaa        invokes      /usr/sbin/naaagt

      HP-UX 10.X, 11.X
      /sbin/rc                     invokes     /sbin/rc2.d/S560SnmpMaster
      /sbin/rc2.d/S560SnmpMaster   invokes     /sbin/init.d/SnmpMaster
      /sbin/init.d/SnmpMaster      invokes     /usr/sbin/snmpdm

 Hewlett-Packard CompanNNM Pre-Release6X.07.00 (Design-Proto-4): August 2003

 snmpd(1M)                                                         snmpd(1M)

      /usr/sbin/snmpdm             reads       /etc/SnmpAgent.d/snmpd.conf

      /sbin/rc                     invokes     /sbin/rc2.d/s565SnmpMib2
      /sbin/rc2.d/s565SnmpMib2     invokes     /sbin/init.d/SnmpMib2
      /sbin/init.d/SnmpMib2        invokes     /usr/sbin/mib2agt

      /sbin/rc                     invokes     /sbin/rc2.d/s565SnmpHpunix
      /sbin/rc2.d/s565SnmpHpunix   invokes     /sbin/init.d/SnmpHpunix
      /sbin/init.d/SnmpHpunix      invokes     /usr/sbin/hp_unixagt

      /sbin/rc                     invokes     /sbin/rc2.d/s565SnmpTrpDst
      /sbin/rc2.d/s565SnmpTrpDst   invokes     /sbin/init.d/SnmpTrpDst
      /sbin/init.d/SnmpTrpDst      invokes     /usr/sbin/trapdestagt

    Manual Startup    [Toc]    [Back]
      There are two ways to start the SNMP agent manually. The first way is
      to execute snmpdm and then start each subagent. Separate process
      subagents are started by invoking the particular subagent executable.

      The second and simplest way to start the SNMP agent manually is to
      execute the snmpd startup script which will invoke the master agent
      and all subagents which have been installed and designed to operate in
      this paradigm. The snmpd  script is layered upon the V.4 startup
      paradigm and so makes use of the component startup scripts in
      /sbin/init.d and configuration scripts in /etc/rc.config.d. When snmpd
      is invoked it passes all its command line arguments to snmpdm and then
      executes each start script  (S*) found in /sbin/SnmpAgtStart.d.

    Objects on which the agent supports snmpset requests    [Toc]    [Back]
         +  syscontact











 Hewlett-Packard CompanNNM Pre-Release7X.07.00 (Design-Proto-4): August 2003

 snmpd(1M)                                                         snmpd(1M)

    Objects that Return Null Values (Solaris only)    [Toc]    [Back]
         +  ifInNUcastPkts




    Objects that Return noSuchName Errors (Solaris only)    [Toc]    [Back]
         +  ifLastChange




         +  ipInReceives
















 Hewlett-Packard CompanNNM Pre-Release8X.07.00 (Design-Proto-4): August 2003

 snmpd(1M)                                                         snmpd(1M)




         +  tcpActiveOpens









         +  udpInDatagrams



         +  egp group

 ERRORS    [Toc]    [Back]
      Duplicate community names may not be used in the configuration file.
      In the past the agent allowed a user to have the same name used many
      times in the file.  This typically happens when the user would set the
      same name for a get and set community name. The implication being that
      the name could be used for gets and sets. Due to the new Emanate
      agent, it would cause problems to allow this. So, now the set
      community names have read/write access. That is, they are both a set
      and get community name. When this error occurs the agent will still
      start. However, an ERROR log will be written in the logfile and you
      will likely end up with undesirable results.

    Environmental Variables
      $LANG determines the language in which messages appear. If $LANG is
      not specified or is set to the empty string, a default of C (see
      lang(5)) is used instead of $LANG. If any internationalization
      variable contains an invalid setting, snmpdm behaves as if all
      internationalization variables are set to C. See environ(5).

 Hewlett-Packard CompanNNM Pre-Release9X.07.00 (Design-Proto-4): August 2003

 snmpd(1M)                                                         snmpd(1M)

      The environment variables specific to the master agent snmpdm are as

      Environment Variables    [Toc]    [Back]
      SNMP_LOG_SIZE                Exporting this variable to
                                   >= 1MB restricts the size of
                                   the snmp log file. When the
                                   size grows beyond the value
                                   exported, the log file rolls
      SR_SNMP_TEST_PORT            This variable can be
                                   exported to change the
                                   default port on which snmpdm
      SR_TRAP_TEST_PORT            This variable can be
                                   exported to change the
                                   default port to which snmpdm
                                   sends  traps
      COLDSTART_TIMEOUT            Exporting this variable to
                                   any value between 1 and 600
                                   seconds will control the
                                   behaviour of snmpdm in
                                   sending the coldstart trap.
                                   The trap will be sent after
                                   the expiry of the number of
                                   seconds specified or mib2agt
                                   registering, whichever is
      SR_LOG_DIR                   This variable can be
                                   exported to specify the
                                   directory where the log file
                                   snmpd.log will be created.
      SR_AGT_CONF_DIR              This variable can be
                                   exported to specify the
                                   directory in which the
                                   configuration file
                                   snmpd.conf is available.

    International Code Set Support    [Toc]    [Back]
      Supports single-byte character code sets.

 AUTHOR    [Toc]    [Back]
      snmpd was developed by Hewlett-Packard, Massachusetts Institute of
      Technology, and SNMP Research.

 FILES    [Toc]    [Back]


 Hewlett-Packard CompanNNM Pre-Release0X.07.00 (Design-Proto-4): August 2003

 snmpd(1M)                                                         snmpd(1M)







 SEE ALSO    [Toc]    [Back]

      RFC 1155, RFC 1157, RFC 1212, RFC 1213, RFC 1231, RFC 1398

 Hewlett-Packard CompanyNNM Pre-Rele-as1e1X-.07.00 (Design-Proto-4): August 2003
[ Back ]
 Similar pages
Name OS Title
snmpd.conf Tru64 Simple Network Management Protocol (SNMP) agent daemon
snmpd Tru64 Simple Network Management Protocol (SNMP) agent daemon
peer_snmpd IRIX Simple Network Management Protocol daemon
snmpd IRIX Simple Network Management Protocol daemon
peer_encaps IRIX Simple Network Management Protocol Agent Encapsulator
bsnmpd FreeBSD simple and extendable SNMP daemon
pffindtype FreeBSD network domain management
pffindproto FreeBSD network domain management
pfctlinput2 FreeBSD network domain management
pfctlinput FreeBSD network domain management
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service