dssh

Langue: en

Version: September 2003 (mandriva - 01/05/08)

Section: 1 (Commandes utilisateur)

Sommaire

NAME

dssh - Run commands, send and receive files from multiple systems with a single command

SYNOPSIS

dssh [ARGUMENTS]

DESCRIPTION

Seperate switches and values with a single space.

-h
Displays usage information
-a
Will connect to all nodes in the default node group 'ALL'
-e 'command'
Execute command on remote systems. This is will be processed by /bin/sh on the remote system, so you may specify multiple commands using standard sh shell characters such as ; and &&
-f
The 'force' switch, dssh will not prompt the user whether or not to continue if a node is unreachable or refusing a remote connection.
-F number
Sets the fanout level, this is the number of nodes to which dssh will attempt to connect simultaneously
-N group1, group2, ..., groupN
Adds the nodes belonging to the groups given as arguments to the list of nodes to connect to
-p port_number
Uses a non-standard port number as default. dssh will only use this port number with nodes that do not have a port number explicitly defined in the node group file
-q
Displays a list of all the nodes to which dssh would connect, without actually connecting to any of them
-tf file1, file2, ..., fileN
Transfer the given list of files to the remote system. Files will be placed in the remote users home directory without regard for files that already exist there. Duplicate filenames, even those who exist in different directories on the local system, will be assumed to be duplicated and only one copy will be transferred.
-tr
Specifies recursive file transfer, with this option, directories can be specified with the -tf option above. Using this option will force dssh to recognise the local file source, so directory location on the local system, as specified by the name given to the -tf switch, will result in the base directory and subdirectories leading to target file being transferred to the remote users home directory.
-td destination
Specifies a directory on the remote node in which to place transferred files instead of the remote users home directory.
-rf file1, file2, ..., fileN
Specifies a list of files on the remote system which to retrieve. Retrieved files will by default be placed as ~/node_name/file
-rr
Specifies recursive file retrieval, with this option, dssh will recognise remote directories and will retrieve the path as specified by the user to ~/node_name/path/file
-rd destination
Specifies a directory on the local system in which to place retrieved files, this does not mean all files will be placed in one directory. On the local system, remote retrievals will be placed in destination/node_name/path/file
-sn
Specifies that you do not want strict host key checking. This is not recommended, but may be necessary if you are communicating with remote machines hidden behind a NAT gateway that are accessible by forwarded ports.
-sa
Specifies you want to be asked about changed or new host keys, this is the default SSH functionality, useful if you disable host key checking entirely, or enforce it completely in your default local ssh client configurations.
-sy
Specifies that you do not want be asked about host key changes, and do not want to connect to hosts whose keys have changed.
-t time_in_seconds
Specifies the time to wait for a node to respond before labelling it "unreachable".
-u username
dssh uses your current local username as the default with which to connect to nodes, this option sets a default username with which to connect to those nodes with. dssh will not use this username with nodes which have a username explicitly defined in the node file.
-fu username
This forces dssh to use the same username when connecting to all nodes, usernames explicitly set in node group files will be ignored.
-w node1, node2, ..., nodeN
Adds a number of single nodes not listed in any node groups which dssh should attempt to connect to.
-W
Causes all warning and diagnostic messages to be suppressed

A mere - implies -i. If no COMMAND, print the resulting environment.

AUTHOR

Written by Colin Stubbs, credit goes to X and X for writing dsh, upon which dssh is based.

REPORTING BUGS

Report bugs to <bug-dssh@subverted.net> Something, not sure yet :/
This is free software; see the source for copying conditions. There is NO warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.