Penguin
Recent Changes
Annotated edit history of ncftpls(1) version 1, including all changes. View license author blame.
Rev Author # Line
1 perry 1 ncftpls
2 !!!ncftpls
3 NAME
4 SYNOPSIS
5 OPTIONS
6 DESCRIPTION
7 DIAGNOSTICS
8 AUTHOR
9 SEE ALSO
10 ----
11 !!NAME
12
13
14 ncftpls - Internet file transfer program for scripts
15 !!SYNOPSIS
16
17
18 __ncftpls__ [[''options'']
19 ''ftp://url.style/host/path/name/''
20 !!OPTIONS
21
22
23 __Command line flags:__
24
25
26 __-1__
27
28
29 Most basic format, one item per line.
30
31
32 __-l__
33
34
35 Long list format.
36
37
38 __-x -__''XX''
39
40
41 Additional ''ls'' flags to pass on to the
42 server.
43
44
45 __-u__ ''XX''
46
47
48 Use username ''XX'' instead of anonymous.
49
50
51 __-p__ ''XX''
52
53
54 Use password ''XX'' with the username.
55
56
57 __-P__ ''XX''
58
59
60 Use port number ''XX'' instead of the default FTP service
61 port (21).
62
63
64 __-d__ ''XX''
65
66
67 Use the file ''XX'' for debug logging.
68
69
70 __-t__ ''XX''
71
72
73 Timeout after ''XX'' seconds.
74
75
76 __-E__
77
78
79 Use regular (PORT) data connections.
80
81
82 __-F__
83
84
85 Use passive (PASV) data connections. The default is to use
86 passive, but to fallback to regular if the passive
87 connection fails or times out.
88
89
90 __-r__ ''XX''
91
92
93 Redial a maximum of ''XX'' times until connected to the
94 remote FTP server.
95
96
97 __-W__ ''XX''
98
99
100 Send raw FTP command ''XX'' after logging
101 in.
102
103
104 __-X__ ''XX''
105
106
107 Send raw FTP command ''XX'' after each file
108 transferred.
109
110
111 __-Y__ ''XX''
112
113
114 Send raw FTP command ''XX'' before logging
115 out.
116
117
118 The __-W__, __-X__, and __-Y__ options are useful
119 for advanced users who need to tweak behavior on some
120 servers. For example, users accessing mainframes might need
121 to send some special SITE commands to set blocksize and
122 record format information.
123
124
125 For these options, you can use them multiple times each if
126 you need to send multiple commands. For the __-X__
127 option, you can use the cookie __%s__ to expand into the
128 name of the file that was transferred.
129 !!DESCRIPTION
130
131
132 The purpose of ''ncftpls'' is to do remote directory
133 listings using the File Transfer Protocol without entering
134 an interactive shell. This lets you write shell scripts or
135 other unattended processes that can do FTP.
136
137
138 The default behavior is to print the directory listing in
139 columnized format (i.e. ls -CF), but that is not very useful
140 for scripting. This example uses the __-1__ flag, to
141 print one file per line:
142
143
144 $ ncftpls -1 ftp://ftp.ncftp.com/pub/ncftp/
145
146
147 You can also do a remote
148 -x__ flag. For example, if
149 you wanted to do a remote
150 __
151
152
153 $ ncftpls -x
154
155
156 By default the program tries to open the remote host and
157 login anonymously, but you can specify a username and
158 password information like you can with ''ncftpget'' or
159 ''ncftpput''.
160 !!DIAGNOSTICS
161
162
163 ''ncftpls'' returns the following exit
164 values:
165
166
167 0
168
169
170 Success.
171
172
173 1
174
175
176 Could not connect to remote host.
177
178
179 2
180
181
182 Could not connect to remote host - timed out.
183
184
185 3
186
187
188 Transfer failed.
189
190
191 4
192
193
194 Transfer failed - timed out.
195
196
197 5
198
199
200 Directory change failed.
201
202
203 6
204
205
206 Directory change failed - timed out.
207
208
209 7
210
211
212 Malformed URL.
213
214
215 8
216
217
218 Usage error.
219
220
221 9
222
223
224 Error in login configuration file.
225
226
227 10
228
229
230 Library initialization failed.
231
232
233 11
234
235
236 Session initialization failed.
237 !!AUTHOR
238
239
240 Mike Gleason, NcFTP Software
241 (mgleason@ncftp.com).
242 !!SEE ALSO
243
244
245 ncftpput(1), ''ncftpget(1), ncftp''(1),
246 ftp(1), rcp(1), tftp(1).
247
248
249 ''LibNcFTP''
250 (http://www.ncftp.com/libncftp/).
251 ----
This page is a man page (or other imported legacy content). We are unable to automatically determine the license status of this page.