remote_shell

NAME

SYNOPSIS

remote_shell [ -c cfg_file ] [ -m mode[{,mode}] ] [ -q ] [ -N ] [ -s username ] [ -l username ] [ -t ] host [ -- ] [ command ]

remote_shell [ -c cfg_file ] -f -m mode [ -n ] [ -q ] [ -N ] [ -s username ] [ -l username ] [ -t ] host [ -- ] [ command ]

AVAILABILITY

DESCRIPTION

This command enables you to write scripts independent of the current security policy of your systems.

Internally remote_shell uses remsh, rsh or ssh dependent of the configuration settings.

Furthermore this command provides a caching mechanism which remembers successful connection modes to speed up future connections.

OPTIONS

-h

usage message.

-c cfg_file

config file (default=edrc/etc/remote_shell.cfg).

-m mode

connection mode (default=rtools): rtools: rsh, rcp; OpenSSH: ssh, scp; default: default from config file.

-n

do not probe connection before executing the command.

-N

do not 'su' to the user given in -s username prior to invoking the connection.

-s username

user to switch to on the local machine.

-f

force connection mode.

-l username

user to log in as on the remote machine.

-q

quiet, no error message output.

-t

allocate a tty even if command is given.

host

host to log on to.

--

mark end of remote_shell options.

command

command to execute on the remote host.

ENVIRONMENT

EXIT STATUS

0

no error.

2

operating system not supported.

3

remote system is not up.

4

usage displayed.

5

command aborted.

6

config file not found.

7

cannot log on to remote system.

1##

## exit code of rsh or ssh if not successful.

FILES

edrc/etc/remote_shell.cfg

configruation file.

edrc/var/connection/security/

connection security files (e.g. SSH keys).

edrc/var/connection/cache/

connection cache files.

EXAMPLES

SEE ALSO

NOTES

BUGS

AUTHOR

COPYRIGHT

This is free software; see edrc/doc/COPYING for copying conditions. There is ABSOLUTELY NO WARRANTY; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.