"Fossies" - the Fresh Open Source Software Archive  

Source code changes of the file "doc/ref.txt" between
swaks-20201010.0.tar.gz and swaks-20201014.0.tar.gz

About: Swaks is a featureful, flexible, scriptable, transaction-oriented SMTP test tool.

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

Home  |  About  |  Features  |  All  |  Newest  |  Dox  |  Diffs  |  RSS Feeds  |  Screenshots  |  Comments  |  Imprint  |  Privacy  |  HTTP(S)