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