ncftpls(1)                                             ncftpls(1)

NAME
       ncftpls - Internet file transfer program for scripts

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

OPTIONS
   Command line flags:
       -1      Most basic format, one item per line.

       -l      Long list format.

       -x -XX  Additional ls flags to pass on to 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 ser-
               vice port (21).

       -d XX   Use the file XX for debug logging.

       -t XX   Timeout after XX seconds.

       -F      Use passive (PASV) data connections.

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

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 use-
       ful for scripting.  This example  uses  the  -1  flag,  to
       print one file per line:

           $ ncftpls -1 ftp://ftp.probe.net/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.probe.net/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  ncftp-
       put.

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, NCEMRSoft (mgleason@probe.net).

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

       LibNcFTP (http://www.probe.net/~mgleason/libncftp).

                            NCEMRSoft                           1