manual/ncftp/original/man1/ncftpls.1

   1 .TH ncftpls 1 NcFTP Software
   2 .SH NAME
   3 ncftpls - Internet file transfer program for scripts
   4 .SH "SYNOPSIS"
   5 .PP
   6 .B ncftpls
   7 .RI [ "options" ]
   8 .I "ftp://url.style/host/path/name/"
   9 .\"-------
  10 .SH "OPTIONS"
  11 .\"-------
  12 .SS
  13 Command line flags:
  14 .TP 8
  15 .B \-1
  16 Most basic format, one item per line.
  17 .TP 8
  18 .B \-l
  19 Long list format.
  20 .TP 8
  21 .BI "-x -" "XX"
  22 Additional
  23 .I ls
  24 flags to pass on to the server.
  25 .TP 8
  26 .BI "-u " "XX"
  27 Use username
  28 .I XX
  29 instead of anonymous.
  30 .TP 8
  31 .BI "-p " "XX"
  32 Use password
  33 .I XX
  34 with the username.
  35 .TP 8
  36 .BI "-P " "XX"
  37 Use port number
  38 .I XX
  39 instead of the default FTP service port (21).
  40 .TP 8
  41 .BI "-d " "XX"
  42 Use the file
  43 .I XX
  44 for debug logging.
  45 .TP 8
  46 .BI "-t " "XX"
  47 Timeout after
  48 .I XX
  49 seconds.
  50 .TP 8
  51 .B -E
  52 Use regular (PORT) data connections.
  53 .TP 8
  54 .B -F
  55 Use passive (PASV) data connections.
  56 The default is to use passive, but to fallback to
  57 regular if the passive connection fails or times out.
  58 .TP 8
  59 .BI "-r " "XX"
  60 Redial a maximum of
  61 .I XX
  62 times until connected to the remote FTP server.
  63 .\"-------
  64 .SH "DESCRIPTION"
  65 .\"-------
  66 .PP
  67 The
  68 purpose of
  69 .I ncftpls
  70 is to do remote directory listings using
  71 the File Transfer Protocol without entering an interactive shell.
  72 This lets you write shell scripts or other unattended
  73 processes that can do FTP.
  74 .PP
  75 The default behavior is to print the directory listing in columnized
  76 format (i.e. ls\ \-CF), but that is not very useful for scripting.
  77 This example uses the
  78 .B \-1
  79 flag, to print one file per line:
  80 .RS 4
  81 .br
  82 .sp
  83 $ ncftpls -1 ftp://ftp.ncftp.com/pub/ncftp/
  84 .RE
  85 .PP
  86 You can also do a remote "ls\ \-l", by using "ncftpls\ \-l".
  87 If you want to try other flags, you have to use them with the
  88 .B \-x
  89 flag.
  90 For example, if you wanted to do a remote "ls\ \-lrt", you could
  91 do this:
  92 .RS 4
  93 .br
  94 .sp
  95 $ ncftpls -x "-lrt" ftp://ftp.ncftp.com/pub/ncftp/
  96 .RE
  97 .PP
  98 By default the program tries to open the remote host
  99 and login anonymously, but you can specify a username
 100 and password information like you can with
 101 .I ncftpget
 102 or
 103 .IR ncftpput "."
 104 .\"-------
 105 .SH "DIAGNOSTICS"
 106 .\"-------
 107 .PP
 108 .I ncftpls
 109 returns the following exit values:
 110 .TP 8
 111 0
 112 Success.
 113 .TP 8
 114 1
 115 Could not connect to remote host.
 116 .TP 8
 117 2
 118 Could not connect to remote host - timed out.
 119 .TP 8
 120 3
 121 Transfer failed.
 122 .TP 8
 123 4
 124 Transfer failed - timed out.
 125 .TP 8
 126 5
 127 Directory change failed.
 128 .TP 8
 129 6
 130 Directory change failed - timed out.
 131 .TP 8
 132 7
 133 Malformed URL.
 134 .TP 8
 135 8
 136 Usage error.
 137 .TP 8
 138 9
 139 Error in login configuration file.
 140 .TP 8
 141 10
 142 Library initialization failed.
 143 .TP 8
 144 11
 145 Session initialization failed.
 146 .\"-------
 147 .SH "AUTHOR"
 148 .\"-------
 149 .PP
 150 Mike Gleason, NcFTP Software (mgleason@ncftp.com).
 151 .\"-------
 152 .SH "SEE ALSO"
 153 .\"-------
 154 .PP
 155 .IR ncftpput (1),
 156 .IR ncftpget(1),
 157 .IR ncftp (1),
 158 .IR ftp (1),
 159 .IR rcp (1),
 160 .IR tftp (1).
 161 .PP
 162 .IR "LibNcFTP" " (http://www.ncftp.com/libncftp/)."