Signed-off-by: Peter Schneider <pe...@psch.de> --- phc2sys.8 | 103 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++-- 1 file changed, 101 insertions(+), 2 deletions(-)
diff --git a/phc2sys.8 b/phc2sys.8 index 4fc4fa3..fa2dbc9 100644 --- a/phc2sys.8 +++ b/phc2sys.8 @@ -8,10 +8,16 @@ phc2sys \- synchronize two or more clocks .B \-r ] [ .B \-r -] [ options ] +] [ +.BI \-f " config-file" +] [ options ] [ +.I long-options +] .br .B phc2sys [ +.BI \-f " config-file" +] [ .BI \-d " pps-device" ] [ .BI \-s " device" @@ -21,7 +27,11 @@ phc2sys \- synchronize two or more clocks .BI \-O " offset" ] [ .BI \-w -] [ options ] +] [ options ] [ +.I long-options +] +.I .\|.\|. + .SH DESCRIPTION .B phc2sys @@ -226,6 +236,77 @@ Display a help message. .B \-v Prints the software version and exits. +.SH LONG OPTIONS + +Each and every configuration file option (see below in section +.BR FILE\ OPTIONS) +may also appear +as a "long" style command line argument. For example, the transportSpecific +option may be set using either of these two forms: + +.RS +\f(CW\-\-transportSpecific 1 \-\-transportSpecific=1\fP +.RE + +Option values given on the command line override values in the global +section of the configuration file (which, in turn overrides default +values). + +.SH CONFIGURATION FILE + +The configuration file is divided into sections. Each section starts with a +line containing its name enclosed in brackets and it follows with settings. +Each setting is placed on a separate line, it contains the name of the +option and the value separated by whitespace characters. Empty lines and lines +starting with # are ignored. + +The global section (indicated as +.BR [global] ) +sets the program options. This is the only used option. + +.SH FILE OPTIONS + +.TP +.B transportSpecific +The transport specific field. Must be in the range 0 to 255. +The default is 0. + +.TP +There are more options, which SHOULD be working, but these are untested: + +.TP +.B pi_proportional_const +Specifies the proportional constant of the PI controller. + +.TP +.B pi_integral_const +Specifies the integral constant of the PI controller. + +.TP +.B step_threshold +Specifies the step threshold of the servo. It is the maximum offset that +the servo corrects by changing the clock frequency instea of stepping +the clock. The clock is stepped on start regardless of the option if the +offset is larger than 20 microseconds (unless the -F option is used). +It's specified in seconds. The value of 0.0 disables stepping after +the start. The default is 0.0. + +.TP +.B first_step_threshold +Specify the step threshold applied only on the first update. It is the +maximum offset that is corrected by adjusting clock. It's specified in +seconds. The value of 0.0 disables stepping on start. The default is +0.00002 (20 microseconds). + +.TP +.B ntpshm_segment +The number of the SHM segment used by ntpshm servo. The default is 0. + +.TP +.B uds_address +Specifies the address of the server's UNIX domain socket. The default +is /var/run/ptp4 + .SH TIME SCALE USAGE .B Ptp4l @@ -269,6 +350,12 @@ in the domain to its system clock. \f(CWphc2sys \-a \-rr\fP .RE +Same as above, in an IEEE 802.1AS domain. + +.RS +\f(CWphc2sys \-a \-rr --transportSpecific=1\fP +.RE + The host is a domain master, PTP clock is synchronized to system clock and the time offset is obtained from .BR ptp4l . @@ -310,5 +397,17 @@ does not wait. \f(CWphc2sys \-s eth0 \-O \-35\fP .RE +.SH WARNING + +Be cautious when the same configuration file is used for both ptp4l and phc2sys. +Keep in mind, that values specified in the configuration file take precedence +over their default values. If a certain option, which is common to ptp4l and +phc2sys, is specified to a non-default value in the configuration file +(p.e., for ptp4l), then this non-default value applies also for phc2sys. This +might be not what is expected. + +To avoid securely these unexpected behaviour, different configuration files +for ptp4l and phc2sys are recommended. + .SH SEE ALSO .BR ptp4l (8) -- 2.14.3 ------------------------------------------------------------------------------ Check out the vibrant tech community on one of the world's most engaging tech sites, Slashdot.org! http://sdm.link/slashdot _______________________________________________ Linuxptp-devel mailing list Linuxptp-devel@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/linuxptp-devel
