.SH SYNOPSIS
.B webfs
[
+.B -A
+.I useragent
+] [
+.B -T
+.I timeout
+] [
.B -m
.I mtpt
]
is specified, will post a service file descriptor in
.BR /srv/\fIservice .
.PP
-If the enviroment variable
+If the environment variable
.B httpproxy
is set, all HTTP request initiated by
.I webfs
-will be made thru that proxy url.
+will be made through that proxy url.
.PP
.I Webfs
presents a three-level file system suggestive
and
.IR ether (3).
.PP
-The top level contains the files files:
+The top level contains the two files:
.BR ctl ,
and
.BR clone .
Writing strings of the form
.RB `` attr " " value ''
sets a particular attribute.
+.PP
+The following global parameters can be set:
+.TP
+.B useragent
+Sets the HTTP user agent string.
+.TP
+.B timeout
+Sets the request timeout in seconds.
+.TP
+.BI flushauth " url"
+Flushes any associated authentication information for
+resources under
+.I url
+or all resources if no url was given.
+.TP
+.BI preauth " url realm"
+Preauthenticates all resources under
+.I url
+with the given
+.I realm
+using HTTP Basic authentication. This will cause
+.I webfs
+to preemptively send the resulting authorization information
+not waiting for the server to respond with an
+HTTP 401 Unauthorized status.
+.PP
The top-level directory also contains
numbered directories corresponding to connections, which
may be used to fetch a single URL.
.B baseurl
attribute sets the URL against which relative URLs
are interpreted.
-Once the URL has been set by wrting to the
+Once the URL has been set by writing to the
.B ctl
-file of the connetcion, its pieces can be retrieved via
+file of the connection, its pieces can be retrieved via
individual files in the
.B parsed
directory:
.PP
When the
.B body
-file has been opend, response headers appear
+file has been opened, response headers appear
as files in the connection directory. For example
reading the
.B contenttype
file yields the MIME content type of the body data.
-If the request was redirected, the URL represended
+If the request was redirected, the URL represented
by the
.B parsed
directory will change to the final destination.
as it arrives.
.PP
The following is a list of attributes that can be
-set to to a connection prior initiating the request:
+set to do a connection prior initiating the request:
.TP
.B url,baseurl
See above.
Sets the MIME content type of the postbody.
.TP
.B request
-Usualy, the HTTP method used is
+Usually, the HTTP method used is
.B POST
when
.B postbody
file is opend first or
.B GET
-otherwise. This can be overriden with the
+otherwise. This can be overridden with the
.B request
attribute so send arbitrary HTTP requests.
.TP
should be running and mounted on
.B /mnt/webcookies
otherwise cookies will be ignored.
+.SH HISTORY
+.I Webfs
+first appeared in Plan 9 from Bell Labs. It was
+rewritten from scratch for 9front (January, 2012).