87 lines
1.2 KiB
Plaintext
87 lines
1.2 KiB
Plaintext
.TH HGET 1
|
|
.SH NAME
|
|
hget \- retrieve a web page corresponding to a url
|
|
.SH SYNOPSIS
|
|
.B hget
|
|
[
|
|
.B -o
|
|
.I file
|
|
] [
|
|
.B -p
|
|
.I body
|
|
|
|
|
.B -P
|
|
] [
|
|
.B -r
|
|
.I header
|
|
] [
|
|
.B -m
|
|
.I method
|
|
] [
|
|
.B -b
|
|
.I baseurl
|
|
]
|
|
.I url
|
|
.SH DESCRIPTION
|
|
.I Hget
|
|
retrieves the web page specified by the URL
|
|
.I url
|
|
and writes it, absent the
|
|
.B -o
|
|
option, to standard output.
|
|
.PP
|
|
The
|
|
.I url
|
|
can be a relative path like
|
|
.B ../index.html
|
|
if a absolute
|
|
.I baseurl
|
|
was specified with the
|
|
.B -b
|
|
option.
|
|
.PP
|
|
If
|
|
.I url
|
|
is of type HTTP and the
|
|
.B -p
|
|
or
|
|
.B -P
|
|
options are specified, then a HTTP POST is performed.
|
|
With
|
|
.B -p
|
|
the data to be posted is provided by the
|
|
.I body
|
|
argument as a string or alternatively with
|
|
.B -P
|
|
read from standard input.
|
|
.PP
|
|
The
|
|
.B -o
|
|
option is used to keep a local file in sync with a
|
|
web page. If the web page has been modified later than the
|
|
file, it is copied into the file. If the file is up to date
|
|
but incomplete,
|
|
.I hget
|
|
will fetch the missing bytes.
|
|
.PP
|
|
Option
|
|
.B -r
|
|
sends an arbitrary HTTP
|
|
.IR header .
|
|
.PP
|
|
Option
|
|
.B -m
|
|
overrides the HTTP method used for the request.
|
|
.SH SOURCE
|
|
.B /rc/bin/hget
|
|
.SH "SEE ALSO"
|
|
.IR webfs (4),
|
|
.IR ftpfs (4)
|
|
.SH DIAGNOSTICS
|
|
.I Hget
|
|
requires
|
|
.IR webfs (4)
|
|
service mounted on
|
|
.B /mnt/web
|
|
to work.
|