+subject: ftps - shell FTP client
FTPS(1) FTPS(1)
NAME
ftps - shell FTP client
SYNOPSIS
ftps [options] [command [arg]]
DESCRIPTION
ftpc is an akanga(1) script for ftpc(1). It translates
ftps commands in ftpc invocations to give FTP server
access directly to shell commands. For each ftps command
a connection to the server is made, the command executed
and then closed again.
Server Configuration
ftps reads it's server configuration data from the file
~/.ftps.server. Each line (empty lines and comments are
allowed) defines the following fields of server informa-
tion separated by white space:
name the entry's short name. This name is used to
select the server from within ftps.
address
the server's address.
username[:password]
username and password for the server login.
directory
the login's home directory.
options
server options. The only yet available option is
if passive mode should be used for data transfers.
To enable passive mode the options field must be
either passive or pasv. Otherwise this field may
be empty.
If unset in the configuration file the password may be
also read from the ~/.netrc file. Since the entry's name
is used for server (or better session) selection multiple
entries can be given for the same server with either dif-
ferent logins and/or home directories.
Sessions
ftps is meant for parallel interactive use from a shell
interpreter. It maintains different sessions (selected
server, login and current directory) for different tty's.
Furthermore each session has it's own directory listing
cache. Each time the server's directory is changed with
cd or cl or the current working directory is listed with
list the resulting directory contents is written to this
cache file. The cache's contents can be displayed with
the cache command.
The session's name can be set or changed with the
FTPS_SESSION variable. Setting the session name is
required if the calling process doesn't have a controlling
tty.
FTP Commands
ftps supports the following commands
cat file
get file from server to standard output.
cd [dir]
change directory.
cl [dir]
change directory and list.
del file ...
delete files.
edit file
edit file from server.
files dir
enumerate files.
get file ...
get files from the server.
help print list of commands.
home changes to the configured home directory.
lc [pattern ...]
list current directory cache matching pattern if
given or all files.
list [dir]
list files.
ln [pattern ...]
same as lc but prints only filenames.
lsr [dir]
attempts to list files recursivly by applying the
options `-lR' to the LIST command.
mkdir dir ...
create directories on the server.
open server
open server with anonymous account.
put file ...
store files on server.
pwd print current working directory.
retr remote local
retrieve file from server.
rmdir dir ...
delete remote directories.
server [name]
print current server information or switch to
server name.
site cmd arg ...
execute server site command and show the output.
stor local remote
store local file on server.
view file
get file and view with less(1).
write file
store standard input in file on server.
Control Commands
ftps implements the following control commands:
.edit loads ftps's configuration file into a text editor.
.help displays the list of control commands.
.lc lists ftps's configuration data.
.lh lists the current session's history.
.man displays ftps's manpage.
.save name
appends the current location as entry name to the
server configuration file.
.session
lists the available sessions in the order of recent
last modification.
.take tty
takes the current position from session on tty.
OPTIONS
The following options are available:
-g turns ftpc's filename globbing on.
-q sets ftpc's -q option.
-s supresses file transfer messages.
-v sets ftpc's verbose option.
NOTES
ftps is an akanga(1) shell script. So obviously you need
akanga to run it. If you become a frequent ftps user you
might want to rename it's name to something shorter.
SEE ALSO
ftpc(1).
05 APRIL 2004 FTPS(1)
