git: 9front

ref: cb5c02dd1775a825f68c54d0a619e34d7603e7a9
dir: /sys/man/1/hget/

View raw version
.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 -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
option is specified, then an HTTP POST is performed
with
.I body
as the data to be posted.
.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.