Table of Contents

Name

mkethcon - create LINX Ethernet connections.

Synopsis

mkethcon [OPTIONS] <connection>

Description

Create a LINX Ethernet connection to a remote node.

Options

-h, --help
Display help and exit.

Mandatory options

-m, --mac=MAC address
Specify the remote MAC address of the node to connect to, e.g. 0a:1b:2c:3d:4d:5e.

-i, --if=interface
Specify the Ethernet interface to use, e.g. eth0.

Optional options

--window_size=nnn
This is the send/receive window_size, in number of packets on the link, and may need to be modified to adapt LINX to really slow or really fast Ethernet performance.
Both the local and remote side negotiate the window size, being the smallest of the two sizes the selected one. The default 128 messages should be sufficient in most configurations. The window size shall always be of a power of 2. Size 0 means to use the default window size.

--defer_queue_size=nnn
The defer queue size is in packages, with the size depending on the LINX link. The defer queue is used on the sender side when the send queue is full. Every message sent, when the send queue is full, is stored in the defer queue, until the send queue has room for more messages. The defer queue size is the maximum number of packages, with messages, that can be stored in the defer queue before the link is disconnected, due to lack or resources. The default value 2048 packages should be sufficient in most systems. Size 0 means to use the default defer queue size.

--send_tmo=nnn
The send acknowledge timeout specifies the time (in msec) to wait until unacknowledged messages are resent. The default 10 should be sufficient in most systems. Tmo 0 means to use the default timeout.

NOTE: from Linx 2.2, the parameter is hard coded to 100 milliseconds.

--nack_tmo=nnn
The retransmission timeout specifies the time (in msec) to wait until nack messages are resent. The default 20 should be sufficient in most systems. Tmo 0 means to use the default timeout.

NOTE: from Linx 2.2, the parameter is hard coded to 100 milliseconds.

--conn_tmo=nnn
The connect timeout specifies the time (in msec) to wait until an attempt to establish a connection is considered failed. The default 200 should be sufficient in most systems. Tmo 0 means to use the default timeout.

NOTE: from Linx 2.2, the parameter has a new meaning. While connecting, it specifies the time, in milliseconds, to wait until a connection attempt fails and a new attempt is made. Once connected, it is used as a supervision time-out, i.e. every conn_tmo milliseconds, LINX checks if any packets from the peer has been received. LINX disconnects the connection after two consequtive conn_tmo:s without any packets from the peer.

--live_tmo=nnn
The connection supervision timeout specifies the time (in msec) to wait until a connection is considered broken. Default is 100 (when the system is not idle) and should be sufficient in most systems. When the system is idle, the live timeout is ten times larger than the configured live timeout value. Tmo 0 means to use the default timeout.

NOTE: from Linx 2.2, the parameter is not used.

--mtu=nnn
The MTU (Maximum Transmission Unit) specifies the size in bytes of the largets packet that the Ethernet protocol can pass onwards (this excludes the size of the Ethernet header). If not set the MTU is fetched from the interface. Typcially a MTU of 1500 bytes is used for Ethernet.

Files

None.

Diagnostics

None.

Known Bugs

None.

Examples


mkethcon --mac=01:23:a4:4f:b3:ac --if=eth0 ethcon_A
mkethcon -m 01:23:a4:4f:b3:ac -i eth0 ethcon_A

See Also

linx(7) , linxcfg(1) , linxstat(1) , linxdisc(8) , mklink(1) , rmethcon(1)

Author

Enea LINX team

Copyright

Copyright (c) 2006-2007, Enea Software AB All rights reserved.

Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:

Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution. Neither the name of Enea Software AB nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission.

THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

Table of Contents