|
Packit Service |
3880ab |
.TH TIPC-LINK 8 "22 Mar 2019" "iproute2" "Linux"
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.\" For consistency, please keep padding right aligned.
|
|
Packit Service |
3880ab |
.\" For example '.B "foo " bar' and not '.B foo " bar"'
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.SH NAME
|
|
Packit Service |
3880ab |
tipc-link \- show links or modify link properties
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.SH SYNOPSIS
|
|
Packit Service |
3880ab |
.ad l
|
|
Packit Service |
3880ab |
.in +8
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.ti -8
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.ti -8
|
|
Packit Service |
3880ab |
.B tipc link set
|
|
Packit Service |
3880ab |
.br
|
|
Packit Service |
3880ab |
.RB "[ " "{ " "priority "
|
|
Packit Service |
3880ab |
.IR PRIORITY
|
|
Packit Service |
3880ab |
.RB "| " tolerance
|
|
Packit Service |
3880ab |
.IR TOLERANCE
|
|
Packit Service |
3880ab |
.RB "| " window
|
|
Packit Service |
3880ab |
.IR "WINDOW " }
|
|
Packit Service |
3880ab |
.BI "link " LINK " ]"
|
|
Packit Service |
3880ab |
.RB "|"
|
|
Packit Service |
3880ab |
.br
|
|
Packit Service |
3880ab |
.RB "[ "
|
|
Packit Service |
3880ab |
.RB "{ " broadcast " [ "
|
|
Packit Service |
3880ab |
.IR BROADCAST
|
|
Packit Service |
3880ab |
.RB " | "
|
|
Packit Service |
3880ab |
.IR REPLICAST
|
|
Packit Service |
3880ab |
.RB " | "
|
|
Packit Service |
3880ab |
.IR AUTOSELECT
|
|
Packit Service |
3880ab |
.RB "[ " ratio
|
|
Packit Service |
3880ab |
.IR SIZE
|
|
Packit Service |
3880ab |
.RB "] " ] " } " "]"
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.ti -8
|
|
Packit Service |
3880ab |
.B tipc link get
|
|
Packit Service |
3880ab |
.br
|
|
Packit Service |
3880ab |
.RB "[ " "{ " "priority" " | " tolerance " | " window " } " link
|
|
Packit Service |
3880ab |
.IR LINK " ] "
|
|
Packit Service |
3880ab |
.RB "|"
|
|
Packit Service |
3880ab |
.br
|
|
Packit Service |
3880ab |
.RB "[ " { " broadcast " } " ]"
|
|
Packit Service |
3880ab |
.br
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.ti -8
|
|
Packit Service |
3880ab |
.B tipc link statistics
|
|
Packit Service |
3880ab |
.RB "{ " "show " "[ " link
|
|
Packit Service |
3880ab |
.I LINK
|
|
Packit Service |
3880ab |
.RB "] | " "reset
|
|
Packit Service |
3880ab |
.BI "link " "LINK "
|
|
Packit Service |
3880ab |
}
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.ti -8
|
|
Packit Service |
3880ab |
.B tipc link list
|
|
Packit Service |
3880ab |
.br
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.ti -8
|
|
Packit Service |
3880ab |
.B tipc link monitor set
|
|
Packit Service |
3880ab |
.RB "{ " "threshold" " } "
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.ti -8
|
|
Packit Service |
3880ab |
.B tipc link monitor get
|
|
Packit Service |
3880ab |
.RB "{ " "threshold" " } "
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.ti -8
|
|
Packit Service |
3880ab |
.B tipc link monitor summary
|
|
Packit Service |
3880ab |
.br
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.ti -8
|
|
Packit Service |
3880ab |
.B tipc link monitor list
|
|
Packit Service |
3880ab |
.br
|
|
Packit Service |
3880ab |
.RB "[ " "media " " { " eth " | " ib " } " device
|
|
Packit Service |
3880ab |
.IR "DEVICE" " ]"
|
|
Packit Service |
3880ab |
.RB "|"
|
|
Packit Service |
3880ab |
.br
|
|
Packit Service |
3880ab |
.RB "[ " "media udp name"
|
|
Packit Service |
3880ab |
.IR NAME " ]"
|
|
Packit Service |
3880ab |
.br
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.SH OPTIONS
|
|
Packit Service |
3880ab |
Options (flags) that can be passed anywhere in the command chain.
|
|
Packit Service |
3880ab |
.TP
|
|
Packit Service |
3880ab |
.BR "\-h" , " --help"
|
|
Packit Service |
3880ab |
Show help about last valid command. For example
|
|
Packit Service |
3880ab |
.B tipc link --help
|
|
Packit Service |
3880ab |
will show link help and
|
|
Packit Service |
3880ab |
.B tipc --help
|
|
Packit Service |
3880ab |
will show general help. The position of the option in the string is irrelevant.
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.TP
|
|
Packit Service |
3880ab |
.BR "\-j", " \-json"
|
|
Packit Service |
3880ab |
Output results in JavaScript Object Notation (JSON).
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.TP
|
|
Packit Service |
3880ab |
.BR "\-p", " \-pretty"
|
|
Packit Service |
3880ab |
The default JSON format is compact and more efficient to parse but hard for most users to read.
|
|
Packit Service |
3880ab |
This flag adds indentation for readability.
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.SH DESCRIPTION
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.SS Link statistics
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.TP
|
|
Packit Service |
3880ab |
.BR "ACTIVE " "link state"
|
|
Packit Service |
3880ab |
.br
|
|
Packit Service |
3880ab |
An
|
|
Packit Service |
3880ab |
.B ACTIVE
|
|
Packit Service |
3880ab |
link is serving traffic. Two links to the same node can become
|
|
Packit Service |
3880ab |
.B ACTIVE
|
|
Packit Service |
3880ab |
if they have the same link
|
|
Packit Service |
3880ab |
.BR priority .
|
|
Packit Service |
3880ab |
If there is more than two links with the same priority the additional links will
|
|
Packit Service |
3880ab |
be put in
|
|
Packit Service |
3880ab |
.B STANDBY
|
|
Packit Service |
3880ab |
state.
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.TP
|
|
Packit Service |
3880ab |
.BR "STANDBY " "link state"
|
|
Packit Service |
3880ab |
.br
|
|
Packit Service |
3880ab |
A
|
|
Packit Service |
3880ab |
.B STANDBY
|
|
Packit Service |
3880ab |
link has lower link priority than an
|
|
Packit Service |
3880ab |
.B ACTIVE
|
|
Packit Service |
3880ab |
link. A
|
|
Packit Service |
3880ab |
.B STANDBY
|
|
Packit Service |
3880ab |
link has control traffic flowing and is ready to take over should the
|
|
Packit Service |
3880ab |
.B ACTIVE
|
|
Packit Service |
3880ab |
link(s) go down.
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.TP
|
|
Packit Service |
3880ab |
.B MTU
|
|
Packit Service |
3880ab |
.br
|
|
Packit Service |
3880ab |
The Maximum Transmission Unit. The two endpoints advertise their default or
|
|
Packit Service |
3880ab |
configured
|
|
Packit Service |
3880ab |
.B MTU
|
|
Packit Service |
3880ab |
at initial link setup and will agree to use the lower of the two values should
|
|
Packit Service |
3880ab |
they differ.
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.TP
|
|
Packit Service |
3880ab |
.B Packets
|
|
Packit Service |
3880ab |
.br
|
|
Packit Service |
3880ab |
The total amount of transmitted or received TIPC packets on a link. Including
|
|
Packit Service |
3880ab |
.BR "fragmented " "and " "bundled " packets.
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.TP
|
|
Packit Service |
3880ab |
.B Fragments
|
|
Packit Service |
3880ab |
.br
|
|
Packit Service |
3880ab |
Represented in the form
|
|
Packit Service |
3880ab |
.BR fragments / fragmented .
|
|
Packit Service |
3880ab |
Where
|
|
Packit Service |
3880ab |
.B fragmented
|
|
Packit Service |
3880ab |
is the amount of data messages which have been broken into
|
|
Packit Service |
3880ab |
.BR fragments .
|
|
Packit Service |
3880ab |
Subsequently the
|
|
Packit Service |
3880ab |
.B fragments
|
|
Packit Service |
3880ab |
are the total amount of packets that the
|
|
Packit Service |
3880ab |
.B fragmented
|
|
Packit Service |
3880ab |
messages has been broken into.
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.TP
|
|
Packit Service |
3880ab |
.B Bundles
|
|
Packit Service |
3880ab |
.br
|
|
Packit Service |
3880ab |
Represented in the form
|
|
Packit Service |
3880ab |
.BR bundles / bundled .
|
|
Packit Service |
3880ab |
If a link becomes congested the link will attempt to bundle data from small
|
|
Packit Service |
3880ab |
.B bundled
|
|
Packit Service |
3880ab |
packets into
|
|
Packit Service |
3880ab |
.B bundles
|
|
Packit Service |
3880ab |
of full MTU size packets before they are transmitted.
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.TP
|
|
Packit Service |
3880ab |
.B Profile
|
|
Packit Service |
3880ab |
.br
|
|
Packit Service |
3880ab |
Shows the
|
|
Packit Service |
3880ab |
.B average
|
|
Packit Service |
3880ab |
packet size in octets/bytes for a
|
|
Packit Service |
3880ab |
.B sample
|
|
Packit Service |
3880ab |
of packets. It also shows the packet size distribution of the
|
|
Packit Service |
3880ab |
.B sampled
|
|
Packit Service |
3880ab |
packets in the intervals
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
0-64 bytes
|
|
Packit Service |
3880ab |
.br
|
|
Packit Service |
3880ab |
64-256 bytes
|
|
Packit Service |
3880ab |
.br
|
|
Packit Service |
3880ab |
256-1024 bytes
|
|
Packit Service |
3880ab |
.br
|
|
Packit Service |
3880ab |
1024-4096 bytes
|
|
Packit Service |
3880ab |
.br
|
|
Packit Service |
3880ab |
4096-16384 bytes
|
|
Packit Service |
3880ab |
.br
|
|
Packit Service |
3880ab |
16384-32768 bytes
|
|
Packit Service |
3880ab |
.br
|
|
Packit Service |
3880ab |
32768-66000 bytes
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.TP
|
|
Packit Service |
3880ab |
.B Message counters
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.B states
|
|
Packit Service |
3880ab |
- Number of link state messages
|
|
Packit Service |
3880ab |
.sp
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.B probes
|
|
Packit Service |
3880ab |
- Link state messages with probe flag set. Typically sent when a link is idle
|
|
Packit Service |
3880ab |
.sp
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.B nacks
|
|
Packit Service |
3880ab |
- Number of negative acknowledgement (NACK) packets sent and received by the
|
|
Packit Service |
3880ab |
link
|
|
Packit Service |
3880ab |
.sp
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.B defs
|
|
Packit Service |
3880ab |
- Number of packets received out of order
|
|
Packit Service |
3880ab |
.sp
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.B dups
|
|
Packit Service |
3880ab |
- Number of duplicate packets received
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.TP
|
|
Packit Service |
3880ab |
.B Congestion link
|
|
Packit Service |
3880ab |
The number of times an application has tried to send data when the TIPC link
|
|
Packit Service |
3880ab |
was congested
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.TP
|
|
Packit Service |
3880ab |
.B Send queue
|
|
Packit Service |
3880ab |
.B Max
|
|
Packit Service |
3880ab |
is the maximum amount of messages that has resided in the out queue during the
|
|
Packit Service |
3880ab |
statistics collection period of a link.
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.B Avg
|
|
Packit Service |
3880ab |
is the average outqueue size during the lifetime of a link.
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.SS Link properties
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.TP
|
|
Packit Service |
3880ab |
.B priority
|
|
Packit Service |
3880ab |
.br
|
|
Packit Service |
3880ab |
The priority between logical TIPC links to a particular node. Link priority can
|
|
Packit Service |
3880ab |
range from 0 (lowest) to 31 (highest).
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.TP
|
|
Packit Service |
3880ab |
.B tolerance
|
|
Packit Service |
3880ab |
.br
|
|
Packit Service |
3880ab |
Link tolerance specifies the maximum time in milliseconds that TIPC will allow
|
|
Packit Service |
3880ab |
a communication problem to exist before taking the link down. The default value
|
|
Packit Service |
3880ab |
is 1500 milliseconds.
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.TP
|
|
Packit Service |
3880ab |
.B window
|
|
Packit Service |
3880ab |
.br
|
|
Packit Service |
3880ab |
The link window controls how many unacknowledged messages a link endpoint can
|
|
Packit Service |
3880ab |
have in its transmit queue before TIPC's congestion control mechanism is
|
|
Packit Service |
3880ab |
activated.
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.SS Monitor properties
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.TP
|
|
Packit Service |
3880ab |
.B threshold
|
|
Packit Service |
3880ab |
.br
|
|
Packit Service |
3880ab |
The threshold specifies the cluster size exceeding which the link monitoring
|
|
Packit Service |
3880ab |
algorithm will switch from "full-mesh" to "overlapping-ring".
|
|
Packit Service |
3880ab |
If set of 0 the overlapping-ring monitoring is always on and if set to a
|
|
Packit Service |
3880ab |
value larger than anticipated cluster size the overlapping-ring is disabled.
|
|
Packit Service |
3880ab |
The default value is 32.
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.SS Monitor information
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.TP
|
|
Packit Service |
3880ab |
.B table_generation
|
|
Packit Service |
3880ab |
.br
|
|
Packit Service |
3880ab |
Represents the event count in a node's local monitoring list. It steps every
|
|
Packit Service |
3880ab |
time something changes in the local monitor list, including changes in the
|
|
Packit Service |
3880ab |
local domain.
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.TP
|
|
Packit Service |
3880ab |
.B cluster_size
|
|
Packit Service |
3880ab |
.br
|
|
Packit Service |
3880ab |
Represents the current count of cluster members.
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.TP
|
|
Packit Service |
3880ab |
.B algorithm
|
|
Packit Service |
3880ab |
.br
|
|
Packit Service |
3880ab |
The current supervision algorithm used for neighbour monitoring for the bearer.
|
|
Packit Service |
3880ab |
Possible values are full-mesh or overlapping-ring.
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.TP
|
|
Packit Service |
3880ab |
.B status
|
|
Packit Service |
3880ab |
.br
|
|
Packit Service |
3880ab |
The node status derived by the local node.
|
|
Packit Service |
3880ab |
Possible status are up or down.
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.TP
|
|
Packit Service |
3880ab |
.B monitored
|
|
Packit Service |
3880ab |
.br
|
|
Packit Service |
3880ab |
Represent the type of monitoring chosen by the local node.
|
|
Packit Service |
3880ab |
Possible values are direct or indirect.
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.TP
|
|
Packit Service |
3880ab |
.B generation
|
|
Packit Service |
3880ab |
.br
|
|
Packit Service |
3880ab |
Represents the domain generation which is the event count in a node's local
|
|
Packit Service |
3880ab |
domain. Every time something changes (peer add/remove/up/down) the domain
|
|
Packit Service |
3880ab |
generation is stepped and a new version of node record is sent to inform
|
|
Packit Service |
3880ab |
the neighbors about this change. The domain generation helps the receiver
|
|
Packit Service |
3880ab |
of a domain record to know if it should ignore or process the record.
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.TP
|
|
Packit Service |
3880ab |
.B applied_node_status
|
|
Packit Service |
3880ab |
.br
|
|
Packit Service |
3880ab |
The node status reported by the peer node for the succeeding peers in
|
|
Packit Service |
3880ab |
the node list. The Node list is a circular list of ascending addresses
|
|
Packit Service |
3880ab |
starting with the local node.
|
|
Packit Service |
3880ab |
Possible status are: U or D. The status U implies up and D down.
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.TP
|
|
Packit Service |
3880ab |
.B [non_applied_node:status]
|
|
Packit Service |
3880ab |
.br
|
|
Packit Service |
3880ab |
Represents the nodes and their status as reported by the peer node.
|
|
Packit Service |
3880ab |
These nodes were not applied to the monitoring list for this peer node.
|
|
Packit Service |
3880ab |
They are usually transient and occur during the cluster startup phase
|
|
Packit Service |
3880ab |
or network reconfiguration.
|
|
Packit Service |
3880ab |
Possible status are: U or D. The status U implies up and D down.
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.SS Broadcast properties
|
|
Packit Service |
3880ab |
.TP
|
|
Packit Service |
3880ab |
.B BROADCAST
|
|
Packit Service |
3880ab |
.br
|
|
Packit Service |
3880ab |
Forces all multicast traffic to be transmitted via broadcast only,
|
|
Packit Service |
3880ab |
irrespective of cluster size and number of destinations.
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.TP
|
|
Packit Service |
3880ab |
.B REPLICAST
|
|
Packit Service |
3880ab |
.br
|
|
Packit Service |
3880ab |
Forces all multicast traffic to be transmitted via replicast only,
|
|
Packit Service |
3880ab |
irrespective of cluster size and number of destinations.
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.TP
|
|
Packit Service |
3880ab |
.B AUTOSELECT
|
|
Packit Service |
3880ab |
.br
|
|
Packit Service |
3880ab |
Auto switching to broadcast or replicast depending on cluster size and
|
|
Packit Service |
3880ab |
destination node number.
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.TP
|
|
Packit Service |
3880ab |
.B ratio SIZE
|
|
Packit Service |
3880ab |
.br
|
|
Packit Service |
3880ab |
Set the AUTOSELECT criteria, percentage of destination nodes vs cluster
|
|
Packit Service |
3880ab |
size.
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.SH EXAMPLES
|
|
Packit Service |
3880ab |
.PP
|
|
Packit Service |
3880ab |
tipc link monitor list
|
|
Packit Service |
3880ab |
.RS 4
|
|
Packit Service |
3880ab |
Shows the link monitoring information for cluster members on device data0.
|
|
Packit Service |
3880ab |
.RE
|
|
Packit Service |
3880ab |
.PP
|
|
Packit Service |
3880ab |
tipc link monitor summary
|
|
Packit Service |
3880ab |
.RS 4
|
|
Packit Service |
3880ab |
The monitor summary command prints the basic attributes.
|
|
Packit Service |
3880ab |
.RE
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.SH EXIT STATUS
|
|
Packit Service |
3880ab |
Exit status is 0 if command was successful or a positive integer upon failure.
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.SH SEE ALSO
|
|
Packit Service |
3880ab |
.BR tipc (8),
|
|
Packit Service |
3880ab |
.BR tipc-media (8),
|
|
Packit Service |
3880ab |
.BR tipc-bearer (8),
|
|
Packit Service |
3880ab |
.BR tipc-nametable (8),
|
|
Packit Service |
3880ab |
.BR tipc-node (8),
|
|
Packit Service |
3880ab |
.BR tipc-peer (8),
|
|
Packit Service |
3880ab |
.BR tipc-socket (8)
|
|
Packit Service |
3880ab |
.br
|
|
Packit Service |
3880ab |
.SH REPORTING BUGS
|
|
Packit Service |
3880ab |
Report any bugs to the Network Developers mailing list
|
|
Packit Service |
3880ab |
.B <netdev@vger.kernel.org>
|
|
Packit Service |
3880ab |
where the development and maintenance is primarily done.
|
|
Packit Service |
3880ab |
You do not have to be subscribed to the list to send a message there.
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.SH AUTHOR
|
|
Packit Service |
3880ab |
Richard Alpe <richard.alpe@ericsson.com>
|