LWP-RGET(1)    User Contributed Perl Documentation    LWP-RGET(1)


NNNNAAAAMMMMEEEE
       lwp-rget - Retrieve WWW documents recursively

SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
        lwp-rget [--verbose] [--auth=USER:PASS] [--depth=N] [--hier] [--iis]
                 [--keepext=mime/type[,mime/type]] [--limit=N] [--nospace]
                 [--prefix=URL] [--referer=URL] [--sleep=N] [--tolower] <URL>
        lwp-rget --version


DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
       This program will retrieve a document and store it in a
       local file.  It will follow any links found in the
       document and store these documents as well, patching links
       so that they refer to these local copies.  This process
       continues until there are no more unvisited links or the
       process is stopped by the one or more of the limits which
       can be controlled by the command line arguments.

       This program is useful if you want to make a local copy of
       a collection of documents or want to do web reading off-
       line.

       All documents are stored as plain files in the current
       directory. The file names chosen are derived from the last
       component of URL paths.

       The options are:

       --auth=USER:PASn
          Set the authentication credentials to user "USER" and
          password "PASS" if any restricted parts of the web site
          are hit.  If there are restricted parts of the web site
          and authentication credentials are not available, those
          pages will not be downloaded.

       --depth=_n
          Limit the recursive level. Embedded images are always
          loaded, even if they fall outside the _-_-_d_e_p_t_h. This
          means that one can use _-_-_d_e_p_t_h_=_0 in order to fetch a
          single document together with all inline graphics.

          The default depth is 5.

       --hier
          Download files into a hierarchy that mimics the web
          site structure.  The default is to put all files in the
          current directory.

       --referer=_U_R_I
          Set the value of the referer header for the initial
          request.  The special value "NONE" can be used to
          suppress the referer header in any of subsequent
          requests.



5/Aug/1999               libwww-perl-5.44                       1





LWP-RGET(1)    User Contributed Perl Documentation    LWP-RGET(1)


       --iis
          Sends an "Accept: */*" on all URL requests as a
          workaround for a bug in IIS 2.0.  If no Accept MIME
          header is present, IIS 2.0 returns with a "406 No
          acceptable objects were found" error.  Also converts
          any back slashes (\\) in URLs to forward slashes (/).

       --keepext=_m_i_m_e_/_t_y_p_e_[_,_m_i_m_e_/_t_y_p_e_]
          Keeps the current extension for the list MIME types.
          Useful when downloading text/plain documents that
          shouldn't all be translated to *.txt files.

       --limit=_n
          Limit the number of documents to get.  The default
          limit is 50.

       --nospace
          Changes spaces in all URLs to underscore characters
          (_).  Useful when downloading files from sites serving
          URLs with spaces in them.    Does not remove spaces
          from fragments, e.g., "file.html#somewhere in here".

       --prefix=_u_r_l___p_r_e_f_i_x
          Limit the links to follow. Only URLs that start the
          prefix string are followed.

          The default prefix is set as the "directory" of the
          initial URL to follow.    For instance if we start lwp-
          rget with the URL http://www.sn.no/foo/bar.html, then
          prefix will be set to http://www.sn.no/foo/.

          Use --prefix='' if you don't want the fetching to be
          limited by any prefix.

       --sleep=_n
          Sleep _n seconds before retrieving each document. This
          options allows you to go slowly, not loading the server
          you visiting too much.

       --tolower
          Translates all links to lowercase.  Useful when
          downloading files from IIS since it does not serve
          files in a case sensitive manner.

       --verbose
          Make more noise while running.

       --quiet
          Don't make any noise.

       --version
          Print program version number and quit.





5/Aug/1999               libwww-perl-5.44                       2





LWP-RGET(1)    User Contributed Perl Documentation    LWP-RGET(1)


       --help
          Print the usage message and quit.

       Before the program exits the name of the file, where the
       initial URL is stored, is printed on stdout.  All used
       filenames are also printed on stderr as they are loaded.
       This printing can be suppressed with the _-_-_q_u_i_e_t option.

SSSSEEEEEEEE AAAALLLLSSSSOOOO
       the _l_w_p_-_r_e_q_u_e_s_t manpage, the _L_W_P manpage

AAAAUUUUTTTTHHHHOOOORRRR
       Gisle Aas <aas@sn.no>












































5/Aug/1999               libwww-perl-5.44                       3