home *** CD-ROM | disk | FTP | other *** search
/ PC Online 1999 November / PCONLINE_11_99.ISO / filesbbs / DOS / PCFSP105.EXE / PCFSP.DOC < prev    next >
Encoding:
Text File  |  1993-11-06  |  17.0 KB  |  490 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6. PCFSP 
  7. Version 1.05
  8. Novemeber 6, 1993
  9.  
  10.  
  11.  
  12.    
  13. By Lindsey Smith 
  14.  
  15. Email: lsmith@symantec.com
  16.  
  17. US Mail: 8276 Menlo Drive
  18.          Baton Rouge, LA 70808
  19.          USA
  20.  
  21.  
  22.  
  23.                             
  24. Based on FSP 2.6.5
  25. By Wen-King Su
  26. wen-king@vlsi.cs.caltech.edu
  27.  
  28.  
  29.        
  30.  
  31.  
  32. I. What is PCFSP?
  33. -----------------
  34.  
  35. PCFSP is a port to the PC of the UNIX program set collectively known as 
  36. FSP. Well then, what is FSP? FSP is a TCP/IP file transfer protocol similar 
  37. to FTP, the standard Internet file transfer program. With FSP you (the 
  38. client) can upload and download files from an FSP site (the server)
  39. via the Internet. If you have an Internet-connected PC, I highly recommend 
  40. you give PCFSP a try.
  41.  
  42. PCFSP is CardWare.  To be a fully registered user of PCFSP you must
  43. send a postcard to the US mail address above.  I prefer something
  44. scenic or touristy...  In return for the postcard, you'll be notified
  45. by Internet email (don't forget to give/email me your Internet
  46. address) of updates to PCFSP.  That's not too bad is it?
  47.  
  48.  
  49.  
  50. II. What do I need to run PCFSP?
  51. --------------------------------
  52.  
  53. Basically you need a PC that is connected to the Internet and has some 
  54. sort of packet driver loaded. Exactly what drivers you need to load
  55. and what other configuration tweaking needs to be done before you can
  56. access the Internet is far beyond the scope of this document. There are
  57. far to many networking operating systems and PC TCP/IP implementations
  58. for me to give you much help in this department. Don't be intimidated
  59. by this, though. You'll proabably just need to talk to your network 
  60. administrator before you begin configuring PCFSP. He/she should be able
  61. to get you up and running. Just remember that PCFSP itself is very simple 
  62. to configure, it's making your system capable of running PCFSP or any
  63. other Internet access software that can be tricky.
  64.  
  65.  
  66.  
  67. III. Configuring PCFSP
  68. ----------------------
  69.  
  70. PCFSP depends on a file called WATTCP.CFG for its configuration
  71. information. If you have used Internet access software on your PC
  72. before, then filling in the information in WATTCP.CFG should be
  73. pretty straightforward. Otherwise I suggest you get your system
  74. administrator to help you fill it in.
  75.  
  76. Edit the sample WATTCP.CFG file provided. My WATTCP.CFG file is 
  77. shown below as an example.
  78.  
  79.  
  80. my_ip=192.246.63.98
  81. netmask=255.255.255.0
  82. nameserver=38.145.250.2
  83. gateway=192.246.63.1
  84.  
  85.  
  86. The my_ip line should be set to your unique IP address.  The netmask
  87. line should be set to the netmask of your LAN's configuration. The
  88. nameserver line should be set to a numeric IP address that will resolve
  89. IP names into IP numbers.  And finally, the gateway line should be set
  90. to the address of your Internet gateway.
  91.  
  92. If gateways and netmasks are Greek to you, don't worry. As I've said 
  93. before, your network administrator should be able to fill in the
  94. information for you. It's really not as complicated as it might seem.
  95.  
  96. The WATTCP.CFG file needs to be in the same directory as the PCFSP
  97. executables.  You can, however, put the executables and WATTCP.CFG in 
  98. a directory in your DOS path. As long as WATTCP.CFG is in the same
  99. directory as the executables, PCFSP should be able to run properly.
  100.  
  101. Once you have WATTCP.CFG filled in, run the SETFSP batch file. This
  102. file sets the FSP_HOST and FSP_PORT environment variables to usable
  103. defaults. Now run FVER. If your WATTCP.CFG is set properly, then
  104. FVER should first print "[SEISMO.SOAR.CS.CMU.EDU : 21]".  If it
  105. does not, there is either something wrong in your WATTCP.CFG file
  106. or the Waterloo TCP/IP library used in PCFSP is incompatible with
  107. your network configuration.  Double check your WATTCP.CFG, then try
  108. again. If FVER still doesn't work, contact me at the email address at
  109. the top of the file.
  110.  
  111. If everything has worked so far, FVER should have printed
  112. "[SEISMO.SOAR.CS.CMU.EDU : 21]".  Next it should print the FSP version
  113. information for the seismo site.  If FVER does not print the version
  114. information, then the seismo site may be down.  Refer to the section on
  115. changing FSP sites and the site list at the end of this document.
  116. Set FSP_HOST and FSP_PORT to a site other than seismo and run FVER
  117. again.  If _that_ site doesn't respond correctly, keep trying the
  118. other sites in the list.  If none of the sites respond, as above, 
  119. contact me at the email address at the top of file.
  120.  
  121. If FVER responded properly, then your configuration should be
  122. finished.  All other FSP commands should work without any other
  123. tweaking.
  124.  
  125.  
  126.  
  127. IV. Changing FSP Sites
  128. ----------------------
  129.  
  130. Like its UNIX predecessor, PCFSP uses two environment variables to
  131. specify the FSP server you are interacting with.  The FSP_HOST
  132. variable contains the IP number or name of the site and the FSP_PORT
  133. variable contains the FSP port number.  As a start, some name and
  134. port pairs are included at the end of this document.
  135.  
  136. FSP_HOST and FSP_PORT must be defined for any PCFSP command to work.
  137. The SETFSP batch file is a convenient way of doing this.
  138.  
  139. When you want to change sites, merely change the settings of FSP_HOST
  140. and FSP_PORT at the DOS prompt like this:
  141.  
  142. C:\>set fsp_host=alpha.gnu.ai.mit.edu
  143. C:\>set fsp_port=21
  144.  
  145. That's all there is to it.
  146.  
  147. Whenever you change sites be aware of the fact that the site you want
  148. to access might be down.  I recommend that whenever you change sites
  149. that you either run "FVER" or "FCD /" to verify that the site will
  150. respond.  
  151.  
  152. Also be aware that changing sites does not reset the FSP_DIR. This is
  153. another good reason to do an "FCD /" right after you change sites.
  154.  
  155.  
  156.  
  157. V. PCFSP Command Set
  158. --------------------
  159.  
  160. Below is a description of each PCFSP command.  The format is as
  161. follows:
  162.  
  163. COMMAND [-switches] RequiredParamter [OptionalParameter]
  164.  
  165. where 
  166.  
  167. COMMAND is the name of the PCFSP executable (.EXE) file
  168.  
  169. [-switches] are optional command line switches that modify the behavior 
  170. of the command. Switches are combinable so "FLS -l -a" is equivalent to
  171. "FLS -la"
  172.  
  173. RequiredParameter is a paramter that must be specified.  For example,
  174. file1 must be specified when using the FCAT command.
  175.  
  176. [Optional Paramter] is a paramter that may be specified only if
  177. necessary.  Usually optional paramters come in the form of multiple
  178. paths, files, or directories.  For example, if you wanted to list
  179. the contents of more than one directory you could "FLS dir1 dir2"
  180. instead of "FLS dir1", then "FLS dir2"
  181.  
  182. The three paramter types:
  183.  
  184.    A file is an actual file and not a directory. FCAT paramters, for 
  185.    example, must be files since you cannot literally view a directory
  186.    as you could a text file.
  187.  
  188.    A directory is an actual directory and not a file. Dot (.) is the
  189.    current directory, dot-dot (..) is parent directory, and forward
  190.    slash (/) is the root directory.
  191.  
  192.    A path may either be a file or a directory. You can, for example,
  193.    perform FLS operations on both files and directories.
  194.  
  195. All FSP commands can be cleanly exited by pressing Ctrl-C,
  196. Ctrl-Break, or ESC.
  197.  
  198. Setting the FSP_TRACE environment variable will cause all PCFSP
  199. commands to print hash marks as operation progresses. The SETFSP
  200. batch file will do this for you.
  201.  
  202.  
  203. FCAT file1 [file2] ... [fileN]
  204.  
  205. FCAT is similar to the DOS TYPE command.  It reads text files from the
  206. server machine and then displays them on your screen.  The files are
  207. not saved on your machine as they would be during an FGET.
  208.  
  209.  
  210.  
  211. FCD [directory]
  212.  
  213. If no path is specified, FCD prints the current working directory on
  214. the server machine. If a path is specified, FCD attempts to change into
  215. that directory.  FCD works similarly to the DOS CD command with the
  216. notable exception that the slash convention is reversed.  In DOS you
  217. use a backslash (\) to specify the root and to separate directories.
  218. FSP, however, adheres to the UNIX convention of the forward slash ('/').
  219.  
  220.  
  221.  
  222. FGET [-oprs?] file1 [file2] ... [fileN]
  223.  
  224. FGET attempts to retrieve files from the server machine. The * and ?
  225. wildcards are expanded.
  226.  
  227. During the course of PCFSP use you are certain to run into UNIX long
  228. filenames: files that do not meet the DOS limitation of 8 characters,
  229. a dot (.), and a 3 character extension.  FGET attempts to "fix" long
  230. filenames into valid, unique DOS filenames.  For example if you were
  231. to "FGET Long.File.Name.1 Long.File.Name.2", FGET would create 2
  232. unique files instead of merely overwriting the first file with the
  233. second.
  234.  
  235. Also be aware of the fact that UNIX filenames are case sensitive, so 
  236. READ.ME, Read.Me, and read.me are all different files.
  237.  
  238. FGET has four, mutually exclusive command line switches that modify
  239. its behavior when it detects that it might overwrite a file that
  240. already exists on your harddrive.
  241.  
  242.    -o Overwrite the file that already exists 
  243.  
  244.    -p Prompt on each file whether to overwrite, rename, or skip the
  245.       file
  246.  
  247.    -r Attempt to rename the file to a unique filename to preserve the
  248.       file that already exist but still get file from the server
  249.  
  250.    -s Skip the file without overwriting the file that already exists
  251.  
  252.    -? Prints the FGET usage message
  253.  
  254.  
  255.  
  256. FLS [-1ACFLRacdfgiklqrstu?] [path1] [path2] ... [pathN]
  257.  
  258. FLS lists the contents of directories in the same way as the UNIX ls 
  259. command.  If you are not a UNIX user, ls is an ancestor of the DOS DIR 
  260. command.  If you do not specify a path, FLS lists the contents of the 
  261. current directory.  By default FLS displays only the names of files
  262. in the directory and sorts them alphabetically.  You can modify FLS's
  263. behavior using the following command line switches.
  264.  
  265.    -1 List one entry per line
  266.  
  267.    -A List all entries beginning with a period (.) except for . and ..
  268.  
  269.    -C Force multicolumn output with entries sorted down the columns
  270.  
  271.    -Dxx/yy/zz Display only files that were last modified on or after
  272.       the date specified in month/day/year format
  273.  
  274.    -F Mark directories with a trailing /, sockets with a trailing =, 
  275.       symbolic links with a trailing @, and executable files with a 
  276.       trailing *
  277.  
  278.    -L For symbolic links, list the file or directory the link 
  279.       references rather than the link itself
  280.  
  281.    -R Recursively list subdirectories encountered
  282.  
  283.    -a List all entries; by default, entries whose names begin with a
  284.       period (.) are usually not listed (see -A)
  285.  
  286.    -c Use time of last file status change for sorting or printing
  287.  
  288.    -d List only the name (not the contents) of directory arguments.
  289.       Often used with -l to get the status of a directory
  290.  
  291.    -f Turns off entry sorting
  292.  
  293.    -g Include the group ownership of the file in a long output
  294.  
  295.    -i Include the i-number of each file in the first column of the 
  296.       report
  297.  
  298.    -k Print file sizes in kilobyte blocks
  299.  
  300.    -l List in long format, giving mode, number of links, owner, size 
  301.       in bytes, and time of last modification for each file (see -u).
  302.       For symbolic links, the pathname of the linked-to file is 
  303.       preceded by "->"
  304.  
  305.    -q Print nongraphic characters in file names as the character '?'
  306.  
  307.    -r Reverse the order of sort to get reverse alphabetic or oldest 
  308.       first as appropriate
  309.  
  310.    -s Give the size of the disk blocks (in kilobytes rounded up to 
  311.       the nearest kilobyte) allocated for each file. This number 
  312.       depends, in part, on the block size of the disk partition the 
  313.       file resides on
  314.  
  315.    -t Sort by time modified (latest first) instead of by name
  316.  
  317.    -u Use time of last access instead of last modification for 
  318.       sorting (with the -t option) and printing (with the -l option)
  319.  
  320.    -? Prints an abbreviated usage message
  321.  
  322.  
  323.  
  324. FMKDIR directory1 [directory2] ... [directoryN]
  325.  
  326. FMKDIR attempts to create the specified directories.
  327.  
  328. Be aware that you may not have rights to create directories on server 
  329. machines.
  330.  
  331.  
  332.  
  333. FPRO [+c] [-c] [+d] [-d] [directory1] [directory2] ... [directoryN]
  334.  
  335. FPRO without the +/-c or +/-d arguments displays the directory
  336. protection mode of each path.  You can modify each path's directory
  337. protection mode with the following switches:
  338.  
  339.    +c give others permission to create new items
  340.    -c deny others permission to create new items
  341.    +d give others permission to delete old items
  342.    -d deny others permission to delete old items
  343.  
  344.  
  345.  
  346. FPUT file1 [file2] ... [fileN]
  347.  
  348. FPUT attempts to upload the specified file(s) to the server machine. 
  349. The * and ? wildcards are expanded as necessary.
  350.  
  351.  
  352.  
  353. FRM file1 [file2] ... [fileN]
  354.  
  355. FRM attempts to delete the specified file(s). The * and ? wildcards
  356. are expanded as necessary.
  357.  
  358. Be aware that you may not have rights to delete files on server
  359. machines.
  360.  
  361.  
  362.  
  363. FRMDIR directory1 [directory2] ... [directoryN]
  364.  
  365. FRMDIR attempts to delete the specified directories.
  366.  
  367. Be aware that you may not have rights to delete certain directories 
  368. on server machines.
  369.  
  370.  
  371.  
  372. FVER
  373.  
  374. With no parameters, FVER returns the server's FSP version information. 
  375. If specify any parameters, FVER prints the PCFSP version information.
  376.  
  377.  
  378.  
  379. V. Additional PCFSP features
  380. ----------------------------
  381.  
  382. FSP_TRACE 
  383.  
  384. Setting this variable will cause PCFSP commands to print hash marks
  385. periodically during the course of operation so you know that the
  386. operation is proceeding. The marks, the letters 'R', 'I', and 'E', each
  387. have a certain meaning. 'R' is printed the first time the client
  388. listens for a response from the server. An 'I' is printed for each
  389. listen after the first.  E means an error has occured and PCFSP will
  390. retry the last operation. You can set (enable) tracing or unset
  391. (disable) tracing with the following commands.
  392.  
  393. C:\>set fsp_trace=1   (to enable)
  394. C:\>set fsp_trace=    (to disable)
  395.  
  396.  
  397.  
  398. FSP_LOG
  399.  
  400. Setting this variable to a filename will cause FGET to log all
  401. transactions it makes. You can set (enable) tracing or unset
  402. (disable) tracing with the following commands.
  403.  
  404. C:\>set fsp_log=c:\fsp\fsp.log      (to enable)
  405. C:\>set fsp_log=                    (to disable)
  406.  
  407.  
  408.  
  409. VI. FSP Site List
  410. -----------------
  411.  
  412. This list is by no means complete. It was merely culled from the
  413. alt.comp.fsp Frequently Asked Questions (FAQ) file.
  414.  
  415.    There is a list, maintained by <archive-admin@Germany.EU.net>,
  416.    which you can get hold of by fsp from ftp.Germany.EU.net (port
  417.    2001):/pub/lists/fsp-servers.  Various other people produce
  418.    lists as well: have a look around!
  419.  
  420.    You are encouraged to post site information to alt.comp.fsp, and
  421.    if you post in the format below, most people will be able to
  422.    slurp your list straight into their front-end programs.  There's
  423.    an unofficial standard for the format, which you can find on taxus
  424.    in the file "fsplist.std".
  425.  
  426.    In the meantime, here's a list to get you going.
  427.  
  428.    128.52.46.11      21   alpha        # GNU Alpha releases
  429.    131.231.19.21     21   genie        # small UK site
  430.    192.76.144.75   2001   germany      # big German archive
  431.    131.215.131.148   21   mosaic       # BSD386/Usenet
  432.    128.2.206.138     30   seismo       # main FSP code site
  433.    146.169.2.1       21   src          # big UK site
  434.    129.177.30.10   9000   taxus        # fspadm, fsp-shell tools
  435.    131.155.2.71      21   terra        # big Netherlands site
  436.    18.172.1.2        21   tsx          # linux
  437.    fsp.warwick.ac.uk 21   warwick      # Computer Underground Digest
  438.    128.252.135.4     21   wuarchive    # WUStL archive site
  439.  
  440.  
  441.  
  442. VII. PCFSP and 4DOS
  443. -------------------
  444.  
  445. 4DOS is a wonderful COMMAND.COM replacement that implements several
  446. features that generic MS-DOS does not such as command aliasing and
  447. scrollback.  The FGET command automatically detects if you are using
  448. 4DOS. If you are, FGET creates an entry in the DESCRIPT.ION file for
  449. each file that you get. The entry contains the original long filename
  450. before FGET converted it into a DOS compatible filename.
  451.  
  452. If you take a look at the provided SETFSP.BAT there are few ALIAS
  453. commands REM'd out. If you are using 4DOS I highly recommend removing
  454. the REMs and using the aliases. I find they are very handy.
  455.  
  456.  
  457.  
  458. VIII. End Notes
  459. ---------------
  460.  
  461. Hopefully this document has given you enough information to configure
  462. and use PCFSP without too much fuss.  If you run into problems or
  463. bugs or have questions or comments, don't hesitate to email me at the
  464. address at the top of the file.  In the future I'd like to distribute
  465. a troubleshooting guide, so if you run into a problem and then solve
  466. it, let me know so I can include your solution.
  467.  
  468. There are two discussion groups at present for FSP.  The first is the
  469. alt.comp.fsp Usenet newsgroup and the second is an Internet mailing
  470. list which can be subscribed to by sending mail to
  471. listserv@germany.eu.net.
  472.  
  473. If you have any ideas or bug reports for PCFSP, drop me a line.  All 
  474. suggestions are appreciated.
  475.  
  476. Finally, many thanks to Keith Grimes for all the testing and coding
  477. he has done to PCFSP. Many of features were conceived and/or implemented 
  478. by him.
  479.  
  480.  
  481.  
  482. IX. Legal Stuff
  483. ----------------
  484.  
  485. PCFSP is provided as is and without warranty. The author is not
  486. liable for any damage occuring from usage of this software.
  487.  
  488. The PCFSP software package is Copyright 1993 by Lindsey Smith.
  489.  
  490.