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

  
 
  

home | help
QUFTP(1)			  David Parrish 			QUFTP(1)

NAME
     quftp - command line FTP client

SYNOPSIS
     quftp [-vhi] [-r filename] [-s filename] [-d[n]] [URL]

DESCRIPTION
     Command line FTP client, with support for queueing and transferring server-
     to-server

     -v     Display version number, then exit

     -h     Display usage help, then exit

     -i     Ignore any errors that may occur processing a script

     -r     Use filename as the configuration instead of the default

     -s     Read  in  script  commands	from filename. If an error occurs during
	    script execution, quftp will exit unless -i is specified. After  the
	    script is finished executing, quftp will drop into interactive mode.

     URL    Specify  a	valid  ftp:// URL to connect to. Any valid URL should be
	    acceptable.
	    ftp://username:password@hostname:port/directory/

USAGE
     Normally, quftp runs in interactive mode, where commands are entered at the
     command line. Any of these commands can be put into a script file, which is
     executed with the -s command line option.

     Variables can be inserted into the  command  line	using  $variable,  where
     variable has already been defined using the set command.

     To execute a shell command, enter !command at the prompt.

     Basic  help  for each command can be obtained from within quftp by the help
     commad.

     quit   Exit the program

     exit   Exit the program

     ls [filespec]
	    List current directory. If filespec is given, it is passed	directly
	    to the FTP server.

     lls    List the local directory

     cd [dirname]
	    Change  the  current  directory  to dirname if dirname is not given,
	    display the current directory.

     lcd dirname
	    Change the current local directory to  dirname  if	dirname  is  not
	    given, display the current directory.

     pwd    Show current working directory

     get filename...
	    Queue a file or files for download.

     put filename...
	    Queue a file or files for upload

     mkdir  Create a new directory dirname

     rmdir  Remove a directory dirname

     fxp filename...
	    Queue  a file or files to be transferred between the current connec-
	    tion and the  last	connection  ($LAST_CONNECTION).  Use  switch  to
	    change the connection.

     go     Start transferring the queue

     clear  Delete all items from the queue

     queue  List all items on the queue

     close  Disconnect from the server

     open URL
	    Connect to a server specified by URL.

     status
	    Show the current status of all available connections.

     stat [filename]
	    Display statistics for filename.

     nlst   List just the filenames in the current directory.

     switch [connection]
	    Switch  to another connection. If connection is not given, switch to
	    the lat used connection ($LAST_CONNECTION).

     debug [debuglevel]
	    Set debugging level. If debuglevel is not given, increase the debug-
	    ging level by 1.  Debugging levels are:
	    1	      No information - fairly quiet
	    2	      Normal
	    3	      More information
	    4	      Internal function calls
	    5	      Control connection data

     user username [password]
	    Enter username and password for  the  server.  If  password  is  not
	    given, prompt the user for the password. This forces a re-connect if
	    a connection is already established.

     cat [filename]
	    Output filename to stdout

     more [filename]
	    Page filename using the command given in $pager.

     set variable value
	    Set  variable to equal value. This is most commonly used in the con-
	    figuration file.

     unset variable
	    Remove variable.

     rm filename...
	    Delete a remote file or files.

     run filename
	    Run a script file. After the script has  finished,	control  is  re-
	    turned to the user.

     alias alias command
	    Define  alias  to  execute	command.  If neither alias or command is
	    specified, list all the aliases that have been defined.

     getlist filename
	    Read in filename and retrieve all the files listed.

     assert
	    Be sure the last command was successful. If it  was  not,  exit  the
	    program. This is normally only used in scripts, to stop execution if
	    a command does not work.

     quote command
	    Send command verbatim to the server, and display the result.

CONFIGURATION
     Configuration  is	read  at  startup  from ~/.quftprc, although this can be
     specified as a different file using the -c command line option.  This  file
     must  contain valid quftp commands, one per line. These commands are gener-
     ally ste commands that configure the quftp environment.

     This section provides a brief overview of the configuration  variables  and
     their possible values.

     motd (true/false)
	    Display  the server's Message Of The Day when establishing a connec-
	    tion

     passive (true/false)
	    Use passive mode when transferring files. Read RFC	959  for  a  de-
	    scription of passive mode.

     pager (any valid program)
	    The name of the program to use as the pager when using the more com-
	    mand. This should be specified with the full path.

     email (any valid e-mail address)
	    This  is  uesd  as	the  password when connecting to a server anony-
	    mously.

     progress_update (number)
	    How often should the progress bar be updated during a file	transfer
	    (in  seconds).  If	this is 0 then the progress bar will not be dis-
	    played.

     queuefiles (true/false)
	    Use the queue when transferring files. If false, then files will  be
	    transferred immediately after entering the get, put or fxp command.

     quftp  by	default  supports  only UNIX-style listings from servers. If you
     have a need to access another server type, run a ls command with the  debug
     level  set  to 5 (debug 5), and E-mail me with the the output from the LIST
     command. Alternatively, you can try adding your  own  list  description  in
     ftp.c  (around  line 35). This is unsupported, so please e-mail me with any
     changes you make.

INTERNAL VARIABLES
     State information internal to quftp is accessable read-only using the  nor-
     mal  variable commands, including set and normal variable expansion ($vari-
     able).

     PROGRAM_NAME
	    Always contains "quftp"

     VERSION
	    The version number of quftp being used. This  is  also  the  version
	    that is reported by the -v command line option.

     CURRENT_CONNECTION
	    The  number  of  the  connection  currently  being actioned. Use the
	    switch command to use a different connection.

     LAST_CONNECTION
	    The number of the last connection used. This is also the  connection
	    that any files transferred with the fxp command will go to.

     HOSTNAME
	    The name of the host the current connection applies to.

     USERNAME
	    The username currently being used on the current connection.

BUGS
     Report bugs to <david@dparrish.com>.

David Parrish			   March 2000				QUFTP(1)

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

home | help