author | Sunil Nimmagadda <sunil@nimmagadda.net> |
Tue, 06 Dec 2022 13:51:55 +0000 | |
changeset 0 | 1d0ce1ebbc72 |
permissions | -rw-r--r-- |
0
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
1 |
.\" $OpenBSD: ftp.1,v 1.114 2019/05/15 11:53:22 kmos Exp $ |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
2 |
.\" The Regents of the University of California. All rights reserved. |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
3 |
.\" |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
4 |
.\" Redistribution and use in source and binary forms, with or without |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
5 |
.\" modification, are permitted provided that the following conditions |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
6 |
.\" are met: |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
7 |
.\" 1. Redistributions of source code must retain the above copyright |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
8 |
.\" notice, this list of conditions and the following disclaimer. |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
9 |
.\" 2. Redistributions in binary form must reproduce the above copyright |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
10 |
.\" notice, this list of conditions and the following disclaimer in the |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
11 |
.\" documentation and/or other materials provided with the distribution. |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
12 |
.\" 3. Neither the name of the University nor the names of its contributors |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
13 |
.\" may be used to endorse or promote products derived from this software |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
14 |
.\" without specific prior written permission. |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
15 |
.\" |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
16 |
.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
17 |
.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
18 |
.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
19 |
.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
20 |
.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
21 |
.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
22 |
.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
23 |
.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
24 |
.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
25 |
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
26 |
.\" SUCH DAMAGE. |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
27 |
.\" |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
28 |
.\" @(#)ftp.1 8.3 (Berkeley) 10/9/94 |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
29 |
.\" |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
30 |
.\" Copyright (c) 2015 Sunil Nimmagadda <sunil@openbsd.org> |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
31 |
.\" |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
32 |
.\" Permission to use, copy, modify, and distribute this software for any |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
33 |
.\" purpose with or without fee is hereby granted, provided that the above |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
34 |
.\" copyright notice and this permission notice appear in all copies. |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
35 |
.\" |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
36 |
.\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
37 |
.\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
38 |
.\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
39 |
.\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
40 |
.\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
41 |
.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
42 |
.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
43 |
.\" |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
44 |
.Dd $Mdocdate: August 13 2015 $ |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
45 |
.Dt FTP 1 |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
46 |
.Os |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
47 |
.Sh NAME |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
48 |
.Nm ftp |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
49 |
.Nd Internet file transfer program |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
50 |
.Sh SYNOPSIS |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
51 |
.Nm |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
52 |
.Op Fl 46AVv |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
53 |
.Op Fl N Ar name |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
54 |
.Op Fl D Ar title |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
55 |
.Op Ar host Op Ar port |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
56 |
.Nm |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
57 |
.Op Fl 46ACMmVv |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
58 |
.Op Fl N Ar name |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
59 |
.Op Fl D Ar title |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
60 |
.Op Fl o Ar output |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
61 |
.Op Fl S Ar tls_options |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
62 |
.Op Fl U Ar useragent |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
63 |
.Op Fl w Ar seconds |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
64 |
.Ar url ... |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
65 |
.Sh DESCRIPTION |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
66 |
.Nm |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
67 |
is the user interface to the Internet standard File Transfer |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
68 |
Protocol (FTP). |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
69 |
The program allows a user to transfer files to and from a |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
70 |
remote network site. |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
71 |
.Pp |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
72 |
The latter usage format will fetch a file using either the |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
73 |
FTP, HTTP or HTTPS protocols into the current directory. |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
74 |
This is ideal for scripts. |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
75 |
Refer to |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
76 |
.Sx AUTO-FETCHING FILES |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
77 |
below for more information. |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
78 |
.Pp |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
79 |
The options are as follows: |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
80 |
.Bl -tag -width Ds |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
81 |
.It Fl 4 |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
82 |
Forces |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
83 |
.Nm |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
84 |
to use IPv4 addresses only. |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
85 |
.It Fl 6 |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
86 |
Forces |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
87 |
.Nm |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
88 |
to use IPv6 addreses only. |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
89 |
.It Fl A |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
90 |
Force active mode FTP. |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
91 |
By default, |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
92 |
.Nm |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
93 |
will try to use passive mode FTP and fall back to active mode |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
94 |
if passive is not supported by the server. |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
95 |
This option causes |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
96 |
.Nm |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
97 |
to always use an active connection. |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
98 |
It is only useful for connecting |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
99 |
to very old servers that do not implement passive mode properly. |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
100 |
.It Fl C |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
101 |
Continue a previously interrupted file transfer. |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
102 |
.Nm |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
103 |
will continue transferring from an offset equal to the length of file. |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
104 |
.Pp |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
105 |
Resuming HTTP(S) transfers are only supported if the remote server supports the |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
106 |
.Dq Range |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
107 |
header. |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
108 |
.It Fl D Ar title |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
109 |
Specify a short title for the start of the progress bar. |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
110 |
.It Fl M |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
111 |
Causes |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
112 |
.Nm |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
113 |
to never display the progress meter in cases where it would do so by default. |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
114 |
.It Fl N Ar name |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
115 |
Use this alternative name instead of |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
116 |
.Nm |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
117 |
in some error reports. |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
118 |
.It Fl m |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
119 |
Causes |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
120 |
.Nm |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
121 |
to display the progress meter in cases where it would not do so by default. |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
122 |
.It Fl o Ar output |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
123 |
When fetching a file or URL, save the contents in |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
124 |
.Ar output . |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
125 |
To make the contents go to stdout, use `-' for |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
126 |
.Ar output . |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
127 |
.It Fl S Ar tls_options |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
128 |
TLS options to use with HTTPS transfers. |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
129 |
The following settings are available: |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
130 |
.Bl -tag -width Ds |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
131 |
.It Cm cafile Ns = Ns Ar /path/to/cert.pem |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
132 |
PEM encoded file containing CA certificates used for certificate validation. |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
133 |
.It Cm capath Ns = Ns Ar /path/to/certs/ |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
134 |
Directory containing PEM encoded CA certificates used for certificate |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
135 |
validation. |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
136 |
.It Cm ciphers Ns = Ns Ar cipher_list |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
137 |
Specify the list of ciphers that will be used by |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
138 |
.Nm . |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
139 |
See the |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
140 |
.Xr openssl 1 |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
141 |
.Cm ciphers |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
142 |
subcommand. |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
143 |
.It Cm depth Ns = Ns Ar max_depth |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
144 |
Maximum depth of the certificate chain allowed when performing validation. |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
145 |
.It Cm dont |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
146 |
Don't perform server certificate validation. |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
147 |
.It Cm protocols Ns = Ns Ar string |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
148 |
Specify the TLS protocols to use. |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
149 |
If not specified the value |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
150 |
.Qq all |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
151 |
is used. |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
152 |
Refer to the |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
153 |
.Xr tls_config_parse_protocols 3 |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
154 |
function for other valid protocol string values. |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
155 |
.It Cm muststaple |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
156 |
Require the server to present a valid OCSP stapling in the TLS handshake. |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
157 |
.It Cm noverifytime |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
158 |
Disable validation of certificate times and OCSP validation. |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
159 |
.It Cm session Ns = Ns Ar /path/to/session |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
160 |
Specify a file to use for TLS session data. |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
161 |
If this file has a non-zero length, the session data will be read from this file |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
162 |
and the client will attempt to resume the TLS session with the server. |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
163 |
Upon completion of a successful TLS handshake this file will be updated with |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
164 |
new session data, if available. |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
165 |
This file will be created if it does not already exist. |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
166 |
.El |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
167 |
.Pp |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
168 |
By default, server certificate validation is performed, and if it fails |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
169 |
.Nm |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
170 |
will abort. |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
171 |
If no |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
172 |
.Cm cafile |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
173 |
or |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
174 |
.Cm capath |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
175 |
setting is provided, |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
176 |
.Pa /etc/ssl/cert.pem |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
177 |
will be used. |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
178 |
.It Fl U Ar useragent |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
179 |
Set |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
180 |
.Ar useragent |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
181 |
as the User-Agent for HTTP(S) URL requests. |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
182 |
If not specified, the default User-Agent is |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
183 |
.Dq OpenBSD ftp . |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
184 |
.It Fl V |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
185 |
Disable verbose mode. |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
186 |
.It Fl v |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
187 |
Enable verbose mode. |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
188 |
This is the default if input if from a terminal. |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
189 |
Forces |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
190 |
.Nm |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
191 |
to show all responses from the remote server, as well as report on data |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
192 |
transfer statistics. |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
193 |
.It Fl w Ar seconds |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
194 |
Abort a slow connection after |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
195 |
.Ar seconds . |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
196 |
.El |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
197 |
.Pp |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
198 |
The host with which |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
199 |
.Nm |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
200 |
is to communicate may be specified on the command line. |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
201 |
If this is done, |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
202 |
.Nm |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
203 |
will immediately attempt to establish a connection to an |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
204 |
FTP server on that host; otherwise, |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
205 |
.Nm |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
206 |
will enter its command interpreter and await instructions |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
207 |
from the user. |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
208 |
When |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
209 |
.Nm |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
210 |
is awaiting commands, the prompt |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
211 |
.Dq ftp\*(Gt |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
212 |
is provided to the user. |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
213 |
The following commands are recognized |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
214 |
by |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
215 |
.Nm : |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
216 |
.Bl -tag -width Ds |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
217 |
.It Ic open Ar host Op Ar port |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
218 |
Establish a connection to the specified |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
219 |
.Ar host |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
220 |
FTP server. |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
221 |
An optional port number may be supplied, |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
222 |
in which case |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
223 |
.Nm |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
224 |
will attempt to contact an FTP server at that port. |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
225 |
.It Ic close |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
226 |
Terminate the FTP session with the remote server and |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
227 |
return to the command interpreter. |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
228 |
.It Ic help Op Ar command |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
229 |
Print an informative message about the meaning of |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
230 |
.Ar command . |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
231 |
If no argument is given, |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
232 |
.Nm |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
233 |
prints a list of the known commands. |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
234 |
.It Ic \&? Op Ar command |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
235 |
A synonym for |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
236 |
.Ic help . |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
237 |
.It Ic quit |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
238 |
Terminate the FTP session with the remote server and exit |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
239 |
.Nm . |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
240 |
.It Ic exit |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
241 |
A synonym for |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
242 |
.Ic quit . |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
243 |
.It Ic ls Op Ar remote-directory Op Ar local-file |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
244 |
Print a listing of the contents of a directory on the remote machine. |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
245 |
The listing includes any system-dependent information that the server |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
246 |
chooses to include; for example, most |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
247 |
.Ux |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
248 |
systems will produce output from the command |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
249 |
.Ql ls -l . |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
250 |
If |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
251 |
.Ar remote-directory |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
252 |
is left unspecified, the current working directory is used. |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
253 |
If no local file is specified, or if |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
254 |
.Ar local-file |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
255 |
is |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
256 |
.Sq - , |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
257 |
the output is sent to the terminal. |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
258 |
.It Ic nlist Op Ar remote-directory Op Ar local-file |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
259 |
Print a list of the files in a |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
260 |
directory on the remote machine. |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
261 |
If |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
262 |
.Ar remote-directory |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
263 |
is left unspecified, the current working directory is used. |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
264 |
If no local file is specified, or if |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
265 |
.Ar local-file |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
266 |
is |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
267 |
.Sq - , |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
268 |
the output is sent to the terminal. |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
269 |
Note that on some servers, the |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
270 |
.Ic nlist |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
271 |
command will only return information on normal files (not directories |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
272 |
or special files). |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
273 |
.It Ic pwd |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
274 |
Print the name of the current working directory on the remote |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
275 |
machine. |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
276 |
.It Ic cd Ar remote-directory |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
277 |
Change the working directory on the remote machine |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
278 |
to |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
279 |
.Ar remote-directory . |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
280 |
.It Ic get Ar remote-file Op Ar local-file |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
281 |
Retrieve the |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
282 |
.Ar remote-file |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
283 |
and store it on the local machine. |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
284 |
If the local |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
285 |
file name is not specified, it is given the same |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
286 |
name it has on the remote machine. |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
287 |
.It Ic passive Op Ic on | off |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
288 |
Toggle passive mode. |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
289 |
If passive mode is turned on (default is on), |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
290 |
.Nm |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
291 |
will send a |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
292 |
.Dv EPSV |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
293 |
command for all data connections instead of the usual |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
294 |
.Dv EPRT |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
295 |
command. |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
296 |
The |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
297 |
.Dv EPSV |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
298 |
command requests that the remote server open a port for the data connection |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
299 |
and return the address of that port. |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
300 |
The remote server listens on that port and the client connects to it. |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
301 |
When using the more traditional |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
302 |
.Dv EPRT |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
303 |
command, the client listens on a port and sends that address to the remote |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
304 |
server, who connects back to it. |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
305 |
Passive mode is useful when using |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
306 |
.Nm |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
307 |
through a gateway router or host that controls the directionality of |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
308 |
traffic. |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
309 |
.It Ic lcd Op Ar local-directory |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
310 |
Change the working directory on the local machine. |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
311 |
If |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
312 |
no |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
313 |
.Ar local-directory |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
314 |
is specified, the user's home directory is used. |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
315 |
.It Ic lpwd |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
316 |
Print the working directory on the local machine. |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
317 |
.It Ic put Ar local-file Op Ar remote-file |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
318 |
Store a local file on the remote machine. |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
319 |
If |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
320 |
.Ar remote-file |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
321 |
is left unspecified, the local file name is used. |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
322 |
.It Ic mget Ar remote-files |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
323 |
Do a |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
324 |
.Ic get |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
325 |
for each file name specified. |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
326 |
.It Ic mput Ar local-files |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
327 |
Do a |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
328 |
.Ic put |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
329 |
for each file name specified. |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
330 |
.El |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
331 |
.Sh AUTO-FETCHING FILES |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
332 |
In addition to standard commands, this version of |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
333 |
.Nm |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
334 |
supports an auto-fetch feature. |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
335 |
To enable auto-fetch, simply pass the list of hostnames/files |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
336 |
on the command line. |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
337 |
.Pp |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
338 |
The following formats are valid syntax for an auto-fetch element: |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
339 |
.Bl -tag -width Ds |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
340 |
.Sm off |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
341 |
.It Xo ftp:// |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
342 |
.Ar host Op : Ar port |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
343 |
.No / Ar file |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
344 |
.Xc |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
345 |
.Sm on |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
346 |
An FTP URL, retrieved using the FTP protocol if |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
347 |
.Ev ftp_proxy |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
348 |
isn't defined. |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
349 |
Otherwise, transfer using HTTP via the proxy defined in |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
350 |
.Ev ftp_proxy . |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
351 |
.Sm off |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
352 |
.It Xo http:// |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
353 |
.Ar host Op : Ar port |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
354 |
.No / Ar file |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
355 |
.Xc |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
356 |
.Sm on |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
357 |
An HTTP URL, retrieved using the HTTP protocol. |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
358 |
If |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
359 |
.Ev http_proxy |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
360 |
is defined, it is used as a URL to an HTTP proxy server. |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
361 |
.Sm off |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
362 |
.It Xo https:// |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
363 |
.Ar host Op : Ar port |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
364 |
.No / Ar file |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
365 |
.Xc |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
366 |
.Sm on |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
367 |
An HTTPS URL, retrieved using the HTTPS protocol. |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
368 |
If |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
369 |
.Ev http_proxy |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
370 |
is defined, this HTTPS proxy server will be used to fetch the |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
371 |
file using the CONNECT method. |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
372 |
.It Pf file: Ar file |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
373 |
.Ar file |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
374 |
is retrieved from a mounted file system. |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
375 |
.El |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
376 |
.Sh ENVIRONMENT |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
377 |
.Nm |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
378 |
utilizes the following environment variables: |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
379 |
.Bl -tag -width Ds |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
380 |
.It Ev ftp_proxy |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
381 |
URL of FTP proxy to use when making FTP URL requests |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
382 |
(if not defined, use the standard FTP protocol). |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
383 |
.It Ev http_proxy |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
384 |
URL of HTTP proxy to use when making HTTP(S) URL requests. |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
385 |
.El |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
386 |
.Sh PORT ALLOCATION |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
387 |
For active mode data connections, |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
388 |
.Nm |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
389 |
will listen to a random high TCP port. |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
390 |
The interval of ports used are configurable using |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
391 |
.Xr sysctl 8 |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
392 |
variables |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
393 |
.Va net.inet.ip.porthifirst |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
394 |
and |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
395 |
.Va net.inet.ip.porthilast . |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
396 |
.Sh HISTORY |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
397 |
The |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
398 |
.Nm |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
399 |
command first appeard in |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
400 |
.Bx 4.2 . |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
401 |
A complete rewrite of the |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
402 |
.Nm |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
403 |
command first appeared in |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
404 |
.Ox x.x . |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
405 |
.Sh AUTHORS |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
406 |
.An Sunil Nimmagadda Aq Mt sunil@openbsd.org |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
407 |
.Sh CAVEATS |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
408 |
While aborting a data transfer, certain FTP servers violate |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
409 |
the protocol by not responding with a 426 reply first, thereby making |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
410 |
.Nm |
1d0ce1ebbc72
An HTTP(S), FTP client.
Sunil Nimmagadda <sunil@nimmagadda.net>
parents:
diff
changeset
|
411 |
wait indefinitely for a correct reply. |