xref: /freebsd/lib/libfetch/fetch.h (revision 4cf49a43559ed9fdad601bdcccd2c55963008675)
1 /*-
2  * Copyright (c) 1998 Dag-Erling Co�dan Sm�rgrav
3  * All rights reserved.
4  *
5  * Redistribution and use in source and binary forms, with or without
6  * modification, are permitted provided that the following conditions
7  * are met:
8  * 1. Redistributions of source code must retain the above copyright
9  *    notice, this list of conditions and the following disclaimer
10  *    in this position and unchanged.
11  * 2. Redistributions in binary form must reproduce the above copyright
12  *    notice, this list of conditions and the following disclaimer in the
13  *    documentation and/or other materials provided with the distribution.
14  * 3. The name of the author may not be used to endorse or promote products
15  *    derived from this software without specific prior written permission
16  *
17  * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
18  * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
19  * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
20  * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
21  * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
22  * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
23  * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
24  * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
25  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
26  * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
27  *
28  * $FreeBSD$
29  */
30 
31 #ifndef _FETCH_H_INCLUDED
32 #define _FETCH_H_INCLUDED
33 
34 #include <fetch_err.h>
35 
36 #define _LIBFETCH_VER "libfetch/1.0"
37 
38 #define URL_SCHEMELEN 16
39 #define URL_USERLEN 256
40 #define URL_PWDLEN 256
41 
42 struct url {
43     char	 scheme[URL_SCHEMELEN+1];
44     char	 user[URL_USERLEN+1];
45     char	 pwd[URL_PWDLEN+1];
46     char	 host[MAXHOSTNAMELEN+1];
47     int		 port;
48     char	 doc[2];
49 };
50 
51 struct url_stat {
52     off_t	 size;
53     time_t	 atime;
54     time_t	 mtime;
55 };
56 
57 struct url_ent {
58     char	 name[MAXPATHLEN];
59     struct url_stat stat;
60 };
61 
62 /* FILE-specific functions */
63 FILE		*fetchGetFile(struct url *, char *);
64 FILE		*fetchPutFile(struct url *, char *);
65 int		 fetchStatFile(struct url *, struct url_stat *, char *);
66 struct url_ent	*fetchListFile(struct url *, char *);
67 
68 /* HTTP-specific functions */
69 char		*fetchContentType(FILE *);
70 FILE		*fetchGetHTTP(struct url *, char *);
71 FILE		*fetchPutHTTP(struct url *, char *);
72 int		 fetchStatHTTP(struct url *, struct url_stat *, char *);
73 struct url_ent	*fetchListHTTP(struct url *, char *);
74 
75 /* FTP-specific functions */
76 FILE		*fetchGetFTP(struct url *, char *);
77 FILE		*fetchPutFTP(struct url *, char *);
78 int		 fetchStatFTP(struct url *, struct url_stat *, char *);
79 struct url_ent	*fetchListFTP(struct url *, char *);
80 
81 /* Generic functions */
82 struct url	*fetchParseURL(char *);
83 FILE		*fetchGetURL(char *, char *);
84 FILE		*fetchPutURL(char *, char *);
85 int		 fetchStatURL(char *, struct url_stat *, char *);
86 struct url_ent	*fetchListURL(char *, char *);
87 FILE		*fetchGet(struct url *, char *);
88 FILE		*fetchPut(struct url *, char *);
89 int		 fetchStat(struct url *, struct url_stat *, char *);
90 struct url_ent	*fetchList(struct url *, char *);
91 
92 /* Last error code */
93 extern int	 fetchLastErrCode;
94 
95 #endif
96