Notice IPv6 address [] notation.

This commit is contained in:
Darko Poljak 2016-11-27 17:02:51 +01:00
parent 6ce6c7830b
commit 835e281c9c
3 changed files with 17 additions and 0 deletions

View file

@ -17,6 +17,11 @@ passing them to cdist with the --remote-exec and/or --remote-copy arguments.
For __remote_exec, the custom implementation must behave as if it where ssh. For __remote_exec, the custom implementation must behave as if it where ssh.
For __remote_copy, it must behave like scp. For __remote_copy, it must behave like scp.
Please notice, custom implementations should work like ssh/scp so __remote_copy
must support IPv6 addresses enclosed in square brackets. For __remote_exec you
must take into account that for some options (like -L) IPv6 addresses can be
specified by enclosed in square brackets (see :strong:`ssh`\ (1) and
:strong:`scp`\ (1)).
With this simple interface the user can take total control of how cdist With this simple interface the user can take total control of how cdist
interacts with the target when required, while the default implementation interacts with the target when required, while the default implementation

View file

@ -251,6 +251,12 @@ script, you can write to stderr:
# Output to be saved by cdist for execution on the target # Output to be saved by cdist for execution on the target
echo "touch /etc/cdist-configured" echo "touch /etc/cdist-configured"
Notice: if you use __remote_copy or __remote_exec directly in your scripts
then for IPv6 address with __remote_copy execution you should enclose IPv6
address in square brackets. The same applies to __remote_exec if it behaves
the same as ssh for some options where colon is a delimiter, as for -L ssh
option (see :strong:`ssh`\ (1) and :strong:`scp`\ (1)).
Variable access from the generated scripts Variable access from the generated scripts
------------------------------------------ ------------------------------------------

View file

@ -157,6 +157,12 @@ cdist/conf
The distribution configuration directory. It contains official types and The distribution configuration directory. It contains official types and
explorers. This path is relative to cdist installation directory. explorers. This path is relative to cdist installation directory.
NOTES
-----
cdist detects if host is specified by IPv6 address. If so then remote_copy
command is executed with host address enclosed in square brackets
(see :strong:`scp`\ (1)).
EXAMPLES EXAMPLES
-------- --------