NAME

       ncftpls - Internet file transfer program for scripts

SYNOPSIS

       ncftpls [options] ftp://url.style/host/path/name/

OPTIONS

   Command line flags:
       -m      Use  a  machine  readable  list format, if the server supports it.  This requires that the server
               software support the MLSD extensions, and many implementations do not have these features.

       -1      Most basic format, one item per line.

       -l      Long list format.

       -C      Columnized list format. This is the default list format.

       -R      Recurse all subdirectories while listing.

       -a      Show all files, if server allows it (as in "/bin/ls -a").

       -i XX   Filter the listing (if server supports it) with the wildcard XX.

       -x -XX  Set the ls flags to use on the server.

       -u XX   Use username XX instead of anonymous.

       -p XX   Use password XX with the username.

       -P XX   Use port number XX instead of the default FTP service port (21).

       -d XX   Use the file XX for debug logging.

       -t XX   Timeout after XX seconds.

       -E      Use regular (PORT) data connections.

       -F      Use passive (PASV) data connections.  The default is to use passive, but to fallback  to  regular
               if the passive connection fails or times out.

       -r XX   Redial a maximum of XX times until connected to the remote FTP server.

       -W XX   Send raw FTP command XX after logging in.

       -X XX   Send raw FTP command XX after each file transferred.

       -Y XX   Send raw FTP command XX before logging out.

               The  -W,  -X,  and  -Y  options  are useful for advanced users who need to tweak behavior on some
               servers.  For example, users accessing mainframes might need to send some special  SITE  commands
               to set blocksize and record format information.

               For  these  options,  you can use them multiple times each if you need to send multiple commands.
               For the -X option, you can use the cookie %s to expand  into  the  name  of  the  file  that  was
               transferred.

       -o XX   Set advanced option XX.

               This  option  is  used  primarily for debugging.  It sets the value of an internal variable to an
               integer value.  An example usage would be: -o useFEAT=0,useCLNT=1 which in  this  case,  disables
               use  of the FEAT command and enables the CLNT command.  The available variables include: usePASV,
               useSIZE,  useMDTM,  useREST,  useNLST_a,   useNLST_d,   useFEAT,   useMLSD,   useMLST,   useCLNT,
               useHELP_SITE,      useSITE_UTIME,      STATfileParamWorks,     NLSTfileParamWorks,     require20,
               allowProxyForPORT, doNotGetStartCWD.

DESCRIPTION

       The purpose of ncftpls is to do remote directory  listings  using  the  File  Transfer  Protocol  without
       entering  an interactive shell.  This lets you write shell scripts or other unattended processes that can
       do FTP.

       The default behavior is to print the directory listing in columnized format (i.e. ls -CF),  but  that  is
       not very useful for scripting.  This example uses the -1 flag, to print one file per line:

           $ ncftpls -1 ftp://ftp.ncftp.com/pub/ncftp/

       You can also do a remote "ls -l", by using "ncftpls -l".  If you want to try other flags, you have to use
       them with the -x flag.  For example, if you wanted to do a remote "ls -lrt", you could do this:

           $ ncftpls -x "-lrt" ftp://ftp.ncftp.com/pub/ncftp/

       By default the program tries to open the remote host  and  login  anonymously,  but  you  can  specify  a
       username and password information like you can with ncftpget or ncftpput.

       Note that the standard specifies that URL pathnames are are relative pathnames.  For FTP, this means that
       URLs specify relative pathnames from the start directory, which for user logins, are typically the user's
       home  directory.   If  you want to use absolute pathnames, you need to include a literal slash, using the
       "%2F" code for a "/" character.  Examples:

           $ ncftpls -u linus ftp://ftp.kernel.org/%2Fusr/src/
           $ ncftpls ftp://steve@ftp.apple.com/%2Fetc/

DIAGNOSTICS

       ncftpls returns the following exit values:

       0       Success.

       1       Could not connect to remote host.

       2       Could not connect to remote host - timed out.

       3       Transfer failed.

       4       Transfer failed - timed out.

       5       Directory change failed.

       6       Directory change failed - timed out.

       7       Malformed URL.

       8       Usage error.

       9       Error in login configuration file.

       10      Library initialization failed.

       11      Session initialization failed.

AUTHOR

       Mike Gleason, NcFTP Software (http://www.ncftp.com).

SEE ALSO

       ncftpput(1), ncftpget(1), ncftp(1), ftp(1), rcp(1), tftp(1).

       LibNcFTP (http://www.ncftp.com/libncftp/).