Lines Matching +full:ascii +full:. +full:r
1 .\" $NetBSD: ftp.1,v 1.18 2021/08/27 01:38:49 lukem Exp $
2 .\" from NetBSD: ftp.1,v 1.146 2021/04/25 09:09:55 lukem Exp
3 .\"
4 .\" Copyright (c) 1996-2021 The NetBSD Foundation, Inc.
5 .\" All rights reserved.
6 .\"
7 .\" This code is derived from software contributed to The NetBSD Foundation
8 .\" by Luke Mewburn.
9 .\"
10 .\" Redistribution and use in source and binary forms, with or without
11 .\" modification, are permitted provided that the following conditions
12 .\" are met:
13 .\" 1. Redistributions of source code must retain the above copyright
14 .\" notice, this list of conditions and the following disclaimer.
15 .\" 2. Redistributions in binary form must reproduce the above copyright
16 .\" notice, this list of conditions and the following disclaimer in the
17 .\" documentation and/or other materials provided with the distribution.
18 .\"
19 .\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
20 .\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
21 .\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
22 .\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
23 .\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
24 .\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
25 .\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
26 .\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
27 .\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
28 .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
29 .\" POSSIBILITY OF SUCH DAMAGE.
30 .\"
31 .\"
32 .\" Copyright (c) 1985, 1989, 1990, 1993
33 .\" The Regents of the University of California. All rights reserved.
34 .\"
35 .\" Redistribution and use in source and binary forms, with or without
36 .\" modification, are permitted provided that the following conditions
37 .\" are met:
38 .\" 1. Redistributions of source code must retain the above copyright
39 .\" notice, this list of conditions and the following disclaimer.
40 .\" 2. Redistributions in binary form must reproduce the above copyright
41 .\" notice, this list of conditions and the following disclaimer in the
42 .\" documentation and/or other materials provided with the distribution.
43 .\" 3. Neither the name of the University nor the names of its contributors
44 .\" may be used to endorse or promote products derived from this software
45 .\" without specific prior written permission.
46 .\"
47 .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
48 .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
49 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
50 .\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
51 .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
52 .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
53 .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
54 .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
55 .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
56 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
57 .\" SUCH DAMAGE.
58 .\"
59 .\" @(#)ftp.1 8.3 (Berkeley) 10/9/94
60 .\"
74 .Op Fl r Ar retry
77 .\" [-T dir,max[,inc]]
90 .\" [[user@]host [port]]
92 .Oo Ar user Ns Li \&@ Oc Ns Ar host Oo Ar port Oc
96 .\" [[user@]host:[path][/]]
99 .Op Ar user Li \&@
100 .Ar host Li \&:
107 .\" [file:///path]
115 .\" [ftp://[user[:password]@]host[:port]/path[/]]
120 .Op Li \&: Ar password
121 .Li \&@ Oc
122 .Ar host Oo Li \&: Ar port Oc
130 .\" [http://[user[:password]@]host[:port]/path]
135 .Op Li \&: Ar password
136 .Li \&@ Oc
137 .Ar host Oo Li \&: Ar port Oc
143 .\" [https://[user[:password]@]host[:port]/path]
148 .Op Li \&: Ar password
149 .Li \&@ Oc
150 .Ar host Oo Li \&: Ar port Oc
155 .Ar \&...
162 is the user interface to the Internet standard File Transfer Protocol.
164 remote network site.
170 protocols, or by direct copying, into the current directory.
171 This is ideal for scripts.
174 below for more information.
177 command interpreter.
182 to only use IPv4 addresses.
186 to only use IPv6 addresses.
189 .Tn FTP .
195 if passive is not supported by the server.
198 to always use an active connection.
200 implement passive mode properly.
204 to bypass normal login procedure, and use an anonymous login instead.
206 Enables debugging.
208 Disables command line editing.
209 This is useful for Emacs ange-ftp mode.
215 proxies.
217 Disables file name globbing.
220 multiple file transfers.
225 .Pa ~/.netrc .
227 .Sx THE .netrc FILE
228 for more information.
234 upon initial connection for non auto-fetch transfers.
238 .Pa .netrc
240 an account on the remote machine.
245 and an account with which to login.
247 username (and optionally, password) as appropriate.
250 .Ar output .
254 below.
260 .Sq \&| ,
264 remote name.
267 .Ar port .
269 Enable passive mode operation for use behind connection filtering firewalls.
273 if the server does not support passive connections.
277 seconds.
278 .It Fl R
279 Restart all non-proxied auto-fetches.
280 .It Fl r Ar wait
283 seconds.
287 as the local IP address for all connections.
289 Enables packet tracing.
298 bytes/second.
301 for more information.
312 is one or more local files to be uploaded.
318 overriding the default of enabled when output is to a terminal.
323 .Ic progress .
327 is the foreground process).
331 as report on data transfer statistics.
334 .Ar xfersize .
337 for more information.
339 Display help to stdout, and exit.
344 is to communicate may be specified on the command line.
352 from the user.
357 is provided to the user.
362 .It Ic \&! Op Ar command Op Ar args
363 Invoke an interactive shell on the local machine.
365 directly, with the rest of the arguments as its arguments.
366 .It Ic \&$ Ar macro-name Op Ar args
371 command.
372 Arguments are passed to the macro unglobbed.
375 to resources once a login has been successfully completed.
377 password in a non-echoing input mode.
379 Append a local file to a file on the remote machine.
387 setting.
393 .Ic structure .
394 .It Ic ascii
398 .Tn ASCII .
399 This is the default type.
402 command is completed.
406 to support binary image transfer.
412 .Nm ftp .
413 An end of file will also terminate the session and exit.
420 commands.
425 to lower case.
426 .It Ic \&cd Ar remote-directory
429 .Ar remote-directory .
432 current remote machine working directory.
438 .Ar mode .
443 return to the command interpreter.
444 Any defined macros are erased.
445 .It Ic \&cr
447 ascii type file retrieval.
449 during ascii type file transfer.
451 .Ic \&cr
456 delimiter.
460 when an ascii type transfer is made, these linefeeds may be
462 .Ic \&cr
463 is off.
465 Toggle debugging mode.
468 is specified it is used to set the debugging level.
473 .Ql \-\-> .
477 on the remote machine.
480 directory on the remote machine.
486 .Ql ls \-l .
489 is left unspecified, the current working directory is used.
495 output.
500 the output is sent to the terminal.
503 .Ic close .
506 completion.
508 disabled otherwise.
514 commands on all IP, IPv4, and IPv6 connections respectively.
518 .Dv PASV Ns \^/\^ Ns Dv PORT .
519 This is enabled by default.
526 is executed again.
529 .Ic bye .
533 command).
537 which has one line per filename.
542 .Ar format .
545 .Dq non-print .
548 .Ic open .
553 proxies.
557 environment variable).
562 .Ar host .
566 gate-ftp server.
570 and store it on the local machine.
579 settings.
586 are used while transferring the file.
593 .Ic mreget .
597 are taken literally and not expanded.
601 .Xr csh 1 .
608 separately on the remote machine and the lists are not merged.
615 .Sq Li mls remote-files \- .
622 entire directory subtrees of files.
626 archive of the subtree (in binary mode).
630 printing for each data block transferred.
631 The size of a data block defaults to 1024 bytes.
634 in bytes.
638 .Ic progress .
641 .Ar command .
644 prints a list of the known commands.
648 seconds.
651 is omitted, the current inactivity timer is printed.
654 .Ic binary .
656 Change the working directory on the local machine.
660 is specified, the user's home directory is used.
663 .Ic page .
669 option.
671 Print the working directory on the local machine.
672 .It Ic \&ls Op Ar remote-path Op Ar local-file
674 .Ic dir .
676 Define a macro.
680 returns from the terminal) terminates macro input mode.
682 defined macros.
683 Macro names can be a maximum of 8 characters.
690 command is executed.
693 command (see above).
699 as special characters.
703 corresponding argument on the macro invocation command line.
709 looped.
714 and so on.
717 followed by any character is replaced by that character.
721 .Ql $ .
725 on the remote machine.
729 except multiple remote files may be specified.
735 output.
742 for each file name thus produced.
745 for details on the filename expansion.
751 settings.
756 .Sq Li "\&! mkdir directory" .
758 Make a directory on the remote machine.
765 must be specified.
771 output.
777 .Dv MLSD .
779 .Sq Li "remopts mlst ..." .
785 .Dv MLST .
787 .Sq Li "remopts mlst ..." .
792 .Ar mode-name .
795 .Dq stream .
799 format.
802 .Ic page .
807 for each file in the resulting list.
810 for details of filename expansion.
815 settings.
822 .Ic get .
825 .Ic mput .
828 recent that the file on the current system.
831 .Ic newer .
833 .Ic get .
836 .Ic ls .
838 Set or unset the filename mapping mechanism.
839 If no arguments are specified, the filename mapping mechanism is unset.
844 commands issued without a specified remote target filename.
849 commands issued without a specified local target filename.
853 with different file naming conventions or practices.
857 .Ar outpattern .
865 settings).
870 \&...\|,
873 .Ar inpattern .
878 character.
882 variable values.
885 .Sq Li $1.$2
887 .Sq Li mydata.data ,
894 .Sq Li data .
898 determines the resulting mapped filename.
902 \&...\|,
906 template.
909 is replaced by the original filename.
917 .Ar seq2 .
920 .Dl nmap $1.$2.$3 [$1,$2].[$2,file]
924 .Sq Li myfile.data
926 .Sq Li myfile.data
928 .Sq Li myfile.data.old ,
929 .Sq Li myfile.file
933 .Sq Li myfile.myfile
935 .Sq Li "\&.myfile" .
947 .Ql \&[ ,
948 .Ql \&] ,
950 .Ql \&,
951 characters.
953 Set or unset the filename character translation mechanism.
955 translation mechanism is unset.
961 commands issued without a specified remote target filename.
967 commands issued without a specified local target filename.
971 with different file naming conventions or practices.
975 .Ar outchars .
980 the character is deleted from the file name.
985 server.
991 server at that port.
999 server (see below).
1005 option.
1007 Toggle passive mode (if no arguments are given).
1013 .Sq auto .
1020 command.
1024 and return the address of that port.
1025 The remote server listens on that port and the client connects to it.
1029 server, who connects back to it.
1033 traffic.
1040 some do not.)
1047 option.
1054 option.
1061 option.
1063 Toggle preservation of modification times on retrieved files.
1065 Toggle display of transfer progress bar.
1071 .Ql \&| .
1074 for more information.
1078 .Ic hash .
1080 Toggle interactive prompting.
1083 user to selectively retrieve or store files.
1090 will delete all files.
1099 to any remaining files for the current command.
1103 and do not transfer the file.
1110 had been given).
1112 Terminate the current operation.
1116 and transfer the file.
1117 .It Cm \&?
1118 Display a help message.
1123 to the current file.
1127 command on a secondary control connection.
1130 servers for transferring files between the two servers.
1135 to establish the secondary control connection.
1140 commands executable on the secondary connection.
1157 to the host on the primary control connection.
1162 command by the server on the secondary control connection.
1164 Store a local file on the remote machine.
1173 in naming the remote file.
1180 .Ic structure .
1183 machine.
1186 .Ic bye .
1187 .It Ic quote Op Ar arg ...
1190 server.
1194 bytes/second.
1197 is 0, disable the throttle.
1201 .Bl -tag -width ".Cm all" -offset indent -compact
1203 Both directions.
1205 Incoming transfers.
1207 Outgoing transfers.
1214 .Bl -tag -width ".Dv SIGUSR1" -offset indent
1220 bytes.
1226 bytes.
1227 The result must be a positive number.
1232 is not supplied, the current throttle rates are displayed.
1236 is not yet implemented for ascii mode transfers.
1239 .Ar size .
1242 .Ic get .
1257 is continued from the apparent point of failure.
1260 are prone to dropping connections.
1268 (whose absence is handled on a command-specific basis).
1276 .Dv MLST ) .
1281 .Ar to .
1283 Clear reply queue.
1286 server.
1289 protocol by the remote server.
1297 .Ar marker .
1301 offset into the file.
1305 server.
1308 is specified it is supplied to the server as well.
1310 Delete a directory on the remote machine.
1312 With no arguments, show status of remote machine.
1317 on remote machine.
1319 Toggle storing of files on the local system with unique filenames.
1326 .Ql \&.1
1327 is appended to the name.
1330 .Ql \&.2
1331 is appended to the original name.
1333 .Ql .99 ,
1335 message is printed, and the transfer does not take place.
1336 The generated unique filename will be reported.
1340 (see below).
1341 The default value is off.
1344 .Ic put .
1348 commands.
1354 a connection for each data transfer.
1358 when performing multiple file transfers.
1363 will use the default data port.
1368 commands for each data transfer.
1374 commands but, incorrectly, indicate they've been accepted.
1379 .Ar value .
1384 are not given, display all of the options and their values.
1392 .Ev $ftp_proxy .
1395 .Ev $http_proxy .
1398 .Ev $https_proxy .
1401 .Ev $no_proxy .
1404 .Ev $PAGER .
1407 .Ev $FTPPROMPT .
1410 .Ev $FTPRPROMPT .
1412 .It Ic site Op Ar arg ...
1417 command.
1421 on remote machine.
1424 .Ar size .
1427 .Nm ftp .
1432 .Ar struct-name .
1435 .Dq file .
1437 Toggle storing of files on remote machine under unique file names.
1445 successful completion.
1446 The remote server will report unique name.
1447 Default value is off.
1449 Show the type of operating system running on the remote machine.
1454 machines.
1457 .Ic rate .
1459 Toggle packet tracing.
1464 .Ar type-name .
1466 is printed.
1468 .Tn ASCII .
1471 .Ar newmask .
1474 is omitted, the current umask is printed.
1477 .Ar option .
1480 for more information.
1483 .Ar command .
1487 server.
1492 will prompt the user for it (after disabling local echo).
1498 requires it, the user will be prompted for it.
1504 for logging in.
1511 server.
1513 Toggle verbose mode.
1517 server are displayed to the user.
1520 regarding the efficiency of the transfer are reported.
1522 verbose is on.
1525 .Ar size .
1526 .It Ic \&? Op Ar command
1528 .Ic help .
1533 .Ql \&\(dq
1534 marks.
1540 argument to force the setting appropriately.
1543 (e.g.,
1549 interpretation of the argument.
1553 Causes no modification.
1575 same format as the standard completion message.
1579 supports an auto-fetch feature.
1581 on the command line.
1585 .\" [user@]host:[path][/]
1586 .It Oo Ar user Ns Li \&@ Oc Ns Ar host Ns Li \&: Ns Oo Ar path Oc \
1590 format.
1599 is performed.
1608 in the current directory.
1610 relative to the local root directory.
1611 .\" ftp://[user[:password]@]host[:port]/path[/][;type=type]
1612 .It Li ftp:// Ns Oo Ar user Ns Oo Ns Li \&: Ns Ar password Oc Ns Li \&@ Oc \
1613 Ns Ar host Ns Oo Li \&: Ns Ar port Oc Ns Li / Ns Ar path Ns Oo Li / Oc \
1621 isn't defined.
1625 .Ic "set ftp_proxy" .
1631 .Ar user .
1634 if supplied, otherwise prompt the user for one.
1637 .Sq Li \&;type=A
1639 .Sq Li \&;type=I
1641 ascii or binary (respectively).
1642 The default transfer type is binary.
1657 .Ar host Ns Oo Li \&: Ns Ar port Oc
1662 itself.
1668 list of name components.
1673 command.
1678 command.
1691 command without a directory name.
1692 This is unlikely to be useful.
1695 .Sq Li \&% Ns Ar XX
1697 (per
1701 representing a character code in hexadecimal.
1709 command.
1711 .Sq Li \&%2F
1715 .Sq Li \&%7E
1717 .Sq Li ~ ) .
1726 user.
1730 .Sq Li \&%2F .
1733 .Sq Li \&%7E Ns Ar user Ns Li / .
1753 .Sq Li \&%2F
1755 .Sq Li %2f ) .
1762 .Dq "get file" .
1766 .Dq "get file" .
1769 .Dq "get file" .
1772 .Dq "get file" .
1774 .Dq "get dir1/dir2/file" .
1776 .Dq "get /dir1/dir2/file" .
1782 command.
1784 .\" http://[user[:password]@]host[:port]/path
1785 .It Li http:// Ns Oo Ar user Ns Oo Li \&: Ns Ar password Oc Ns Li \&@ Oc \
1786 Ns Ar host Ns Oo Li \&: Ns Ar port Oc Ns Li / Ns Ar path
1791 protocol.
1796 proxy server.
1805 is in the URL, use them for the first attempt to authenticate.
1806 .\" https://[user[:password]@]host[:port]/path
1807 .It Li https:// Ns Oo Ar user Ns Oo Li \&: Ns Ar password Oc Ns Li \&@ Oc \
1808 Ns Ar host Ns Oo Li \&: Ns Ar port Oc Ns Li / Ns Ar path
1813 protocol.
1818 proxy server.
1827 is in the URL, use them for the first attempt to authenticate.
1828 There is currently no certificate validation and verification.
1829 .\" file:///path
1833 on the local host.
1834 .\" about:
1838 no file is retrieved for this auto-fetched element.
1843 .Nm ftp .
1846 .Nm ftp .
1847 Useful to provide when reporting problems.
1856 .Ar path .
1861 .Ar path .
1864 is recommended, to avoid writing to unexpected file names.
1877 mode ready for further input.
1880 is being used.
1884 transfers use HTTP 1.1.
1889 transfers use HTTP 1.0.
1892 .Fl R
1897 proxies will be restarted.
1903 .Ic get .
1909 directive.
1912 to enter a username and password to authenticate with.
1915 surround the address in square brackets.
1916 E.g.:
1917 .Sq Li ftp://[::1]:21/ .
1919 being the separator for the port number.
1922 (usually Ctrl-C).
1923 Sending transfers will be immediately halted.
1928 command to the remote server, and discarding any further data received.
1932 processing.
1936 sending the requested file.
1943 then the connection will be closed.
1945 terminal interrupt during this phase), but is considered more useful.
1949 commands are processed according to the following rules.
1956 (for reading) or
1958 (for writing) is used.
1961 .Ql \&| ,
1963 remainder of the argument is interpreted as a shell command.
1968 (stdin).
1970 must be quoted; e.g.
1971 .Sq Li \(dq|\~ls\~\-lt\(dq .
1974 .Sq Li dir\~\(dq\(dq\~|more .
1982 command.
1985 command expects a single local file (e.g.
1987 only the first filename generated by the globbing operation is used.
1999 setting.
2002 is on.
2013 setting.
2016 is on.
2021 specification specifies many parameters which may affect a file transfer.
2025 .Dq ascii ,
2031 (for
2035 mostly).
2037 supports the ascii and image types of file transfer,
2040 mode transfers.
2048 .Ic struct .
2049 .Sh THE .netrc FILE
2051 .Pa .netrc
2053 used by the auto-login process.
2059 environment variable.
2065 .Ar name .
2067 .Pa .netrc
2074 command argument.
2076 .Pa .netrc
2082 token is encountered.
2089 matches any name.
2094 tokens.
2103 .Pa .netrc .
2107 flag to disable auto-login.
2109 Identify a user on the remote machine.
2112 .Ar name .
2114 Supply a password.
2117 of the login process.
2119 .Pa .netrc
2125 .Pa .netrc
2127 anyone besides the user.
2129 Supply an additional account password.
2134 command if it does not.
2136 Define a macro.
2140 command functions.
2143 .Pa .netrc
2145 characters) is encountered.
2147 .Pa .netrc
2152 definition preceding it.
2159 it is intended to be used with.
2163 auto-login process.
2171 followed by a blank line.
2177 library.
2180 command, and is enabled by default if input is from a tty.
2182 and other GNU Emacs-style editing keys may be used as well.
2187 .Pa .editrc
2190 for more information.
2195 (including remote file completion).
2199 .Ic ftp-complete .
2200 By default, this is bound to the TAB key.
2206 to the user.
2209 command.
2214 command.
2219 .It Li \&%/
2220 The current remote working directory.
2221 .\" %c[[0]n], %.[[0]n]
2222 .It Li \&%c Ns Oo Oo Li 0 Oc Ns Ar n Oc , Li \&%. Ns Oo Oo Li 0 Oc Ns Ar n Oc
2227 is given.
2234 .\" ``/<number>trailing''
2241 (for
2242 .Ql \&%c )
2244 .\" ``...trailing''
2245 .Dq Li \&... Ns Ar trailing
2246 (for
2247 .Ql \&%. ) .
2248 .It Li \&%M
2249 The remote host name.
2250 .It Li \&%m
2252 .Ql \&. .
2253 .It Li \&%n
2254 The remote user name.
2255 .It Li \&%%
2257 .Ql % .
2261 uses the following environment variables.
2266 transfer.
2268 .Dq Li \&\`whoami\`@ .
2270 Overrides the default operation mode.
2287 Command-line prompt to use.
2289 .Sq Li ftp>\~ .
2292 for more information.
2294 Command-line right side prompt to use.
2295 Defaults to empty string.
2298 for more information.
2302 is enabled.
2306 is enabled.
2310 .Dq Li ftpgate/tcp .
2315 header.
2318 .Pa .netrc
2319 file, if one exists.
2322 .Pa .netrc
2323 file.
2325 Used by various commands to display files.
2328 if empty or not set.
2330 For default shell.
2339 protocol).
2343 for further notes about proxy use.
2349 URL requests.
2352 attempt to authenticate to the proxy.
2357 (for example
2363 .Sq Li \&% Ns Ar XX
2364 encoding.
2372 .Xr lynx 1 ) .
2376 fetches.
2382 URL requests.
2386 for further notes about proxy use.
2389 proxying is not to be used.
2391 .Sq Li \&: Ns Ar port ,
2393 the matching to connections to that port.
2398 to use extended passive mode.
2406 .Ic epsv4 off .
2408 .Sx The .netrc File
2409 for an example of how to make this automatic.
2442 .Bx 4.2 .
2456 .Aq lukem@NetBSD.org .
2460 if the operating system supports IPv6 in a similar manner to KAME).
2463 by the remote server.
2468 ascii-mode transfer code
2469 has been corrected.
2473 servers using the ascii type.
2474 Avoid this problem by using the binary image type.
2480 .Li ::ffff:10.1.1.1
2484 sockets.
2485 However, in certain IPv6 network configurations, this assumption is not true.
2488 sockets directly.
2491 is unable to support your configuration.