home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 35 Internet / 35-Internet.zip / wwwgrab1.zip / wwwgrab2.doc < prev   
Text File  |  1996-10-14  |  6KB  |  187 lines
  1.  
  2.                      Welcome to WWWGrab/2 v 1.0
  3.  
  4.  
  5.      WWWGrab/2 is an utility for mirroring complete websites.
  6.  
  7.  
  8. WWWGrab/2 Requirements:
  9.   OS/2 Version 2.11 or greater. OS/2 Warp Connect suggested for best 
  10.     performance.
  11.   One of the following TCP/IP packages for OS/2. (Listed in order
  12.      of preference.)
  13.       - IBM TCP/IP 3.0 included in OS/2 Warp Connect.
  14.       - IBM TCP/IP 2.0 Base Kit with CSD64092 or greater applied.
  15.       - The Internet Access Kit from OS/2 Warp's Bonus pack.
  16.   A disk with longnames support!!
  17.  
  18.  
  19.      To  start  WWWGrab/2  simply  type  at  the  OS/2 command prompt:
  20.                WWWGRAB2 <config_file>  [URL]
  21.  
  22.      The  URL must be in the "http form", i.e. http://blah.blah.blah... Config
  23. file  must  be  plain text file. The easiest way to create a config file is to
  24. copy one of the demofiles and adjust it to your needs. I've included the files
  25. I  use  it  for  testing. Below you find an overview of the parameters as they
  26. should be in the config file.
  27.  
  28.  
  29.   URL <url-in-the-http-form>
  30.      The complete URL of the site you want to mirror. Http is required!
  31.  
  32.   Example: URL http://www.vr.net/~pepsi/helloween/index.html
  33.  
  34.  
  35.  
  36.   LOCALPATH <path>
  37.  
  38.      This  is  the  path  on  your  local  machine  under  which the directory
  39.      structure will be created.
  40.  
  41.   Example: LOCALPATH F:\GRAB\IBM\
  42.  
  43.  
  44. $ EXTENSIONS <list of extensions>
  45.  
  46.      Extensions  defines a list of file extension search strings which have to
  47.      be  processed.  The  extensions  are  seperated by a space. HTM, HTML are
  48.      already  implied.  Be carefull what you put here. EXE or ZIP as extension
  49.      could  mean  that  you start copying complete HOBBES! You may use the ':'
  50.      char as 'NOT' operator.
  51.  
  52.   Example: EXTENSIONS  JPG GIF WAV AU
  53.            EXTENSIONS  :JPG :GIF      -> All, except JPG and GIF files
  54.  
  55.      [Shareware  version  has  hardcoded following extensions: HTM, HTML, JPG,
  56.      GIF, WAV, AU]
  57.  
  58.   MAXDEEP <levels>
  59.  
  60.      MaxDeep  defines how many levels deep you want to mirror. Pages which are
  61.      lower in the tree are ignored.
  62.  
  63.   Example: MAXDEEP 5
  64.  
  65.      [Shareware version is limited to max. 5 levels]
  66.  
  67.   MAXTRIES <num>
  68.  
  69.      MaxTries  defines  the  number  of attempts for getting a file. WWWGrab/2
  70.      tries  to  grab  all  the  files. If a file isn't retrieved, it's ignored
  71.      until  the  complete  list  has  been processed. Then WWWGrab/2 checks if
  72.      there  are  missing  files  and  starts  to  retry those. This process is
  73.      repeated until all the files are retrieved or MAXTRIES times.
  74.  
  75.   Example: MAXTRIES 3
  76.  
  77.  
  78.  
  79. $ DEFAULTNAME <name>
  80.  
  81.      Sometimes  links  point  to a directory instead of a file. If is not know
  82.      filename, the DefaultName is used.
  83.  
  84.   Example: DEFAULTNAME Welcome.htm
  85.  
  86.  
  87.   ALL
  88.  
  89.      Normaly,  if  WWWGrab/2  sees  that a file already exists, it will send a
  90.      conditional  GET  to  the  remote server. The file is only send back when
  91.      it's newer than the local file. This behaviour is default. If you want to
  92.      update all the files regardless dates and local existance, you should use
  93.      ALL.
  94.  
  95.   Example: ALL
  96.  
  97. $ CHANGESITE <num sites>
  98.      Normaly,  if WWWGrab/2 found in HTM* file link to the another WWW server,
  99.      is  ignored.  If  you  want  allow  change the WWW server, you should use
  100.      CHANGESITE.  Default  is  0 - DON'T change site. BE CAREFULL which number
  101.      you  enter  here!  You may start mirror complete WWW! In the next version
  102.      will be List_Of_Allowed_Sites.
  103.  
  104.   Example: CHANGESITE 0
  105.  
  106.  
  107. $ -> Registered version only.
  108.  
  109. Disclaimer etc.
  110. ===============
  111.  
  112. This program is COPYRIGHTED by J. Rubes.
  113.  
  114.      WWWGrab/2 is a shareware product. It is distributed through public access
  115. channels  so  that perspective buyers can have the opportunity to evaluate the
  116. product  before  making  a decision to buy.
  117.  
  118.      WWWGrab/2  may  be used only for legal purposes. CHECK if you are allowed
  119. to  mirror  a  site.
  120.  
  121.                              USE AT YOUR OWN RISK
  122.  
  123.      This  program  is  provided  AS  IS  without  any  warranty, expressed or
  124. implied,  including  but not limited to fitness for a particular use. The user
  125. is responsible for the results of correct or incorrect usage of this software.
  126.  
  127.      WWWGrab/2  may not be used to provide commercial services without written
  128. permission  of  the  author.
  129.  
  130.  
  131.  
  132. If you like this program, please:
  133.      Send  me $10.00, the normal user fee for WWWGrab/2. You may send more:-)
  134.  
  135.      For  this  you will recieve (via email) a registered personalised copy of
  136. the  most  recent  version of WWGrab/2. This registration makes all subsequent
  137. versions possible free of charge.
  138.  
  139. If you don't like this program:
  140.      Delete it.
  141.  
  142. If you wanna crack it:
  143.      Ask me how:-)
  144.  
  145. ------------------------------8<----------------------------------------------
  146.                         REGISTRATION FORM
  147.  
  148.  
  149. You sending me $__. (Minimum is $10).
  150.  
  151. Your REAL name:_________________________________________________________
  152.  
  153. Your email address:_____________________________________________________
  154.  
  155. Date:__/__/____
  156.  
  157.  
  158.  
  159. Signature:______________________________________
  160.  
  161.  
  162.      I'm  sorry,  but  I  may  accept  only  paper  money  enclosed  with this
  163. registration form. No credit cards, nor checks:-(
  164.      Please  enclose paper money with this form between thick paper to make it
  165. impossible to see it from outside the envelope.
  166.  
  167.                                                 Thanx
  168.  
  169. Please post this registration form and enclosed money to:
  170.        Jiri Rubes
  171.        E. Benese 9/15
  172.        Prostejov
  173.        796 03
  174.        CZECH REPUBLIC
  175.  
  176. ------------------------------8<----------------------------------------------
  177.  
  178. Conatct:
  179. Remember that software of this kind lives or dies by the response I get.
  180.  
  181. You may send comments, suggestions, bugs, etc. to:
  182. email:
  183.   Jiri_Rubes@slad.fido.cz
  184.  
  185. FidoNet:
  186.   2:421/37
  187.