"Fossies" - the Fresh Open Source Software Archive

Member "ntp-4.2.8p15/ntpsnmpd/ntpsnmpd.mdoc.in" (23 Jun 2020, 4586 Bytes) of package /linux/misc/ntp-4.2.8p15.tar.gz:


As a special service "Fossies" has tried to format the requested text file into HTML format (style: standard) with prefixed line numbers. Alternatively you can here view or download the uninterpreted source code file. See also the latest Fossies "Diffs" side-by-side code changes report for "ntpsnmpd.mdoc.in": 4.2.8p14_vs_4.2.8p15.

    1 .Dd June 23 2020
    2 .Dt NTPSNMPD @NTPSNMPD_MS@ User Commands
    3 .Os
    4 .\"  EDIT THIS FILE WITH CAUTION  (ntpsnmpd-opts.mdoc)
    5 .\"
    6 .\"  It has been AutoGen-ed  June 23, 2020 at 02:20:59 AM by AutoGen 5.18.5
    7 .\"  From the definitions    ntpsnmpd-opts.def
    8 .\"  and the template file   agmdoc-cmd.tpl
    9 .Sh NAME
   10 .Nm ntpsnmpd
   11 .Nd NTP SNMP MIB agent
   12 .Sh SYNOPSIS
   13 .Nm
   14 .\" Mixture of short (flag) options and long options
   15 .Op Fl flags
   16 .Op Fl flag Op Ar value
   17 .Op Fl \-option\-name Ns Oo Oo Ns "=| " Oc Ns Ar value Oc
   18 .Pp
   19 All arguments must be options.
   20 .Pp
   21 .Sh DESCRIPTION
   22 .Nm
   23 is an SNMP MIB agent designed to interface with
   24 .Xr ntpd @NTPD_MS@ .
   25 .Sh "OPTIONS"
   26 .Bl -tag
   27 .It  Fl n , Fl \-nofork 
   28 Do not fork.
   29 .sp
   30 .It  Fl p , Fl \-syslog 
   31 Log to syslog().
   32 .sp
   33 .It  Fl \-agentxsocket  Ns = Ns Ar string 
   34 The socket address ntpsnmpd uses to connect to net\-snmpd.
   35 The default
   36 .Ar string
   37 for this option is:
   38 .ti +4
   39  unix:/var/agentx/master
   40 .sp
   41 [<transport\-specifier>:]<transport\-address>
   42 The default "agent X socket" is the Unix Domain socket
   43 \fIunix:/var/agentx/master\fP.
   44 Another common alternative is \fItcp:localhost:705\fP.
   45 .It Fl \&? , Fl \-help
   46 Display usage information and exit.
   47 .It Fl \&! , Fl \-more\-help
   48 Pass the extended usage information through a pager.
   49 .It Fl > Oo Ar cfgfile Oc , Fl \-save\-opts Oo Ns = Ns Ar cfgfile Oc
   50 Save the option state to \fIcfgfile\fP.  The default is the \fIlast\fP
   51 configuration file listed in the \fBOPTION PRESETS\fP section, below.
   52 The command will exit after updating the config file.
   53 .It Fl < Ar cfgfile , Fl \-load\-opts Ns = Ns Ar cfgfile , Fl \-no\-load\-opts
   54 Load options from \fIcfgfile\fP.
   55 The \fIno\-load\-opts\fP form will disable the loading
   56 of earlier config/rc/ini files.  \fI\-\-no\-load\-opts\fP is handled early,
   57 out of order.
   58 .It Fl \-version Op Brq Ar v|c|n
   59 Output version of program and exit.  The default mode is `v', a simple
   60 version.  The `c' mode will print copyright information and `n' will
   61 print the full copyright notice.
   62 .El
   63 .Sh "OPTION PRESETS"
   64 Any option that is not marked as \fInot presettable\fP may be preset
   65 by loading values from configuration ("RC" or ".INI") file(s) and values from
   66 environment variables named:
   67 .nf
   68   \fBNTPSNMPD_<option\-name>\fP or \fBNTPSNMPD\fP
   69 .fi
   70 .ad
   71 The environmental presets take precedence (are processed later than)
   72 the configuration files.
   73 The \fIhomerc\fP files are "\fI$HOME\fP", and "\fI.\fP".
   74 If any of these are directories, then the file \fI.ntprc\fP
   75 is searched for within those directories.
   76 .Sh USAGE
   77 .Nm
   78 currently uses a private MIB OID,
   79 .Ql enterprises.5597 ,
   80 which is the Meinberg top level OEM OID, and
   81 .Ql 99
   82 is the temporary working space for this project. 
   83 The final OID has to be registered with IANA
   84 and this is done by the RFC Editor
   85 when the NTPv4 MIB RFC is standardized. 
   86 .Pp
   87 If you have
   88 .Xr snmpwalk 1
   89 installed you can run
   90 .Dl % snmpwalk \-v2c \-c public localhost enterprises.5597.99
   91 to see a list of all currently supported NTP MIB objects
   92 and their current values.
   93 .Sh "ENVIRONMENT"
   94 See \fBOPTION PRESETS\fP for configuration environment variables.
   95 .Sh "FILES"
   96 See \fBOPTION PRESETS\fP for configuration files.
   97 .Sh "EXIT STATUS"
   98 One of the following exit values will be returned:
   99 .Bl -tag
  100 .It 0 " (EXIT_SUCCESS)"
  101 Successful program execution.
  102 .It 1 " (EXIT_FAILURE)"
  103 The operation failed or the command syntax was not valid.
  104 .It 66 " (EX_NOINPUT)"
  105 A specified configuration file could not be loaded.
  106 .It 70 " (EX_SOFTWARE)"
  107 libopts had an internal operational error.  Please report
  108 it to autogen\-users@lists.sourceforge.net.  Thank you.
  109 .El
  110 .Sh AUTHORS
  111 .An "Heiko Gerstung"
  112 .Sh "COPYRIGHT"
  113 Copyright (C) 1992\-2020 The University of Delaware and Network Time Foundation all rights reserved.
  114 This program is released under the terms of the NTP license, <http://ntp.org/license>.
  115 .Sh "BUGS"
  116 Please send bug reports to: http://bugs.ntp.org, bugs@ntp.org
  117 .Sh NOTES
  118 The following objects are currently supported:
  119 .Pp
  120 .Bl -tag -width ".Li ntpEntSoftwareVersionVal" -compact -offset indent
  121 .It Li ntpEntSoftwareName
  122 please fill me in...
  123 .It Li ntpEntSoftwareVersion
  124 please fill me in...
  125 .It Li ntpEntSoftwareVersionVal
  126 please fill me in...
  127 .It Li ntpEntSoftwareVendor
  128 please fill me in...
  129 .It Li ntpEntSystemType
  130 please fill me in...
  131 .It Li ntpEntTimeResolution
  132 please fill me in...
  133 .It Li ntpEntTimeResolutionVal
  134 please fill me in...
  135 .It Li ntpEntTimePrecision
  136 please fill me in...
  137 .It Li ntpEntTimePrecisionVal
  138 please fill me in...
  139 .It Li ntpEntTimeDistance
  140 please fill me in...
  141 .El
  142 .Pp
  143 This manual page was \fIAutoGen\fP\-erated from the \fBntpsnmpd\fP
  144 option definitions.