ref.txt (swaks-20201010.0) | : | ref.txt (swaks-20201014.0) | ||
---|---|---|---|---|
skipping to change at line 199 | skipping to change at line 199 | |||
of "STDIN". Multiple options can all specify "STDIN", but the same | of "STDIN". Multiple options can all specify "STDIN", but the same | |||
content will be used for each of them. | content will be used for each of them. | |||
If the initial argument is prefixed with "@", the argument will be | If the initial argument is prefixed with "@", the argument will be | |||
treated as a path to a file. The file will be opened and the | treated as a path to a file. The file will be opened and the | |||
contents will be used as the final argument. If the contents of the | contents will be used as the final argument. If the contents of the | |||
file can't be read, Swaks will exit. To specify a literal value | file can't be read, Swaks will exit. To specify a literal value | |||
starting with an "@", use two "@" symbols. The first will be | starting with an "@", use two "@" symbols. The first will be | |||
stripped. | stripped. | |||
Sensitive | ||||
If an option marked Sensitive attempts to prompt the user for an | ||||
argument and the "--protect-prompt" option is set, Swaks will | ||||
attempt to mask the user input from being echoed on the terminal. | ||||
Swaks tries to mask the input in several ways, but if none of them | ||||
work program flow will continue with unmasked input. | ||||
Deprecated | Deprecated | |||
An option labeled Deprecated has been officially deprecated and will | An option labeled Deprecated has been officially deprecated and will | |||
be removed in a future release. See the "DEPRECATIONS" section of | be removed in a future release. See the "DEPRECATIONS" section of | |||
this documentation for details about the deprecations. | this documentation for details about the deprecations. | |||
The exact mechanism and format for using each of the types is listed | The exact mechanism and format for using each of the types is listed | |||
below. | below. | |||
CONFIGURATION FILES | CONFIGURATION FILES | |||
A configuration file can be used to set commonly-used or abnormally | A configuration file can be used to set commonly-used or abnormally | |||
skipping to change at line 840 | skipping to change at line 847 | |||
provided and cannot be found via .netrc, the user will be prompted | provided and cannot be found via .netrc, the user will be prompted | |||
to provide one. The string "<>" can be supplied to mean an empty | to provide one. The string "<>" can be supplied to mean an empty | |||
username. (Arg-Required, From-Prompt) | username. (Arg-Required, From-Prompt) | |||
-ap, --auth-password [<password>] | -ap, --auth-password [<password>] | |||
Provide the password to be used for authentication. If no password | Provide the password to be used for authentication. If no password | |||
is provided, indicate that Swaks should attempt to find the password | is provided, indicate that Swaks should attempt to find the password | |||
via .netrc (requires the Net::Netrc module). If no password is | via .netrc (requires the Net::Netrc module). If no password is | |||
provided and cannot be found via .netrc, the user will be prompted | provided and cannot be found via .netrc, the user will be prompted | |||
to provide one. The string "<>" can be supplied to mean an empty | to provide one. The string "<>" can be supplied to mean an empty | |||
password. (Arg-Required, From-Prompt) | password. (Arg-Required, From-Prompt, Sensitive) | |||
-ae, --auth-extra <key-value-pair>[,<key-value-pair>[,...]] | -ae, --auth-extra <key-value-pair>[,<key-value-pair>[,...]] | |||
Some of the authentication types allow extra information to be | Some of the authentication types allow extra information to be | |||
included in the authentication process. Rather than add a new option | included in the authentication process. Rather than add a new option | |||
for every nook and cranny of each authenticator, the "--auth-extra" | for every nook and cranny of each authenticator, the "--auth-extra" | |||
option allows this information to be supplied. The format for | option allows this information to be supplied. The format for | |||
<key-value-pair> is KEYWORD=VALUE. (Arg-Required) | <key-value-pair> is KEYWORD=VALUE. (Arg-Required) | |||
The following table lists the currently recognized keywords and the | The following table lists the currently recognized keywords and the | |||
authenticators that use them | authenticators that use them | |||
skipping to change at line 1397 | skipping to change at line 1404 | |||
--output-file-stderr <file-path> | --output-file-stderr <file-path> | |||
These options allow the user to send output to files instead of | These options allow the user to send output to files instead of | |||
"STDOUT"/"STDERR". The first option sends both to the same file. The | "STDOUT"/"STDERR". The first option sends both to the same file. The | |||
arguments of &STDOUT and &STDERR are treated specially, referring to | arguments of &STDOUT and &STDERR are treated specially, referring to | |||
the "normal" file handles, so "--output-file-stderr '&STDOUT'" would | the "normal" file handles, so "--output-file-stderr '&STDOUT'" would | |||
redirect "STDERR" to "STDOUT". These options are honored for all | redirect "STDERR" to "STDOUT". These options are honored for all | |||
output except "--help" and "--version". (Arg-Required) | output except "--help" and "--version". (Arg-Required) | |||
-pp, --protect-prompt | -pp, --protect-prompt | |||
Don't echo user input on prompts that are potentially sensitive | Don't echo user input on prompts that are potentially sensitive | |||
(right now only authentication password). See also | (right now only authentication password). Very specifically, any | |||
"--auth-hide-password". (Arg-None) | option which is marked 'Sensitive' and eventually prompts for an | |||
argument will do its best to mask that argument from being echoed. | ||||
See also "--auth-hide-password". (Arg-None) | ||||
-hr, --hide-receive | -hr, --hide-receive | |||
Don't display lines sent from the remote server being received by | Don't display lines sent from the remote server being received by | |||
Swaks. (Arg-None) | Swaks. (Arg-None) | |||
-hs, --hide-send | -hs, --hide-send | |||
Don't display lines being sent by Swaks to the remote server. | Don't display lines being sent by Swaks to the remote server. | |||
(Arg-None) | (Arg-None) | |||
-hi, --hide-informational | -hi, --hide-informational | |||
End of changes. 3 change blocks. | ||||
3 lines changed or deleted | 12 lines changed or added |