2013-09-30 02:58:17 +08:00
|
|
|
.TH PMC 8 "October 2013" "linuxptp"
|
2012-11-01 18:24:24 +08:00
|
|
|
.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"
|
|
|
|
|
] [
|
2013-09-30 02:58:17 +08:00
|
|
|
.BI \-s " uds-address"
|
|
|
|
|
] [
|
2012-11-01 18:24:24 +08:00
|
|
|
.BI \-t " transport-specific-field"
|
2012-12-10 17:28:28 +08:00
|
|
|
] [
|
|
|
|
|
.B \-v
|
2013-07-22 02:48:20 +08:00
|
|
|
] [
|
|
|
|
|
.B \-z
|
2013-02-06 00:36:06 +08:00
|
|
|
] [ command ] ...
|
2012-11-01 18:24:24 +08:00
|
|
|
|
|
|
|
|
.SH DESCRIPTION
|
|
|
|
|
.B pmc
|
|
|
|
|
is a program which implements a PTP management client according to IEEE
|
2013-02-06 00:36:06 +08:00
|
|
|
standard 1588. The program reads from the standard input or from the command
|
|
|
|
|
line actions specified by name and management ID, sends them over the selected
|
|
|
|
|
transport and prints any received replies. There are three actions supported:
|
2012-11-01 18:24:24 +08:00
|
|
|
.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"
|
2013-02-06 00:36:05 +08:00
|
|
|
Specify the network interface. The default is /var/run/pmc for the Unix Domain
|
2012-11-01 18:24:24 +08:00
|
|
|
Socket transport and eth0 for the other transports.
|
|
|
|
|
.TP
|
2013-09-30 02:58:17 +08:00
|
|
|
.BI \-s " uds-address"
|
|
|
|
|
Specifies the address of the server's UNIX domain socket.
|
|
|
|
|
The default is /var/run/ptp4l.
|
|
|
|
|
.TP
|
2012-11-01 18:24:24 +08:00
|
|
|
.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.
|
2012-12-10 17:28:28 +08:00
|
|
|
.TP
|
|
|
|
|
.B \-v
|
|
|
|
|
Prints the software version and exits.
|
2013-07-22 02:48:20 +08:00
|
|
|
.TP
|
|
|
|
|
.B \-z
|
|
|
|
|
The official interpretation of the 1588 standard mandates sending
|
|
|
|
|
GET actions with valid (but meaningless) TLV values. Therefore the
|
|
|
|
|
pmc program normally sends GET requests with properly formed TLV
|
|
|
|
|
values. This option enables the legacy option of sending zero
|
|
|
|
|
length TLV values instead.
|
2012-11-01 18:24:24 +08:00
|
|
|
|
|
|
|
|
.SH MANAGEMENT IDS
|
|
|
|
|
|
|
|
|
|
.TP
|
|
|
|
|
.B CURRENT_DATA_SET
|
|
|
|
|
.TP
|
|
|
|
|
.B TIME_STATUS_NP
|
|
|
|
|
.TP
|
|
|
|
|
.B NULL_MANAGEMENT
|
|
|
|
|
|
|
|
|
|
.SH SEE ALSO
|
|
|
|
|
.BR ptp4l (8)
|
