Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
pscp(1) 			PuTTY tool suite			 pscp(1)

NAME
     pscp - command-line SCP (secure copy) / SFTP client

SYNOPSIS
     pscp [options] [user@]host:source target
     pscp [options] source [source...] [user@]host:target
     pscp [options] -ls [user@]host:filespec

DESCRIPTION
     pscp  is a command-line client for the SSH-based SCP (secure copy) and SFTP
     (secure file transfer protocol) protocols.

OPTIONS
     The command-line options supported by pscp are:

     -V     Show version information and exit.

     -pgpfp Display the fingerprints of the PuTTY PGP Master Keys and  exit,  to
	    aid in verifying new files released by the PuTTY team.

     -ls    Remote directory listing.

     -p     Preserve file attributes.

     -q     Quiet, don't show statistics.

     -r     Copy directories recursively.

     -unsafeAllow server-side wildcards (DANGEROUS).

     -v     Show verbose messages.

     -load session
	    Load settings from saved session.

     -P portConnect to port port.

     -proxycmd command
	    Instead  of making a TCP connection, use command as a proxy; network
	    traffic will be redirected to the standard input and output of  com-
	    mand. command must be a single word, so is likely to need quoting by
	    the shell.

	    The  special  strings %host and %port in command will be replaced by
	    the hostname and port number you want to connect to; to get  a  lit-
	    eral % sign, enter %%.

	    Backslash  escapes are also supported, such as sequences like \n be-
	    ing replaced by a literal newline; to get a literal backslash, enter
	    \\. (Further escaping may be required by the shell.)

	    (See the main PuTTY manual for full details of the supported %-  and
	    backslash-delimited  tokens,  although most of them are probably not
	    very useful in this context.)

     -preconnectcommand command
	    Specify an external command to run just before making the main  net-
	    work connection. The syntax of command is similar to that for -prox-
	    ycmd.

     -l userSet remote username to user.

     -batch Disable interactive prompts.

     -no-sanitise-stderr
	    By	default,  PSCP	will filter control characters from the standard
	    error channel from the server, to prevent remote  processes  sending
	    confusing  escape  sequences.  This option forces the standard error
	    channel to not be filtered.

     -pwfile filename
	    Open the specified file, and use the first line of text read from it
	    as the remote password.

     -pw password
	    Set remote password to password. CAUTION: this will likely make  the
	    password  visible  to other users of the local machine (via commands
	    such as `ps' or `w'). Use -pwfile instead.

     -1     Force use of SSH protocol version 1.

     -2     Force use of SSH protocol version 2.

     -ssh-connection
	    Force use of the `bare ssh-connection' protocol. This is only likely
	    to be useful when connecting to a psusan(1) server, most likely with
	    an absolute path to a Unix-domain socket in place of host.

     -ssh   Force use of the SSH protocol. (This is  usually  not  needed;  it's
	    only likely to be useful if you need to override some other configu-
	    ration of the `bare ssh-connection' protocol.)

     -4, -6 Force use of IPv4 or IPv6 for network connections.

     -C     Enable SSH compression.

     -i keyfile
	    Private  key  file for user authentication. For SSH-2 keys, this key
	    file must be in PuTTY's PPK format, not OpenSSH's format  or  anyone
	    else's.

	    If	you  are  using  an authentication agent, you can also specify a
	    public key here (in RFC 4716 or OpenSSH format), to  identify  which
	    of the agent's keys to use.

     -noagent
	    Don't try to use an authentication agent.

     -agent Allow use of an authentication agent. (This option is only necessary
	    to override a setting in a saved session.)

     -no-trivial-auth
	    Disconnect	from any SSH server which accepts authentication without
	    ever having asked for any kind of password or  signature  or  token.
	    (You  might  want  to  enable this for a server you always expect to
	    challenge you, for instance to ensure you  don't  accidentally  type
	    your key file's passphrase into a compromised server spoofing PSCP's
	    passphrase prompt.)

     -hostkey key
	    Specify  an acceptable host public key. This option may be specified
	    multiple   times;	each   key   can   be	either	 a   fingerprint
	    (SHA256:AbCdE...,  99:aa:bb:...,  etc)  or	a base64-encoded blob in
	    OpenSSH's one-line format.

	    Specifying this option overrides automated host key management; only
	    the key(s) specified on the command-line will be accepted (unless  a
	    saved  session also overrides host keys, in which case those will be
	    added to), and the host key cache will not be written.

     -scp   Force use of SCP protocol.

     -sftp  Force use of SFTP protocol.

     -sshlog logfile

     -sshrawlog logfile
	    These options make pscp log protocol details to  a	file.  (Some  of
	    these  may	be  sensitive,	although by default an effort is made to
	    suppress obvious passwords.)

	    -sshlog logs decoded SSH packets and other	events	(those	that  -v
	    would  print). -sshrawlog additionally logs the raw encrypted packet
	    data.

     -logoverwrite
	    If PSCP is configured to write to a log file  that	already  exists,
	    discard the existing file.

     -logappend
	    If	PSCP  is  configured to write to a log file that already exists,
	    append new log data to the existing file.

MORE INFORMATION
     For more information on pscp it's probably best to go and look at the  man-
     ual on the PuTTY web page:

     https://www.chiark.greenend.org.uk/~sgtatham/putty/

BUGS
     This  man	page  isn't terribly complete. See the above web link for better
     documentation.

PuTTY tool suite		   2004-03-24				 pscp(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=pscp&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>

home | help