From: Harlan Stenn Date: Sun, 20 Jul 2014 09:44:32 +0000 (+0000) Subject: autogen-5.18.4pre9 X-Git-Tag: NTP_4_2_7P457~12 X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=f9df37599341be98f2de0977191b0409bb9fa4aa;p=thirdparty%2Fntp.git autogen-5.18.4pre9 bk: 53cb8f800B5im0oaKS-Y8fSvXworTQ --- diff --git a/ntpd/ntpd-opts.c b/ntpd/ntpd-opts.c index 3505edaf4..3b225d52a 100644 --- a/ntpd/ntpd-opts.c +++ b/ntpd/ntpd-opts.c @@ -1,11 +1,11 @@ /* * EDIT THIS FILE WITH CAUTION (ntpd-opts.c) * - * It has been AutoGen-ed July 19, 2014 at 09:27:54 AM by AutoGen 5.18.3pre18 + * It has been AutoGen-ed July 20, 2014 at 08:20:30 AM by AutoGen 5.18.4pre9 * From the definitions ntpd-opts.def * and the template file options * - * Generated from AutoOpts 40:2:15 templates. + * Generated from AutoOpts 41:0:16 templates. * * AutoOpts is a copyrighted work. This source file is not encumbered * by AutoOpts licensing, but is provided under the licensing terms chosen diff --git a/ntpd/ntpd-opts.h b/ntpd/ntpd-opts.h index bcb6e4ef3..f751616e3 100644 --- a/ntpd/ntpd-opts.h +++ b/ntpd/ntpd-opts.h @@ -1,11 +1,11 @@ /* * EDIT THIS FILE WITH CAUTION (ntpd-opts.h) * - * It has been AutoGen-ed July 19, 2014 at 09:27:53 AM by AutoGen 5.18.3pre18 + * It has been AutoGen-ed July 20, 2014 at 08:20:30 AM by AutoGen 5.18.4pre9 * From the definitions ntpd-opts.def * and the template file options * - * Generated from AutoOpts 40:2:15 templates. + * Generated from AutoOpts 41:0:16 templates. * * AutoOpts is a copyrighted work. This header file is not encumbered * by AutoOpts licensing, but is provided under the licensing terms chosen @@ -53,7 +53,7 @@ * tolerable version is at least as old as what was current when the header * template was released. */ -#define AO_TEMPLATE_VERSION 163842 +#define AO_TEMPLATE_VERSION 167936 #if (AO_TEMPLATE_VERSION < OPTIONS_MINIMUM_VERSION) \ || (AO_TEMPLATE_VERSION > OPTIONS_STRUCT_VERSION) # error option template version mismatches autoopts/options.h header @@ -379,11 +379,11 @@ typedef enum { #define VALUE_OPT_USEPCC 0x1004 #define VALUE_OPT_PCCFREQ 0x1005 #define VALUE_OPT_MDNS 'm' -/** option flag (value) for " (get "val-name") " option */ +/** option flag (value) for help-value option */ #define VALUE_OPT_HELP '?' -/** option flag (value) for " (get "val-name") " option */ +/** option flag (value) for more-help-value option */ #define VALUE_OPT_MORE_HELP '!' -/** option flag (value) for " (get "val-name") " option */ +/** option flag (value) for version-value option */ #define VALUE_OPT_VERSION 0x1006 /* * Interface defines not associated with particular options @@ -416,11 +416,11 @@ extern tOptions ntpdOptions; # include # endif -# ifndef __attribute__ -# define __attribute__(_a) +# ifndef ATTRIBUTE_FORMAT_ARG +# define ATTRIBUTE_FORMAT_ARG(_a) # endif -static inline char* aoGetsText(char const* pz) __attribute__ ((format_arg(1))); +static inline char* aoGetsText(char const* pz) ATTRIBUTE_FORMAT_ARG(1); static inline char* aoGetsText(char const* pz) { if (pz == NULL) return NULL; return (char*)gettext(pz); diff --git a/ntpd/ntpdsim-opts.c b/ntpd/ntpdsim-opts.c index 2e8d4d385..e3655be13 100644 --- a/ntpd/ntpdsim-opts.c +++ b/ntpd/ntpdsim-opts.c @@ -1,11 +1,11 @@ /* * EDIT THIS FILE WITH CAUTION (ntpdsim-opts.c) * - * It has been AutoGen-ed March 30, 2014 at 01:32:59 AM by AutoGen 5.18.3pre18 + * It has been AutoGen-ed July 20, 2014 at 08:20:33 AM by AutoGen 5.18.4pre9 * From the definitions ntpdsim-opts.def * and the template file options * - * Generated from AutoOpts 40:2:15 templates. + * Generated from AutoOpts 41:0:16 templates. * * AutoOpts is a copyrighted work. This source file is not encumbered * by AutoOpts licensing, but is provided under the licensing terms chosen @@ -18,7 +18,7 @@ * The ntpdsim program is copyrighted and licensed * under the following terms: * - * Copyright (C) 1970-2013 The University of Delaware, all rights reserved. + * Copyright (C) 1970-2014 The University of Delaware, all rights reserved. * This is free software. It is licensed for use, modification and * redistribution under the terms of the NTP License, copies of which * can be seen at: @@ -75,8 +75,8 @@ extern FILE * option_usage_fp; * static const strings for ntpdsim options */ static char const ntpdsim_opt_strs[3124] = -/* 0 */ "ntpdsim 4.2.7p435\n" - "Copyright (C) 1970-2013 The University of Delaware, all rights reserved.\n" +/* 0 */ "ntpdsim 4.2.7p453\n" + "Copyright (C) 1970-2014 The University of Delaware, all rights reserved.\n" "This is free software. It is licensed for use, modification and\n" "redistribution under the terms of the NTP License, copies of which\n" "can be seen at:\n" @@ -207,14 +207,14 @@ static char const ntpdsim_opt_strs[3124] = /* 2916 */ "no-load-opts\0" /* 2929 */ "no\0" /* 2932 */ "NTPDSIM\0" -/* 2940 */ "ntpdsim - NTP daemon simulation program - Ver. 4.2.7p435\n" +/* 2940 */ "ntpdsim - NTP daemon simulation program - Ver. 4.2.7p453\n" "Usage: %s [ - [] | --[{=| }] ]...\n\0" /* 3055 */ "$HOME\0" /* 3061 */ ".\0" /* 3063 */ ".ntprc\0" /* 3070 */ "http://bugs.ntp.org, bugs@ntp.org\0" /* 3104 */ "\n\0" -/* 3106 */ "ntpdsim 4.2.7p435"; +/* 3106 */ "ntpdsim 4.2.7p453"; /** * ipv4 option description with @@ -1603,8 +1603,8 @@ static void bogus_function(void) { translate option names. */ /* referenced via ntpdsimOptions.pzCopyright */ - puts(_("ntpdsim 4.2.7p435\n\ -Copyright (C) 1970-2013 The University of Delaware, all rights reserved.\n\ + puts(_("ntpdsim 4.2.7p453\n\ +Copyright (C) 1970-2014 The University of Delaware, all rights reserved.\n\ This is free software. It is licensed for use, modification and\n\ redistribution under the terms of the NTP License, copies of which\n\ can be seen at:\n")); @@ -1746,14 +1746,14 @@ provided \"as is\" without express or implied warranty.\n")); puts(_("load options from a config file")); /* referenced via ntpdsimOptions.pzUsageTitle */ - puts(_("ntpdsim - NTP daemon simulation program - Ver. 4.2.7p435\n\ + puts(_("ntpdsim - NTP daemon simulation program - Ver. 4.2.7p453\n\ Usage: %s [ - [] | --[{=| }] ]...\n")); /* referenced via ntpdsimOptions.pzDetail */ puts(_("\n")); /* referenced via ntpdsimOptions.pzFullVersion */ - puts(_("ntpdsim 4.2.7p435")); + puts(_("ntpdsim 4.2.7p453")); /* referenced via ntpdsimOptions.pzFullUsage */ puts(_("<<>>")); diff --git a/ntpd/ntpdsim-opts.h b/ntpd/ntpdsim-opts.h index 3dd56c152..23d6faf6f 100644 --- a/ntpd/ntpdsim-opts.h +++ b/ntpd/ntpdsim-opts.h @@ -1,11 +1,11 @@ /* * EDIT THIS FILE WITH CAUTION (ntpdsim-opts.h) * - * It has been AutoGen-ed March 30, 2014 at 01:32:59 AM by AutoGen 5.18.3pre18 + * It has been AutoGen-ed July 20, 2014 at 08:20:33 AM by AutoGen 5.18.4pre9 * From the definitions ntpdsim-opts.def * and the template file options * - * Generated from AutoOpts 40:2:15 templates. + * Generated from AutoOpts 41:0:16 templates. * * AutoOpts is a copyrighted work. This header file is not encumbered * by AutoOpts licensing, but is provided under the licensing terms chosen @@ -18,7 +18,7 @@ * The ntpdsim program is copyrighted and licensed * under the following terms: * - * Copyright (C) 1970-2013 The University of Delaware, all rights reserved. + * Copyright (C) 1970-2014 The University of Delaware, all rights reserved. * This is free software. It is licensed for use, modification and * redistribution under the terms of the NTP License, copies of which * can be seen at: @@ -53,7 +53,7 @@ * tolerable version is at least as old as what was current when the header * template was released. */ -#define AO_TEMPLATE_VERSION 163842 +#define AO_TEMPLATE_VERSION 167936 #if (AO_TEMPLATE_VERSION < OPTIONS_MINIMUM_VERSION) \ || (AO_TEMPLATE_VERSION > OPTIONS_STRUCT_VERSION) # error option template version mismatches autoopts/options.h header @@ -107,9 +107,9 @@ typedef enum { /** count of all options for ntpdsim */ #define OPTION_CT 39 /** ntpdsim version */ -#define NTPDSIM_VERSION "4.2.7p435" +#define NTPDSIM_VERSION "4.2.7p453" /** Full ntpdsim version text */ -#define NTPDSIM_FULL_VERSION "ntpdsim 4.2.7p435" +#define NTPDSIM_FULL_VERSION "ntpdsim 4.2.7p453" /** * Interface defines for all options. Replace "n" with the UPPER_CASED @@ -382,15 +382,15 @@ typedef enum { #define VALUE_OPT_USEPCC 0x1004 #define VALUE_OPT_PCCFREQ 0x1005 #define VALUE_OPT_MDNS 'm' -/** option flag (value) for " (get "val-name") " option */ +/** option flag (value) for help-value option */ #define VALUE_OPT_HELP '?' -/** option flag (value) for " (get "val-name") " option */ +/** option flag (value) for more-help-value option */ #define VALUE_OPT_MORE_HELP '!' -/** option flag (value) for " (get "val-name") " option */ +/** option flag (value) for version-value option */ #define VALUE_OPT_VERSION 0x1006 -/** option flag (value) for " (get "val-name") " option */ +/** option flag (value) for save-opts-value option */ #define VALUE_OPT_SAVE_OPTS '>' -/** option flag (value) for " (get "val-name") " option */ +/** option flag (value) for load-opts-value option */ #define VALUE_OPT_LOAD_OPTS '<' #define SET_OPT_SAVE_OPTS(a) STMTS( \ DESC(SAVE_OPTS).fOptState &= OPTST_PERSISTENT_MASK; \ @@ -427,11 +427,11 @@ extern tOptions ntpdsimOptions; # include # endif -# ifndef __attribute__ -# define __attribute__(_a) +# ifndef ATTRIBUTE_FORMAT_ARG +# define ATTRIBUTE_FORMAT_ARG(_a) # endif -static inline char* aoGetsText(char const* pz) __attribute__ ((format_arg(1))); +static inline char* aoGetsText(char const* pz) ATTRIBUTE_FORMAT_ARG(1); static inline char* aoGetsText(char const* pz) { if (pz == NULL) return NULL; return (char*)gettext(pz); diff --git a/ntpdc/ntpdc-opts.c b/ntpdc/ntpdc-opts.c index 15cd4ab87..3e9fd4a43 100644 --- a/ntpdc/ntpdc-opts.c +++ b/ntpdc/ntpdc-opts.c @@ -1,11 +1,11 @@ /* * EDIT THIS FILE WITH CAUTION (ntpdc-opts.c) * - * It has been AutoGen-ed July 19, 2014 at 09:30:59 AM by AutoGen 5.18.3pre18 + * It has been AutoGen-ed July 20, 2014 at 08:20:35 AM by AutoGen 5.18.4pre9 * From the definitions ntpdc-opts.def * and the template file options * - * Generated from AutoOpts 40:2:15 templates. + * Generated from AutoOpts 41:0:16 templates. * * AutoOpts is a copyrighted work. This source file is not encumbered * by AutoOpts licensing, but is provided under the licensing terms chosen diff --git a/ntpdc/ntpdc-opts.h b/ntpdc/ntpdc-opts.h index 15d0eae50..42e044e37 100644 --- a/ntpdc/ntpdc-opts.h +++ b/ntpdc/ntpdc-opts.h @@ -1,11 +1,11 @@ /* * EDIT THIS FILE WITH CAUTION (ntpdc-opts.h) * - * It has been AutoGen-ed July 19, 2014 at 09:30:59 AM by AutoGen 5.18.3pre18 + * It has been AutoGen-ed July 20, 2014 at 08:20:35 AM by AutoGen 5.18.4pre9 * From the definitions ntpdc-opts.def * and the template file options * - * Generated from AutoOpts 40:2:15 templates. + * Generated from AutoOpts 41:0:16 templates. * * AutoOpts is a copyrighted work. This header file is not encumbered * by AutoOpts licensing, but is provided under the licensing terms chosen @@ -53,7 +53,7 @@ * tolerable version is at least as old as what was current when the header * template was released. */ -#define AO_TEMPLATE_VERSION 163842 +#define AO_TEMPLATE_VERSION 167936 #if (AO_TEMPLATE_VERSION < OPTIONS_MINIMUM_VERSION) \ || (AO_TEMPLATE_VERSION > OPTIONS_STRUCT_VERSION) # error option template version mismatches autoopts/options.h header @@ -207,15 +207,15 @@ typedef enum { #define VALUE_OPT_NUMERIC 'n' #define VALUE_OPT_PEERS 'p' #define VALUE_OPT_SHOWPEERS 's' -/** option flag (value) for " (get "val-name") " option */ +/** option flag (value) for help-value option */ #define VALUE_OPT_HELP '?' -/** option flag (value) for " (get "val-name") " option */ +/** option flag (value) for more-help-value option */ #define VALUE_OPT_MORE_HELP '!' -/** option flag (value) for " (get "val-name") " option */ +/** option flag (value) for version-value option */ #define VALUE_OPT_VERSION 0x1001 -/** option flag (value) for " (get "val-name") " option */ +/** option flag (value) for save-opts-value option */ #define VALUE_OPT_SAVE_OPTS '>' -/** option flag (value) for " (get "val-name") " option */ +/** option flag (value) for load-opts-value option */ #define VALUE_OPT_LOAD_OPTS '<' #define SET_OPT_SAVE_OPTS(a) STMTS( \ DESC(SAVE_OPTS).fOptState &= OPTST_PERSISTENT_MASK; \ @@ -252,11 +252,11 @@ extern tOptions ntpdcOptions; # include # endif -# ifndef __attribute__ -# define __attribute__(_a) +# ifndef ATTRIBUTE_FORMAT_ARG +# define ATTRIBUTE_FORMAT_ARG(_a) # endif -static inline char* aoGetsText(char const* pz) __attribute__ ((format_arg(1))); +static inline char* aoGetsText(char const* pz) ATTRIBUTE_FORMAT_ARG(1); static inline char* aoGetsText(char const* pz) { if (pz == NULL) return NULL; return (char*)gettext(pz); diff --git a/ntpq/invoke-ntpq.texi b/ntpq/invoke-ntpq.texi index 595afd3d4..b2db7e3fc 100644 --- a/ntpq/invoke-ntpq.texi +++ b/ntpq/invoke-ntpq.texi @@ -6,7 +6,7 @@ # # EDIT THIS FILE WITH CAUTION (invoke-ntpq.texi) # -# It has been AutoGen-ed July 19, 2014 at 09:31:51 AM by AutoGen 5.18.3pre18 +# It has been AutoGen-ed July 20, 2014 at 09:28:57 AM by AutoGen 5.18.4pre9 # From the definitions ntpq-opts.def # and the template file agtexi-cmd.tpl @end ignore @@ -219,9 +219,6 @@ There appear to be no servers left which demand version 1. With no argument, displays the current NTP version that will be used when communicating with servers. -@item @code{quit} -Exit -@code{ntpq} @item @code{passwd} This command prompts you to type in a password (which will not be echoed) which will be used to authenticate configuration @@ -229,6 +226,9 @@ requests. The password must correspond to the key configured for use by the NTP server for this purpose if such requests are to be successful. +@item @code{quit} +Exit +@code{ntpq} @item @code{raw} Causes all output from query commands is printed as received from the remote server. @@ -270,7 +270,7 @@ ind assid status conf reach auth condition last_event cnt @item @code{status} @code{Ta} @code{peer} @code{status} @code{word} @item @code{conf} @code{Ta} @code{yes}: @code{persistent,} @code{no}: @code{ephemeral} @item @code{reach} @code{Ta} @code{yes}: @code{reachable,} @code{no}: @code{unreachable} -@item @code{auth} @code{Ta} @code{ok}, @code{Liyes}, @code{bad} @code{and} @code{none} +@item @code{auth} @code{Ta} @code{ok}, @code{yes}, @code{bad} @code{and} @code{none} @item @code{condition} @code{Ta} @code{selection} @code{status} @code{(see} @code{the} @code{select} @code{field} @code{of} @code{the} @code{peer} @code{status} @code{word)} @item @code{last_event} @code{Ta} @code{event} @code{report} @code{(see} @code{the} @code{event} @code{field} @code{of} @code{the} @code{peer} @code{status} @code{word)} @item @code{cnt} @code{Ta} @code{event} @code{count} @code{(see} @code{the} @code{count} @code{field} @code{of} @code{the} @code{peer} @code{status} @code{word)} @@ -379,7 +379,9 @@ Perform the same function as the except that it uses previously stored data rather than making a new query. @item @code{peers} Display a list of peers in the form: -@code{[tally]remote} @code{refid} @code{st} @code{t} @code{when} @code{pool} @code{reach} @code{delay} @code{offset} @code{jitter} +@example +[tally]remote refid st t when pool reach delay offset jitter +@end example @table @asis @item Variable Description @@ -387,12 +389,12 @@ Description single-character code indicating current value of the @code{select} field of the -peer status word +.Lk decode.html#peer "peer status word" @item @code{remote} host name (or IP number) of peer @item @code{refid} association ID or -kiss code +.Lk decode.html#kiss "'kiss code" @item @code{st} stratum @item @code{t} @@ -429,9 +431,9 @@ Display the specified variables. If @kbd{assocID} is zero, the variables are from the -system variables +@ref{System Variables} name space, otherwise they are from the -peer variables +@ref{Peer Variables} name space. The @kbd{assocID} @@ -461,7 +463,7 @@ or to the ntpd host's file @kbd{filename}. This command will be rejected by the server unless -saveconfigdir +.Lk miscopt.html#saveconfigdir "saveconfigdir" appears in the @code{ntpd} configuration file. @@ -478,9 +480,9 @@ Write the specified variables. If the @kbd{assocID} is zero, the variables are from the -system variables +@ref{System Variables} name space, otherwise they are from the -peer variables +@ref{Peer Variables} name space. The @kbd{assocID} @@ -491,7 +493,7 @@ Display operational summary. Print statistics counters maintained in the protocol module. @end table -.SS Status Words and Kiss Codes +@subsubsection Status Words and Kiss Codes The current state of the operating program is shown in a set of status words maintained by the system and each association separately. These words are displayed in the @@ -500,13 +502,14 @@ and @code{as} commands both in hexadecimal and decoded short tip strings. The codes, tips and short explanations are on the -Event Messages and Status Words page. +.Lk decode.html "Event Messages and Status Words" +page. The page also includes a list of system and peer messages, the code for the latest of which is included in the status word. Information resulting from protocol machine state transitions is displayed using an informal set of ASCII strings called -kiss codes. +.Lk decode.html#kiss "kiss codes" . The original purpose was for kiss-o'-death (KoD) packets sent by the server to advise the client of an unusual condition. They are now displayed, when appropriate, @@ -521,8 +524,7 @@ Not all variables are displayed in some configurations. @item Variable Description @item @code{status} - -system status word +.Lk decode.html#sys "system status word" @item @code{version} NTP software version and build time @item @code{processor} @@ -549,7 +551,7 @@ minimum time constant (log2 s) (3-10) date and time of day @item @code{refid} reference ID or -kiss code +.Lk decode.html#kiss "kiss code" @item @code{reftime} reference time @item @code{offset} @@ -610,7 +612,7 @@ Description @item @code{associd} association ID @item @code{status} -peer status word +.Lk decode.html#peer "peer status word" @item @code{srcadr} source (remote) IP address @item @code{srcport} @@ -631,7 +633,7 @@ total roundtrip delay to the primary reference clock total root dispersion to the primary reference clock @item @code{refid} reference ID or -kiss code +.Lk decode.html#kiss "kiss code" @item @code{reftime} reference time @item @code{reach} @@ -648,9 +650,9 @@ host poll exponent (log2 s) (3-17) peer poll exponent (log2 s) (3-17) @item @code{headway} headway (see -Rate Management and the Kiss-o'-Death Packet ) +.Lk rate.html "Rate Management and the Kiss-o'-Death Packet" ) @item @code{flash} -flash status word +.Lk decode.html#flash "flash status word" @item @code{offset} filter offset @item @code{delay} @@ -665,7 +667,7 @@ Autokey group name for this association unicast/broadcast bias @item @code{xleave} interleave delay (see -NTP Interleaved Modes ) +.Lk xleave.html "NTP Interleaved Modes" ) @end table The @code{bias} @@ -710,7 +712,7 @@ Description @item @code{associd} association ID @item @code{status} -clock status word +.Lk decode.html#clock "clock status word" @item @code{device} device description @item @code{timecode} diff --git a/ntpq/ntpq-opts.c b/ntpq/ntpq-opts.c index d3c1b66ad..8ca57a803 100644 --- a/ntpq/ntpq-opts.c +++ b/ntpq/ntpq-opts.c @@ -1,11 +1,11 @@ /* * EDIT THIS FILE WITH CAUTION (ntpq-opts.c) * - * It has been AutoGen-ed July 19, 2014 at 09:31:21 AM by AutoGen 5.18.3pre18 + * It has been AutoGen-ed July 20, 2014 at 09:28:39 AM by AutoGen 5.18.4pre9 * From the definitions ntpq-opts.def * and the template file options * - * Generated from AutoOpts 40:2:15 templates. + * Generated from AutoOpts 41:0:16 templates. * * AutoOpts is a copyrighted work. This source file is not encumbered * by AutoOpts licensing, but is provided under the licensing terms chosen diff --git a/ntpq/ntpq-opts.h b/ntpq/ntpq-opts.h index a0c82c655..46124a5f6 100644 --- a/ntpq/ntpq-opts.h +++ b/ntpq/ntpq-opts.h @@ -1,11 +1,11 @@ /* * EDIT THIS FILE WITH CAUTION (ntpq-opts.h) * - * It has been AutoGen-ed July 19, 2014 at 09:31:21 AM by AutoGen 5.18.3pre18 + * It has been AutoGen-ed July 20, 2014 at 09:28:39 AM by AutoGen 5.18.4pre9 * From the definitions ntpq-opts.def * and the template file options * - * Generated from AutoOpts 40:2:15 templates. + * Generated from AutoOpts 41:0:16 templates. * * AutoOpts is a copyrighted work. This header file is not encumbered * by AutoOpts licensing, but is provided under the licensing terms chosen @@ -53,7 +53,7 @@ * tolerable version is at least as old as what was current when the header * template was released. */ -#define AO_TEMPLATE_VERSION 163842 +#define AO_TEMPLATE_VERSION 167936 #if (AO_TEMPLATE_VERSION < OPTIONS_MINIMUM_VERSION) \ || (AO_TEMPLATE_VERSION > OPTIONS_STRUCT_VERSION) # error option template version mismatches autoopts/options.h header @@ -200,15 +200,15 @@ typedef enum { #define VALUE_OPT_INTERACTIVE 'i' #define VALUE_OPT_NUMERIC 'n' #define VALUE_OPT_OLD_RV 0x1001 -/** option flag (value) for " (get "val-name") " option */ +/** option flag (value) for help-value option */ #define VALUE_OPT_HELP '?' -/** option flag (value) for " (get "val-name") " option */ +/** option flag (value) for more-help-value option */ #define VALUE_OPT_MORE_HELP '!' -/** option flag (value) for " (get "val-name") " option */ +/** option flag (value) for version-value option */ #define VALUE_OPT_VERSION 0x1002 -/** option flag (value) for " (get "val-name") " option */ +/** option flag (value) for save-opts-value option */ #define VALUE_OPT_SAVE_OPTS '>' -/** option flag (value) for " (get "val-name") " option */ +/** option flag (value) for load-opts-value option */ #define VALUE_OPT_LOAD_OPTS '<' #define SET_OPT_SAVE_OPTS(a) STMTS( \ DESC(SAVE_OPTS).fOptState &= OPTST_PERSISTENT_MASK; \ @@ -245,11 +245,11 @@ extern tOptions ntpqOptions; # include # endif -# ifndef __attribute__ -# define __attribute__(_a) +# ifndef ATTRIBUTE_FORMAT_ARG +# define ATTRIBUTE_FORMAT_ARG(_a) # endif -static inline char* aoGetsText(char const* pz) __attribute__ ((format_arg(1))); +static inline char* aoGetsText(char const* pz) ATTRIBUTE_FORMAT_ARG(1); static inline char* aoGetsText(char const* pz) { if (pz == NULL) return NULL; return (char*)gettext(pz); diff --git a/ntpq/ntpq.1ntpqman b/ntpq/ntpq.1ntpqman index 95e139c46..67fc976fd 100644 --- a/ntpq/ntpq.1ntpqman +++ b/ntpq/ntpq.1ntpqman @@ -10,11 +10,11 @@ .ds B-Font B .ds I-Font I .ds R-Font R -.TH ntpq 1ntpqman "19 Jul 2014" "4.2.7p453" "User Commands" +.TH ntpq 1ntpqman "20 Jul 2014" "4.2.7p453" "User Commands" .\" -.\" EDIT THIS FILE WITH CAUTION (/tmp/.ag-psaWPR/ag-BsaWOR) +.\" EDIT THIS FILE WITH CAUTION (in-mem file) .\" -.\" It has been AutoGen-ed July 19, 2014 at 09:31:47 AM by AutoGen 5.18.3pre18 +.\" It has been AutoGen-ed July 20, 2014 at 09:28:59 AM by AutoGen 5.18.4pre9 .\" From the definitions ntpq-opts.def .\" and the template file agman-cmd.tpl .SH NAME @@ -273,12 +273,6 @@ when communicating with servers. .br .ns .TP 20 -.NOP \f\*[B-Font]quit\f[] -Exit -\f\*[B-Font]ntpq\fP -.br -.ns -.TP 20 .NOP \f\*[B-Font]passwd\f[] This command prompts you to type in a password (which will not be echoed) which will be used to authenticate configuration @@ -289,6 +283,12 @@ successful. .br .ns .TP 20 +.NOP \f\*[B-Font]quit\f[] +Exit +\f\*[B-Font]ntpq\fP +.br +.ns +.TP 20 .NOP \f\*[B-Font]raw\f[] Causes all output from query commands is printed as received from the remote server. @@ -330,7 +330,7 @@ Display a list of mobilized associations in the form: .IP \fB\(bu\fP 2 \f[C]status\f[] \f[C]Ta\f[] \f[C]peer\f[] \f[C]status\f[] \f[C]word\f[] .IP \fB\(bu\fP 2 \f[C]conf\f[] \f[C]Ta\f[] \f[C]yes\f[]: \f[C]persistent,\f[] \f[C]no\f[]: \f[C]ephemeral\f[] .IP \fB\(bu\fP 2 \f[C]reach\f[] \f[C]Ta\f[] \f[C]yes\f[]: \f[C]reachable,\f[] \f[C]no\f[]: \f[C]unreachable\f[] -.IP \fB\(bu\fP 2 \f[C]auth\f[] \f[C]Ta\f[] \f[C]ok\f[], \f[C]Liyes\f[], \f[C]bad\f[] \f[C]and\f[] \f[C]none\f[] +.IP \fB\(bu\fP 2 \f[C]auth\f[] \f[C]Ta\f[] \f[C]ok\f[], \f[C]yes\f[], \f[C]bad\f[] \f[C]and\f[] \f[C]none\f[] .IP \fB\(bu\fP 2 \f[C]condition\f[] \f[C]Ta\f[] \f[C]selection\f[] \f[C]status\f[] \f[C](see\f[] \f[C]the\f[] \f[C]select\f[] \f[C]field\f[] \f[C]of\f[] \f[C]the\f[] \f[C]peer\f[] \f[C]status\f[] \f[C]word)\f[] .IP \fB\(bu\fP 2 \f[C]last_event\f[] \f[C]Ta\f[] \f[C]event\f[] \f[C]report\f[] \f[C](see\f[] \f[C]the\f[] \f[C]event\f[] \f[C]field\f[] \f[C]of\f[] \f[C]the\f[] \f[C]peer\f[] \f[C]status\f[] \f[C]word)\f[] .IP \fB\(bu\fP 2 \f[C]cnt\f[] \f[C]Ta\f[] \f[C]event\f[] \f[C]count\f[] \f[C](see\f[] \f[C]the\f[] \f[C]count\f[] \f[C]field\f[] \f[C]of\f[] \f[C]the\f[] \f[C]peer\f[] \f[C]status\f[] \f[C]word)\f[] @@ -347,12 +347,12 @@ Display a list of clock variables for those associations supporting a reference .br .ns .TP 10 -.NOP \f[C]:config\f[] [...] +.NOP \f\*[B-Font]:config\f[] [...] Send the remainder of the command line, including whitespace, to the server as a run-time configuration command in the same format as a line in the configuration file. This command is experimental until further notice and clarification. Authentication is of course required. .br .ns .TP 10 -.NOP \f[C]config-from-file\f[] \f\*[I-Font]filename\f[] +.NOP \f\*[B-Font]config-from-file\f[] \f\*[I-Font]filename\f[] Send the each line of \f\*[I-Font]filename\f[] to the server as run-time configuration commands in the same format as a line in the configuration file. This command is experimental until further notice and clarification. Authentication is required. @@ -509,7 +509,7 @@ except that it uses previously stored data rather than making a new query. .TP 10 .NOP \f\*[B-Font]peers\f[] Display a list of peers in the form: -\f\*[B-Font][tally]remote\f[] \f\*[B-Font]refid\f[] \f\*[B-Font]st\f[] \f\*[B-Font]t\f[] \f\*[B-Font]when\f[] \f\*[B-Font]pool\f[] \f\*[B-Font]reach\f[] \f\*[B-Font]delay\f[] \f\*[B-Font]offset\f[] \f\*[B-Font]jitter\f[] +.Dl [tally]remote refid st t when pool reach delay offset jitter .RS .TP 10 .NOP Variable @@ -521,7 +521,7 @@ Description single-character code indicating current value of the \f\*[B-Font]select\f[] field of the -peer status word +.Lk decode.html#peer "peer status word" .br .ns .TP 10 @@ -532,7 +532,7 @@ host name (or IP number) of peer .TP 10 .NOP \f\*[B-Font]refid\f[] association ID or -kiss code +.Lk decode.html#kiss "'kiss code" .br .ns .TP 10 @@ -599,9 +599,9 @@ Display the specified variables. If \f\*[I-Font]assocID\f[] is zero, the variables are from the -system variables +\fISystem\f[] \fIVariables\f[] name space, otherwise they are from the -peer variables +\fIPeer\f[] \fIVariables\f[] name space. The \f\*[I-Font]assocID\f[] @@ -633,7 +633,7 @@ or to the ntpd host's file \f\*[I-Font]filename\f[]. This command will be rejected by the server unless -saveconfigdir +.Lk miscopt.html#saveconfigdir "saveconfigdir" appears in the \f\*[B-Font]ntpd\f[] configuration file. @@ -653,9 +653,9 @@ Write the specified variables. If the \f\*[I-Font]assocID\f[] is zero, the variables are from the -system variables +\fISystem\f[] \fIVariables\f[] name space, otherwise they are from the -peer variables +\fIPeer\f[] \fIVariables\f[] name space. The \f\*[I-Font]assocID\f[] @@ -679,12 +679,16 @@ and \f\*[B-Font]as\f[] commands both in hexadecimal and decoded short tip strings. The codes, tips and short explanations are on the -Event Messages and Status Words page. +.Lk decode.html "Event Messages and Status Words" +page. The page also includes a list of system and peer messages, the code for the latest of which is included in the status word. +.sp \n(Ppu +.ne 2 + Information resulting from protocol machine state transitions is displayed using an informal set of ASCII strings called -kiss codes. +.Lk decode.html#kiss "kiss codes" . The original purpose was for kiss-o'-death (KoD) packets sent by the server to advise the client of an unusual condition. They are now displayed, when appropriate, @@ -701,8 +705,7 @@ Description .ns .TP 10 .NOP \f\*[B-Font]status\f[] - -system status word +.Lk decode.html#sys "system status word" .br .ns .TP 10 @@ -768,7 +771,7 @@ date and time of day .TP 10 .NOP \f\*[B-Font]refid\f[] reference ID or -kiss code +.Lk decode.html#kiss "kiss code" .br .ns .TP 10 @@ -818,6 +821,9 @@ NTP seconds when the NIST leapseconds file expires The jitter and wander statistics are exponentially-weighted RMS averages. The system jitter is defined in the NTPv4 specification; the clock jitter statistic is computed by the clock discipline module. +.sp \n(Ppu +.ne 2 + When the NTPv4 daemon is compiled with the OpenSSL software library, additional system variables are displayed, including some or all of the following, @@ -883,7 +889,7 @@ association ID .ns .TP 10 .NOP \f\*[B-Font]status\f[] -peer status word +.Lk decode.html#peer "peer status word" .br .ns .TP 10 @@ -934,7 +940,7 @@ total root dispersion to the primary reference clock .TP 10 .NOP \f\*[B-Font]refid\f[] reference ID or -kiss code +.Lk decode.html#kiss "kiss code" .br .ns .TP 10 @@ -975,12 +981,12 @@ peer poll exponent (log2 s) (3-17) .TP 10 .NOP \f\*[B-Font]headway\f[] headway (see -Rate Management and the Kiss-o'-Death Packet ) +.Lk rate.html "Rate Management and the Kiss-o'-Death Packet" ) .br .ns .TP 10 .NOP \f\*[B-Font]flash\f[] -flash status word +.Lk decode.html#flash "flash status word" .br .ns .TP 10 @@ -1016,7 +1022,7 @@ unicast/broadcast bias .TP 10 .NOP \f\*[B-Font]xleave\f[] interleave delay (see -NTP Interleaved Modes ) +.Lk xleave.html "NTP Interleaved Modes" ) .PP The \f\*[B-Font]bias\f[] @@ -1028,6 +1034,9 @@ The variable appears only for the interleaved symmetric and interleaved modes. It represents the internal queuing, buffering and transmission delays for the preceding packet. +.sp \n(Ppu +.ne 2 + When the NTPv4 daemon is compiled with the OpenSSL software library, additional peer variables are displayed, including the following: .TP 10 @@ -1086,7 +1095,7 @@ association ID .ns .TP 10 .NOP \f\*[B-Font]status\f[] -clock status word +.Lk decode.html#clock "clock status word" .br .ns .TP 10 @@ -1251,35 +1260,6 @@ 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. -.TH ntpq 1ntpqman "19 Jul 2014" "4.2.7p453" "User Commands" -.\" -.\" EDIT THIS FILE WITH CAUTION (/tmp/.ag-psaWPR/ag-BsaWOR) -.\" -.\" It has been AutoGen-ed July 19, 2014 at 09:31:47 AM by AutoGen 5.18.3pre18 -.\" From the definitions ntpq-opts.def -.\" and the template file agman-cmd.tpl -.SH NAME -\f\*[B-Font]ntpq\fP ntpq -\- standard NTP query program -cvt_prog='/usr/local/gnu/share/autogen/texi2man' -cvt_prog=`cd \`dirname "$cvt_prog"\` >/dev/null && pwd - `/`basename "$cvt_prog"` -cd $tmp_dir -test \-x "$cvt_prog" || die "'$cvt_prog' is not executable" -{ - list='synopsis description options option-presets' - for f in $list ; do cat $f ; echo ; done - rm \-f $list name - list='implementation-notes environment files examples exit-status errors - compatibility see-also conforming-to history authors copyright bugs - notes' - for f in $list ; do cat $f ; echo ; done > .end-doc - rm \-f $list - list=`ls \-1 *`' .end-doc' - for f in $list ; do cat $f ; echo ; done - rm \-f $list -} 1>.doc 2>/dev/null -/opt/csw/bin/ggrep \-E \-v '^[ ]*$' .doc | $cvt_prog .SH "ENVIRONMENT" See \fBOPTION PRESETS\fP for configuration environment variables. .SH "FILES" diff --git a/ntpq/ntpq.1ntpqmdoc b/ntpq/ntpq.1ntpqmdoc index e5e3a0fdf..b654938b5 100644 --- a/ntpq/ntpq.1ntpqmdoc +++ b/ntpq/ntpq.1ntpqmdoc @@ -1,9 +1,9 @@ -.Dd July 19 2014 +.Dd July 20 2014 .Dt NTPQ 1ntpqmdoc User Commands .Os .\" EDIT THIS FILE WITH CAUTION (ntpq-opts.mdoc) .\" -.\" It has been AutoGen-ed July 19, 2014 at 09:31:53 AM by AutoGen 5.18.3pre18 +.\" It has been AutoGen-ed July 20, 2014 at 09:28:49 AM by AutoGen 5.18.4pre9 .\" From the definitions ntpq-opts.def .\" and the template file agmdoc-cmd.tpl .Sh NAME @@ -236,9 +236,6 @@ There appear to be no servers left which demand version 1. With no argument, displays the current NTP version that will be used when communicating with servers. -.It Ic quit -Exit -.Nm .It Ic passwd This command prompts you to type in a password (which will not be echoed) which will be used to authenticate configuration @@ -246,6 +243,9 @@ requests. The password must correspond to the key configured for use by the NTP server for this purpose if such requests are to be successful. +.It Ic quit +Exit +.Nm .It Ic raw Causes all output from query commands is printed as received from the remote server. @@ -284,7 +284,7 @@ Display a list of mobilized associations in the form: .It Li status Ta peer status word .It Li conf Ta Li yes : persistent, Li no : ephemeral .It Li reach Ta Li yes : reachable, Li no : unreachable -.It Li auth Ta Li ok , Liyes , Li bad and Li none +.It Li auth Ta Li ok , Li yes , Li bad and Li none .It Li condition Ta selection status (see the Li select field of the peer status word) .It Li last_event Ta event report (see the Li event field of the peer status word) .It Li cnt Ta event count (see the Li count field of the peer status word) @@ -292,9 +292,9 @@ Display a list of mobilized associations in the form: .It Cm clockvar Ar assocID Oo Ar name Oo Cm = Ar value Op ... Oc Oc Op ... .It Cm cv Ar assocID Oo Ar name Oo Cm = Ar value Op ... Oc Oc Op ... Display a list of clock variables for those associations supporting a reference clock. -.It Li :config Op ... +.It Cm :config Op ... Send the remainder of the command line, including whitespace, to the server as a run\-time configuration command in the same format as a line in the configuration file. This command is experimental until further notice and clarification. Authentication is of course required. -.It Li config\-from\-file Ar filename +.It Cm config\-from\-file Ar filename Send the each line of .Ar filename to the server as run\-time configuration commands in the same format as a line in the configuration file. This command is experimental until further notice and clarification. Authentication is required. @@ -393,7 +393,7 @@ Perform the same function as the except that it uses previously stored data rather than making a new query. .It Ic peers Display a list of peers in the form: -.Ic [tally]remote refid st t when pool reach delay offset jitter +.Dl [tally]remote refid st t when pool reach delay offset jitter .Bl -tag -width "something" -compact -offset indent .It Variable Description @@ -401,12 +401,12 @@ Description single\-character code indicating current value of the .Ic select field of the -peer status word +.Lk decode.html#peer "peer status word" .It Ic remote host name (or IP number) of peer .It Ic refid association ID or -kiss code +.Lk decode.html#kiss "'kiss code" .It Ic st stratum .It Ic t @@ -443,9 +443,9 @@ Display the specified variables. If .Ar assocID is zero, the variables are from the -system variables +.Sx System Variables name space, otherwise they are from the -peer variables +.Sx Peer Variables name space. The .Ar assocID @@ -474,7 +474,7 @@ or to the ntpd host's file .Ar filename . This command will be rejected by the server unless -saveconfigdir +.Lk miscopt.html#saveconfigdir "saveconfigdir" appears in the .Ic ntpd configuration file. @@ -491,9 +491,9 @@ Write the specified variables. If the .Ar assocID is zero, the variables are from the -system variables +.Sx System Variables name space, otherwise they are from the -peer variables +.Sx Peer Variables name space. The .Ar assocID @@ -503,7 +503,7 @@ Display operational summary. .It Ic sysstats Print statistics counters maintained in the protocol module. .El -.SS Status Words and Kiss Codes +.Ss Status Words and Kiss Codes The current state of the operating program is shown in a set of status words maintained by the system and each association separately. These words are displayed in the .Ic rv @@ -511,12 +511,14 @@ and .Ic as commands both in hexadecimal and decoded short tip strings. The codes, tips and short explanations are on the -Event Messages and Status Words page. +.Lk decode.html "Event Messages and Status Words" +page. The page also includes a list of system and peer messages, the code for the latest of which is included in the status word. +.Pp Information resulting from protocol machine state transitions is displayed using an informal set of ASCII strings called -kiss codes. +.Lk decode.html#kiss "kiss codes" . The original purpose was for kiss\-o'\-death (KoD) packets sent by the server to advise the client of an unusual condition. They are now displayed, when appropriate, @@ -530,8 +532,7 @@ Not all variables are displayed in some configurations. .It Variable Description .It Ic status - -system status word +.Lk decode.html#sys "system status word" .It Ic version NTP software version and build time .It Ic processor @@ -558,7 +559,7 @@ minimum time constant (log2 s) (3\-10) date and time of day .It Ic refid reference ID or -kiss code +.Lk decode.html#kiss "kiss code" .It Ic reftime reference time .It Ic offset @@ -581,6 +582,7 @@ NTP seconds when the NIST leapseconds file expires The jitter and wander statistics are exponentially\-weighted RMS averages. The system jitter is defined in the NTPv4 specification; the clock jitter statistic is computed by the clock discipline module. +.Pp When the NTPv4 daemon is compiled with the OpenSSL software library, additional system variables are displayed, including some or all of the following, @@ -616,7 +618,7 @@ Description .It Ic associd association ID .It Ic status -peer status word +.Lk decode.html#peer "peer status word" .It Ic srcadr source (remote) IP address .It Ic srcport @@ -637,7 +639,7 @@ total roundtrip delay to the primary reference clock total root dispersion to the primary reference clock .It Ic refid reference ID or -kiss code +.Lk decode.html#kiss "kiss code" .It Ic reftime reference time .It Ic reach @@ -654,9 +656,9 @@ host poll exponent (log2 s) (3\-17) peer poll exponent (log2 s) (3\-17) .It Ic headway headway (see -Rate Management and the Kiss\-o'\-Death Packet ) +.Lk rate.html "Rate Management and the Kiss\-o'\-Death Packet" ) .It Ic flash -flash status word +.Lk decode.html#flash "flash status word" .It Ic offset filter offset .It Ic delay @@ -671,7 +673,7 @@ Autokey group name for this association unicast/broadcast bias .It Ic xleave interleave delay (see -NTP Interleaved Modes ) +.Lk xleave.html "NTP Interleaved Modes" ) .El The .Ic bias @@ -683,6 +685,7 @@ The variable appears only for the interleaved symmetric and interleaved modes. It represents the internal queuing, buffering and transmission delays for the preceding packet. +.Pp When the NTPv4 daemon is compiled with the OpenSSL software library, additional peer variables are displayed, including the following: .Bl -tag -width "something" -compact -offset indent @@ -714,7 +717,7 @@ Description .It Ic associd association ID .It Ic status -clock status word +.Lk decode.html#clock "clock status word" .It Ic device device description .It Ic timecode @@ -833,25 +836,6 @@ 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. -cvt_prog='/usr/local/gnu/share/autogen/texi2mdoc' -cvt_prog=`cd \`dirname "$cvt_prog"\` >/dev/null && pwd - `/`basename "$cvt_prog"` -cd $tmp_dir -test \-x "$cvt_prog" || die "'$cvt_prog' is not executable" -{ - list='synopsis description options option\-presets' - for f in $list ; do cat $f ; echo ; done - rm \-f $list name - list='implementation\-notes environment files examples exit\-status errors - compatibility see\-also conforming\-to history authors copyright bugs - notes' - for f in $list ; do cat $f ; echo ; done > .end\-doc - rm \-f $list - list=`ls \-1 *`' .end\-doc' - for f in $list ; do cat $f ; echo ; done - rm \-f $list -} 1>.doc 2>/dev/null -/opt/csw/bin/ggrep \-E \-v '^[ ]*$' .doc | $cvt_prog .Sh "ENVIRONMENT" See \fBOPTION PRESETS\fP for configuration environment variables. .Sh "FILES" diff --git a/ntpq/ntpq.man.in b/ntpq/ntpq.man.in index c09dcde48..cef4ccbfe 100644 --- a/ntpq/ntpq.man.in +++ b/ntpq/ntpq.man.in @@ -10,11 +10,11 @@ .ds B-Font B .ds I-Font I .ds R-Font R -.TH ntpq @NTPQ_MS@ "19 Jul 2014" "4.2.7p453" "User Commands" +.TH ntpq @NTPQ_MS@ "20 Jul 2014" "4.2.7p453" "User Commands" .\" -.\" EDIT THIS FILE WITH CAUTION (/tmp/.ag-psaWPR/ag-BsaWOR) +.\" EDIT THIS FILE WITH CAUTION (in-mem file) .\" -.\" It has been AutoGen-ed July 19, 2014 at 09:31:47 AM by AutoGen 5.18.3pre18 +.\" It has been AutoGen-ed July 20, 2014 at 09:28:59 AM by AutoGen 5.18.4pre9 .\" From the definitions ntpq-opts.def .\" and the template file agman-cmd.tpl .SH NAME @@ -273,12 +273,6 @@ when communicating with servers. .br .ns .TP 20 -.NOP \f\*[B-Font]quit\f[] -Exit -\f\*[B-Font]ntpq\fP -.br -.ns -.TP 20 .NOP \f\*[B-Font]passwd\f[] This command prompts you to type in a password (which will not be echoed) which will be used to authenticate configuration @@ -289,6 +283,12 @@ successful. .br .ns .TP 20 +.NOP \f\*[B-Font]quit\f[] +Exit +\f\*[B-Font]ntpq\fP +.br +.ns +.TP 20 .NOP \f\*[B-Font]raw\f[] Causes all output from query commands is printed as received from the remote server. @@ -330,7 +330,7 @@ Display a list of mobilized associations in the form: .IP \fB\(bu\fP 2 \f[C]status\f[] \f[C]Ta\f[] \f[C]peer\f[] \f[C]status\f[] \f[C]word\f[] .IP \fB\(bu\fP 2 \f[C]conf\f[] \f[C]Ta\f[] \f[C]yes\f[]: \f[C]persistent,\f[] \f[C]no\f[]: \f[C]ephemeral\f[] .IP \fB\(bu\fP 2 \f[C]reach\f[] \f[C]Ta\f[] \f[C]yes\f[]: \f[C]reachable,\f[] \f[C]no\f[]: \f[C]unreachable\f[] -.IP \fB\(bu\fP 2 \f[C]auth\f[] \f[C]Ta\f[] \f[C]ok\f[], \f[C]Liyes\f[], \f[C]bad\f[] \f[C]and\f[] \f[C]none\f[] +.IP \fB\(bu\fP 2 \f[C]auth\f[] \f[C]Ta\f[] \f[C]ok\f[], \f[C]yes\f[], \f[C]bad\f[] \f[C]and\f[] \f[C]none\f[] .IP \fB\(bu\fP 2 \f[C]condition\f[] \f[C]Ta\f[] \f[C]selection\f[] \f[C]status\f[] \f[C](see\f[] \f[C]the\f[] \f[C]select\f[] \f[C]field\f[] \f[C]of\f[] \f[C]the\f[] \f[C]peer\f[] \f[C]status\f[] \f[C]word)\f[] .IP \fB\(bu\fP 2 \f[C]last_event\f[] \f[C]Ta\f[] \f[C]event\f[] \f[C]report\f[] \f[C](see\f[] \f[C]the\f[] \f[C]event\f[] \f[C]field\f[] \f[C]of\f[] \f[C]the\f[] \f[C]peer\f[] \f[C]status\f[] \f[C]word)\f[] .IP \fB\(bu\fP 2 \f[C]cnt\f[] \f[C]Ta\f[] \f[C]event\f[] \f[C]count\f[] \f[C](see\f[] \f[C]the\f[] \f[C]count\f[] \f[C]field\f[] \f[C]of\f[] \f[C]the\f[] \f[C]peer\f[] \f[C]status\f[] \f[C]word)\f[] @@ -347,12 +347,12 @@ Display a list of clock variables for those associations supporting a reference .br .ns .TP 10 -.NOP \f[C]:config\f[] [...] +.NOP \f\*[B-Font]:config\f[] [...] Send the remainder of the command line, including whitespace, to the server as a run-time configuration command in the same format as a line in the configuration file. This command is experimental until further notice and clarification. Authentication is of course required. .br .ns .TP 10 -.NOP \f[C]config-from-file\f[] \f\*[I-Font]filename\f[] +.NOP \f\*[B-Font]config-from-file\f[] \f\*[I-Font]filename\f[] Send the each line of \f\*[I-Font]filename\f[] to the server as run-time configuration commands in the same format as a line in the configuration file. This command is experimental until further notice and clarification. Authentication is required. @@ -509,7 +509,7 @@ except that it uses previously stored data rather than making a new query. .TP 10 .NOP \f\*[B-Font]peers\f[] Display a list of peers in the form: -\f\*[B-Font][tally]remote\f[] \f\*[B-Font]refid\f[] \f\*[B-Font]st\f[] \f\*[B-Font]t\f[] \f\*[B-Font]when\f[] \f\*[B-Font]pool\f[] \f\*[B-Font]reach\f[] \f\*[B-Font]delay\f[] \f\*[B-Font]offset\f[] \f\*[B-Font]jitter\f[] +.Dl [tally]remote refid st t when pool reach delay offset jitter .RS .TP 10 .NOP Variable @@ -521,7 +521,7 @@ Description single-character code indicating current value of the \f\*[B-Font]select\f[] field of the -peer status word +.Lk decode.html#peer "peer status word" .br .ns .TP 10 @@ -532,7 +532,7 @@ host name (or IP number) of peer .TP 10 .NOP \f\*[B-Font]refid\f[] association ID or -kiss code +.Lk decode.html#kiss "'kiss code" .br .ns .TP 10 @@ -599,9 +599,9 @@ Display the specified variables. If \f\*[I-Font]assocID\f[] is zero, the variables are from the -system variables +\fISystem\f[] \fIVariables\f[] name space, otherwise they are from the -peer variables +\fIPeer\f[] \fIVariables\f[] name space. The \f\*[I-Font]assocID\f[] @@ -633,7 +633,7 @@ or to the ntpd host's file \f\*[I-Font]filename\f[]. This command will be rejected by the server unless -saveconfigdir +.Lk miscopt.html#saveconfigdir "saveconfigdir" appears in the \f\*[B-Font]ntpd\f[] configuration file. @@ -653,9 +653,9 @@ Write the specified variables. If the \f\*[I-Font]assocID\f[] is zero, the variables are from the -system variables +\fISystem\f[] \fIVariables\f[] name space, otherwise they are from the -peer variables +\fIPeer\f[] \fIVariables\f[] name space. The \f\*[I-Font]assocID\f[] @@ -679,12 +679,16 @@ and \f\*[B-Font]as\f[] commands both in hexadecimal and decoded short tip strings. The codes, tips and short explanations are on the -Event Messages and Status Words page. +.Lk decode.html "Event Messages and Status Words" +page. The page also includes a list of system and peer messages, the code for the latest of which is included in the status word. +.sp \n(Ppu +.ne 2 + Information resulting from protocol machine state transitions is displayed using an informal set of ASCII strings called -kiss codes. +.Lk decode.html#kiss "kiss codes" . The original purpose was for kiss-o'-death (KoD) packets sent by the server to advise the client of an unusual condition. They are now displayed, when appropriate, @@ -701,8 +705,7 @@ Description .ns .TP 10 .NOP \f\*[B-Font]status\f[] - -system status word +.Lk decode.html#sys "system status word" .br .ns .TP 10 @@ -768,7 +771,7 @@ date and time of day .TP 10 .NOP \f\*[B-Font]refid\f[] reference ID or -kiss code +.Lk decode.html#kiss "kiss code" .br .ns .TP 10 @@ -818,6 +821,9 @@ NTP seconds when the NIST leapseconds file expires The jitter and wander statistics are exponentially-weighted RMS averages. The system jitter is defined in the NTPv4 specification; the clock jitter statistic is computed by the clock discipline module. +.sp \n(Ppu +.ne 2 + When the NTPv4 daemon is compiled with the OpenSSL software library, additional system variables are displayed, including some or all of the following, @@ -883,7 +889,7 @@ association ID .ns .TP 10 .NOP \f\*[B-Font]status\f[] -peer status word +.Lk decode.html#peer "peer status word" .br .ns .TP 10 @@ -934,7 +940,7 @@ total root dispersion to the primary reference clock .TP 10 .NOP \f\*[B-Font]refid\f[] reference ID or -kiss code +.Lk decode.html#kiss "kiss code" .br .ns .TP 10 @@ -975,12 +981,12 @@ peer poll exponent (log2 s) (3-17) .TP 10 .NOP \f\*[B-Font]headway\f[] headway (see -Rate Management and the Kiss-o'-Death Packet ) +.Lk rate.html "Rate Management and the Kiss-o'-Death Packet" ) .br .ns .TP 10 .NOP \f\*[B-Font]flash\f[] -flash status word +.Lk decode.html#flash "flash status word" .br .ns .TP 10 @@ -1016,7 +1022,7 @@ unicast/broadcast bias .TP 10 .NOP \f\*[B-Font]xleave\f[] interleave delay (see -NTP Interleaved Modes ) +.Lk xleave.html "NTP Interleaved Modes" ) .PP The \f\*[B-Font]bias\f[] @@ -1028,6 +1034,9 @@ The variable appears only for the interleaved symmetric and interleaved modes. It represents the internal queuing, buffering and transmission delays for the preceding packet. +.sp \n(Ppu +.ne 2 + When the NTPv4 daemon is compiled with the OpenSSL software library, additional peer variables are displayed, including the following: .TP 10 @@ -1086,7 +1095,7 @@ association ID .ns .TP 10 .NOP \f\*[B-Font]status\f[] -clock status word +.Lk decode.html#clock "clock status word" .br .ns .TP 10 @@ -1251,35 +1260,6 @@ 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. -.TH ntpq @NTPQ_MS@ "19 Jul 2014" "4.2.7p453" "User Commands" -.\" -.\" EDIT THIS FILE WITH CAUTION (/tmp/.ag-psaWPR/ag-BsaWOR) -.\" -.\" It has been AutoGen-ed July 19, 2014 at 09:31:47 AM by AutoGen 5.18.3pre18 -.\" From the definitions ntpq-opts.def -.\" and the template file agman-cmd.tpl -.SH NAME -\f\*[B-Font]ntpq\fP ntpq -\- standard NTP query program -cvt_prog='/usr/local/gnu/share/autogen/texi2man' -cvt_prog=`cd \`dirname "$cvt_prog"\` >/dev/null && pwd - `/`basename "$cvt_prog"` -cd $tmp_dir -test \-x "$cvt_prog" || die "'$cvt_prog' is not executable" -{ - list='synopsis description options option-presets' - for f in $list ; do cat $f ; echo ; done - rm \-f $list name - list='implementation-notes environment files examples exit-status errors - compatibility see-also conforming-to history authors copyright bugs - notes' - for f in $list ; do cat $f ; echo ; done > .end-doc - rm \-f $list - list=`ls \-1 *`' .end-doc' - for f in $list ; do cat $f ; echo ; done - rm \-f $list -} 1>.doc 2>/dev/null -/opt/csw/bin/ggrep \-E \-v '^[ ]*$' .doc | $cvt_prog .SH "ENVIRONMENT" See \fBOPTION PRESETS\fP for configuration environment variables. .SH "FILES" diff --git a/ntpq/ntpq.mdoc.in b/ntpq/ntpq.mdoc.in index 7e1941768..17c0d5a12 100644 --- a/ntpq/ntpq.mdoc.in +++ b/ntpq/ntpq.mdoc.in @@ -1,9 +1,9 @@ -.Dd July 19 2014 +.Dd July 20 2014 .Dt NTPQ @NTPQ_MS@ User Commands .Os .\" EDIT THIS FILE WITH CAUTION (ntpq-opts.mdoc) .\" -.\" It has been AutoGen-ed July 19, 2014 at 09:31:53 AM by AutoGen 5.18.3pre18 +.\" It has been AutoGen-ed July 20, 2014 at 09:28:49 AM by AutoGen 5.18.4pre9 .\" From the definitions ntpq-opts.def .\" and the template file agmdoc-cmd.tpl .Sh NAME @@ -236,9 +236,6 @@ There appear to be no servers left which demand version 1. With no argument, displays the current NTP version that will be used when communicating with servers. -.It Ic quit -Exit -.Nm .It Ic passwd This command prompts you to type in a password (which will not be echoed) which will be used to authenticate configuration @@ -246,6 +243,9 @@ requests. The password must correspond to the key configured for use by the NTP server for this purpose if such requests are to be successful. +.It Ic quit +Exit +.Nm .It Ic raw Causes all output from query commands is printed as received from the remote server. @@ -284,7 +284,7 @@ Display a list of mobilized associations in the form: .It Li status Ta peer status word .It Li conf Ta Li yes : persistent, Li no : ephemeral .It Li reach Ta Li yes : reachable, Li no : unreachable -.It Li auth Ta Li ok , Liyes , Li bad and Li none +.It Li auth Ta Li ok , Li yes , Li bad and Li none .It Li condition Ta selection status (see the Li select field of the peer status word) .It Li last_event Ta event report (see the Li event field of the peer status word) .It Li cnt Ta event count (see the Li count field of the peer status word) @@ -292,9 +292,9 @@ Display a list of mobilized associations in the form: .It Cm clockvar Ar assocID Oo Ar name Oo Cm = Ar value Op ... Oc Oc Op ... .It Cm cv Ar assocID Oo Ar name Oo Cm = Ar value Op ... Oc Oc Op ... Display a list of clock variables for those associations supporting a reference clock. -.It Li :config Op ... +.It Cm :config Op ... Send the remainder of the command line, including whitespace, to the server as a run\-time configuration command in the same format as a line in the configuration file. This command is experimental until further notice and clarification. Authentication is of course required. -.It Li config\-from\-file Ar filename +.It Cm config\-from\-file Ar filename Send the each line of .Ar filename to the server as run\-time configuration commands in the same format as a line in the configuration file. This command is experimental until further notice and clarification. Authentication is required. @@ -393,7 +393,7 @@ Perform the same function as the except that it uses previously stored data rather than making a new query. .It Ic peers Display a list of peers in the form: -.Ic [tally]remote refid st t when pool reach delay offset jitter +.Dl [tally]remote refid st t when pool reach delay offset jitter .Bl -tag -width "something" -compact -offset indent .It Variable Description @@ -401,12 +401,12 @@ Description single\-character code indicating current value of the .Ic select field of the -peer status word +.Lk decode.html#peer "peer status word" .It Ic remote host name (or IP number) of peer .It Ic refid association ID or -kiss code +.Lk decode.html#kiss "'kiss code" .It Ic st stratum .It Ic t @@ -443,9 +443,9 @@ Display the specified variables. If .Ar assocID is zero, the variables are from the -system variables +.Sx System Variables name space, otherwise they are from the -peer variables +.Sx Peer Variables name space. The .Ar assocID @@ -474,7 +474,7 @@ or to the ntpd host's file .Ar filename . This command will be rejected by the server unless -saveconfigdir +.Lk miscopt.html#saveconfigdir "saveconfigdir" appears in the .Ic ntpd configuration file. @@ -491,9 +491,9 @@ Write the specified variables. If the .Ar assocID is zero, the variables are from the -system variables +.Sx System Variables name space, otherwise they are from the -peer variables +.Sx Peer Variables name space. The .Ar assocID @@ -503,7 +503,7 @@ Display operational summary. .It Ic sysstats Print statistics counters maintained in the protocol module. .El -.SS Status Words and Kiss Codes +.Ss Status Words and Kiss Codes The current state of the operating program is shown in a set of status words maintained by the system and each association separately. These words are displayed in the .Ic rv @@ -511,12 +511,14 @@ and .Ic as commands both in hexadecimal and decoded short tip strings. The codes, tips and short explanations are on the -Event Messages and Status Words page. +.Lk decode.html "Event Messages and Status Words" +page. The page also includes a list of system and peer messages, the code for the latest of which is included in the status word. +.Pp Information resulting from protocol machine state transitions is displayed using an informal set of ASCII strings called -kiss codes. +.Lk decode.html#kiss "kiss codes" . The original purpose was for kiss\-o'\-death (KoD) packets sent by the server to advise the client of an unusual condition. They are now displayed, when appropriate, @@ -530,8 +532,7 @@ Not all variables are displayed in some configurations. .It Variable Description .It Ic status - -system status word +.Lk decode.html#sys "system status word" .It Ic version NTP software version and build time .It Ic processor @@ -558,7 +559,7 @@ minimum time constant (log2 s) (3\-10) date and time of day .It Ic refid reference ID or -kiss code +.Lk decode.html#kiss "kiss code" .It Ic reftime reference time .It Ic offset @@ -581,6 +582,7 @@ NTP seconds when the NIST leapseconds file expires The jitter and wander statistics are exponentially\-weighted RMS averages. The system jitter is defined in the NTPv4 specification; the clock jitter statistic is computed by the clock discipline module. +.Pp When the NTPv4 daemon is compiled with the OpenSSL software library, additional system variables are displayed, including some or all of the following, @@ -616,7 +618,7 @@ Description .It Ic associd association ID .It Ic status -peer status word +.Lk decode.html#peer "peer status word" .It Ic srcadr source (remote) IP address .It Ic srcport @@ -637,7 +639,7 @@ total roundtrip delay to the primary reference clock total root dispersion to the primary reference clock .It Ic refid reference ID or -kiss code +.Lk decode.html#kiss "kiss code" .It Ic reftime reference time .It Ic reach @@ -654,9 +656,9 @@ host poll exponent (log2 s) (3\-17) peer poll exponent (log2 s) (3\-17) .It Ic headway headway (see -Rate Management and the Kiss\-o'\-Death Packet ) +.Lk rate.html "Rate Management and the Kiss\-o'\-Death Packet" ) .It Ic flash -flash status word +.Lk decode.html#flash "flash status word" .It Ic offset filter offset .It Ic delay @@ -671,7 +673,7 @@ Autokey group name for this association unicast/broadcast bias .It Ic xleave interleave delay (see -NTP Interleaved Modes ) +.Lk xleave.html "NTP Interleaved Modes" ) .El The .Ic bias @@ -683,6 +685,7 @@ The variable appears only for the interleaved symmetric and interleaved modes. It represents the internal queuing, buffering and transmission delays for the preceding packet. +.Pp When the NTPv4 daemon is compiled with the OpenSSL software library, additional peer variables are displayed, including the following: .Bl -tag -width "something" -compact -offset indent @@ -714,7 +717,7 @@ Description .It Ic associd association ID .It Ic status -clock status word +.Lk decode.html#clock "clock status word" .It Ic device device description .It Ic timecode @@ -833,25 +836,6 @@ 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. -cvt_prog='/usr/local/gnu/share/autogen/texi2mdoc' -cvt_prog=`cd \`dirname "$cvt_prog"\` >/dev/null && pwd - `/`basename "$cvt_prog"` -cd $tmp_dir -test \-x "$cvt_prog" || die "'$cvt_prog' is not executable" -{ - list='synopsis description options option\-presets' - for f in $list ; do cat $f ; echo ; done - rm \-f $list name - list='implementation\-notes environment files examples exit\-status errors - compatibility see\-also conforming\-to history authors copyright bugs - notes' - for f in $list ; do cat $f ; echo ; done > .end\-doc - rm \-f $list - list=`ls \-1 *`' .end\-doc' - for f in $list ; do cat $f ; echo ; done - rm \-f $list -} 1>.doc 2>/dev/null -/opt/csw/bin/ggrep \-E \-v '^[ ]*$' .doc | $cvt_prog .Sh "ENVIRONMENT" See \fBOPTION PRESETS\fP for configuration environment variables. .Sh "FILES" diff --git a/ntpsnmpd/ntpsnmpd-opts.c b/ntpsnmpd/ntpsnmpd-opts.c index a72c55ce9..eb5c52149 100644 --- a/ntpsnmpd/ntpsnmpd-opts.c +++ b/ntpsnmpd/ntpsnmpd-opts.c @@ -1,11 +1,11 @@ /* * EDIT THIS FILE WITH CAUTION (ntpsnmpd-opts.c) * - * It has been AutoGen-ed July 19, 2014 at 09:31:55 AM by AutoGen 5.18.3pre18 + * It has been AutoGen-ed July 20, 2014 at 08:20:39 AM by AutoGen 5.18.4pre9 * From the definitions ntpsnmpd-opts.def * and the template file options * - * Generated from AutoOpts 40:2:15 templates. + * Generated from AutoOpts 41:0:16 templates. * * AutoOpts is a copyrighted work. This source file is not encumbered * by AutoOpts licensing, but is provided under the licensing terms chosen diff --git a/ntpsnmpd/ntpsnmpd-opts.h b/ntpsnmpd/ntpsnmpd-opts.h index 3e5b99928..e03894ab8 100644 --- a/ntpsnmpd/ntpsnmpd-opts.h +++ b/ntpsnmpd/ntpsnmpd-opts.h @@ -1,11 +1,11 @@ /* * EDIT THIS FILE WITH CAUTION (ntpsnmpd-opts.h) * - * It has been AutoGen-ed July 19, 2014 at 09:31:55 AM by AutoGen 5.18.3pre18 + * It has been AutoGen-ed July 20, 2014 at 08:20:38 AM by AutoGen 5.18.4pre9 * From the definitions ntpsnmpd-opts.def * and the template file options * - * Generated from AutoOpts 40:2:15 templates. + * Generated from AutoOpts 41:0:16 templates. * * AutoOpts is a copyrighted work. This header file is not encumbered * by AutoOpts licensing, but is provided under the licensing terms chosen @@ -53,7 +53,7 @@ * tolerable version is at least as old as what was current when the header * template was released. */ -#define AO_TEMPLATE_VERSION 163842 +#define AO_TEMPLATE_VERSION 167936 #if (AO_TEMPLATE_VERSION < OPTIONS_MINIMUM_VERSION) \ || (AO_TEMPLATE_VERSION > OPTIONS_STRUCT_VERSION) # error option template version mismatches autoopts/options.h header @@ -156,15 +156,15 @@ typedef enum { #define VALUE_OPT_NOFORK 'n' #define VALUE_OPT_SYSLOG 'p' #define VALUE_OPT_AGENTXSOCKET 0x1001 -/** option flag (value) for " (get "val-name") " option */ +/** option flag (value) for help-value option */ #define VALUE_OPT_HELP '?' -/** option flag (value) for " (get "val-name") " option */ +/** option flag (value) for more-help-value option */ #define VALUE_OPT_MORE_HELP '!' -/** option flag (value) for " (get "val-name") " option */ +/** option flag (value) for version-value option */ #define VALUE_OPT_VERSION 0x1002 -/** option flag (value) for " (get "val-name") " option */ +/** option flag (value) for save-opts-value option */ #define VALUE_OPT_SAVE_OPTS '>' -/** option flag (value) for " (get "val-name") " option */ +/** option flag (value) for load-opts-value option */ #define VALUE_OPT_LOAD_OPTS '<' #define SET_OPT_SAVE_OPTS(a) STMTS( \ DESC(SAVE_OPTS).fOptState &= OPTST_PERSISTENT_MASK; \ @@ -201,11 +201,11 @@ extern tOptions ntpsnmpdOptions; # include # endif -# ifndef __attribute__ -# define __attribute__(_a) +# ifndef ATTRIBUTE_FORMAT_ARG +# define ATTRIBUTE_FORMAT_ARG(_a) # endif -static inline char* aoGetsText(char const* pz) __attribute__ ((format_arg(1))); +static inline char* aoGetsText(char const* pz) ATTRIBUTE_FORMAT_ARG(1); static inline char* aoGetsText(char const* pz) { if (pz == NULL) return NULL; return (char*)gettext(pz); diff --git a/scripts/calc_tickadj/calc_tickadj-opts b/scripts/calc_tickadj/calc_tickadj-opts index 69aa4395c..f23907c90 100644 --- a/scripts/calc_tickadj/calc_tickadj-opts +++ b/scripts/calc_tickadj/calc_tickadj-opts @@ -1,7 +1,8 @@ - -# DO NOT EDIT THE FOLLOWING +# EDIT THIS FILE WITH CAUTION (calc_tickadj-opts) # -# It's auto generated option handling code +# It has been AutoGen-ed July 20, 2014 at 08:20:40 AM by AutoGen 5.18.4pre9 +# From the definitions calc_tickadj-opts.def +# and the template file perlopt use Getopt::Long qw(GetOptionsFromArray); Getopt::Long::Configure(qw(no_auto_abbrev no_ignore_case_always)); @@ -38,13 +39,13 @@ sub processOptions { 'help|?', 'more-help')); $usage = <<'USAGE'; -calc_tickadj - Calculates "optimal" value for tick given ntp drift file. - Ver. 4.2.7p435 +calc_tickadj - Calculates "optimal" value for tick given ntp drift file. - Ver. 4.2.7p453 USAGE: calc_tickadj [ - [] | --[{=| }] ]... -d, --drift-file=str Ntp drift file to use -t, --tick=num Tick value of this host -?, --help Display usage information and exit - , --more-help Pass the extended usage information through a pager + --more-help Pass the extended usage information through a pager Options are specified by doubled hyphens and their name or by a single hyphen and the flag character. @@ -57,4 +58,3 @@ USAGE } END { close STDOUT }; - diff --git a/scripts/calc_tickadj/calc_tickadj.html b/scripts/calc_tickadj/calc_tickadj.html index c777e2125..3690616bb 100644 --- a/scripts/calc_tickadj/calc_tickadj.html +++ b/scripts/calc_tickadj/calc_tickadj.html @@ -3,7 +3,7 @@ calc_tickadj User's Manual - + @@ -14,18 +14,20 @@ pre.smallformat { font-family:inherit; font-size:smaller } pre.smallexample { font-size:smaller } pre.smalllisp { font-size:smaller } - span.sc { font-variant:small-caps } - span.roman { font-family: serif; font-weight: normal; } + span.sc { font-variant:small-caps } + span.roman { font-family:serif; font-weight:normal; } + span.sansserif { font-family:sans-serif; font-weight:normal; } -->

calc_tickadj User's Manual

+


-Next: , +Next: , Previous: (dir), Up: (dir) -
+

calc_tickadj User's Manual

@@ -46,10 +48,12 @@ This document applies to version 4.2.7p453 of calc_tickadj.
+ +


-Previous: calc_tickadj Description, +Previous: calc_tickadj Description, Up: Top -
+

Invoking calc_tickadj

@@ -82,49 +86,53 @@ current tick manually on command line. using the agtexi-cmd template and the option descriptions for the calc_tickadj program. -

calc_tickadj help/usage (--help)

+

calc_tickadj help/usage (--help)

This is the automatically generated usage text for calc_tickadj.

The text printed is the same whether selected with the help option -(--help) or the more-help option (--more-help). more-help will print +(--help) or the more-help option (--more-help). more-help will print the usage text by passing it through a pager program. more-help is disabled on platforms without a working fork(2) function. The PAGER environment variable is -used to select the program, defaulting to more. Both will exit +used to select the program, defaulting to more. Both will exit with a status code of 0. -

calc_tickadj - Calculates "optimal" value for tick given ntp drift file. - Ver. 4.2.7p435
+
calc_tickadj - Calculates "optimal" value for tick given ntp drift file. - Ver. 4.2.7p453
 USAGE: calc_tickadj [ -<flag> [<val>] | --<name>[{=| }<val>] ]...
 
     -d, --drift-file=str         Ntp drift file to use
     -t, --tick=num               Tick value of this host
     -?, --help                   Display usage information and exit
-      , --more-help              Pass the extended usage information through a pager
+        --more-help              Pass the extended usage information through a pager
 
 Options are specified by doubled hyphens and their name or by a single
 hyphen and the flag character.
 

drift-file option (-d)

@@ -134,11 +142,13 @@ This is the “ntp drift file to use” option. This option takes a string argument. Use the specified drift file for calculations

tick option (-t)

@@ -148,18 +158,20 @@ This is the “tick value of this host” option. This option takes a number argument. The current tick which to adjustment will be calculated
+ +


-Previous: calc_tickadj tick, +Previous: calc_tickadj tick, Up: calc_tickadj Invocation -
+

calc_tickadj exit status

One of the following exit values will be returned:

-
0 (EXIT_SUCCESS)
Successful program execution. -
1 (EXIT_FAILURE)
The operation failed or the command syntax was not valid. +
0 (EXIT_SUCCESS)
Successful program execution. +
1 (EXIT_FAILURE)
The operation failed or the command syntax was not valid.
diff --git a/scripts/calc_tickadj/invoke-calc_tickadj.texi b/scripts/calc_tickadj/invoke-calc_tickadj.texi index cd074bebb..1904eaa62 100644 --- a/scripts/calc_tickadj/invoke-calc_tickadj.texi +++ b/scripts/calc_tickadj/invoke-calc_tickadj.texi @@ -6,7 +6,7 @@ # # EDIT THIS FILE WITH CAUTION (invoke-calc_tickadj.texi) # -# It has been AutoGen-ed July 19, 2014 at 09:26:05 AM by AutoGen 5.18.3pre18 +# It has been AutoGen-ed July 20, 2014 at 08:27:19 AM by AutoGen 5.18.4pre9 # From the definitions calc_tickadj-opts.def # and the template file agtexi-cmd.tpl @end ignore @@ -63,13 +63,13 @@ with a status code of 0. @exampleindent 0 @example -calc_tickadj - Calculates "optimal" value for tick given ntp drift file. - Ver. 4.2.7p435 +calc_tickadj - Calculates "optimal" value for tick given ntp drift file. - Ver. 4.2.7p453 USAGE: calc_tickadj [ - [] | --[@{=| @}] ]... -d, --drift-file=str Ntp drift file to use -t, --tick=num Tick value of this host -?, --help Display usage information and exit - , --more-help Pass the extended usage information through a pager + --more-help Pass the extended usage information through a pager Options are specified by doubled hyphens and their name or by a single hyphen and the flag character. diff --git a/scripts/invoke-plot_summary.texi b/scripts/invoke-plot_summary.texi index c8694fc1a..cdd399ce0 100644 --- a/scripts/invoke-plot_summary.texi +++ b/scripts/invoke-plot_summary.texi @@ -6,7 +6,7 @@ # # EDIT THIS FILE WITH CAUTION (invoke-plot_summary.texi) # -# It has been AutoGen-ed July 19, 2014 at 09:26:30 AM by AutoGen 5.18.3pre18 +# It has been AutoGen-ed July 20, 2014 at 08:27:33 AM by AutoGen 5.18.4pre9 # From the definitions plot_summary-opts.def # and the template file agtexi-cmd.tpl @end ignore @@ -41,19 +41,19 @@ with a status code of 0. @exampleindent 0 @example -plot_summary - plot statistics generated by summary script - Ver. 4.2.7p435 +plot_summary - plot statistics generated by summary script - Ver. 4.2.7p453 USAGE: plot_summary [ - [] | --[@{=| @}] ]... - , --directory=str Where the summary files are - , --identifier=str Origin of the data - , --offset-limit=float Limit of absolute offset - , --peer=str Peers to generate plots for + --directory=str Where the summary files are + --identifier=str Origin of the data + --offset-limit=float Limit of absolute offset + --peer=str Peers to generate plots for - may appear multiple times - , --plot-term=str Gnuplot terminal - , --output-file=str Output file - , --dont-wait Don't wait for keystroke between plots + --plot-term=str Gnuplot terminal + --output-file=str Output file + --dont-wait Don't wait for keystroke between plots -?, --help Display usage information and exit - , --more-help Pass the extended usage information through a pager + --more-help Pass the extended usage information through a pager Options are specified by doubled hyphens and their name or by a single hyphen and the flag character. diff --git a/scripts/invoke-summary.texi b/scripts/invoke-summary.texi index 87fe92dab..e525b70c8 100644 --- a/scripts/invoke-summary.texi +++ b/scripts/invoke-summary.texi @@ -6,7 +6,7 @@ # # EDIT THIS FILE WITH CAUTION (invoke-summary.texi) # -# It has been AutoGen-ed July 19, 2014 at 09:26:35 AM by AutoGen 5.18.3pre18 +# It has been AutoGen-ed July 20, 2014 at 08:27:35 AM by AutoGen 5.18.4pre9 # From the definitions summary-opts.def # and the template file agtexi-cmd.tpl @end ignore @@ -42,17 +42,17 @@ with a status code of 0. @exampleindent 0 @example -summary - compute various stastics from NTP stat files - Ver. 4.2.7p435 +summary - compute various stastics from NTP stat files - Ver. 4.2.7p453 USAGE: summary [ - [] | --[@{=| @}] ]... - , --directory=str Directory containing stat files - , --end-date=num End date - , --output-directory=str Output directory - , --peer-dist-limit=float Peer dist limit - , --skip-time-steps=float Ignore time offsets larger that this - , --start-date=num Start date + --directory=str Directory containing stat files + --end-date=num End date + --output-directory=str Output directory + --peer-dist-limit=float Peer dist limit + --skip-time-steps=float Ignore time offsets larger that this + --start-date=num Start date -?, --help Display usage information and exit - , --more-help Pass the extended usage information through a pager + --more-help Pass the extended usage information through a pager Options are specified by doubled hyphens and their name or by a single hyphen and the flag character. diff --git a/scripts/ntp-wait/ntp-wait-opts b/scripts/ntp-wait/ntp-wait-opts index fc0559477..75089e0e9 100644 --- a/scripts/ntp-wait/ntp-wait-opts +++ b/scripts/ntp-wait/ntp-wait-opts @@ -1,7 +1,8 @@ - -# DO NOT EDIT THE FOLLOWING +# EDIT THIS FILE WITH CAUTION (ntp-wait-opts) # -# It's auto generated option handling code +# It has been AutoGen-ed July 3, 2014 at 09:22:03 AM by AutoGen 5.18.4pre8 +# From the definitions ntp-wait-opts.def +# and the template file perlopt use Getopt::Long qw(GetOptionsFromArray); Getopt::Long::Configure(qw(no_auto_abbrev no_ignore_case_always)); @@ -39,14 +40,14 @@ sub processOptions { 'help|?', 'more-help')); $usage = <<'USAGE'; -ntp-wait - Wait for ntpd to stabilize the system clock - Ver. 4.2.7p411 +ntp-wait - Wait for ntpd to stabilize the system clock - Ver. 4.2.7p446 USAGE: ntp-wait [ - [] | --[{=| }] ]... -n, --tries=num Number of times to check ntpd -s, --sleep=num How long to sleep between tries -v, --verbose Be verbose -?, --help Display usage information and exit - , --more-help Pass the extended usage information through a pager + --more-help Pass the extended usage information through a pager Options are specified by doubled hyphens and their name or by a single hyphen and the flag character. @@ -59,4 +60,3 @@ USAGE } END { close STDOUT }; - diff --git a/scripts/ntpsweep/invoke-ntpsweep.texi b/scripts/ntpsweep/invoke-ntpsweep.texi index 8313b6579..ccaf788b0 100644 --- a/scripts/ntpsweep/invoke-ntpsweep.texi +++ b/scripts/ntpsweep/invoke-ntpsweep.texi @@ -6,7 +6,7 @@ # # EDIT THIS FILE WITH CAUTION (invoke-ntpsweep.texi) # -# It has been AutoGen-ed July 19, 2014 at 09:26:14 AM by AutoGen 5.18.3pre18 +# It has been AutoGen-ed July 20, 2014 at 08:27:25 AM by AutoGen 5.18.4pre9 # From the definitions ntpsweep-opts.def # and the template file agtexi-cmd.tpl @end ignore @@ -45,7 +45,7 @@ with a status code of 0. @exampleindent 0 @example -ntpsweep - Print various informations about given ntp servers - Ver. 4.2.7p435 +ntpsweep - Print various informations about given ntp servers - Ver. 4.2.7p453 USAGE: ntpsweep [ - [] | --[@{=| @}] ]... [hostfile] -l, --host-list=str Host to execute actions on @@ -54,7 +54,7 @@ USAGE: ntpsweep [ - [] | --[@{=| @}] ]... [hostfile] -m, --maxlevel=num Traverse peers up to this level (4 is a reasonable number) -s, --strip=str Strip this string from hostnames -?, --help Display usage information and exit - , --more-help Pass the extended usage information through a pager + --more-help Pass the extended usage information through a pager Options are specified by doubled hyphens and their name or by a single hyphen and the flag character. diff --git a/scripts/ntpsweep/ntpsweep-opts b/scripts/ntpsweep/ntpsweep-opts index 91e9d9e32..fae87c7c6 100644 --- a/scripts/ntpsweep/ntpsweep-opts +++ b/scripts/ntpsweep/ntpsweep-opts @@ -1,7 +1,8 @@ - -# DO NOT EDIT THE FOLLOWING +# EDIT THIS FILE WITH CAUTION (ntpsweep-opts) # -# It's auto generated option handling code +# It has been AutoGen-ed July 20, 2014 at 08:20:40 AM by AutoGen 5.18.4pre9 +# From the definitions ntpsweep-opts.def +# and the template file perlopt use Getopt::Long qw(GetOptionsFromArray); Getopt::Long::Configure(qw(no_auto_abbrev no_ignore_case_always)); @@ -42,7 +43,7 @@ sub processOptions { 'help|?', 'more-help')); $usage = <<'USAGE'; -ntpsweep - Print various informations about given ntp servers - Ver. 4.2.7p435 +ntpsweep - Print various informations about given ntp servers - Ver. 4.2.7p453 USAGE: ntpsweep [ - [] | --[{=| }] ]... [hostfile] -l, --host-list=str Host to execute actions on @@ -51,7 +52,7 @@ USAGE: ntpsweep [ - [] | --[{=| }] ]... [hostfile] -m, --maxlevel=num Traverse peers up to this level (4 is a reasonable number) -s, --strip=str Strip this string from hostnames -?, --help Display usage information and exit - , --more-help Pass the extended usage information through a pager + --more-help Pass the extended usage information through a pager Options are specified by doubled hyphens and their name or by a single hyphen and the flag character. @@ -59,14 +60,8 @@ USAGE usage(0) if $opts->{'help'}; paged_usage(0) if $opts->{'more-help'}; - - if ($argument && $argument =~ /^[^\[]/ && !@$args) { - print STDERR "Not enough arguments supplied (See --help/-?)\n"; - exit 1; - } $_[0] = $opts; return $ret; } END { close STDOUT }; - diff --git a/scripts/ntpsweep/ntpsweep.html b/scripts/ntpsweep/ntpsweep.html index 8d192faa6..c0e0cbb88 100644 --- a/scripts/ntpsweep/ntpsweep.html +++ b/scripts/ntpsweep/ntpsweep.html @@ -3,7 +3,7 @@ ntpsweep User's Manual - + @@ -14,18 +14,20 @@ pre.smallformat { font-family:inherit; font-size:smaller } pre.smallexample { font-size:smaller } pre.smalllisp { font-size:smaller } - span.sc { font-variant:small-caps } - span.roman { font-family: serif; font-weight: normal; } + span.sc { font-variant:small-caps } + span.roman { font-family:serif; font-weight:normal; } + span.sansserif { font-family:sans-serif; font-weight:normal; } -->

ntpsweep User's Manual

+


-Next: , +Next: , Previous: (dir), Up: (dir) -
+

This document describes the use of the NTP Project's ntpsweep program. @@ -44,9 +46,10 @@ Up: (dir)

-


-
+


+ +

0.1 Invoking ntpsweep

@@ -61,7 +64,7 @@ all peers. using the agtexi-cmd template and the option descriptions for the ntpsweep program. -

0.1.1 ntpsweep help/usage (--help)

+

0.1.1 ntpsweep help/usage (--help)

This is the automatically generated usage text for ntpsweep.

The text printed is the same whether selected with the help option -(--help) or the more-help option (--more-help). more-help will print +(--help) or the more-help option (--more-help). more-help will print the usage text by passing it through a pager program. more-help is disabled on platforms without a working fork(2) function. The PAGER environment variable is -used to select the program, defaulting to more. Both will exit +used to select the program, defaulting to more. Both will exit with a status code of 0. -

ntpsweep - Print various informations about given ntp servers - Ver. 4.2.7p435
+
ntpsweep - Print various informations about given ntp servers - Ver. 4.2.7p453
 USAGE: ntpsweep [ -<flag> [<val>] | --<name>[{=| }<val>] ]... [hostfile]
 
     -l, --host-list=str          Host to execute actions on
@@ -99,17 +103,19 @@ USAGE: ntpsweep [ -<flag> [<val>] | --<name>[{=| }<val>]
     -m, --maxlevel=num           Traverse peers up to this level (4 is a reasonable number)
     -s, --strip=str              Strip this string from hostnames
     -?, --help                   Display usage information and exit
-      , --more-help              Pass the extended usage information through a pager
+        --more-help              Pass the extended usage information through a pager
 
 Options are specified by doubled hyphens and their name or by a single
 hyphen and the flag character.
 
+ +


-Next: , +Next: , Previous: ntpsweep usage, Up: ntpsweep Invocation -
+

0.1.2 host-list option (-l)

@@ -126,24 +132,26 @@ This option takes a string argument.

Use this option to specify the host on which this script operates. May appear multiple times.

0.1.3 peers option (-p)

This is the “recursively list all peers a host synchronizes to” option. -This option has no doc documentation. +This option has no ‘doc’ documentation.

+


-Next: , +Next: , Previous: ntpsweep peers, Up: ntpsweep Invocation -
+

0.1.4 maxlevel option (-m)

@@ -151,13 +159,14 @@ Up: ntpsweep Invocati

This is the “traverse peers up to this level (4 is a reasonable number)” option. This option takes a number argument. -This option has no doc documentation. +This option has no ‘doc’ documentation.

+


-Next: , +Next: , Previous: ntpsweep maxlevel, Up: ntpsweep Invocation -
+

0.1.5 strip option (-s)

@@ -165,13 +174,14 @@ Up: ntpsweep Invocati

This is the “strip this string from hostnames” option. This option takes a string argument. -This option has no doc documentation. +This option has no ‘doc’ documentation.

0.1.6 host option (-h)

@@ -179,22 +189,23 @@ Up: ntpsweep Invocati

This is the “specify a single host” option. This option takes a string argument. -This option has no doc documentation. +This option has no ‘doc’ documentation.

NOTE: THIS OPTION IS DEPRECATED

+


-Previous: ntpsweep host, +Previous: ntpsweep host, Up: ntpsweep Invocation -
+

0.1.7 ntpsweep exit status

One of the following exit values will be returned:

-
0 (EXIT_SUCCESS)
Successful program execution. -
1 (EXIT_FAILURE)
The operation failed or the command syntax was not valid. +
0 (EXIT_SUCCESS)
Successful program execution. +
1 (EXIT_FAILURE)
The operation failed or the command syntax was not valid.
diff --git a/scripts/ntptrace/invoke-ntptrace.texi b/scripts/ntptrace/invoke-ntptrace.texi index 701237db6..b5202673d 100644 --- a/scripts/ntptrace/invoke-ntptrace.texi +++ b/scripts/ntptrace/invoke-ntptrace.texi @@ -6,7 +6,7 @@ # # EDIT THIS FILE WITH CAUTION (invoke-ntptrace.texi) # -# It has been AutoGen-ed July 19, 2014 at 09:26:26 AM by AutoGen 5.18.3pre18 +# It has been AutoGen-ed July 20, 2014 at 08:27:31 AM by AutoGen 5.18.4pre9 # From the definitions ntptrace-opts.def # and the template file agtexi-cmd.tpl @end ignore @@ -62,14 +62,14 @@ with a status code of 0. @exampleindent 0 @example -ntptrace - Trace peers of an NTP server - Ver. 4.2.7p435 +ntptrace - Trace peers of an NTP server - Ver. 4.2.7p453 USAGE: ntptrace [ - [] | --[@{=| @}] ]... [host] -n, --numeric Print IP addresses instead of hostnames -m, --max-hosts=num Maximum number of peers to trace -r, --host=str Single remote host -?, --help Display usage information and exit - , --more-help Pass the extended usage information through a pager + --more-help Pass the extended usage information through a pager Options are specified by doubled hyphens and their name or by a single hyphen and the flag character. diff --git a/scripts/ntptrace/ntptrace-opts b/scripts/ntptrace/ntptrace-opts index 19aaf0999..702f4dd40 100644 --- a/scripts/ntptrace/ntptrace-opts +++ b/scripts/ntptrace/ntptrace-opts @@ -1,7 +1,8 @@ - -# DO NOT EDIT THE FOLLOWING +# EDIT THIS FILE WITH CAUTION (ntptrace-opts) # -# It's auto generated option handling code +# It has been AutoGen-ed July 20, 2014 at 08:20:40 AM by AutoGen 5.18.4pre9 +# From the definitions ntptrace-opts.def +# and the template file perlopt use Getopt::Long qw(GetOptionsFromArray); Getopt::Long::Configure(qw(no_auto_abbrev no_ignore_case_always)); @@ -39,14 +40,14 @@ sub processOptions { 'help|?', 'more-help')); $usage = <<'USAGE'; -ntptrace - Trace peers of an NTP server - Ver. 4.2.7p435 +ntptrace - Trace peers of an NTP server - Ver. 4.2.7p453 USAGE: ntptrace [ - [] | --[{=| }] ]... [host] -n, --numeric Print IP addresses instead of hostnames -m, --max-hosts=num Maximum number of peers to trace -r, --host=str Single remote host -?, --help Display usage information and exit - , --more-help Pass the extended usage information through a pager + --more-help Pass the extended usage information through a pager Options are specified by doubled hyphens and their name or by a single hyphen and the flag character. @@ -54,14 +55,8 @@ USAGE usage(0) if $opts->{'help'}; paged_usage(0) if $opts->{'more-help'}; - - if ($argument && $argument =~ /^[^\[]/ && !@$args) { - print STDERR "Not enough arguments supplied (See --help/-?)\n"; - exit 1; - } $_[0] = $opts; return $ret; } END { close STDOUT }; - diff --git a/scripts/ntptrace/ntptrace.html b/scripts/ntptrace/ntptrace.html index ae8d06290..1a6ac47ff 100644 --- a/scripts/ntptrace/ntptrace.html +++ b/scripts/ntptrace/ntptrace.html @@ -3,7 +3,7 @@ Ntptrace User's Manual - + @@ -14,18 +14,20 @@ pre.smallformat { font-family:inherit; font-size:smaller } pre.smallexample { font-size:smaller } pre.smalllisp { font-size:smaller } - span.sc { font-variant:small-caps } - span.roman { font-family: serif; font-weight: normal; } + span.sc { font-variant:small-caps } + span.roman { font-family:serif; font-weight:normal; } + span.sansserif { font-family:sans-serif; font-weight:normal; } -->

Ntptrace User's Manual

+


-Next: , +Next: , Previous: (dir), Up: (dir) -
+

Simple Network Time Protocol User Manual

@@ -46,10 +48,11 @@ This document applies to version 4.2.7p453 of ntptrace.
+


-Previous: ntptrace Description, +Previous: ntptrace Description, Up: Top -
+

Invoking ntptrace

@@ -80,7 +83,7 @@ defined in RFC-1305. using the agtexi-cmd template and the option descriptions for the ntptrace program. -

ntptrace help/usage (--help)

+

ntptrace help/usage (--help)

This is the automatically generated usage text for ntptrace.

The text printed is the same whether selected with the help option -(--help) or the more-help option (--more-help). more-help will print +(--help) or the more-help option (--more-help). more-help will print the usage text by passing it through a pager program. more-help is disabled on platforms without a working fork(2) function. The PAGER environment variable is -used to select the program, defaulting to more. Both will exit +used to select the program, defaulting to more. Both will exit with a status code of 0. -

ntptrace - Trace peers of an NTP server - Ver. 4.2.7p435
+
ntptrace - Trace peers of an NTP server - Ver. 4.2.7p453
 USAGE: ntptrace [ -<flag> [<val>] | --<name>[{=| }<val>] ]... [host]
 
     -n, --numeric                Print IP addresses instead of hostnames
     -m, --max-hosts=num          Maximum number of peers to trace
     -r, --host=str               Single remote host
     -?, --help                   Display usage information and exit
-      , --more-help              Pass the extended usage information through a pager
+        --more-help              Pass the extended usage information through a pager
 
 Options are specified by doubled hyphens and their name or by a single
 hyphen and the flag character.
 
+


-Next: , +Next: , Previous: ntptrace usage, Up: ntptrace Invocation -
+

numeric option (-n)

@@ -134,11 +139,13 @@ This is the “print ip addresses instead of hostnames” option. Output hosts as dotted-quad numeric format rather than converting to the canonical host names.
+ +


-Next: , +Next: , Previous: ntptrace numeric, Up: ntptrace Invocation -
+

max-hosts option (-m)

@@ -146,13 +153,14 @@ Up: ntptrace Invocati

This is the “maximum number of peers to trace” option. This option takes a number argument. -This option has no doc documentation. +This option has no ‘doc’ documentation.

host option (-r)

@@ -160,20 +168,21 @@ Up: ntptrace Invocati

This is the “single remote host” option. This option takes a string argument. -This option has no doc documentation. +This option has no ‘doc’ documentation.

+


-Previous: ntptrace host, +Previous: ntptrace host, Up: ntptrace Invocation -
+

ntptrace exit status

One of the following exit values will be returned:

-
0 (EXIT_SUCCESS)
Successful program execution. -
1 (EXIT_FAILURE)
The operation failed or the command syntax was not valid. +
0 (EXIT_SUCCESS)
Successful program execution. +
1 (EXIT_FAILURE)
The operation failed or the command syntax was not valid.
diff --git a/scripts/plot_summary-opts b/scripts/plot_summary-opts index e82cdf958..2556b02a0 100644 --- a/scripts/plot_summary-opts +++ b/scripts/plot_summary-opts @@ -1,7 +1,8 @@ - -# DO NOT EDIT THE FOLLOWING +# EDIT THIS FILE WITH CAUTION (plot_summary-opts) # -# It's auto generated option handling code +# It has been AutoGen-ed July 20, 2014 at 08:20:40 AM by AutoGen 5.18.4pre9 +# From the definitions plot_summary-opts.def +# and the template file perlopt use Getopt::Long qw(GetOptionsFromArray); Getopt::Long::Configure(qw(no_auto_abbrev no_ignore_case_always)); @@ -45,19 +46,19 @@ sub processOptions { 'help|?', 'more-help')); $usage = <<'USAGE'; -plot_summary - plot statistics generated by summary script - Ver. 4.2.7p435 +plot_summary - plot statistics generated by summary script - Ver. 4.2.7p453 USAGE: plot_summary [ - [] | --[{=| }] ]... - , --directory=str Where the summary files are - , --identifier=str Origin of the data - , --offset-limit=float Limit of absolute offset - , --peer=str Peers to generate plots for + --directory=str Where the summary files are + --identifier=str Origin of the data + --offset-limit=float Limit of absolute offset + --peer=str Peers to generate plots for - may appear multiple times - , --plot-term=str Gnuplot terminal - , --output-file=str Output file - , --dont-wait Don't wait for keystroke between plots + --plot-term=str Gnuplot terminal + --output-file=str Output file + --dont-wait Don't wait for keystroke between plots -?, --help Display usage information and exit - , --more-help Pass the extended usage information through a pager + --more-help Pass the extended usage information through a pager Options are specified by doubled hyphens and their name or by a single hyphen and the flag character. @@ -70,4 +71,3 @@ USAGE } END { close STDOUT }; - diff --git a/scripts/plot_summary.html b/scripts/plot_summary.html index f4290a864..20492b235 100644 --- a/scripts/plot_summary.html +++ b/scripts/plot_summary.html @@ -3,7 +3,7 @@ Plot_summary User's Manual - + @@ -14,18 +14,20 @@ pre.smallformat { font-family:inherit; font-size:smaller } pre.smallexample { font-size:smaller } pre.smalllisp { font-size:smaller } - span.sc { font-variant:small-caps } - span.roman { font-family: serif; font-weight: normal; } + span.sc { font-variant:small-caps } + span.roman { font-family:serif; font-weight:normal; } + span.sansserif { font-family:sans-serif; font-weight:normal; } -->

Plot_summary User's Manual

+


-Next: , +Next: , Previous: (dir), Up: (dir) -
+

Plot_summary User Manual

@@ -46,10 +48,12 @@ This document applies to version 4.2.7p453 of plot_summary.
+ +


-Previous: plot_summary Description, +Previous: plot_summary Description, Up: Top -
+

Invoking plot_summary

@@ -60,7 +64,7 @@ Up: Top using the agtexi-cmd template and the option descriptions for the plot_summary program. -

plot_summary help/usage (--help)

+

plot_summary help/usage (--help)

This is the automatically generated usage text for plot_summary.

The text printed is the same whether selected with the help option -(--help) or the more-help option (--more-help). more-help will print +(--help) or the more-help option (--more-help). more-help will print the usage text by passing it through a pager program. more-help is disabled on platforms without a working fork(2) function. The PAGER environment variable is -used to select the program, defaulting to more. Both will exit +used to select the program, defaulting to more. Both will exit with a status code of 0. -

plot_summary - plot statistics generated by summary script - Ver. 4.2.7p435
+
plot_summary - plot statistics generated by summary script - Ver. 4.2.7p453
 USAGE: plot_summary [ -<flag> [<val>] | --<name>[{=| }<val>] ]...
 
-      , --directory=str          Where the summary files are
-      , --identifier=str         Origin of the data
-      , --offset-limit=float     Limit of absolute offset
-      , --peer=str               Peers to generate plots for
+        --directory=str          Where the summary files are
+        --identifier=str         Origin of the data
+        --offset-limit=float     Limit of absolute offset
+        --peer=str               Peers to generate plots for
                                    - may appear multiple times
-      , --plot-term=str          Gnuplot terminal
-      , --output-file=str        Output file
-      , --dont-wait              Don't wait for keystroke between plots
+        --plot-term=str          Gnuplot terminal
+        --output-file=str        Output file
+        --dont-wait              Don't wait for keystroke between plots
     -?, --help                   Display usage information and exit
-      , --more-help              Pass the extended usage information through a pager
+        --more-help              Pass the extended usage information through a pager
 
 Options are specified by doubled hyphens and their name or by a single
 hyphen and the flag character.
 

directory option

@@ -122,11 +130,13 @@ This option takes a string argument. The directory where the plot_summary will search for the *_summary files generated by summary script.

identifier option

@@ -137,11 +147,13 @@ This option takes a string argument. Where does the plotted data come from, default to string "host" plus current hostname

peer option

@@ -158,11 +170,13 @@ This option takes a string argument.

By default the peer_summary plots are not generated. Use this option to specify list of peers if you want to generate plots for them.

plot-term option

@@ -175,11 +189,13 @@ This option takes a string argument. dumb is it's not'. See output from -e "set terminal") for the list of avalaible options.

output-file option

@@ -189,18 +205,20 @@ This is the “output file” option. This option takes a str argument. Output file for gnuplot, default to stdout.

plot_summary exit status

One of the following exit values will be returned:

-
0 (EXIT_SUCCESS)
Successful program execution. -
1 (EXIT_FAILURE)
The operation failed or the command syntax was not valid. +
0 (EXIT_SUCCESS)
Successful program execution. +
1 (EXIT_FAILURE)
The operation failed or the command syntax was not valid.
diff --git a/scripts/summary-opts b/scripts/summary-opts index 86ca0b6f5..2e7cb8429 100644 --- a/scripts/summary-opts +++ b/scripts/summary-opts @@ -1,7 +1,8 @@ - -# DO NOT EDIT THE FOLLOWING +# EDIT THIS FILE WITH CAUTION (summary-opts) # -# It's auto generated option handling code +# It has been AutoGen-ed July 20, 2014 at 08:20:40 AM by AutoGen 5.18.4pre9 +# From the definitions summary-opts.def +# and the template file perlopt use Getopt::Long qw(GetOptionsFromArray); Getopt::Long::Configure(qw(no_auto_abbrev no_ignore_case_always)); @@ -43,17 +44,17 @@ sub processOptions { 'help|?', 'more-help')); $usage = <<'USAGE'; -summary - compute various stastics from NTP stat files - Ver. 4.2.7p435 +summary - compute various stastics from NTP stat files - Ver. 4.2.7p453 USAGE: summary [ - [] | --[{=| }] ]... - , --directory=str Directory containing stat files - , --end-date=num End date - , --output-directory=str Output directory - , --peer-dist-limit=float Peer dist limit - , --skip-time-steps=float Ignore time offsets larger that this - , --start-date=num Start date + --directory=str Directory containing stat files + --end-date=num End date + --output-directory=str Output directory + --peer-dist-limit=float Peer dist limit + --skip-time-steps=float Ignore time offsets larger that this + --start-date=num Start date -?, --help Display usage information and exit - , --more-help Pass the extended usage information through a pager + --more-help Pass the extended usage information through a pager Options are specified by doubled hyphens and their name or by a single hyphen and the flag character. @@ -66,4 +67,3 @@ USAGE } END { close STDOUT }; - diff --git a/scripts/summary.html b/scripts/summary.html index fd126fdd2..671441f8d 100644 --- a/scripts/summary.html +++ b/scripts/summary.html @@ -3,7 +3,7 @@ Summary User's Manual - + @@ -14,18 +14,20 @@ pre.smallformat { font-family:inherit; font-size:smaller } pre.smallexample { font-size:smaller } pre.smalllisp { font-size:smaller } - span.sc { font-variant:small-caps } - span.roman { font-family: serif; font-weight: normal; } + span.sc { font-variant:small-caps } + span.roman { font-family:serif; font-weight:normal; } + span.sansserif { font-family:sans-serif; font-weight:normal; } -->

Summary User's Manual

+


-Next: , +Next: , Previous: (dir), Up: (dir) -
+

Summary User Manual

@@ -46,10 +48,11 @@ This document applies to version 4.2.7p453 of summary.
+


-Previous: summary Description, +Previous: summary Description, Up: Top -
+

Invoking summary

@@ -60,7 +63,7 @@ Up: Top using the agtexi-cmd template and the option descriptions for the summary program. -

summary help/usage (--help)

+

summary help/usage (--help)

This is the automatically generated usage text for summary.

The text printed is the same whether selected with the help option -(--help) or the more-help option (--more-help). more-help will print +(--help) or the more-help option (--more-help). more-help will print the usage text by passing it through a pager program. more-help is disabled on platforms without a working fork(2) function. The PAGER environment variable is -used to select the program, defaulting to more. Both will exit +used to select the program, defaulting to more. Both will exit with a status code of 0. -

summary - compute various stastics from NTP stat files - Ver. 4.2.7p435
+
summary - compute various stastics from NTP stat files - Ver. 4.2.7p453
 USAGE: summary [ -<flag> [<val>] | --<name>[{=| }<val>] ]...
 
-      , --directory=str          Directory containing stat files
-      , --end-date=num           End date
-      , --output-directory=str   Output directory
-      , --peer-dist-limit=float  Peer dist limit
-      , --skip-time-steps=float  Ignore time offsets larger that this
-      , --start-date=num         Start date
+        --directory=str          Directory containing stat files
+        --end-date=num           End date
+        --output-directory=str   Output directory
+        --peer-dist-limit=float  Peer dist limit
+        --skip-time-steps=float  Ignore time offsets larger that this
+        --start-date=num         Start date
     -?, --help                   Display usage information and exit
-      , --more-help              Pass the extended usage information through a pager
+        --more-help              Pass the extended usage information through a pager
 
 Options are specified by doubled hyphens and their name or by a single
 hyphen and the flag character.
 
+


-Next: , +Next: , Previous: summary usage, Up: summary Invocation -
+

directory option

@@ -119,11 +124,13 @@ This option takes a string argument. The directory where ntpd will search for .stat files generated by ntpd.

end-date option

@@ -135,11 +142,13 @@ This option takes a number argument. option. Defaults to today minus one day (Use date -u +%Y%m%d) to get the timestamp.
+ +


-Next: , +Next: , Previous: summary end-date, Up: summary Invocation -
+

output-directory option

@@ -149,11 +158,13 @@ This is the “output directory” option. This option takes a str argument. The output directory summary will write all output files to.

start-date option

@@ -164,18 +175,19 @@ This option takes a num argument. Process all files with the date suffix more or equal to value of this option. Defaults to 197000101.
+


-Previous: summary start-date, +Previous: summary start-date, Up: summary Invocation -
+

summary exit status

One of the following exit values will be returned:

-
0 (EXIT_SUCCESS)
Successful program execution. -
1 (EXIT_FAILURE)
The operation failed or the command syntax was not valid. +
0 (EXIT_SUCCESS)
Successful program execution. +
1 (EXIT_FAILURE)
The operation failed or the command syntax was not valid.
diff --git a/sntp/sntp-opts.c b/sntp/sntp-opts.c index 1526ca5ea..cf7c41c62 100644 --- a/sntp/sntp-opts.c +++ b/sntp/sntp-opts.c @@ -1,11 +1,11 @@ /* * EDIT THIS FILE WITH CAUTION (sntp-opts.c) * - * It has been AutoGen-ed July 19, 2014 at 09:23:14 AM by AutoGen 5.18.3pre18 + * It has been AutoGen-ed July 20, 2014 at 08:20:41 AM by AutoGen 5.18.4pre9 * From the definitions sntp-opts.def * and the template file options * - * Generated from AutoOpts 40:2:15 templates. + * Generated from AutoOpts 41:0:16 templates. * * AutoOpts is a copyrighted work. This source file is not encumbered * by AutoOpts licensing, but is provided under the licensing terms chosen diff --git a/sntp/sntp-opts.h b/sntp/sntp-opts.h index 8e91b3c92..f867ddacf 100644 --- a/sntp/sntp-opts.h +++ b/sntp/sntp-opts.h @@ -1,11 +1,11 @@ /* * EDIT THIS FILE WITH CAUTION (sntp-opts.h) * - * It has been AutoGen-ed July 19, 2014 at 09:23:14 AM by AutoGen 5.18.3pre18 + * It has been AutoGen-ed July 20, 2014 at 08:20:40 AM by AutoGen 5.18.4pre9 * From the definitions sntp-opts.def * and the template file options * - * Generated from AutoOpts 40:2:15 templates. + * Generated from AutoOpts 41:0:16 templates. * * AutoOpts is a copyrighted work. This header file is not encumbered * by AutoOpts licensing, but is provided under the licensing terms chosen @@ -53,7 +53,7 @@ * tolerable version is at least as old as what was current when the header * template was released. */ -#define AO_TEMPLATE_VERSION 163842 +#define AO_TEMPLATE_VERSION 167936 #if (AO_TEMPLATE_VERSION < OPTIONS_MINIMUM_VERSION) \ || (AO_TEMPLATE_VERSION > OPTIONS_STRUCT_VERSION) # error option template version mismatches autoopts/options.h header @@ -283,15 +283,15 @@ typedef enum { DESC(WAIT).fOptState &= OPTST_PERSISTENT_MASK; \ DESC(WAIT).fOptState |= OPTST_SET | OPTST_DISABLED; \ DESC(WAIT).optArg.argString = NULL ) -/** option flag (value) for " (get "val-name") " option */ +/** option flag (value) for help-value option */ #define VALUE_OPT_HELP '?' -/** option flag (value) for " (get "val-name") " option */ +/** option flag (value) for more-help-value option */ #define VALUE_OPT_MORE_HELP '!' -/** option flag (value) for " (get "val-name") " option */ +/** option flag (value) for version-value option */ #define VALUE_OPT_VERSION 0x1002 -/** option flag (value) for " (get "val-name") " option */ +/** option flag (value) for save-opts-value option */ #define VALUE_OPT_SAVE_OPTS '>' -/** option flag (value) for " (get "val-name") " option */ +/** option flag (value) for load-opts-value option */ #define VALUE_OPT_LOAD_OPTS '<' #define SET_OPT_SAVE_OPTS(a) STMTS( \ DESC(SAVE_OPTS).fOptState &= OPTST_PERSISTENT_MASK; \ @@ -328,11 +328,11 @@ extern tOptions sntpOptions; # include # endif -# ifndef __attribute__ -# define __attribute__(_a) +# ifndef ATTRIBUTE_FORMAT_ARG +# define ATTRIBUTE_FORMAT_ARG(_a) # endif -static inline char* aoGetsText(char const* pz) __attribute__ ((format_arg(1))); +static inline char* aoGetsText(char const* pz) ATTRIBUTE_FORMAT_ARG(1); static inline char* aoGetsText(char const* pz) { if (pz == NULL) return NULL; return (char*)gettext(pz); diff --git a/util/ntp-keygen-opts.c b/util/ntp-keygen-opts.c index 7b66747b7..1b1793ce0 100644 --- a/util/ntp-keygen-opts.c +++ b/util/ntp-keygen-opts.c @@ -1,11 +1,11 @@ /* * EDIT THIS FILE WITH CAUTION (ntp-keygen-opts.c) * - * It has been AutoGen-ed July 19, 2014 at 09:32:14 AM by AutoGen 5.18.3pre18 + * It has been AutoGen-ed July 20, 2014 at 08:20:43 AM by AutoGen 5.18.4pre9 * From the definitions ntp-keygen-opts.def * and the template file options * - * Generated from AutoOpts 40:2:15 templates. + * Generated from AutoOpts 41:0:16 templates. * * AutoOpts is a copyrighted work. This source file is not encumbered * by AutoOpts licensing, but is provided under the licensing terms chosen diff --git a/util/ntp-keygen-opts.h b/util/ntp-keygen-opts.h index da77ce2c4..68e90cb93 100644 --- a/util/ntp-keygen-opts.h +++ b/util/ntp-keygen-opts.h @@ -1,11 +1,11 @@ /* * EDIT THIS FILE WITH CAUTION (ntp-keygen-opts.h) * - * It has been AutoGen-ed July 19, 2014 at 09:32:13 AM by AutoGen 5.18.3pre18 + * It has been AutoGen-ed July 20, 2014 at 08:20:43 AM by AutoGen 5.18.4pre9 * From the definitions ntp-keygen-opts.def * and the template file options * - * Generated from AutoOpts 40:2:15 templates. + * Generated from AutoOpts 41:0:16 templates. * * AutoOpts is a copyrighted work. This header file is not encumbered * by AutoOpts licensing, but is provided under the licensing terms chosen @@ -53,7 +53,7 @@ * tolerable version is at least as old as what was current when the header * template was released. */ -#define AO_TEMPLATE_VERSION 163842 +#define AO_TEMPLATE_VERSION 167936 #if (AO_TEMPLATE_VERSION < OPTIONS_MINIMUM_VERSION) \ || (AO_TEMPLATE_VERSION > OPTIONS_STRUCT_VERSION) # error option template version mismatches autoopts/options.h header @@ -299,15 +299,15 @@ typedef enum { #ifdef AUTOKEY #define OPT_VALUE_MV_KEYS (DESC(MV_KEYS).optArg.argInt) #endif /* AUTOKEY */ -/** option flag (value) for " (get "val-name") " option */ +/** option flag (value) for help-value option */ #define VALUE_OPT_HELP '?' -/** option flag (value) for " (get "val-name") " option */ +/** option flag (value) for more-help-value option */ #define VALUE_OPT_MORE_HELP '!' -/** option flag (value) for " (get "val-name") " option */ +/** option flag (value) for version-value option */ #define VALUE_OPT_VERSION 0x1001 -/** option flag (value) for " (get "val-name") " option */ +/** option flag (value) for save-opts-value option */ #define VALUE_OPT_SAVE_OPTS '>' -/** option flag (value) for " (get "val-name") " option */ +/** option flag (value) for load-opts-value option */ #define VALUE_OPT_LOAD_OPTS '<' #define SET_OPT_SAVE_OPTS(a) STMTS( \ DESC(SAVE_OPTS).fOptState &= OPTST_PERSISTENT_MASK; \ @@ -344,11 +344,11 @@ extern tOptions ntp_keygenOptions; # include # endif -# ifndef __attribute__ -# define __attribute__(_a) +# ifndef ATTRIBUTE_FORMAT_ARG +# define ATTRIBUTE_FORMAT_ARG(_a) # endif -static inline char* aoGetsText(char const* pz) __attribute__ ((format_arg(1))); +static inline char* aoGetsText(char const* pz) ATTRIBUTE_FORMAT_ARG(1); static inline char* aoGetsText(char const* pz) { if (pz == NULL) return NULL; return (char*)gettext(pz);