.TH \fBuftp\fR 1 .SH Name uftp \- universal file transfer program .SH Syntax \fBuftp\fR .PP \fBuftp alias_name [args_for_alias]\fR .PP \fBuftp hostname\fR .SH Description The uftp is user interactive and non-interactive program to the ARPANET File Transfer Protocol (RFC959). The uftp allows user to transfer files, group of files in foreground and background modes. uftp runs on the client host. .SH Basic features Auto retrying of connection to remote node until it is succeeded. .PP Automatic reconnection with continue to transfer if the connection was broken. .PP Several sessions (frames) at once. Dynamically switching between them. .PP Setup commands, which are executed after "open" and "cd" commands. (aliases autologin & autocd ) .PP Cleaning timeout on the remote server. .PP The user can setup any system parameters, like timeouts, reconnect delays, default port number, automatic binary mode, automatic "hash" mode and interval to clean timeouts on FTP server. .PP User can setup the prompt with the descriptions of local and remote directories, full or short site name, time, frame number, remote user's name, port number, timeout, process identification. .PP Several commands in one line. .PP Aliases with arguments, which may contain few commands separated by ';'. .PP Redirection input/output irrespective of context or/and command. .PP The local files are libftp-files, which split on local files, pipes and ftp-files. This particular file specification can be used in any context, including for file names of redirection input/output streams. .PP Any command may be executed in background mode, though the current frame is not droped out and user can continue his work. .PP Creation of alias described the current frame, and save all exist aliases to personal automatic startup file, which is differ from startup file. This file user can make himself. .SH Environment description Command line mode supports all edit key bindings. (uftp using readline library). Before each command user can see the prompt with description of current frame. If debug mode is enabled user see the protocol between uftp and ftp-daemon (ftpd). .SH Commands .IP \fBconnect\fR 10 [host-name] Connect to remote site. .IP \fBopen\fR 10 [host-name] [user-name] [password] [directory] Makes connection to remote site, sent login, password and change directory. If the "try" option is set an attempt to connect will be forced until success. .IP \fBftp\fR 10 [hostname] [directory] Anonymous connection to ftp-site. .IP \fBreopen\fR 10 Reopen broken frame. .IP \fBclose\fR 10 Close the current connection. .IP \fBquit\fR 10 Quit from uftp (You can press Contol-D) .IP \fBlist\fR 10 Description list of all frames. .IP \fBuser\fR 10 [user-name] [password] Send user's name to site, automatically require password if needed. .IP \fBpass\fR 10 [password] Specify user's password. .IP \fBbin\fR 10 Set binary transfer mode. .IP \fBascii\fR 10 Set ASCII transfer mode. .IP \fBcd\fR 10 directory_name Change the current directory on remote site. .IP \fBacd\fR 10 [directory_name] Archie searching by specified pattern with subsequent connection to desired point. Maximum number of possible points is 20. Afterwards user can select any point. If user don't specify "directory_name", last search buffer is displayed for selection, if this buffer is not empty. .IP \fBlcd\fR 10 directory_name Local change directory. User can use metacharacters. .IP \fBabort\fR 10 Abort execute of last procedure with server. Warning: this procedure sometimes is not correctly working. .IP \fBmkdir\fR 10 directory_name Create new directory on the server. .IP \fBrm\fR 10 filename_or_pattern Remove specified file(s) on the server. .IP \fBmv\fR 10 old_filename new_filename Move file on the server. .IP \fBdir\fR 10 [keys] [filename_spec] .... Make long list of specified file(s) with date, size, etc... .IP \fBls\fR 10 [keys] [filename_spec] .... Make short list of specified file(s). .IP \fBget\fR 10 remote_filename [local_filename_or_directory] Receive the file from the server to local file system (only one file!). If option "rest" is turn on then transfer starts from the end of local file. .IP \fBmget\fR 10 [remote_filename] [local_directory] Receive many files from the server to local file system. .IP \fBreget\fR 10 remote_filename [local_filename_or_directory]. The same as get, but the option "rest" is ignored. .IP \fBaget\fR 10 [pattern_for_archie] Getting the file, which need to find via archie service. See also "acd" description. .IP \fBbget\fR 10 [libftp_file] [local_file] Get file specified as libftp-file. See libftp file specification. Operation proceedes until success. .IP \fBput\fR 10 local_filename [remote_filename] Put one file to server. .IP \fBmput\fR 10 local_filename(s) Put specified file(s) to server. .IP \fBreput\fR 10 The same as put, but the option "rest" is ignored. .IP \fBbput\fR 10 [[local_file] libftp_file] Put file specified as libftp-file. See libftp file specification. Operation proceedes until success. .IP \fBcopy\fR 10 [frame/]filename [frame/]filename Copy one file from first frame to second. If the frame number is not specified then use current frame number. Transfer operation executes via libftp cache. .IP \fBccopy\fR 10 [frame/]filename [frame/]filename Copy one file from first frame to second. If the frame number is not specified then used current frame number. Transfer operation executes via leased line between two servers cache. .IP \fBcat\fR 10 filename Display context of specified file on screen. .IP \fBpage\fR 10 The same as cat, but with using of pager. Name of pager specified in environment variable PAGER or "more" by default. .IP \fBbg\fR 10 any_command any_command & Run any command in background mode. Default output is redirected to /tmp/uftp-.XXXXXX file. .IP \fBarchie\fR 10 [pattern] Archie search. In case if argument are omitted, reprint last search. .IP \fBdup\fR 10 Create new frame as current. .IP \fBquote\fR 10 Send raw command to server. If option "glassmode" is set then all non-recognized commands send to server as raw also. .IP \fBhelp\fR 10 [command] Print brief help or help for specified command. .IP \fBalias\fR 10 alias_name alias_string Makes new alias, if the alias string uftp contains string like $1, $2, $* then it will be replaced by argument to alias. If this sequences in alias is not found, then all existing alias's arguments will append to end of alias call string. User can insert to alias string like \\\> \\\< for future redirect input/output. Quotes ' and " can be used also. .IP \fBunalias\fR 10 alias_name Remove specified alias. .IP \fBmkalias\fR 10 alias_name Makes new alias, which user can use in future for login to this point again. See also "savealias" .IP \fBsavealias\fR 10 Save all aliases in startup file. .SH Libftp file specification All local files interpret as libftp's files. Libftp responds to three types of files such as local file, ftp files and program pipes. All files can be described as next syntax: |string - interprets string as shell command, which must be \ executed with appropriate input/output for file. It depends where this file is specified. hostname:filename - interprets as file, which must be taken using ftp protocol with anonymous access user@hostname:filename - interprets as file accesses via ftp with password yourname@your_host.your_domain user/pass@hostname:filename - also ftp file. *STDIN*, *STDOUT*, *STDERR* or char '-' - opened streams. anything - local file name. .SH String syntax The strings starting from char '!' interpret as shell command. The strings or aliases containing one or few char ';' will be executed as a chain commands. The chains of characters between " or ' interpret as one set without syntax resolving. In any command string user can redirect input or/and output using char > and < . For the complex file name it must quoted by ' or ". Examples: dir >filename cat filename >'|mail -s "my files" fiend@hostname.domain' dir -R etc bin >"|gzip >result.gz" cat filename > user/password@hostname:/dir/filename.ext put - < "|finger @hostname" newfile.finger .SH Options (command set) .IP \fBset\fR Show all current settings. .IP \fBset\fR frame Switch to another frame. You can also switch by insert on frame number to the begin of command line. .IP \fBset\fR timeout Set timeout for send/receive operations. .IP \fBset\fR noop Set interval for send NOOP command to each connected server for cleaning timeouts. .IP \fBset\fR nooptimeout Set timeout for NOOP operation. .IP \fBset\fR sleep Set pause interval between transfer attempts. .IP \fBset\fR debug Enable or disable protocol debug output .IP \fBset\fR try Enable or disable retrys after lost peer. .IP \fBset\fR hash Enable or disable trace for the transfer operations. .IP \fBset\fR restore Enable or disable default transfer starting from end of file. .IP \fBset\fR bin Automatic binary mode. .IP \fBset\fR glass This command only to debug the protocol. After glassmode it is enable to send raw to server of all unresponded commands. .IP \fBset\fR prompt Set the prompt. Prompt is a string, which may contain % or ^ combitanions with the next embodies: %H, %h - full and short remote host names %M, %m - full and short local host names %u - remote user's name %d - remote current directory %D - local current directory %f - number of current frame %p - the ftp's port number %t - timeout %T - current time %P - uftp process id %% - character % ^- control character %^ - character ^ .IP \fBset\fR port Set default FTP's port for next sessions. .IP \fBset\fR user Set default user's name. .SH Startup file User can modify his startup file created automatically. This file may contain some uftp's commands separated by new-line. The name of this file is ~/.uftprc. The file ~/.uftp_aliases is created automatically by uftp's command "savealias", so it is not needed to edit handly. .SH Author of uftp and libftp Oleg Orel Department of Electronics and automatisation. Institute for High Energy Physics Protvino, Russia E-mail: orel@oea.ihep.su, orel@dxcern.cern.ch .SH See also \fBncftp\fR (1), \fBftp\fR (1), \fBftpd\fR (8)