ncftpls(1)ncftpls(1)NAMEncftpls - Internet file transfer program for scripts
SYNOPSISncftpls [options] ftp://url.style/host/path/name/
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 service port
-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
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
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 exam‐
ple, 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 anony‐
mously, but you can specify a username and password information like
you can with ncftpget or ncftpput.
DIAGNOSTICSncftpls returns the following exit values:
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.
Mike Gleason, NcFTP Software (email@example.com).
SEE ALSOncftpput(1), ncftpget(1), ncftp(1), ftp(1), rcp(1), tftp(1).
Software NcFTP ncftpls(1)