Differences
This shows you the differences between the selected revisions of the page.
| 2016-01-22 | 2016-01-22 | ||
| option anchors (martin) | commandline#scripting (martin) | ||
| Line 15: | Line 15: | ||
| ^ Option ^ Values and description ^ | ^ Option ^ Values and description ^ | ||
| | ''==echo=='' | ''%%off|on%%'' \\ Toggles echoing of command being executed. \\ Commands affected: all \\ Default: ''off'' | | | ''==echo=='' | ''%%off|on%%'' \\ Toggles echoing of command being executed. \\ Commands affected: all \\ Default: ''off'' | | ||
| - | | ''==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 a different default answer (such as a default "Reconnect" answer for a reconnect prompt), in what case the default answer is used (after a short time interval). See also a ''reconnecttime'' option below. \\ 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. \\ Enabling batch mode sets reconnect time (''reconnecttime'' option below) to 120 seconds, if it is not set yet. \\ Commands affected: nearly all \\ Default: ''abort'' for commands specified using ''/script'' or ''/command''; ''off'' for commands specified on input. | | + | | ''==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 a different default answer (such as a default "Reconnect" answer for a reconnect prompt), in what case the default answer is used (after a short time interval). See also a ''reconnecttime'' option below. \\ 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. \\ Enabling batch mode sets reconnect time (''reconnecttime'' option below) to 120 seconds, if it is not set yet. \\ Commands affected: nearly all \\ Default: ''abort'' for commands specified using ''[[commandline#scripting|/script]]'' or ''[[commandline#scripting|/command]]''; ''off'' for commands specified on input. | |
| - | | ''confirm'' | ''%%off|on%%'' \\ Toggles confirmations (overwrite, etc.). \\ Commands affected: ''[[scriptcommand_get|get]]'', ''[[scriptcommand_put|put]]'' \\ Default: ''off'' for commands specified using ''/script'' or ''/command''; ''on'' for commands specified on input. | | + | | ''confirm'' | ''%%off|on%%'' \\ Toggles confirmations (overwrite, etc.). \\ Commands affected: ''[[scriptcommand_get|get]]'', ''[[scriptcommand_put|put]]'' \\ Default: ''off'' for commands specified using ''[[commandline#scripting|/script]]'' or ''[[commandline#scripting|/command]]''; ''on'' for commands specified on input. | |
| | ''==reconnecttime=='' | ''%%off | <sec>%%'' \\ Sets time limit in seconds to try reconnecting broken sessions. Value ''off'' removes any time limit. \\ Reconnect time is set implicitly to 120 seconds, when batch mode (''batch'' option above) is enabled. \\ Commands affected: ''[[scriptcommand_get|get]]'', ''[[scriptcommand_put|put]]'', ''[[scriptcommand_synchronize|synchronize]]'', ''[[scriptcommand_keepuptodate|keepuptodate]]'' \\ Default: ''off'' | | | ''==reconnecttime=='' | ''%%off | <sec>%%'' \\ Sets time limit in seconds to try reconnecting broken sessions. Value ''off'' removes any time limit. \\ Reconnect time is set implicitly to 120 seconds, when batch mode (''batch'' option above) is enabled. \\ Commands affected: ''[[scriptcommand_get|get]]'', ''[[scriptcommand_put|put]]'', ''[[scriptcommand_synchronize|synchronize]]'', ''[[scriptcommand_keepuptodate|keepuptodate]]'' \\ Default: ''off'' | | ||
| | ''==failonnomatch=='' | ''%%off|on%%'' \\ Toggles whether commands fail when a [[file_mask|wildcard]] used to select files for an operation matches no files. \\ Commands affected: ''[[scriptcommand_get|get]]'', ''[[scriptcommand_put|put]]'', ''[[scriptcommand_rm|rm]]'', ''[[scriptcommand_mv|mv]]'', ''[[scriptcommand_chmod|chmod]]'', ''[[scriptcommand_ls|ls]]'', ''[[scriptcommand_lls|lls]]'' \\ Note that the option does not affect ''-filemask'' switch of ''get'' and ''put'' commands. \\ Default: ''off'' | | | ''==failonnomatch=='' | ''%%off|on%%'' \\ Toggles whether commands fail when a [[file_mask|wildcard]] used to select files for an operation matches no files. \\ Commands affected: ''[[scriptcommand_get|get]]'', ''[[scriptcommand_put|put]]'', ''[[scriptcommand_rm|rm]]'', ''[[scriptcommand_mv|mv]]'', ''[[scriptcommand_chmod|chmod]]'', ''[[scriptcommand_ls|ls]]'', ''[[scriptcommand_lls|lls]]'' \\ Note that the option does not affect ''-filemask'' switch of ''get'' and ''put'' commands. \\ Default: ''off'' | | ||