Import sources from 2011-03-30 iso image - sys/man

1 files changed, 86 insertions, 0 deletions

diff --git a/sys/man/1/hget b/sys/man/1/hget
new file mode 100755
index 000000000..7cc8c97c5
--- /dev/null
+++ b/sys/man/1/hget
@@ -0,0 +1,86 @@
+.TH HGET 1
+.SH NAME
+hget \- retrieve a web page corresponding to a url
+.SH SYNOPSIS
+.B hget
+[
+.B -dhv
+] [
+.B -o
+.I ofile
+] [
+.B -p
+.I body
+] [
+.B -x
+.I netmntpt
+] [
+.B -r
+.I header
+]
+.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.
+The known URL types are: http and ftp.
+.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 -h
+causes HTTP headers to be printed to standard output
+in addition to the transferred web page.
+.PP
+Option
+.B -r
+sends an arbitrary HTTP
+.IR header .
+.PP
+Option
+.B -d
+turns on debugging written to standard error.
+.PP
+Normally,
+.I hget
+uses the IP stack mounted under
+.BR /net .
+The
+.B -x
+option can be used to specify the mount point of
+a different IP stack to use.
+.PP
+Option
+.B -v
+writes progress lines to standard error once a second.
+Each line contains two numbers, the bytes transferred so
+far and the total length to be transferred.
+.PP
+If the environment variable
+.B httpproxy
+is set, it is used as a URL denoting an HTTP proxy server.
+All HTTP accesses use this server to get the page instead of
+calling the destination server.
+.SH SOURCE
+.B /sys/src/cmd/hget.c
+.SH "SEE ALSO"
+.IR ftpfs (4)