plan9port

fork of plan9port with libvec, libstr and libsdb
Log | Files | Refs | README | LICENSE

hget.1 (1451B)


      1 .TH HGET 1 
      2 .SH NAME
      3 hget  \- retrieve a web page corresponding to a url
      4 .SH SYNOPSIS
      5 .PP
      6 .B hget
      7 [
      8 .B -dhv
      9 ][
     10 .B -o
     11 .I ofile
     12 ][
     13 .B -p
     14 .I body
     15 ][
     16 .B -x
     17 .I netmntpt
     18 ]
     19 .I url
     20 .SH DESCRIPTION
     21 .I Hget
     22 retrieves the web page specified by the URL
     23 .I url
     24 and writes it, absent the
     25 .B -o
     26 option, to standard output.
     27 The only supported URL type is http.
     28 .PP
     29 If
     30 .I url
     31 is of type HTTP and the
     32 .B -p
     33 option is specified, then an HTTP POST is performed
     34 with
     35 .I body
     36 as the data to be posted.
     37 .PP
     38 The
     39 .B -o
     40 option is used to keep a local file in sync with a
     41 web page.  If the web page has been modified later than the
     42 file, it is copied into the file.  If the file is up to date
     43 but incomplete,
     44 .I hget
     45 will fetch the missing bytes.
     46 .PP
     47 Option
     48 .B -h
     49 causes HTTP headers to be printed to standard output
     50 in addition to the transferred web page.
     51 .PP
     52 Option
     53 .B -d
     54 turns on debugging written to standard error.
     55 .PP
     56 Normally,
     57 .I hget
     58 uses the IP stack mounted under
     59 .BR /net .
     60 The
     61 .B -x
     62 option can be used to specify the mount point of
     63 a different IP stack to use.
     64 .PP
     65 Option
     66 .B -v
     67 writes progress lines to standard output once a second.
     68 Each line contains two numbers, the bytes transferred so
     69 far and the total length to be transferred.
     70 .PP
     71 If the environment variable
     72 .B httpproxy
     73 is set, it is used as a URL denoting an HTTP proxy server.
     74 All HTTP accesses use this server to get the page instead of
     75 calling the destination server.
     76 .SH SOURCE
     77 .B \*9/src/cmd/hget.c