]> git.lizzy.rs Git - plan9front.git/blob - sys/man/1/hget
add pstree to ps(1) manpage.
[plan9front.git] / sys / man / 1 / hget
1 .TH HGET 1
2 .SH NAME
3 hget \- retrieve a web page corresponding to a url
4 .SH SYNOPSIS
5 .B hget
6 [
7 .B -o
8 .I file
9 ] [
10 .B -p
11 .I body
12 ] [
13 .B -r
14 .I header
15 ] [
16 .B -m
17 .I method
18 ] [
19 .B -b
20 .I baseurl
21 ]
22 .I url
23 .SH DESCRIPTION
24 .I Hget
25 retrieves the web page specified by the URL
26 .I url
27 and writes it, absent the
28 .B -o
29 option, to standard output.
30 .PP
31 The
32 .I url
33 can be a relative path like
34 .B ../index.html
35 if a absolute
36 .I baseurl
37 was specified with the
38 .B -b
39 option.
40 .PP
41 If
42 .I url
43 is of type HTTP and the
44 .B -p
45 option is specified, then an HTTP POST is performed
46 with
47 .I body
48 as the data to be posted.
49 .PP
50 The
51 .B -o
52 option is used to keep a local file in sync with a
53 web page.  If the web page has been modified later than the
54 file, it is copied into the file.  If the file is up to date
55 but incomplete,
56 .I hget
57 will fetch the missing bytes.
58 .PP
59 Option
60 .B -r
61 sends an arbitrary HTTP
62 .IR header .
63 .PP
64 Option
65 .B -m
66 overrides the HTTP method used for the request.
67 .SH SOURCE
68 .B /rc/bin/hget
69 .SH "SEE ALSO"
70 .IR webfs (4),
71 .IR ftpfs (4)
72 .SH DIAGNOSTICS
73 .I Hget
74 requires 
75 .IR webfs (4)
76 service mounted on
77 .B /mnt/web
78 to work.