| fetch.3 (116169) | fetch.3 (119893) |
|---|---|
| 1.\" Copyright (c) 1998 Dag-Erling Co�dan Sm�rgrav 2.\" All rights reserved. 3.\" 4.\" Redistribution and use in source and binary forms, with or without 5.\" modification, are permitted provided that the following conditions 6.\" are met: 7.\" 1. Redistributions of source code must retain the above copyright 8.\" notice, this list of conditions and the following disclaimer. --- 8 unchanged lines hidden (view full) --- 17.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 18.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 19.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 20.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 21.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 22.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 23.\" SUCH DAMAGE. 24.\" | 1.\" Copyright (c) 1998 Dag-Erling Co�dan Sm�rgrav 2.\" All rights reserved. 3.\" 4.\" Redistribution and use in source and binary forms, with or without 5.\" modification, are permitted provided that the following conditions 6.\" are met: 7.\" 1. Redistributions of source code must retain the above copyright 8.\" notice, this list of conditions and the following disclaimer. --- 8 unchanged lines hidden (view full) --- 17.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 18.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 19.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 20.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 21.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 22.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 23.\" SUCH DAMAGE. 24.\" |
| 25.\" $FreeBSD: head/lib/libfetch/fetch.3 116169 2003-06-10 20:41:18Z trhodes $ | 25.\" $FreeBSD: head/lib/libfetch/fetch.3 119893 2003-09-08 19:57:22Z ru $ |
| 26.\" 27.Dd July 1, 1998 28.Dt FETCH 3 29.Os 30.Sh NAME 31.Nm fetchMakeURL , 32.Nm fetchParseURL , 33.Nm fetchFreeURL , --- 110 unchanged lines hidden (view full) --- 144components. 145.Pp 146.Fn fetchMakeURL 147and 148.Fn fetchParseURL 149return a pointer to a 150.Vt url 151structure, which is defined as follows in | 26.\" 27.Dd July 1, 1998 28.Dt FETCH 3 29.Os 30.Sh NAME 31.Nm fetchMakeURL , 32.Nm fetchParseURL , 33.Nm fetchFreeURL , --- 110 unchanged lines hidden (view full) --- 144components. 145.Pp 146.Fn fetchMakeURL 147and 148.Fn fetchParseURL 149return a pointer to a 150.Vt url 151structure, which is defined as follows in |
| 152.Aq Pa fetch.h : | 152.In fetch.h : |
| 153.Bd -literal 154#define URL_SCHEMELEN 16 155#define URL_USERLEN 256 156#define URL_PWDLEN 256 157 158struct url { 159 char scheme[URL_SCHEMELEN+1]; 160 char user[URL_USERLEN+1]; --- 38 unchanged lines hidden (view full) --- 199in the appropriate section below. 200.Pp 201.Fn fetchStatURL 202attempts to obtain the requested document's metadata and fill in the 203structure pointed to by its second argument. 204The 205.Vt url_stat 206structure is defined as follows in | 153.Bd -literal 154#define URL_SCHEMELEN 16 155#define URL_USERLEN 256 156#define URL_PWDLEN 256 157 158struct url { 159 char scheme[URL_SCHEMELEN+1]; 160 char user[URL_USERLEN+1]; --- 38 unchanged lines hidden (view full) --- 199in the appropriate section below. 200.Pp 201.Fn fetchStatURL 202attempts to obtain the requested document's metadata and fill in the 203structure pointed to by its second argument. 204The 205.Vt url_stat 206structure is defined as follows in |
| 207.Aq Pa fetch.h : | 207.In fetch.h : |
| 208.Bd -literal 209struct url_stat { 210 off_t size; 211 time_t atime; 212 time_t mtime; 213}; 214.Ed 215.Pp --- 11 unchanged lines hidden (view full) --- 227attempts to list the contents of the directory pointed to by the URL 228provided. 229If successful, it returns a malloced array of 230.Vt url_ent 231structures. 232The 233.Vt url_ent 234structure is defined as follows in | 208.Bd -literal 209struct url_stat { 210 off_t size; 211 time_t atime; 212 time_t mtime; 213}; 214.Ed 215.Pp --- 11 unchanged lines hidden (view full) --- 227attempts to list the contents of the directory pointed to by the URL 228provided. 229If successful, it returns a malloced array of 230.Vt url_ent 231structures. 232The 233.Vt url_ent 234structure is defined as follows in |
| 235.Aq Pa fetch.h : | 235.In fetch.h : |
| 236.Bd -literal 237struct url_ent { 238 char name[MAXPATHLEN]; 239 struct url_stat stat; 240}; 241.Ed 242.Pp 243The list is terminated by an entry with an empty name. --- 152 unchanged lines hidden (view full) --- 396The 397.Fn fetchStat 398functions return 0 on success and -1 on failure. 399.Pp 400All other functions return a stream pointer which may be used to 401access the requested document, or NULL if an error occurred. 402.Pp 403The following error codes are defined in | 236.Bd -literal 237struct url_ent { 238 char name[MAXPATHLEN]; 239 struct url_stat stat; 240}; 241.Ed 242.Pp 243The list is terminated by an entry with an empty name. --- 152 unchanged lines hidden (view full) --- 396The 397.Fn fetchStat 398functions return 0 on success and -1 on failure. 399.Pp 400All other functions return a stream pointer which may be used to 401access the requested document, or NULL if an error occurred. 402.Pp 403The following error codes are defined in |
| 404.Aq Pa fetch.h : | 404.In fetch.h : |
| 405.Bl -tag -width 18n 406.It Bq Er FETCH_ABORT 407Operation aborted 408.It Bq Er FETCH_AUTH 409Authentication failed 410.It Bq Er FETCH_DOWN 411Service unavailable 412.It Bq Er FETCH_EXISTS --- 255 unchanged lines hidden --- | 405.Bl -tag -width 18n 406.It Bq Er FETCH_ABORT 407Operation aborted 408.It Bq Er FETCH_AUTH 409Authentication failed 410.It Bq Er FETCH_DOWN 411Service unavailable 412.It Bq Er FETCH_EXISTS --- 255 unchanged lines hidden --- |