parent
ebe6a24bd7
commit
2f3b9f718f
|
@ -0,0 +1,56 @@
|
|||
.TH HWSTAMP_CTL 8 "November 2012" "linuxptp"
|
||||
.SH NAME
|
||||
hwstamp_ctl \- set time stamping policy at the driver level
|
||||
|
||||
.SH SYNOPSIS
|
||||
.B hwstamp_ctl
|
||||
.BI \-i " interface"
|
||||
[
|
||||
.BI \-r " rx-filter"
|
||||
] [
|
||||
.BI \-t " tx-type"
|
||||
]
|
||||
|
||||
.SH DESCRIPTION
|
||||
.B hwstamp_ctl
|
||||
is a program used to set the hardware time stamping policy at the network
|
||||
driver level with the
|
||||
.B SIOCSHWTSTAMP
|
||||
.BR ioctl (2).
|
||||
The
|
||||
.I tx-type
|
||||
and
|
||||
.I rx-filter
|
||||
values are hints to the driver what it is expected to do. If the requested
|
||||
fine-grained filtering for incoming packets is not supported, the driver may
|
||||
time stamp more than just the requested types of packets.
|
||||
|
||||
This program is a debugging tool. The
|
||||
.BR ptp4l (8)
|
||||
program does not need this program to function, it will set the policy
|
||||
automatically as appropriate.
|
||||
|
||||
.SH OPTIONS
|
||||
.TP
|
||||
.BI \-i " interface"
|
||||
Specify the network interface of which the policy should be changed.
|
||||
.TP
|
||||
.BI \-r " rx-filter"
|
||||
Specify which types of incoming packets should be time stamped,
|
||||
.I rx-filter
|
||||
is an integer value.
|
||||
.TP
|
||||
.BI \-t " tx-type"
|
||||
Enable or disable hardware time stamping for outgoing packets,
|
||||
.I tx-type
|
||||
is an integer value.
|
||||
.TP
|
||||
.BI \-h
|
||||
Display a help message and list of possible values for
|
||||
.I rx-filter
|
||||
and
|
||||
.IR tx-type .
|
||||
|
||||
.SH SEE ALSO
|
||||
.BR ioctl (2),
|
||||
.BR ptp4l (8)
|
|
@ -0,0 +1,91 @@
|
|||
.TH PHC2SYS 8 "November 2012" "linuxptp"
|
||||
.SH NAME
|
||||
phc2sys \- synchronize two clocks
|
||||
|
||||
.SH SYNOPSIS
|
||||
.B phc2sys
|
||||
{
|
||||
.BI \-d " pps-device"
|
||||
[
|
||||
.BI \-s " phc-device"
|
||||
|
|
||||
.BI \-i " interface"
|
||||
] |
|
||||
.BI \-s " phc-device"
|
||||
|
|
||||
.BI \-i " interface"
|
||||
} [
|
||||
.BI \-c " phc-device"
|
||||
] [
|
||||
.BI \-P " kp"
|
||||
] [
|
||||
.BI \-I " ki"
|
||||
] [
|
||||
.BI \-R " update-rate"
|
||||
] [
|
||||
.BI \-N " clock-readings"
|
||||
]
|
||||
|
||||
.SH DESCRIPTION
|
||||
.B phc2sys
|
||||
is a program which synchronizes two clocks in the system. Typically, it is used
|
||||
to synchronize the system clock to a PTP hardware clock (PHC), which itself is
|
||||
synchronized by the
|
||||
.BR ptp4l (8)
|
||||
program.
|
||||
|
||||
Two synchronization modes are supported, one uses a pulse per second (PPS)
|
||||
signal provided by the source clock and the other mode reads time from the
|
||||
source clock directly. The PPS mode is usually preferred, because reading the
|
||||
PHC is slow and introduces an unknown error in the readings, but not all PHCs
|
||||
provide the PPS signal.
|
||||
|
||||
.SH OPTIONS
|
||||
.TP
|
||||
.BI \-d " pps-device"
|
||||
Specify the PPS device of the master clock (e.g. /dev/pps0). With this option
|
||||
the PPS synchronization mode is used instead of the direct mode. As the PPS
|
||||
signal does not specify time and only marks start of a second, the slave clock
|
||||
should be already close to the correct time before
|
||||
.B phc2sys
|
||||
is started or the
|
||||
.B \-s
|
||||
option should be used too.
|
||||
.TP
|
||||
.BI \-s " phc-device"
|
||||
Specify the device of the master clock (e.g. /dev/ptp0). When this option is
|
||||
used together with the
|
||||
.B \-d
|
||||
option, the master clock is read only on start to fix an offset over 0.5
|
||||
seconds which cannot be fixed with PPS alone.
|
||||
.TP
|
||||
.BI \-i " interface"
|
||||
Similar to the
|
||||
.B \-s
|
||||
option, but specified by the interface which provides the master clock.
|
||||
.TP
|
||||
.BI \-c " phc-device"
|
||||
Specify the device of the slave clock (e.g. /dev/ptp1). The default slave clock
|
||||
is the system clock (CLOCK_REALTIME).
|
||||
.TP
|
||||
.BI \-P " kp"
|
||||
Specify the proportional constant of the PI controller. The default is 0.7.
|
||||
.TP
|
||||
.BI \-I " ki"
|
||||
Specify the integral constant of the PI controller. The default is 0.3.
|
||||
.TP
|
||||
.BI \-R " update-rate"
|
||||
Specify the slave clock update rate when running in the direct synchronization
|
||||
mode. The default is 1 per second.
|
||||
.TP
|
||||
.BI \-N " phc-num"
|
||||
Specify the number of master clock readings per one slave clock update. Only
|
||||
the fastest reading is used to update the slave clock, this is useful to
|
||||
minimize the error caused by random delays in scheduling and bus utilization.
|
||||
The default is 5.
|
||||
.TP
|
||||
.BI \-h
|
||||
Display a help message.
|
||||
|
||||
.SH SEE ALSO
|
||||
.BR ptp4l (8)
|
|
@ -0,0 +1,85 @@
|
|||
.TH PMC 8 "November 2012" "linuxptp"
|
||||
.SH NAME
|
||||
pmc \- PTP management client
|
||||
|
||||
.SH SYNOPSIS
|
||||
.B pmc
|
||||
[
|
||||
.B \-2
|
||||
|
|
||||
.B \-4
|
||||
|
|
||||
.B \-6
|
||||
|
|
||||
.B \-u
|
||||
] [
|
||||
.BI \-b " boundary-hops"
|
||||
] [
|
||||
.BI \-d " domain-number"
|
||||
] [
|
||||
.BI \-i " interface"
|
||||
] [
|
||||
.BI \-t " transport-specific-field"
|
||||
]
|
||||
|
||||
.SH DESCRIPTION
|
||||
.B pmc
|
||||
is a program which implements a PTP management client according to IEEE
|
||||
standard 1588. The program reads from the standard input actions specified by
|
||||
name and management ID, sends them over the selected transport and prints any
|
||||
received replies. There are three actions supported:
|
||||
.B GET
|
||||
retrieves the specified information,
|
||||
.B SET
|
||||
updates the specified information and
|
||||
.B CMD
|
||||
(or
|
||||
.BR COMMAND )
|
||||
initiates the specified event.
|
||||
|
||||
Command
|
||||
.B help
|
||||
can be used to get a list of supported actions and management IDs.
|
||||
|
||||
.SH OPTIONS
|
||||
.TP
|
||||
.B \-2
|
||||
Select the IEEE 802.3 network transport.
|
||||
.TP
|
||||
.B \-4
|
||||
Select the UDP IPv4 network transport. This is the default transport.
|
||||
.TP
|
||||
.B \-6
|
||||
Select the UDP IPv6 network transport.
|
||||
.TP
|
||||
.B \-u
|
||||
Select the Unix Domain Socket transport.
|
||||
.TP
|
||||
.BI \-b " boundary-hops"
|
||||
Specify the boundary hops value in sent messages. The default is 1.
|
||||
.TP
|
||||
.BI \-d " domain-number"
|
||||
Specify the domain number in sent messages. The default is 0.
|
||||
.TP
|
||||
.BI \-i " interface"
|
||||
Specify the network interface. The default is /tmp/pmc for the Unix Domain
|
||||
Socket transport and eth0 for the other transports.
|
||||
.TP
|
||||
.BI \-t " transport-specific-field"
|
||||
Specify the transport specific field in sent messages as a hexadecimal number.
|
||||
The default is 0x0.
|
||||
.TP
|
||||
.B \-h
|
||||
Display a help message.
|
||||
|
||||
.SH MANAGEMENT IDS
|
||||
|
||||
.TP
|
||||
.B CURRENT_DATA_SET
|
||||
.TP
|
||||
.B TIME_STATUS_NP
|
||||
.TP
|
||||
.B NULL_MANAGEMENT
|
||||
|
||||
.SH SEE ALSO
|
||||
.BR ptp4l (8)
|
|
@ -0,0 +1,291 @@
|
|||
.TH PTP4l 8 "November 2012" "linuxptp"
|
||||
.SH NAME
|
||||
ptp4l \- PTP Boundary/Ordinary Clock
|
||||
|
||||
.SH SYNOPSIS
|
||||
.B ptp4l
|
||||
[
|
||||
.B \-A
|
||||
|
|
||||
.B \-E
|
||||
|
|
||||
.B \-P
|
||||
] [
|
||||
.B \-2
|
||||
|
|
||||
.B \-4
|
||||
|
|
||||
.B \-6
|
||||
] [
|
||||
.B \-H
|
||||
|
|
||||
.B \-S
|
||||
|
|
||||
.B \-L
|
||||
] [
|
||||
.BI \-f " config"
|
||||
] [
|
||||
.BI \-p " phc-device"
|
||||
] [
|
||||
.B \-s
|
||||
] [
|
||||
.BI \-l " print-level"
|
||||
] [
|
||||
.B \-q
|
||||
] [
|
||||
.B \-v
|
||||
]
|
||||
[
|
||||
.BI \-i " interface"
|
||||
]
|
||||
.I .\|.\|.
|
||||
|
||||
.SH DESCRIPTION
|
||||
.B ptp4l
|
||||
is an implementation of the Precision Time Protocol (PTP) according to IEEE
|
||||
standard 1588 for Linux. It implements Boundary Clock (BC) and Ordinary Clock
|
||||
(OC).
|
||||
|
||||
.SH OPTIONS
|
||||
.TP
|
||||
.B \-A
|
||||
Select the delay mechanism automatically. Start with E2E and switch to P2P when
|
||||
a peer delay request is received.
|
||||
.TP
|
||||
.B \-E
|
||||
Select the delay request-response (E2E) mechanism. This is the default
|
||||
mechanism.
|
||||
.TP
|
||||
.B \-P
|
||||
Select the peer delay (P2P) mechanism.
|
||||
.TP
|
||||
.B \-2
|
||||
Select the IEEE 802.3 network transport.
|
||||
.TP
|
||||
.B \-4
|
||||
Select the UDP IPv4 network transport. This is the default transport.
|
||||
.TP
|
||||
.B \-6
|
||||
Select the UDP IPv6 network transport.
|
||||
.TP
|
||||
.B \-H
|
||||
Select the hardware time stamping. All ports specified by the
|
||||
.B \-i
|
||||
option and in the configuration file must be attached to the same PTP hardware
|
||||
clock (PHC). This is the default time stamping.
|
||||
.TP
|
||||
.B \-S
|
||||
Select the software time stamping.
|
||||
.TP
|
||||
.B \-L
|
||||
Select the legacy hardware time stamping.
|
||||
.TP
|
||||
.BI \-f " config"
|
||||
Read configuration from the specified file. No configuration file is read by
|
||||
default.
|
||||
.TP
|
||||
.BI \-p " phc-device"
|
||||
With hardware time stamping, force which PHC device (e.g. /dev/ptp0) should be
|
||||
used.
|
||||
.TP
|
||||
.B \-s
|
||||
Enable the slaveOnly mode.
|
||||
.TP
|
||||
.BI \-l " print-level"
|
||||
Set the maximum syslog level of messages which should be printed or sent to
|
||||
the system logger. The default is 6 (LOG_INFO).
|
||||
.TP
|
||||
.B \-q
|
||||
Don't send messages to the system logger.
|
||||
.TP
|
||||
.B \-v
|
||||
Print messages to the standard output.
|
||||
.TP
|
||||
.BI \-i " interface"
|
||||
Specify a PTP port, it may be used multiple times. At least one port must be
|
||||
specified by this option or in the configuration file.
|
||||
.TP
|
||||
.BI \-h
|
||||
Display a help message.
|
||||
|
||||
.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.
|
||||
|
||||
The global section (indicated as
|
||||
.BR [global] )
|
||||
sets the program options, clock options and default port options. Other
|
||||
sections are port specific sections and they override the default port options.
|
||||
The name of the section is the name of the configured port (e.g.
|
||||
.BR [eth0] ).
|
||||
Ports specified in the configuration file don't need to be
|
||||
specified by the
|
||||
.B \-i
|
||||
option. An empty port section can be used to replace the command line option.
|
||||
|
||||
.SH PORT OPTIONS
|
||||
|
||||
.TP
|
||||
.B logAnnounceInterval
|
||||
The mean time interval between Announce messages. A shorter interval makes
|
||||
ptp4l react faster to the changes in the master-slave hierarchy. The interval
|
||||
should be the same in the whole domain. It's specified as a power of two in
|
||||
seconds.
|
||||
The default is 1 (2 seconds).
|
||||
.TP
|
||||
.B logSyncInterval
|
||||
The mean time interval between Sync messages. A shorter interval may improve
|
||||
accuracy of the local clock. It's specified as a power of two in seconds.
|
||||
The default is 0 (1 second).
|
||||
.TP
|
||||
.B logMinDelayReqInterval
|
||||
The minimum permitted mean time interval between Delay_Req messages. A shorter
|
||||
interval makes ptp4l react faster to the changes in the path delay. It's
|
||||
specified as a power of two in seconds.
|
||||
The default is 0 (1 second).
|
||||
.TP
|
||||
.B logMinPdelayReqInterval
|
||||
The minimum permitted mean time interval between Pdelay_Req messages. It's
|
||||
specified as a power of two in seconds.
|
||||
The default is 0 (1 second).
|
||||
.TP
|
||||
.B announceReceiptTimeout
|
||||
The number of missed Announce messages before the last Announce messages
|
||||
expires.
|
||||
The default is 3.
|
||||
.TP
|
||||
.B transportSpecific
|
||||
The transport specific field. Must be in the range 0 to 255.
|
||||
The default is 0.
|
||||
.TP
|
||||
.B path_trace_enabled
|
||||
Enable the mechanism used to trace the route of the Announce messages.
|
||||
The default is 0 (disabled).
|
||||
.TP
|
||||
.B follow_up_info
|
||||
Include the 802.1AS data in the Follow_Up messages if enabled.
|
||||
The default is 0 (disabled).
|
||||
.TP
|
||||
.B delay_mechanism
|
||||
Select the delay mechanism. Possible values are E2E, P2P and Auto.
|
||||
The default is E2E.
|
||||
.TP
|
||||
.B network_transport
|
||||
Select the network transport. Possible values are UDPv4, UDPv6 and L2.
|
||||
The default is UDPv4.
|
||||
|
||||
.SH PROGRAM AND CLOCK OPTIONS
|
||||
|
||||
.TP
|
||||
.B twoStepFlag
|
||||
The local clock is a two-step clock if enabled. One-step clocks are not
|
||||
supported yet.
|
||||
The default is 1 (enabled).
|
||||
.TP
|
||||
.B slaveOnly
|
||||
The local clock is a slave-only clock if enabled.
|
||||
The default is 0 (disabled).
|
||||
.TP
|
||||
.B priority1
|
||||
The priority1 attribute of the local clock. It is used in the best master
|
||||
selection algorithm, lower values take precedence. Must be in the range 0 to
|
||||
255.
|
||||
The default is 128.
|
||||
.TP
|
||||
.B priority2
|
||||
The priority2 attribute of the local clock. It is used in the best master
|
||||
selection algorithm, lower values take precedence. Must be in the range 0 to
|
||||
255.
|
||||
The default is 128.
|
||||
.TP
|
||||
.B clockClass
|
||||
The clockClass attribute of the local clock. It denotes the traceability of the
|
||||
time distributed by the grandmaster clock.
|
||||
The default is 248.
|
||||
.TP
|
||||
.B clockAccuracy
|
||||
The clockAccuracy attribute of the local clock. It is used in the best master
|
||||
selection algorithm.
|
||||
The default is 0xFE.
|
||||
.TP
|
||||
.B offsetScaledLogVariance
|
||||
The offsetScaledLogVariance attribute of the local clock. It characterizes the
|
||||
stability of the clock.
|
||||
The default is 0xFFFF.
|
||||
.TP
|
||||
.B domainNumber
|
||||
The domain attribute of the local clock.
|
||||
The default is 0.
|
||||
.TP
|
||||
.B free_running
|
||||
Don't adjust the local clock if enabled.
|
||||
The default is 0 (disabled).
|
||||
.TP
|
||||
.B freq_est_interval
|
||||
The time interval over which is estimated the ratio of the local and
|
||||
peer clock frequencies. It is specified as a power of two in seconds.
|
||||
The default is 1 (2 seconds).
|
||||
.TP
|
||||
.B assume_two_step
|
||||
Treat one-step responses as two-step if enabled. It is used to work around
|
||||
buggy 802.1AS switches.
|
||||
The default is 0 (disabled).
|
||||
.TP
|
||||
.B tx_timestamp_retries
|
||||
The number of retries to fetch the tx time stamp from the kernel when a message
|
||||
is sent.
|
||||
The default is 2.
|
||||
.TP
|
||||
.B clock_servo
|
||||
The servo which is used to synchronize the local clock. Currently only one
|
||||
servo is implemented, a PI controller.
|
||||
The default is pi.
|
||||
.TP
|
||||
.B pi_proportional_const
|
||||
The proportional constant of the PI controller. When set to 0.0, the value will
|
||||
be selected from 0.7 and 0.1 for the hardware and software time stamping
|
||||
respectively.
|
||||
The default is 0.0.
|
||||
.TP
|
||||
.B pi_integral_const
|
||||
The integral constant of the PI controller. When set to 0.0, the value will be
|
||||
selected from 0.3 and 0.001 for the hardware and software time stamping
|
||||
respectively.
|
||||
The default is 0.0.
|
||||
.TP
|
||||
.B pi_offset_const
|
||||
The maximum offset the PI controller will correct by changing the clock
|
||||
frequency instead of stepping the clock. When set to 0.0, the controller will
|
||||
never step the clock.
|
||||
The default is 0.0.
|
||||
.TP
|
||||
.B ptp_dst_mac
|
||||
The MAC address where should be PTP messages sent.
|
||||
Relevant only with L2 transport. The default is 01:1B:19:00:00:00.
|
||||
.TP
|
||||
.B p2p_dst_mac
|
||||
The MAC address where should be peer delay messages the PTP peer.
|
||||
Relevant only with L2 transport. The default is 01:80:C2:00:00:0E.
|
||||
.TP
|
||||
.B logging_level
|
||||
The maximum logging level of messages which should be printed.
|
||||
The default is 6 (LOG_INFO).
|
||||
.TP
|
||||
.B verbose
|
||||
Print messages to the standard output if enabled.
|
||||
The default is 0 (disabled).
|
||||
.TP
|
||||
.B use_syslog
|
||||
Print messages to the system log if enabled.
|
||||
The default is 1 (enabled).
|
||||
.TP
|
||||
.B time_stamping
|
||||
The time stamping method. The allowed values are hardware, software and legacy.
|
||||
The default is hardware.
|
||||
|
||||
.SH SEE ALSO
|
||||
.BR pmc (8),
|
||||
.BR phc2sys (8)
|
Loading…
Reference in New Issue