| @@ -1,21 +1,21 @@ | | | @@ -1,21 +1,21 @@ |
1 | FETCH(1) NetBSD General Commands Manual FETCH(1) | | 1 | FETCH(1) NetBSD General Commands Manual FETCH(1) |
2 | | | 2 | |
3 | NNAAMMEE | | 3 | NNAAMMEE |
4 | ffeettcchh -- retrieve a file by Uniform Resource Locator | | 4 | ffeettcchh -- retrieve a file by Uniform Resource Locator |
5 | | | 5 | |
6 | SSYYNNOOPPSSIISS | | 6 | SSYYNNOOPPSSIISS |
7 | ffeettcchh [--114466AAFFMMRRUUaaddiillmmnnqqrrssvv] [--BB _b_y_t_e_s] [--SS _b_y_t_e_s] [--TT _s_e_c_o_n_d_s] [--NN _f_i_l_e] | | 7 | ffeettcchh [--114466AAFFMMRRUUaaddiillmmnnqqrrssvv] [--BB _b_y_t_e_s] [--NN _f_i_l_e] [--oo _f_i_l_e] [--SS _b_y_t_e_s] |
8 | [--oo _f_i_l_e] [--ww _s_e_c_o_n_d_s] [_U_R_L _._._.] | | 8 | [--TT _s_e_c_o_n_d_s] [--ww _s_e_c_o_n_d_s] [_U_R_L _._._.] |
9 | | | 9 | |
10 | DDEESSCCRRIIPPTTIIOONN | | 10 | DDEESSCCRRIIPPTTIIOONN |
11 | The ffeettcchh utility provides a command-line interface to the fetch(3) | | 11 | The ffeettcchh utility provides a command-line interface to the fetch(3) |
12 | library. Its purpose is to retrieve the file(s) pointed to by the URL(s) | | 12 | library. Its purpose is to retrieve the file(s) pointed to by the URL(s) |
13 | on the command line. | | 13 | on the command line. |
14 | | | 14 | |
15 | The following options are available: | | 15 | The following options are available: |
16 | | | 16 | |
17 | --11 Stop and return exit code 0 at the first successfully | | 17 | --11 Stop and return exit code 0 at the first successfully |
18 | retrieved file. | | 18 | retrieved file. |
19 | | | 19 | |
20 | --44 Forces ffeettcchh to use IPv4 addresses only. | | 20 | --44 Forces ffeettcchh to use IPv4 addresses only. |
21 | | | 21 | |
| @@ -92,53 +92,53 @@ DDEESSCCRRIIPPTTIIOONN | | | @@ -92,53 +92,53 @@ DDEESSCCRRIIPPTTIIOONN |
92 | nection from the low (default) port range. See ip(4) for | | 92 | nection from the low (default) port range. See ip(4) for |
93 | details on how to specify which port range this corresponds | | 93 | details on how to specify which port range this corresponds |
94 | to. | | 94 | to. |
95 | | | 95 | |
96 | --vv Increase verbosity level. | | 96 | --vv Increase verbosity level. |
97 | | | 97 | |
98 | --ww _s_e_c_o_n_d_s When the --aa flag is specified, wait this many seconds between | | 98 | --ww _s_e_c_o_n_d_s When the --aa flag is specified, wait this many seconds between |
99 | successive retries. | | 99 | successive retries. |
100 | | | 100 | |
101 | If ffeettcchh receives a SIGINFO signal (see the ssttaattuuss argument for stty(1)), | | 101 | If ffeettcchh receives a SIGINFO signal (see the ssttaattuuss argument for stty(1)), |
102 | the current transfer rate statistics will be written to the standard | | 102 | the current transfer rate statistics will be written to the standard |
103 | error output, in the same format as the standard completion message. | | 103 | error output, in the same format as the standard completion message. |
104 | | | 104 | |
| | | 105 | EEXXIITT SSTTAATTUUSS |
| | | 106 | The ffeettcchh command returns zero on success, or one on failure. If multi- |
| | | 107 | ple URLs are listed on the command line, ffeettcchh will attempt to retrieve |
| | | 108 | each one of them in turn, and will return zero only if they were all suc- |
| | | 109 | cessfully retrieved. |
| | | 110 | |
105 | EENNVVIIRROONNMMEENNTT | | 111 | EENNVVIIRROONNMMEENNTT |
106 | FTP_TIMEOUT Maximum time, in seconds, to wait before aborting an FTP | | 112 | FTP_TIMEOUT Maximum time, in seconds, to wait before aborting an FTP |
107 | connection. | | 113 | connection. |
108 | | | 114 | |
109 | HTTP_TIMEOUT Maximum time, in seconds, to wait before aborting an HTTP | | 115 | HTTP_TIMEOUT Maximum time, in seconds, to wait before aborting an HTTP |
110 | connection. | | 116 | connection. |
111 | | | 117 | |
112 | See fetch(3) for a description of additional environment variables, | | 118 | See fetch(3) for a description of additional environment variables, |
113 | including FETCH_BIND_ADDRESS, FTP_LOGIN, FTP_PASSIVE_MODE, FTP_PASSWORD, | | 119 | including FETCH_BIND_ADDRESS, FTP_LOGIN, FTP_PASSIVE_MODE, FTP_PASSWORD, |
114 | FTP_PROXY, ftp_proxy, HTTP_AUTH, HTTP_PROXY, http_proxy, HTTP_PROXY_AUTH, | | 120 | FTP_PROXY, ftp_proxy, HTTP_AUTH, HTTP_PROXY, http_proxy, HTTP_PROXY_AUTH, |
115 | HTTP_REFERER, HTTP_USER_AGENT, NETRC, NO_PROXY and no_proxy. | | 121 | HTTP_REFERER, HTTP_USER_AGENT, NETRC, NO_PROXY and no_proxy. |
116 | | | 122 | |
117 | EEXXIITT SSTTAATTUUSS | | | |
118 | The ffeettcchh command returns zero on success, or one on failure. If multi- | | | |
119 | ple URLs are listed on the command line, ffeettcchh will attempt to retrieve | | | |
120 | each one of them in turn, and will return zero only if they were all suc- | | | |
121 | cessfully retrieved. | | | |
122 | | | | |
123 | SSEEEE AALLSSOO | | 123 | SSEEEE AALLSSOO |
124 | fetch(3) | | 124 | fetch(3) |
125 | | | 125 | |
126 | HHIISSTTOORRYY | | 126 | HHIISSTTOORRYY |
127 | The ffeettcchh command appeared in FreeBSD 2.1.5. This implementation first | | 127 | The ffeettcchh command appeared in FreeBSD 2.1.5. This implementation first |
128 | appeared in FreeBSD 4.1. | | 128 | appeared in FreeBSD 4.1. |
129 | | | 129 | |
130 | AAUUTTHHOORRSS | | 130 | AAUUTTHHOORRSS |
131 | The original implementation of ffeettcchh was done by Jean-Marc Zucconi | | 131 | The original implementation of ffeettcchh was done by Jean-Marc Zucconi |
132 | <jmz@FreeBSD.org>. It was extensively re-worked for FreeBSD 2.2 by | | 132 | <jmz@FreeBSD.org>. It was extensively re-worked for FreeBSD 2.2 by |
133 | Garrett Wollman <wollman@FreeBSD.org>, and later completely rewritten to | | 133 | Garrett Wollman <wollman@FreeBSD.org>, and later completely rewritten to |
134 | use the fetch(3) library by Dag-Erling Sm/orgrav <des@FreeBSD.org>. | | 134 | use the fetch(3) library by Dag-Erling Sm/orgrav <des@FreeBSD.org>. |
135 | | | 135 | |
136 | NNOOTTEESS | | 136 | NNOOTTEESS |
137 | The --bb and --tt options are no longer supported and will generate warnings. | | 137 | The --bb and --tt options are no longer supported and will generate warnings. |
138 | They were workarounds for bugs in other OSes which this implementation | | 138 | They were workarounds for bugs in other OSes which this implementation |
139 | does not trigger. | | 139 | does not trigger. |
140 | | | 140 | |
141 | One cannot both use the --hh, --cc and --ff options and specify URLs on the | | 141 | One cannot both use the --hh, --cc, and --ff options and specify URLs on the |
142 | command line. | | 142 | command line. |
143 | | | 143 | |
144 | NetBSD 5.0 March 11, 2003 NetBSD 5.0 | | 144 | NetBSD 5.0 February 5, 2009 NetBSD 5.0 |