MTPexpedat Configuration File

On startup, MTPexpedat will attempt to load configuration information a file.  On MacOS X systems, $HOME/.MTPexpedat.cf will be examined.  On Windows, the file %APPDATA%\DEI\MTPexpedat.cf will be read.  Because %APPDATA% may be a hidden directory, an Install-MTPexpedat.cf batch script is provided.  Edit the sample MTPexpedat.cf file first, then run the installer to copy it into place.

A configuration file consists of plain text lines, at most 127 characters long.  Lines beginning with a hash, space, or tab are ignored.  All other lines are of the following format:

<variable>=<value> <variable> <value>

The second form will ignore any leading white space in <value>.  Note that Variable names are NOT case sensitive.  See the enclosed MTPexpedat.cf file for an example configuration file.  Following is a list of variables which may be set.

Aggression <-3 to 5>
Advise MTP/IP as to how aggressive it should be in fully utilizing the network path.  Positive values may increase performance at the expense of third-party traffic.  Negative values may reduce path latency and allow better performance for other traffic, at the cost of reducing performance.  See the Performance section for details.

Debug <level>
Enable diagnostic messages.  Levels above 1 will produce copious output which may not fit in the message box.  See LogFile below.

Encrypt <0 or 1>
If non-zero, then the "Encryption" box will be checked by default after MTPexpedat is launched.

Expire <seconds>
Sets how long MTPexpedat should wait without hearing from the server before it gives up and cancels a stalled transaction.  Longer values may be useful on highly unreliable networks.

Latency <rtt>[:<rate>]
Advise MTP/IP of operation on a path with a high latency (over 500ms).  The first number is the minimum round trip time of the path, in milliseconds.  The second number, if present, advises the expected speed of the link (in kilobytes per second) and activates pipelining mode, which may result in faster throughput files on high-delay links.  This value is different from MaxRate, and should be a conservative (low) estimate.

LogFile <pathname>
Send diagnostic output to a file.  Regular application messages will still be displayed in the message box.  If a full pathname is not given, the file will be written in the same directory as the application binary.

MaxDatagram <bytes>
Limit the size of network datagram payloads to no more than this amount.  The full IP datagram size will be 56 bytes larger when MTP/UDP/IP headers are included.  If your network is known to have problems with IP fragmentation, try setting a value of 1424 or smaller.  Default: none.

MaxRate <kilobytes per second>
Set a limit on how fast each transaction can go.

MaxRTT <milliseconds>
Request that the path latency for each transaction be limited to the given amount of time.  This option may severely degrade performance.

MinRTT <milliseconds>
Advise MTP/IP as to the minimum latency of your network uplink.  See Latency above.

MTPexpedatConfigVersion 1
This version check is used to warn you if an update to MTPexpedat causes a change in configuration file processing.

Packages <Suffix List>
Specifies the order of preference for package requests.  The server will use the first supported type.  Default: tgz,zip,tar

RemotePort <UDP Port Number>
Specify the default UDP port number of the server.  Use this option if many of your servers are running on a port other than the default 8080.

Site <address>[/bits] <Aggression> <MaxRate> <Expire> <MaxRTT> <Latency>
Configure performance for individual peers.  Address must be a name, IP address, or subnet.  For subnets, use an address followed by a slash and the number of mask bits.  Remaining fields are white space separated and correspond to the named variables.  A value of 0 implies that the default should be used.  You may have multiple Site lines, one for each address.  MTPexpedat will attempt to resolve DNS names when it first runs and may refresh them periodically.  If a name cannot be resolved at startup, MTPexpedat may not run.