view release on metacpan or  search on metacpan

README  view on Meta::CPAN

        default entry could be written as:

          <send_menu>
            <menu title="Use Macros">
                <toggle/>
                <accelerator>ALT-p</accelerator>
            </menu>
            <menu title="Remote Hostname">
                <command>%s</command>
                <accelerator>ALT-n</accelerator>
            </menu>
            <menu title="Local Hostname">
                <command>%s</command>
                <accelerator>ALT-l</accelerator>
            </menu>
            <menu title="Username">
                <command>%u</command>
                <accelerator>ALT-u</accelerator>
            </menu>
            <menu title="Test Text">
                <command>echo "ClusterSSH Version: %v%n</command>
            </menu>
          </send_menu>

        Submenus can also be specified as follows:

          <send_menu>
            <menu title="Default Entries">
              <detach>yes</detach>
              <menu title="Hostname">
                  <command>%s</command>
                  <accelerator>ALT-n</accelerator>
              </menu>
            </menu>
          </send_menu>

        Caveats:

        There is currently no strict format checking of this file.
        The format of the file may change in the future
        If the file exists, the default entry (Hostname) is not added

        The following replacement macros are available (note: these can be
        changed in the configuration file):

        %s  Hostname part of the specific connection string to each client,
            minus any username or port

        %u  Username part of the connection string to each client

        %h  Hostname of server where cssh is being run from

        %n  "RETURN" code

        NOTE: requires XML::Simple to be installed

KNOWN BUGS
    If you have any ideas about how to fix the below bugs, please get in
    touch and/or provide a patch.

    *   Swapping virtual desktops can cause a redraw of all the terminal
        windows. This is due to a lack of distinction within Tk between
        switching desktops and minimising/maximising windows. Until Tk can
        tell the difference between the two events, there is no fix (apart
        from rewriting everything directly in X).

TROUBLESHOOTING
    If you have issues running cssh, first try:

    "cssh -e [user@]<hostname>[:port]"

    This performs two tests to confirm cssh is able to work properly with
    the settings provided within the $HOME/.clusterssh/config file (or
    internal defaults).

    1   Test the terminal window works with the options provided

    2   Test ssh works to a host with the configured arguments

    Configuration options to watch for in ssh are:

    *   SSH doesn't understand "-o ConnectTimeout=10" - remove the option
        from the $HOME/.clusterssh/config file

    *   OpenSSH-3.8 using untrusted ssh tunnels - use "-Y" instead of "-X"
        or use "ForwardX11Trusted yes" in $HOME/.ssh/ssh_config (if you
        change the default ssh options from "-x" to "-X")

SUPPORT AND REPORTING BUGS
    A web site for comments, requests, bug reports and bug fixes/patches is
    available at: <https://github.com/duncs/clusterssh>

    If you require support, please run the following commands and create an
    issue via: <https://github.com/duncs/clusterssh/issues>

    "perl -V"

    "perl -MTk -e 'print $Tk::VERSION,$/'"

    "perl -MX11::Protocol -e 'print $X11::Protocol::VERSION,$/'"

    "cat /etc/csshrc $HOME/.clusterssh/config"

    Using the debug option (--debug) will turn on debugging output. Repeat
    the option to increase the amount of debug. However, if possible please
    only use this option with one host at a time, e.g. "cssh --debug <host>"
    due to the amount of output produced (in both main and child windows).

SEE ALSO
    <https://github.com/duncs/clusterssh/wiki/>, "ssh", Tk::overview,
    X11::Protocol, "perl"

AUTHOR
    Duncan Ferguson, "<duncan_j_ferguson at yahoo.co.uk>"

LICENSE AND COPYRIGHT
    Copyright 1999-2018 Duncan Ferguson.

    This program is free software; you can redistribute it and/or modify it
    under the terms of either: the GNU General Public License as published
    by the Free Software Foundation; or the Artistic License.

    See http://dev.perl.org/licenses/ for more information.