opendir change: refinement
[minix.git] / commands / ftp101 / ftp.1
blob078b6a81351d36d548e0030dbeecb7cc104aa4a5
1 .TH FTP 1
2 .SH NAME
3 ftp \- a File Transfer Protocol client for Minix
4 .SH SYNOPSIS
5 .B ftp
6 .RI [ server_name ]
7 .SH DESCRIPTION
8 .B Ftp
9 is a File Transfer Protocol client for Minix written by Michael Temari.  
11 There are no command line options for 
12 .B ftp
13 except for the optional server name, which may be either a numeric IP address 
14 or a domain name resolvable by DNS.
16 If a server name is specified a connection attempt will be made, and you 
17 will be prompted for a user name and password by the remote system. 
18 Following the login (or immediately, if no server name was specified), the
19 .br
20 .B ftp>
21 .br 
22 prompt is displayed. The following commands are accepted at the prompt:
24 Command:      Description
25 .br
26 !             Escape to a shell
27 .br
28 append        Append a file to remote host
29 .br
30 ascii         Set file transfer type to ascii
31 .br
32 binary        Set file transfer type to binary
33 .br
34 block         Set file transfer mode to block
35 .br
36 bye           Close connection and exit
37 .br
38 cd            Change directory on remote host
39 .br
40 close         Close connection
41 .br
42 clone         Clone a file
43 .br
44 del           Remove file on remote host
45 .br
46 dir           Display long form remote host directory listing
47 .br
48 exit          Close connection and exit
49 .br
50 get           Retrieve a file from remote host
51 .br
52 help          Display this text
53 .br
54 lcd           Change directory on local host
55 .br
56 ldir          Display long form local host directory listing
57 .br
58 lls           Display local host directory listing
59 .br
60 lmkdir        Create directory on local host
61 .br
62 lpwd          Display current directory on local host
63 .br
64 lrmdir        Remove directory on local host
65 .br
66 ls            Display remote host directory listing
67 .br
68 mget          Retrieve multiple files from remote host
69 .br
70 mkdir         Create directory on remote host
71 .br
72 mod           Get file modification time
73 .br
74 mput          Send multiple files to remote host
75 .br
76 noop          Send the ftp NOOP command
77 .br
78 open          Open connection to remote host
79 .br
80 pass          Enter remote user password
81 .br
82 passive       Toggle passive mode
83 .br
84 put           Send a file to remote host
85 .br
86 putu          Send a file to remote host(unique)
87 .br
88 pwd           Display current directory on remote host
89 .br
90 quit          Close connection and exit
91 .br
92 quote         Send raw ftp command to remote host
93 .br
94 reget         Restart a partial file retrieve from remote host
95 .br
96 remotehelp    Display ftp commands implemented on remote host
97 .br
98 reput         Restart a partial file send to remote host
99 .br
100 rm            Remove file on remote host
102 rmdir         Remove directory on remote host
104 site          Send a site specific command
106 size          Get file size information
108 status        Get connection/file status information
110 stream        Set file transfer mode to stream
112 system        Get remote system type information
114 user          Enter remote user information
116 ver           Display client version information
118 .SH "SEE ALSO"
119 .BR ftpd (8),
120 .BR ftpget (1).
121 .SH NOTES
122 The FTP protocol passes unencrypted usernames and passwords to clients,
123 so they are potentially exposed to evildoers with network sniffers. So be 
124 wary of using this to exchange files between your own accounts. Obviously 
125 if you have a root account on another system and the remote system will 
126 accept a login as root this is extremely dangerous. (Many ftp servers will
127 not allow a connection by root).
129 Text-mode (ASCII) transfers are the default mode, be sure to enter the 
130 "binary" command if you are downloading a program file or a compressed 
131 archive, in fact anything other than a text file from a machine with a
132 different text-file format than Minix uses.
134 If you are behind a firewall you probably need to use passive mode to 
135 successfully transfer files.
137 .SH BUGS
138 None are known, but there may be some unknown ones. Version 1.00 corrects
139 a bug in previous versions that would append a \\r (0xd) character to file
140 names on the destination when an mget transfer was used in binary mode.
142 .SH AUTHOR
143 The Minix httpd server was created by and is maintained by Michael Temari
144 <Michael@TemWare.Com>. The earliest version was released in 1992, for use
145 with Michael's TNet networking extensions for Minix 1.5. 
147 Man page compiled by Al Woodhull <asw@woodhull.com>
148 .\" updated 2006-06-18