Lines Matching +full:document +full:- +full:file

1 .\"-
2 .\" Copyright (c) 1998-2013 Dag-Erling Smørgrav
3 .\" Copyright (c) 2013-2016 Michael Gmelin <freebsd@grem.de>
60 .Nd file transfer functions
126 These functions implement a high-level library for retrieving and
130 takes a URL in the form of a null-terminated string and splits it into
134 .Bd -literal
135     <scheme>:(//(<user>(:<pwd>)?@)?<host>(:<port>)?)?/(<document>)?
140 .Bd -literal
141     ((<user>(:<pwd>)?@)?<host>(:<port>)?)?/(<document>)?
146 For instance, the file scheme only needs the <scheme> and <document>
156 .Bd -literal
177 .Li If-Modified-Since
195 method, and call the appropriate lower-level functions to perform the
198 also returns the remote document's metadata in the
208 meaning of the individual flags is scheme-dependent, and is detailed
212 attempts to obtain the requested document's metadata and fill in the
218 .Bd -literal
228 field is set to -1.
246 .Bd -literal
271 except that they expect a pre-parsed URL in the form of a pointer to
282 write data from or to the requested document, respectively.
289 functions is read-only, and that a stream returned by one of the
291 functions is write-only.
292 .Sh FILE SCHEME
297 provide access to documents which are files in a locally mounted file
299 Only the <document> component of the URL is used.
309 (append to file) flag.
313 will be appended to the previous contents of the file, instead of
378 (if-modified-since) flag is specified, and
388 .Li If-Modified-Since
438 should be set to point to a file containing key and client certificate
440 When a PEM-format key is in a separate file from the client certificate,
443 can be set to point to the key file.
493 functions return 0 on success and -1 on failure.
496 access the requested document, or NULL if an error occurred.
500 .Bl -tag -width 18n
508 File exists
510 File system full
516 File has moved
532 File is not available
539 The accompanying error message includes a protocol-specific error code
540 and message, like "File is not available (404 Not Found)"
542 .Bl -tag -width ".Ev FETCH_BIND_ADDRESS"
559 The document part is ignored.
590 Specifies HTTP authorization parameters as a colon-separated list of
593 respectively; further items are scheme-dependent.
607 The document part is ignored.
631 the document URL will be used as referrer URL.
633 Specifies the User-Agent string to use for HTTP requests.
636 If defined but empty, no User-Agent header is sent.
638 Specifies a file to use instead of
644 for a description of the file format.
647 altogether, or a comma- or whitespace-separated list of hosts for
672 File containing certificate revocation list.
703 .Bd -literal -offset indent
712 .Bd -literal -offset indent
722 .Bd -literal -offset indent
732 .Bd -literal -offset indent
739 .Bd -literal -offset indent
750 .%B File Transfer Protocol
762 .%A T. Berners-Lee
776 .%A T. Berners-Lee
778 .%B Hypertext Transfer Protocol -- HTTP/1.1
783 .%A P. Hallam-Baker
799 .An -nosplit
803 .An Dag-Erling Sm\(/orgrav Aq Mt des@FreeBSD.org
810 .An Jean-Fran\(,cois Dockes Aq Mt jf@dockes.org ,
816 .An Poul-Henning Kamp Aq Mt phk@FreeBSD.org
821 .An Dag-Erling Sm\(/orgrav Aq Mt des@FreeBSD.org
833 There is no way to select a proxy at run-time other than setting the