home *** CD-ROM | disk | FTP | other *** search
/ Just Call Me Internet / Just Call Me Internet.iso / docs / ascii / internet / nhelp411 / ftp < prev    next >
Encoding:
Text File  |  1992-12-30  |  13.3 KB  |  350 lines
  1. ===                                                 NOSview [301]
  2. ftp
  3. ===
  4.  
  5. _________________________________________________________________
  6. ftp <host>
  7. _________________________________________________________________
  8. The command 'ftp' is used to initiate an FTP session with <host>.
  9. When the session is established, you will enter converse mode on
  10. the new FTP session.
  11.  
  12. When in converse mode with an FTP server, only the FTP sub-
  13. commands described below will be valid.  This will remain true
  14. until the FTP 'quit' command is issued, ending the FTP session,
  15. and returning you to the "net>" prompt.
  16.  
  17. When the connection between the two machines is opened, you'll
  18. get a banner from the remote machine, followed by a prompt for
  19. your user name and then your password.  If you've negotiated with
  20. the person at the remote machine to have a special user name and
  21. password set up for you in his or her FTPUSERS file, use that.
  22. (See NOSfiles\FTPUSERS for an example of the file).
  23.  
  24. If not, use one of the special user names, "anonymous" or "guest"
  25. or "bbs", and in this case, use your callsign as your password.
  26. Your password is recorded in the log file on the remote host,
  27. allowing the manager of that host to keep track of FTP activity.
  28.  
  29. To perform an automatic login to selected hosts, you can set up
  30. the NET.RC file.  Each line in the file contains the hostname,
  31. user login name and password, each item separated by a space.
  32. (See NOSfiles\NET.RC for an example of this file).
  33.  
  34.  
  35. ===============
  36. FTP SUBCOMMANDS
  37. ===============
  38. During converse mode with an FTP server, everything typed on the
  39. console is first examined to see if it is a locally-known
  40. command.  If not, the line is passed intact to the remote server
  41. on the control channel.
  42.  
  43. However, if it is one of the following commands, it is executed
  44. locally.
  45.  
  46.  
  47. -----------------------------------------------------------------
  48. abort
  49. -----------------------------------------------------------------
  50. Aborts a 'get/mget', 'put/mput', 'dir/ls' operation in progress.
  51. This is the only acceptable command when these operations are in
  52. progress; all other commands will result in an error message.
  53.  
  54. Abort is valid only when a transfer is in progress.  When a 'get'
  55. or 'put' operation is aborted, a partial copy of the transferred
  56. file will be left on the destination machine.  This copy must be
  57. removed manually if it is unwanted.
  58.  
  59. This is also true for a 'dir' or 'ls' operation when the
  60. directory listing is written as a local file.
  61.  
  62.  
  63. -----------------------------------------------------------------
  64. ascii
  65. -----------------------------------------------------------------
  66. Sets the file transfer mode to ASCII.  This is the same as the
  67. 'type a' command.
  68.  
  69.  
  70. -----------------------------------------------------------------
  71. batch on|off                                         Default: off
  72. -----------------------------------------------------------------
  73.  
  74.  
  75. >> Example:  batch on
  76.  
  77.  
  78. -----------------------------------------------------------------
  79. binary
  80. -----------------------------------------------------------------
  81. Sets the file transfer mode to binary, or "image" mode.  This is
  82. the same as the 'type i' command.
  83.  
  84.  
  85. -----------------------------------------------------------------
  86. cd <remote_directory>
  87. -----------------------------------------------------------------
  88. Changes the current directory on the remote host to the directory
  89. indicated by <directory>, which must be an existing directory on
  90. the remote host.  The directory specified can be relative to the
  91. current directory, or absolute, with the name beginning at the
  92. root (/).
  93.  
  94. >> Example:  cd public/tmp
  95.  
  96.  
  97. -----------------------------------------------------------------
  98. dele <remote_filename>
  99. -----------------------------------------------------------------
  100. Deletes a file on the remote system.  You must have delete
  101. privilege on the remote host to use this command.
  102.  
  103. >> Example:  dele foo.txt
  104.  
  105.  
  106. -----------------------------------------------------------------
  107. dir [<remote_filename>|<remote_directory>  [<local_filename>]]
  108. -----------------------------------------------------------------
  109. Without arguments, 'dir' requests that a full directory listing
  110. of the remote server's current directory be sent to the terminal.
  111. The full listing gives the file names, sizes and creation dates.
  112.  
  113. If one argument is given, this is passed along in the LIST
  114. command; this can be a specific file or subdirectory that is
  115. meaningful to the remote file system.
  116.  
  117. If two arguments are given, the second argument is taken as the
  118. local file into which the directory listing should be put
  119. (instead of being sent to the console).  The PORT command is used
  120. before the LIST command is sent.
  121.  
  122. You should request a directory listing when you first log into an
  123. unfamiliar machine.  There will often be a file named 'readme' or
  124. 'whathere.txt' that will give some information about the files
  125. available on the remote machine.  This file can then be acquired
  126. with a "get" command (described below), and read on your machine
  127. to learn more about the files available on the remote host.
  128.  
  129. >> Example:  dir public
  130.  
  131.  
  132. -----------------------------------------------------------------
  133. flow [off|on]
  134. -----------------------------------------------------------------
  135. Display or set screen display flow control.  When set to 'on', a
  136. -More- prompt is displayed after each screenful of output.
  137.  
  138.  
  139. -----------------------------------------------------------------
  140. get <remote_filename> [<local_filename>]
  141. -----------------------------------------------------------------
  142. Asks the remote server to send the file specified in the first
  143. argument.
  144.  
  145. The second argument, if given, will be the name of the file on
  146. the local machine; otherwise it will have the same name as on the
  147. remote machine. The PORT and RETR commands are sent on the
  148. control channel.
  149.  
  150. Before using 'get' you must set the correct transfer mode, using
  151. the 'type' command described below.
  152.  
  153. Use the 'abort command if you want to terminate the transfer
  154. before it has been completed.
  155.  
  156. >> Example:  get public/autoexec.bat
  157.  
  158.  
  159. -----------------------------------------------------------------
  160. hash
  161. -----------------------------------------------------------------
  162. A synonym for the 'verbose 3' command.
  163.  
  164.  
  165. -----------------------------------------------------------------
  166. list [<remote_filename> | <remote_directory> [<local_ filename>]]
  167. ls   [<remote_filename> | <remote_directory> [<local_ filename>]]
  168. -----------------------------------------------------------------
  169. The 'list' and 'ls' commands are identical to 'dir', except that
  170. the "NLST" command is sent to the server instead of the "LIST"
  171. command.  This results in an abbreviated directory listing; i.e.
  172. one showing only the file names themselves without any other
  173. information.
  174.  
  175. >> Example:  ls public
  176.  
  177.  
  178. -----------------------------------------------------------------
  179. mget <remote_filename> [<remote_filename> ...]
  180. -----------------------------------------------------------------
  181. Fetch a collection of files from the server.  File names may
  182. include wild card characters; they will be interpreted and
  183. expanded into a list of files by the remote system using the NLST
  184. command.  The files will have the same name on the local system
  185. that they had on the server.
  186.  
  187. Before using 'mget' you must set the correct transfer mode, using
  188. the 'type' command described below.
  189.  
  190. Use the 'abort command if you want to terminate the transfer
  191. before it has been completed.
  192.  
  193. >> Example:  mget *.txt
  194.  
  195.  
  196. -----------------------------------------------------------------
  197. mkdir <remote_directory>
  198. -----------------------------------------------------------------
  199. Creates a directory on the remote machine.  You must have write
  200. privilege on the remote machine to use this command.
  201.  
  202. >> Example:  mkdir tmp
  203.  
  204.  
  205. -----------------------------------------------------------------
  206. mput <local_filename> [<local_filename> ...]
  207. -----------------------------------------------------------------
  208. Send a collection of files to the server.  File names may include
  209. wild card characters; they will be expanded locally into a list
  210. of files to be sent.  The files will have the same name on the
  211. server as on the local system.
  212.  
  213. Before using 'mput' you must set the correct transfer mode, using
  214. the 'type' command described below.
  215.  
  216. You must have write privilege on the remote host to use this
  217. command.
  218.  
  219. Use the 'abort command if you want to terminate the transfer
  220. before it has been completed.
  221.  
  222. >> Example:  mput *.txt
  223.  
  224.  
  225. -----------------------------------------------------------------
  226. pass <password>
  227. -----------------------------------------------------------------
  228. Normally you will be asked for your password when you log in to
  229. FTP.  However, if you mistype your password and the remote system
  230. rejects it, you can then try again with the 'pass' command.
  231.  
  232. >> Example:  pass foobar
  233.  
  234.  
  235. -----------------------------------------------------------------
  236. put <local_filename> [<remote_filename>]
  237. -----------------------------------------------------------------
  238. Send a local file to the server.  The second argument, if given,
  239. will be the name of the file on the remote machine; otherwise it
  240. will have the same name as on the local machine.  The PORT and
  241. STOR commands are sent on the control channel.
  242.  
  243. Before using 'put' you must set the correct transfer mode, using
  244. the 'type' command described below.
  245.  
  246. You must have write privilege on the remote host to use this
  247. command.
  248.  
  249. Use the 'abort command if you want to terminate the transfer
  250. before it has been completed.
  251.  
  252. >> Example:  put myfoo.txt yourfoo.txt
  253.  
  254.  
  255. -----------------------------------------------------------------
  256. pwd
  257. -----------------------------------------------------------------
  258. Displays the name of the current directory on the remote host.
  259. ('pwd' literally means "print working directory".
  260.  
  261.  
  262. -----------------------------------------------------------------
  263. quit
  264. -----------------------------------------------------------------
  265. Terminates the FTP session and returns you to the "net>" prompt.
  266.  
  267.  
  268. -----------------------------------------------------------------
  269. rmdir <remote_directory>
  270. -----------------------------------------------------------------
  271. Deletes a directory on the remote machine.  You must have delete
  272. privilege on the remote host to use this command.
  273.  
  274. >>  Example:  rmdir tmp
  275.  
  276.  
  277. -----------------------------------------------------------------
  278. type [a | i | l <bytesize>]                            Default: a
  279. -----------------------------------------------------------------
  280. Tells both the local client and remote server the type of file
  281. that is to be transferred.  The 'type' command sets the local
  282. transfer mode and generates the TYPE command on the control
  283. channel.
  284.  
  285. Type 'a' means ASCII (i.e. a text file).  In ASCII mode, files
  286. are sent as varying length lines of text in ASCII separated by
  287. CR/LF sequences.  The 'type a' command is the same as 'ascii'.
  288.  
  289. Type 'i' means image (i.e. binary).  In image mode, files are
  290. sent exactly as they appear in the file system.  The 'type i'
  291. command is the same as 'binary'.
  292.  
  293. Type 'l' (logical byte size) is used when exchanging binary files
  294. with remote servers having oddball word sizes (eg. DECSYSTEM-10s
  295. and 20s).  Locally it works exactly like image, except that it
  296. notifies the remote system how large the byte size is.  The
  297. parameter <bytesize> is typically 8.
  298.  
  299. ASCII mode should be used whenever transferring text between
  300. dissimilar systems (eg. UNIX and DOS) because of their different
  301. end-of-line and/or end-of-file conventions.  When exchanging text
  302. files between machines of the same type, either mode will work
  303. but image mode is usually faster.
  304.  
  305. Naturally, when exchanging raw binary files (executables,
  306. compressed archives, etc) image mode must be used.
  307.  
  308. See also the 'ftype' command.
  309.  
  310. >> Example:  type a
  311.  
  312.  
  313. -----------------------------------------------------------------
  314. user <username>
  315. -----------------------------------------------------------------
  316. Normally you will be asked for your username when you log in to
  317. FTP.  However, if you mistype your name and the remote system
  318. rejects it, you can then try again with the 'user' command.
  319.  
  320. >> Example:  user phil
  321.  
  322.  
  323. -----------------------------------------------------------------
  324. verbose [0 | 1 | 2 | 3]                                Default: 2
  325. -----------------------------------------------------------------
  326. Set or display the level of message output in file transfers.
  327. Verbose 0 gives the least output, and verbose 3 the most, as
  328. follows:
  329.  
  330. 0:  Display error messages only.
  331.  
  332. 1:  Display error messages plus a one-line summary after each
  333.     transfer giving the name of the file, its size, and the
  334.     transfer time and rate.
  335.  
  336. 2:  Display error and summary messages plus the progress messages
  337.     generated by the remote FTP server.
  338.  
  339. 3:  Display all messages. In addition, a "hash mark" (#) is
  340.     displayed for every 1,000 bytes sent or received.  'verbose
  341.     3' is equivalent to 'hash'
  342.  
  343. If a command is sent to the remote server because it is not
  344. recognized locally, the response is always displayed, regardless
  345. of the setting of 'verbose'.  This is necessary for commands like
  346. 'pwd' (display working directory), which would otherwise produce
  347. no message at all if 'verbose' were set to 0 or 1.
  348.  
  349. >> Example:  verbose 0
  350.