This is an old revision of the document!

option

Shows or sets value of script options.

option [ <option> [ <value> ] ]

Advertisement

If no parameters are specified, lists all script options and their values. When one parameter is specified only, shows value of the option. When two parameters are specified sets value of the option. Initial values of some options are taken from application configuration, however modifying the options does not change the application configuration.

Options are:

Option Values and description
echo off|on
Toggles echoing of command being executed.
Commands affected: all
batch off|on|abort|continue
Enables batch mode. In batch mode, any choice prompt is automatically replied and any input prompt is cancelled (after short time interval).
In batch mode, it is recommended to set confirm to off to allow overwrites.
When batch mode is set to on any choice prompt is automatically replied negatively. Unless the prompt has different default answer (such as default “Reconnect” answer for reconnect prompt), in what case the default answer is used (after short time interval).
Value abort is like on. In addition, the script is aborted, when any script command fails or any choice prompt is replied with “Abort” answer (or similar).
When set to continue any choice prompt is automatically replied with “Skip”, “Ignore” or similar answer.
Commands affected: nearly all
confirm off|on
Toggles confirmations (overwrite, etc.).
Commands affected: get, put
transfer binary|ascii|automatic
Transfer mode: binary, ascii (text), automatic (by extension).
Commands affected: get, put, synchronize, keepuptodate
exclude
include
clear | <mask>[;<mask2>...]
Sets exclusion or inclusion masks (only one can be set at time).
Commands affected: get, put, synchronize, keepuptodate
reconnecttime off | <sec>
Sets time limit in seconds to try reconnecting broken sessions.
Commands affected: get, put, synchronize, keepuptodate

Note that resetting the same option overwrites a previous value, it does not append.

Aliases: ascii (for option transfer ascii), binary (for option transfer binary)

Examples

option transfer
option confirm off
option include "*.html; */"
option exclude "*.tpl.php"
option exclude "*.mp3; *.mp4; *.lnk; *.exe; *.msi; My Pictures; My Music; My Videos;"
option

Advertisement

Last modified: by martin