Differences
This shows you the differences between the selected revisions of the page.
scriptcommand_option 2016-11-10 | scriptcommand_option 2020-05-29 (current) | ||
Line 1: | Line 1: | ||
- | ====== option ====== | + | ====== option command ====== |
Shows or sets value of script options. | Shows or sets value of script options. | ||
Line 18: | Line 18: | ||
| ''==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. | | | ''==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|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|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 or when directory synchronization does not find any difference. \\ Commands affected: ''[[scriptcommand_get|get]]'', ''[[scriptcommand_put|put]]'', ''[[scriptcommand_rm|rm]]'', ''[[scriptcommand_mv|mv]]'', ''[[scriptcommand_chmod|chmod]]'', ''[[scriptcommand_ls|ls]]'', ''[[scriptcommand_lls|lls]]'', ''[[scriptcommand_ls|ls]]'', ''[[scriptcommand_synchronize|synchronize]]'' \\ Note that the option does not affect ''-filemask'' switch of ''get'' and ''put'' commands. \\ Default: ''off'' | |
Note that resetting the same option overwrites a previous value, it does not append. | Note that resetting the same option overwrites a previous value, it does not append. | ||
Line 41: | Line 41: | ||
| ''confirm'' | .NET assembly is non-interactive, so confirmations are always off. | | | ''confirm'' | .NET assembly is non-interactive, so confirmations are always off. | | ||
| ''reconnecttime'' | Set ''[[library_session#reconnecttime|Session.ReconnectTime]]''. | | | ''reconnecttime'' | Set ''[[library_session#reconnecttime|Session.ReconnectTime]]''. | | ||
- | | ''failonnomatch'' | No explicit mapping. To check if mask matches any file, you have to retrieve directory listing and search the listing for matching files. | | + | | ''failonnomatch'' | No explicit mapping. To check if mask matches any file, you have to retrieve directory listing and search the listing for matching files. For file transfers and synchronization, use a method return value, to check if the method performed any operation. | |