Poster of Linux kernelThe best gift for a Linux geek
SSHPROXY

SSHPROXY

Section: User Manuals (8) Updated: DECEMBER 2007
Local index Up

 

NAME

pscp - sshproxy secure copy (remote file copy program)

 

SYNOPSIS

pscp [scp-options] [user@]site:remote_file local_file

pscp [scp-options] local_file [user@]site:remote_file
        

DESCRIPTION

pscp (sshproxy secure copy client) is a program to securely copy files from/to the local machine to/from a remote host, through a special proxy called sshproxy. It is actually a bash(1) wrapper around the official scp(1) client.

You can give options to the official scp(1) client by putting them on the command line.

To give the address of the sshproxy server, you may set some environment variables, or copy and edit the pscp script. See the section ENVIRONMENT below.

To copy files from/to a remote host, you need to know its symbolic name (see pssh(1) for details), and put it on the command line as user@site. user is the remote username, and site is the symbolic name of the remote host. If user is not given, a default user will be chosen by the proxy - this differs from scp(1) which use the currently logged in user (id -un).

Unlike scp(1), pscp and sshproxyd(8) do not yet support copies between two remote hosts.

 

OPTIONS

There are no options used by pscp. See scp(1) for a list of options.

 

FILES

/usr/bin/pscp

The wrapper script around scp(1) to copy files through sshproxy.

 

ENVIRONMENT

The following environment variables may be set in the user's .bashrc or equivalent.

SSHPROXY_HOST
The host on which the sshproxyd(8) daemon runs. Defaults to localhost.

SSHPROXY_PORT
The host port on which the sshproxyd(8) daemon runs. Defaults to 2242.

SSHPROXY_USER
The username to authenticate on the sshproxyd(8) daemon. Defaults to $USER, or admin if $USER is not set or empty.

 

DIAGNOSTICS

In case of problem connecting to the sshproxyd(8) server, one can set the environment variable $verbose to check the generated ssh(1) command line.
   

EXAMPLES

To copy a file to the webserver remote host:


    pscp ./httpd.conf webmaster@webserver:/etc/apache2/httpd.conf

To copy a file from db_host as user admin on the proxy:


    USER=admin pscp root@db_host:/backup/latest.dar /data/backup/db_host/

 

BUGS

Copies between two remote hosts are not yet supported.

See sshproxyd(8)/BUGS for the current limitations and features of sshproxy.

You can report any bug found on the sshproxy mailing list:

<sshproxy@penguin.fr>

 

AUTHOR

David Guerizec <david@guerizec.net>

 

SEE ALSO

pssh(1), sshproxyd(8), sshproxy-setup(1), sshproxy.ini(5),

The sshproxy home page: <http://sshproxy-project.org/>

The sshproxy online documentation:

<http://sshproxy-project.org/documentation/>


 

Index

NAME
SYNOPSIS
DESCRIPTION
OPTIONS
FILES
ENVIRONMENT
DIAGNOSTICS
EXAMPLES
BUGS
AUTHOR
SEE ALSO

This document was created by man2html, using the manual pages.
Time: 22:41:43 GMT, April 16, 2011