From 824e4a02740d8b3f618a9dc2eb5e61354c156281 Mon Sep 17 00:00:00 2001 From: Duncan Ferguson Date: Mon, 15 Apr 2013 22:30:32 +0100 Subject: [PATCH] Document external_cluster_command Add in some basic documentation for the new functionality --- bin/cssh | 14 ++++++++++++-- 1 file changed, 12 insertions(+), 2 deletions(-) diff --git a/bin/cssh b/bin/cssh index f12d11f..90ed7e5 100755 --- a/bin/cssh +++ b/bin/cssh @@ -262,8 +262,8 @@ on standard port (e.g not listening on port 22) and ssh_config cannot be used. =item ... -Open a series of xterms defined by within either /etc/clusters or -F<$HOME/.clusterssh/config> (see L). +Open a series of xterms defined by in one of the suplimentary +configuration files (see L). Note: specifying a username on a cluster tag will override any usernames defined in the cluster @@ -437,6 +437,16 @@ Set the initial position of the console - if empty then let the window manager decide. Format is '++', i.e. '+0+0' is top left hand corner of the screen, '+0-70' is bottom left hand side of screen (more or less). +=item external_cluster_command = + +Define the full path to an external command that can be used to resolve tags +to host names. This command can be written in any language. The script must +accept a list of tags to resolve and output a list of hosts on a single line. +Any tags that cannot be resolved should be returned unchanged. + +A non-0 exit code will be counted as an error, a warning will be printed and +output ignored. + =item extra_cluster_file = Define an extra cluster file in the format of F. Multiple