Option Summary
The following configuration options can be used to control and customize the behavior of movedat. Most options can be specified on either the command line, or in a configuration file. Command line settings will override configuration file settings.
You can view a list of movedat's current options, including where they originated, by enabling level 1 debugging with any network transaction. For example, "movedat -d 1 dataexpedition.com:". Look for the section of output labeled "Configuration settings".
Options with the "Boolean" type take no parameter on the command line, but require a value of 0 or 1 in the configuration file.
Each of the following options causes movedat to perform the given maintenance task and then exit.
| CLI | Value | |
| -A | user[:passwd]@host: | |
| Add a set of authentication credentials to encrypted storage. You must specify a port number using -p if the server is not on port 8080. | ||
| -E | user@host: | |
| Expire and remove a set of authentication credentials from storage. You must specify a port number using -p if the server is not on port 8080. | ||
| -F | wildcard pattern | |
| Find and list all remote matches for the given wildcard pattern. This can be useful for scripting operations, such as shell command completion, or to test a pattern prior to starting a transfer. | ||
| -m | [user[:passwd]@]host:oldpath newpath | |
| Request that a remote file be moved or renamed. | ||
| -n | [user[:passwd]@]host:path | |
| Request that a new folder be created. | ||
| -R | Register an MTP/IP license code then exit. You may provide the license code on the command line or enter it when prompted. | |
| -v | Display version information then exit. | |
| -x | [user[:passwd]@]host:path | |
| Request that a remote file be deleted. | ||
These options set the general run-time behavior of movedat.
| CLI | Config | Value |
| -d | Debug | 0 to 6 |
| Enable diagnostic output. Level 1 is recommended any time you are experiencing difficulties. Levels above 1 will produce copious output and may degrade performance. | ||
| -c | NoCheck | Boolean |
| Do not create download checkpoints or temporary files. You will not be able to resume a download if it is interrupted. | ||
| -C | NoPWCache | Boolean |
| Do not load or save the password cache. If a password is required, you must provide it on the command line or in response to a prompt. | ||
| -D | Display | Boolean |
| Allow remote file contents to be displayed to the terminal when no destination file is given. Otherwise, only directory listings will be displayed to the terminal. See Displaying Files. This option is not necessary when stdout has been redirected to a pipe or file. | ||
| -f | path name | |
| Read the given configuration file instead of searching the default paths. movedat will ignore all configuration files if you specify: –f "" | ||
| -h | Boolean | |
| Recursively transfer an entire directory hierarchy. The source must be a non-empty directory. | ||
| -H | ShowHidden | Boolean |
| By default, files which the operating system considers invisible or hidden will not be shown in directory listings or included in hierarchial transfers. Set this option to treat hidden files like regular files. | ||
| -K | Encrypt | Boolean |
| Require all content to be encrypted. If the server does not support content encryption, an error will be returned. Usernames and passwords are always encrypted, regardless of other settings. | ||
| -O | StartOver | Boolean |
| Start over interrupted downloads or interrupted uploads instead of resuming them. | ||
| -p | Port | UDP Port |
| Specify the UDP port of the server. Use this option if the server is running on a port other than the default 8080. | ||
| -q | Quiet | Boolean |
| Display minimal output and behave as if the terminal is non-interactive. | ||
| -r | Boolean | |
| Automatically resume an interrupted download or interrupted upload, when available. | ||
| -s | ShowLogs | Boolean |
| Show detailed, machine parseable, logs of movedat's actions. | ||
| -t | TryInterval | fail | skip | seconds |
| Set the behavior of the Automatic Retry option. | ||
| -W | Windows domain | |
| Specify a Windows authentication domain. | ||
| -y | Yes | Boolean |
| Avoid interactive queries by choosing a default option to questions about overwriting local files or resuming interrupted transfers. | ||
These options set performance parameters and resource utilization. Server side settings will also influence performance.
| CLI | Config | Value |
| -a | 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. | ||
| -b | StreamSize | kilobytes per second |
| Set the buffer size for piping and compression. Default: 8192 kilobytes. | ||
| -e | Expire | seconds |
| Sets how long movedat should wait without hearing from a server before it gives up and aborts a stalled transaction. Longer values may be useful on highly unreliable networks. Default: 40 seconds. | ||
| -k | MaxRate | kilobytes |
| Set a limit on how fast each transaction can go in kilobytes per second. | ||
| -L | Latency | milliseconds |
| Advise MTP/IP of operation on a path with a high latency (over 500ms). The value should be the minimum observed round trip time of the path, in milliseconds. | ||
| -M | MaxRTT | milliseconds |
| Request that the path latency for each transaction be limited to the given amount of time. Use this option if other applications (such as VoIP or video) require that latency along the path be kept below a specific target. Transfer speed will be reduced any time latency exceeds this value. This could severely degrade performance if other network traffic is causing high latency. Consider Aggression level -3 as an alternative. | ||
| MinRTT | milliseconds | |
| Advise MTP/IP of operation on a path with a high latency (over 500ms). The value should be the minimum observed round trip time of the path, in milliseconds. | ||
| -N | NoiseRatio | 4 to 5000 |
| MTP/IP normally regards packet loss as an indication of network congestion. This option will cause MTP/IP to ignore packet losses up to a rate of one in N, for a given number N. For example, a value of 100 will cause MTP/IP to ignore a loss rate of up to 1%. This option should only be used on noisy data paths where loss is occurring due to external factors such as uncorrected bit errors. Improper use of this option may severely disrupt the network and result in a loss of performance or connectivity, especially when Aggression is elevated.
NoiseRatio is not compatible with servedat 1.11.4 or earlier and will cause the transaction to fail. | ||
| Site | address[/bits] Aggression MaxRate Expire MaxRTT MinRTT | |
| Configure performance for an particular server. Address must be a DNS name, IP address, or subnet. For subnets, use an address followed by a slash and the number of mask bits. The remaining fields are white space separated and correspond to the named configuration variables. A value of 0 implies that the default should be used. You may have multiple Site declarations. | ||
| -S | StopTime | Minutes |
| Limit the total runtime of movedat to this many minutes. Any transactions in progress at this time will be aborted. | ||
| -T | 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. | ||
| -z | Boolean | |
| Enables inline zlib compression. | ||