view release on metacpan or  search on metacpan

README  view on Meta::CPAN

        Extra cluster files may also be specified either as an option on the
        command line (see "cluster-file") or in the user's
        $HOME/.clusterssh/config file (see "extra_cluster_file"
        configuration option).

        NOTE: the last tag read overwrites any pre-existing tag of that
        name.

        NOTE: there is a special cluster tag called "default" - any tags or
        hosts included within this tag will be automatically opened if
        nothing is specified on the command line.

    /etc/tags, $HOME/.clusterssh/tags
        Very similar to clusters files but the definition is reversed. The
        format is:

        <host> <tag> [...]

        This allows one host to be specified as a member of a number of
        tags. This format can be clearer than using clusters files.

        Extra tag files may be specified either as an option (see
        "tag-file") or within the user's $HOME/.clusterssh/config file (see
        "extra_tag_file" configuration option).

        NOTE: All tags are added together

    /etc/csshrc & $HOME/.clusterssh/config
        This file contains configuration overrides - the defaults are as
        marked. Default options are overwritten first by the global file,
        and then by the user file.

        NOTE: values for entries do not need to be quoted unless it is
        required for passing arguments, e.g.

        "terminal_allow_send_events="-xrm '*.VT100.allowSendEvents:true'""

        should be written as

        "terminal_allow_send_events=-xrm '*.VT100.allowSendEvents:true'"

        auto_close = 5
            Close terminal window after this many seconds. If set to 0 will
            instead wait on input from the user in each window before
            closing. See also --autoclose and --no-autoclose

        auto_quit = 1
            Automatically quit after the last client window closes. Set to 0
            to disable. See also --autoquit

        auto_wm_decoration_offsets = no
            Enable or disable alternative algorithm for calculating terminal
            positioning.

        comms = ssh
            Sets the default communication method (initially taken from the
            name of the program, but can be overridden here).

        console_position = <null>
            Set the initial position of the console - if empty then let the
            window manager decide. Format is '+<x>+<y>', i.e. '+0+0' is top
            left hand corner of the screen, '+0-70' is bottom left hand side
            of screen (more or less).

        external_command_mode = 0600
            File mode bits for the external_command_pipe.

        external_command_pipe = <null>
            Define the full path to an external command pipe that can be
            written to for controlling some aspects of ClusterSSH, such as
            opening sessions to more clusters.

            Commands:

            "open <tag|hostname>" - open new sessions to provided tag or
            hostname

            "retile" - force window retiling

            e.g.: "echo 'open localhost'" /path/to/external_command_pipe >>

        external_cluster_command = <null>
            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 (space separated 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.

            If the external command is given a "-L" option it should output
            a list of tags (space separated on a single line) it can resolve

        extra_cluster_file = <null>
            Define an extra cluster file in the format of /etc/clusters.
            Multiple files can be specified, separated by commas. Both ~ and
            $HOME are acceptable as a reference to the user's home
            directory, e.g.

            "extra_cluster_file = ~/clusters, $HOME/clus"

        extra_tag_file = <null>
            Define an extra tag file in the format of /etc/tags. Multiple
            files can be specified, separated by commas. Both ~ and $HOME
            are acceptable as a reference to the user's home directory, e.g.

            "extra_tag_file = ~/tags, $HOME/tags"

        key_addhost = Control-Shift-plus
            Default key sequence to open AddHost menu. See "KEY SHORTCUTS"
            for more information.

        hide_menu = 0
            If set to 1, hide the menu bar (File, Hosts, Send, Help) in the
            console.

        key_clientname = Alt-n
            Default key sequence to send cssh client names to client. See
            "KEY SHORTCUTS" for more information.