---
name: "sshproxy-scp"
section: "8"
platform: "linux"
package: "sshproxy-client"
version: "0.6.0~beta2-2"
release: "Debian 5.0 (Lenny)"
platforms: ["linux"]
url: "https://new.carta.tech/sshproxy-scp"
---

# sshproxy-scp(8)

sshproxy secure copy (remote file copy program)

## 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)](/bash/1.md) wrapper around the official [*scp*(1)](/scp/1.md) client.

You can give options to the official [*scp*(1)](/scp/1.md) 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)](/scp/1.md) which use the currently logged in user (id -un).

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

## OPTIONS

There are no options used by *pscp*. See [*scp*(1)](/scp/1.md) for a list of options.

## FILES

*/usr/bin/pscp*

The wrapper script around [*scp*(1)](/scp/1.md) 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)](/sshproxyd/8.md) daemon runs. Defaults to *localhost*.

- SSHPROXY\_PORT

  The host port on which the [*sshproxyd*(8)](/sshproxyd/8.md) daemon runs. Defaults to *2242*.

- SSHPROXY\_USER

  The username to authenticate on the [*sshproxyd*(8)](/sshproxyd/8.md) daemon. Defaults to *$USER*, or *admin* if $USER is not set or empty.

## DIAGNOSTICS

In case of problem connecting to the [*sshproxyd*(8)](/sshproxyd/8.md) server, one can set the environment variable *$verbose* to check the generated [*ssh*(1)](/ssh/1.md) 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)](/sshproxyd/8.md)/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)](/sshproxyd/8.md), **sshproxy-setup**(1), [**sshproxy.ini**(5)](/sshproxy.ini/5.md),

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

The sshproxy online documentation:

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