5645e8e78e
* [Sec 3119] Trap crash <perlinger@ntp.org> * [Sec 3118] Mode 6 information disclosure and DDoS vector <perlinger@ntp.org> - TRAP config via mode 6 packet requires AUTH now. * [Sec 3114] Broadcast Mode Replay Prevention DoS - applied patches by Matthew Van Gundy. <perlinger@ntp.org> - with bcpollbstep, tweaks and cleanup by stenn@ntp.org * [Sec 3113] Broadcast Mode Poll Interval Enforcement DoS <perlinger@ntp.org> - applied fix as suggested by Matthew Van Gundy * [Sec 3110] Windows: ntpd DoS by oversized UDP packet - fixed error handling for truncated UDP packets. <perlinger@ntp.org> * [Sec 3102] Zero origin issues. HStenn. * [Sec 3082] null pointer dereference in _IO_str_init_static_internal() - more hardening to read_mru_list(). perlinger@ntp.org * [Sec 3072] Attack on interface selection <perlinger@ntp.org> - implemented Miroslav Lichvars <mlichvar@redhat.com> suggestion to skip interface updates based on incoming packets * [Bug 3142] bug in netmask prefix length detection <perlinger@ntp.org> * [Bug 3138] gpsdjson refclock should honor fudgetime1. stenn@ntp.org * [Bug 3129] Unknown hosts can put resolver thread into a hard loop - moved retry decision where it belongs. <perlinger@ntp.org> * [Bug 3125] NTPD doesn't fully start when ntp.conf entries are out of order using the loopback-ppsapi-provider.dll <perlinger@ntp.org> * [Bug 3116] unit tests for NTP time stamp expansion. <perlinger@ntp.org> * [Bug 3100] ntpq can't retrieve daemon_version <perlinger@ntp.org> - fixed extended sysvar lookup (bug introduced with bug 3008 fix) * [Bug 3095] Compatibility with openssl 1.1 <perlinger@ntp.org> - applied patches by Kurt Roeckx <kurt@roeckx.be> to source - added shim layer for SSL API calls with issues (both directions) * [Bug 3089] Serial Parser does not work anymore for hopfser like device - simplified / refactored hex-decoding in driver. <perlinger@ntp.org> * [Bug 3084] update-leap mis-parses the leapfile name. HStenn. * [Bug 3068] Linker warnings when building on Solaris. perlinger@ntp.org - applied patch thanks to Andrew Stormont <andyjstormont@gmail.com> * [Bug 3067] Root distance calculation needs improvement. HStenn. * [Bug 3066] NMEA clock ignores pps. perlinger@ntp.org - PPS-HACK works again. * [Bug 3059] Potential buffer overrun from oversized hash <perlinger@ntp.org> - applied patch by Brian Utterback <brian.utterback@oracle.com> * [Bug 3053] ntp_loopfilter.c frequency calc precedence error. Sarah White. * [Bug 3050] Fix for bug #2960 causes [...] spurious error message. <perlinger@ntp.org> - patches by Reinhard Max <max@suse.com> and Havard Eidnes <he@uninett.no> * [Bug 3047] Fix refclock_jjy C-DEX JST2000. abe@ntp.org - Patch provided by Kuramatsu. * [Bug 3021] unity_fixture.c needs pragma weak <perlinger@ntp.org> - removed unnecessary & harmful decls of 'setUp()' & 'tearDown()' * [Bug 3019] Windows: ERROR_HOST_UNREACHABLE block packet processing. DMayer and JPerlinger. * [Bug 2998] sntp/tests/packetProcessing.c broken without openssl. JPerlinger * [Bug 2961] sntp/tests/packetProcessing.c assumes AUTOKEY. HStenn. * [Bug 2959] refclock_jupiter: gps week correction <perlinger@ntp.org> - fixed GPS week expansion to work based on build date. Special thanks to Craig Leres for initial patch and testing. * [Bug 2951] ntpd tests fail: multiple definition of `send_via_ntp_signd' - fixed Makefile.am <perlinger@ntp.org> * [Bug 2689] ATOM driver processes last PPS pulse at startup, even if it is very old <perlinger@ntp.org> - make sure PPS source is alive before processing samples - improve stability close to the 500ms phase jump (phase gate) * Fix typos in include/ntp.h. * Shim X509_get_signature_nid() if needed. * git author attribution cleanup * bk ignore file cleanup * remove locks in Windows IO, use rpc-like thread synchronisation instead
145 lines
4.5 KiB
Plaintext
145 lines
4.5 KiB
Plaintext
.Dd November 21 2016
|
|
.Dt NTPSNMPD @NTPSNMPD_MS@ User Commands
|
|
.Os
|
|
.\" EDIT THIS FILE WITH CAUTION (ntpsnmpd-opts.mdoc)
|
|
.\"
|
|
.\" It has been AutoGen-ed November 21, 2016 at 08:03:24 AM by AutoGen 5.18.5
|
|
.\" From the definitions ntpsnmpd-opts.def
|
|
.\" and the template file agmdoc-cmd.tpl
|
|
.Sh NAME
|
|
.Nm ntpsnmpd
|
|
.Nd NTP SNMP MIB agent
|
|
.Sh SYNOPSIS
|
|
.Nm
|
|
.\" Mixture of short (flag) options and long options
|
|
.Op Fl flags
|
|
.Op Fl flag Op Ar value
|
|
.Op Fl \-option\-name Ns Oo Oo Ns "=| " Oc Ns Ar value Oc
|
|
.Pp
|
|
All arguments must be options.
|
|
.Pp
|
|
.Sh DESCRIPTION
|
|
.Nm
|
|
is an SNMP MIB agent designed to interface with
|
|
.Xr ntpd @NTPD_MS@ .
|
|
.Sh "OPTIONS"
|
|
.Bl -tag
|
|
.It Fl n , Fl \-nofork
|
|
Do not fork.
|
|
.sp
|
|
.It Fl p , Fl \-syslog
|
|
Log to syslog().
|
|
.sp
|
|
.It Fl \-agentxsocket Ns = Ns Ar string
|
|
The socket address ntpsnmpd uses to connect to net\-snmpd.
|
|
The default
|
|
.Ar string
|
|
for this option is:
|
|
.ti +4
|
|
unix:/var/agentx/master
|
|
.sp
|
|
[<transport\-specifier>:]<transport\-address>
|
|
The default "agent X socket" is the Unix Domain socket
|
|
\fIunix:/var/agentx/master\fP.
|
|
Another common alternative is \fItcp:localhost:705\fP.
|
|
.It Fl \&? , Fl \-help
|
|
Display usage information and exit.
|
|
.It Fl \&! , Fl \-more\-help
|
|
Pass the extended usage information through a pager.
|
|
.It Fl > Oo Ar cfgfile Oc , Fl \-save\-opts Oo Ns = Ns Ar cfgfile Oc
|
|
Save the option state to \fIcfgfile\fP. The default is the \fIlast\fP
|
|
configuration file listed in the \fBOPTION PRESETS\fP section, below.
|
|
The command will exit after updating the config file.
|
|
.It Fl < Ar cfgfile , Fl \-load\-opts Ns = Ns Ar cfgfile , Fl \-no\-load\-opts
|
|
Load options from \fIcfgfile\fP.
|
|
The \fIno\-load\-opts\fP form will disable the loading
|
|
of earlier config/rc/ini files. \fI\-\-no\-load\-opts\fP is handled early,
|
|
out of order.
|
|
.It Fl \-version Op Brq Ar v|c|n
|
|
Output version of program and exit. The default mode is `v', a simple
|
|
version. The `c' mode will print copyright information and `n' will
|
|
print the full copyright notice.
|
|
.El
|
|
.Sh "OPTION PRESETS"
|
|
Any option that is not marked as \fInot presettable\fP may be preset
|
|
by loading values from configuration ("RC" or ".INI") file(s) and values from
|
|
environment variables named:
|
|
.nf
|
|
\fBNTPSNMPD_<option\-name>\fP or \fBNTPSNMPD\fP
|
|
.fi
|
|
.ad
|
|
The environmental presets take precedence (are processed later than)
|
|
the configuration files.
|
|
The \fIhomerc\fP files are "\fI$HOME\fP", and "\fI.\fP".
|
|
If any of these are directories, then the file \fI.ntprc\fP
|
|
is searched for within those directories.
|
|
.Sh USAGE
|
|
.Nm
|
|
currently uses a private MIB OID,
|
|
.Ql enterprises.5597 ,
|
|
which is the Meinberg top level OEM OID, and
|
|
.Ql 99
|
|
is the temporary working space for this project.
|
|
The final OID has to be registered with IANA
|
|
and this is done by the RFC Editor
|
|
when the NTPv4 MIB RFC is standardized.
|
|
.Pp
|
|
If you have
|
|
.Xr snmpwalk 1
|
|
installed you can run
|
|
.Dl % snmpwalk \-v2c \-c public localhost enterprises.5597.99
|
|
to see a list of all currently supported NTP MIB objects
|
|
and their current values.
|
|
.Sh "ENVIRONMENT"
|
|
See \fBOPTION PRESETS\fP for configuration environment variables.
|
|
.Sh "FILES"
|
|
See \fBOPTION PRESETS\fP for configuration files.
|
|
.Sh "EXIT STATUS"
|
|
One of the following exit values will be returned:
|
|
.Bl -tag
|
|
.It 0 " (EXIT_SUCCESS)"
|
|
Successful program execution.
|
|
.It 1 " (EXIT_FAILURE)"
|
|
The operation failed or the command syntax was not valid.
|
|
.It 66 " (EX_NOINPUT)"
|
|
A specified configuration file could not be loaded.
|
|
.It 70 " (EX_SOFTWARE)"
|
|
libopts had an internal operational error. Please report
|
|
it to autogen\-users@lists.sourceforge.net. Thank you.
|
|
.El
|
|
.Sh AUTHORS
|
|
.An "Heiko Gerstung"
|
|
.Sh "COPYRIGHT"
|
|
Copyright (C) 1992\-2016 The University of Delaware and Network Time Foundation all rights reserved.
|
|
This program is released under the terms of the NTP license, <http://ntp.org/license>.
|
|
.Sh "BUGS"
|
|
Please send bug reports to: http://bugs.ntp.org, bugs@ntp.org
|
|
.Sh NOTES
|
|
The following objects are currently supported:
|
|
.Pp
|
|
.Bl -tag -width ".Li ntpEntSoftwareVersionVal" -compact -offset indent
|
|
.It Li ntpEntSoftwareName
|
|
please fill me in...
|
|
.It Li ntpEntSoftwareVersion
|
|
please fill me in...
|
|
.It Li ntpEntSoftwareVersionVal
|
|
please fill me in...
|
|
.It Li ntpEntSoftwareVendor
|
|
please fill me in...
|
|
.It Li ntpEntSystemType
|
|
please fill me in...
|
|
.It Li ntpEntTimeResolution
|
|
please fill me in...
|
|
.It Li ntpEntTimeResolutionVal
|
|
please fill me in...
|
|
.It Li ntpEntTimePrecision
|
|
please fill me in...
|
|
.It Li ntpEntTimePrecisionVal
|
|
please fill me in...
|
|
.It Li ntpEntTimeDistance
|
|
please fill me in...
|
|
.El
|
|
.Pp
|
|
This manual page was \fIAutoGen\fP\-erated from the \fBntpsnmpd\fP
|
|
option definitions.
|