Blame


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