mirror of
https://git.FreeBSD.org/src.git
synced 2024-12-16 10:20:30 +00:00
d8acd8dc5c
This commit introduces the following features: a) the fetchStat*() functions, which return meta-information for a document, such as size, modification time, etc. b) the use of the com_err(3) facilities to report errors. It also fixes a bunch of style bugs and a few logic bugs and somewhat improves the man page. Changed files, in alphabetical order: Makefile: Don't generate macros in {ftp,http}err.c. Generate category fields for the error message lists. Compile the error table. Install fetch_err.h along with fetch.h. common.c: Remove the _netdb_errstring() macro, and add FETCH_ERR_NETDB to the error code in the _netdb_seterr() macro. Add categories to the _netdb_errlist table. Report errors through the Common Error library. common.h: Add the DEBUG macros. Add prototype for fetchConnect(). Remove the prototype for _fetch_errstring(), which is local to common.c Add a categroy field to struct fetcherr, and define constants for error categories. Define macros for _{url,netdb,ftp,http}_seterr(). errors.et: (new file) List error categories. fetch.3: Document the fetchStat*() functions. Move the "unimplemented functionality" comments from NOTES to BUGS. Document that applications which use libfetch must also use libcom_err, and list existing error codes. Undocument fetchLastErr{Code,String}. Remove the (empty) DIAGNOSTICS section. Mention Eugene Skepner in the AUTHORS section. fetch.c: Move the DEBUG macros to common.c Add fetchStat() and fetchStatURL(). Generate error messages for URL parser errors, and fix a minor bug in the parser. Use 'struct url' instead of 'url_t'. Remove fetchLastErr{Code,String}. fetch.h: Use 'struct url' instead of 'url_t', and remove the typedef. Define struct url_stat (used by fetchStat()). Add prototypes for fetchStat*(). Remove the declarations for fetchLastErr{Code,String}. Include fetch_err.h. fetch_err.et: (new file) Error table for libfetch. file.c: Add fetchStatFile(). Use 'struct url' instead of 'url_t'. ftp.c: Add fetchStatFTP(). Use 'struct url' instead of 'url_t'. Don't use fetchLastErrCode. ftp.errors: Add categories to all error messages. http.c: Add fetchStatHTTP(). Use 'struct url' instead of 'url_t'. Don't use fetchLastErr{Code,Text}. http.errors: Add categories to all error messages. Prompted by: jkh and Eugene Skepner Numerous sugestions from: Garett Wollman and Eugene Skepner
275 lines
6.5 KiB
C
275 lines
6.5 KiB
C
/*-
|
|
* Copyright (c) 1998 Dag-Erling Coïdan Smørgrav
|
|
* All rights reserved.
|
|
*
|
|
* Redistribution and use in source and binary forms, with or without
|
|
* modification, are permitted provided that the following conditions
|
|
* are met:
|
|
* 1. Redistributions of source code must retain the above copyright
|
|
* notice, this list of conditions and the following disclaimer
|
|
* in this position and unchanged.
|
|
* 2. Redistributions in binary form must reproduce the above copyright
|
|
* notice, this list of conditions and the following disclaimer in the
|
|
* documentation and/or other materials provided with the distribution.
|
|
* 3. The name of the author may not be used to endorse or promote products
|
|
* derived from this software without specific prior written permission
|
|
*
|
|
* THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
|
|
* IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
|
|
* OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
|
|
* IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
|
|
* INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
|
|
* NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
|
|
* DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
|
|
* THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
|
|
* (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
|
|
* THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
|
|
*
|
|
* $Id: fetch.c,v 1.5 1998/11/05 19:48:17 des Exp $
|
|
*/
|
|
|
|
#include <sys/param.h>
|
|
#include <sys/errno.h>
|
|
|
|
#include <ctype.h>
|
|
#include <stdio.h>
|
|
#include <stdlib.h>
|
|
#include <string.h>
|
|
|
|
#include "fetch.h"
|
|
#include "common.h"
|
|
|
|
|
|
/*** Local data **************************************************************/
|
|
|
|
/*
|
|
* Error messages for parser errors
|
|
*/
|
|
#define URL_MALFORMED 1
|
|
#define URL_BAD_SCHEME 2
|
|
#define URL_BAD_PORT 3
|
|
static struct fetcherr _url_errlist[] = {
|
|
{ URL_MALFORMED, FETCH_URL, "Malformed URL" },
|
|
{ URL_BAD_SCHEME, FETCH_URL, "Invalid URL scheme" },
|
|
{ URL_BAD_PORT, FETCH_URL, "Invalid server port" },
|
|
{ -1, FETCH_UNKNOWN, "Unknown parser error" }
|
|
};
|
|
|
|
|
|
/*** Public API **************************************************************/
|
|
|
|
/*
|
|
* Select the appropriate protocol for the URL scheme, and return a
|
|
* read-only stream connected to the document referenced by the URL.
|
|
*/
|
|
FILE *
|
|
fetchGet(struct url *URL, char *flags)
|
|
{
|
|
if (strcasecmp(URL->scheme, "file") == 0)
|
|
return fetchGetFile(URL, flags);
|
|
else if (strcasecmp(URL->scheme, "http") == 0)
|
|
return fetchGetHTTP(URL, flags);
|
|
else if (strcasecmp(URL->scheme, "ftp") == 0)
|
|
return fetchGetFTP(URL, flags);
|
|
else {
|
|
_url_seterr(URL_BAD_SCHEME);
|
|
return NULL;
|
|
}
|
|
}
|
|
|
|
/*
|
|
* Select the appropriate protocol for the URL scheme, and return a
|
|
* write-only stream connected to the document referenced by the URL.
|
|
*/
|
|
FILE *
|
|
fetchPut(struct url *URL, char *flags)
|
|
{
|
|
if (strcasecmp(URL->scheme, "file") == 0)
|
|
return fetchPutFile(URL, flags);
|
|
else if (strcasecmp(URL->scheme, "http") == 0)
|
|
return fetchPutHTTP(URL, flags);
|
|
else if (strcasecmp(URL->scheme, "ftp") == 0)
|
|
return fetchPutFTP(URL, flags);
|
|
else {
|
|
_url_seterr(URL_BAD_SCHEME);
|
|
return NULL;
|
|
}
|
|
}
|
|
|
|
/*
|
|
* Select the appropriate protocol for the URL scheme, and return the
|
|
* size of the document referenced by the URL if it exists.
|
|
*/
|
|
int
|
|
fetchStat(struct url *URL, struct url_stat *us, char *flags)
|
|
{
|
|
if (strcasecmp(URL->scheme, "file") == 0)
|
|
return fetchStatFile(URL, us, flags);
|
|
else if (strcasecmp(URL->scheme, "http") == 0)
|
|
return fetchStatHTTP(URL, us, flags);
|
|
else if (strcasecmp(URL->scheme, "ftp") == 0)
|
|
return fetchStatFTP(URL, us, flags);
|
|
else {
|
|
_url_seterr(URL_BAD_SCHEME);
|
|
return -1;
|
|
}
|
|
}
|
|
|
|
/*
|
|
* Attempt to parse the given URL; if successful, call fetchGet().
|
|
*/
|
|
FILE *
|
|
fetchGetURL(char *URL, char *flags)
|
|
{
|
|
struct url *u;
|
|
FILE *f;
|
|
|
|
if ((u = fetchParseURL(URL)) == NULL)
|
|
return NULL;
|
|
|
|
f = fetchGet(u, flags);
|
|
|
|
free(u);
|
|
return f;
|
|
}
|
|
|
|
|
|
/*
|
|
* Attempt to parse the given URL; if successful, call fetchPut().
|
|
*/
|
|
FILE *
|
|
fetchPutURL(char *URL, char *flags)
|
|
{
|
|
struct url *u;
|
|
FILE *f;
|
|
|
|
if ((u = fetchParseURL(URL)) == NULL)
|
|
return NULL;
|
|
|
|
f = fetchPut(u, flags);
|
|
|
|
free(u);
|
|
return f;
|
|
}
|
|
|
|
/*
|
|
* Attempt to parse the given URL; if successful, call fetchStat().
|
|
*/
|
|
int
|
|
fetchStatURL(char *URL, struct url_stat *us, char *flags)
|
|
{
|
|
struct url *u;
|
|
int s;
|
|
|
|
if ((u = fetchParseURL(URL)) == NULL)
|
|
return -1;
|
|
|
|
s = fetchStat(u, us, flags);
|
|
|
|
free(u);
|
|
return s;
|
|
}
|
|
|
|
/*
|
|
* Split an URL into components. URL syntax is:
|
|
* method:[//[user[:pwd]@]host[:port]]/[document]
|
|
* This almost, but not quite, RFC1738 URL syntax.
|
|
*/
|
|
struct url *
|
|
fetchParseURL(char *URL)
|
|
{
|
|
char *p, *q;
|
|
struct url *u;
|
|
int i;
|
|
|
|
/* allocate struct url */
|
|
if ((u = calloc(1, sizeof(struct url))) == NULL) {
|
|
errno = ENOMEM;
|
|
_fetch_syserr();
|
|
return NULL;
|
|
}
|
|
|
|
/* scheme name */
|
|
for (i = 0; *URL && (*URL != ':'); URL++)
|
|
if (i < URL_SCHEMELEN)
|
|
u->scheme[i++] = *URL;
|
|
if (!URL[0] || (URL[1] != '/')) {
|
|
_url_seterr(URL_BAD_SCHEME);
|
|
goto ouch;
|
|
}
|
|
else URL++;
|
|
if (URL[1] != '/') {
|
|
p = URL;
|
|
goto nohost;
|
|
}
|
|
else URL += 2;
|
|
|
|
p = strpbrk(URL, "/@");
|
|
if (*p == '@') {
|
|
/* username */
|
|
for (q = URL, i = 0; (*q != ':') && (*q != '@'); q++)
|
|
if (i < URL_USERLEN)
|
|
u->user[i++] = *q;
|
|
|
|
/* password */
|
|
if (*q == ':')
|
|
for (q++, i = 0; (*q != ':') && (*q != '@'); q++)
|
|
if (i < URL_PWDLEN)
|
|
u->pwd[i++] = *q;
|
|
|
|
p++;
|
|
} else p = URL;
|
|
|
|
/* hostname */
|
|
for (i = 0; *p && (*p != '/') && (*p != ':'); p++)
|
|
if (i < MAXHOSTNAMELEN)
|
|
u->host[i++] = *p;
|
|
|
|
/* port */
|
|
if (*p == ':') {
|
|
for (q = ++p; *q && (*q != '/'); q++)
|
|
if (isdigit(*q))
|
|
u->port = u->port * 10 + (*q - '0');
|
|
else {
|
|
/* invalid port */
|
|
_url_seterr(URL_BAD_PORT);
|
|
goto ouch;
|
|
}
|
|
while (*p && (*p != '/'))
|
|
p++;
|
|
}
|
|
|
|
nohost:
|
|
/* document */
|
|
if (*p) {
|
|
struct url *t;
|
|
t = realloc(u, sizeof(*u)+strlen(p)-1);
|
|
if (t == NULL) {
|
|
errno = ENOMEM;
|
|
_fetch_syserr();
|
|
goto ouch;
|
|
}
|
|
u = t;
|
|
strcpy(u->doc, p);
|
|
} else {
|
|
u->doc[0] = '/';
|
|
u->doc[1] = 0;
|
|
}
|
|
|
|
DEBUG(fprintf(stderr,
|
|
"scheme: [\033[1m%s\033[m]\n"
|
|
"user: [\033[1m%s\033[m]\n"
|
|
"password: [\033[1m%s\033[m]\n"
|
|
"host: [\033[1m%s\033[m]\n"
|
|
"port: [\033[1m%d\033[m]\n"
|
|
"document: [\033[1m%s\033[m]\n",
|
|
u->scheme, u->user, u->pwd,
|
|
u->host, u->port, u->doc));
|
|
|
|
return u;
|
|
|
|
ouch:
|
|
free(u);
|
|
return NULL;
|
|
}
|