add

1 files changed, 77 insertions, 0 deletions

diff --git a/man/man1/hget.1 b/man/man1/hget.1
new file mode 100644
index 00000000..d716c750
--- /dev/null
+++ b/man/man1/hget.1
@@ -0,0 +1,77 @@
+.TH HGET 1 
+.SH NAME
+hget  \- retrieve a web page corresponding to a url
+.SH SYNOPSIS
+.PP
+.B hget
+[
+.B -dhv
+][
+.B -o
+.I ofile
+][
+.B -p
+.I body
+][
+.B -x
+.I netmntpt
+]
+.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 only supported URL type is http.
+.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 -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 output 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 \*9/src/cmd/hget.c