Annotation of win32/apache13/src/include/util_uri.h, revision 1.1
1.1 ! parser 1: /* ====================================================================
! 2: * Copyright (c) 1998-1999 The Apache Group. 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: *
! 8: * 1. Redistributions of source code must retain the above copyright
! 9: * notice, this list of conditions and the following disclaimer.
! 10: *
! 11: * 2. Redistributions in binary form must reproduce the above copyright
! 12: * notice, this list of conditions and the following disclaimer in
! 13: * the documentation and/or other materials provided with the
! 14: * distribution.
! 15: *
! 16: * 3. All advertising materials mentioning features or use of this
! 17: * software must display the following acknowledgment:
! 18: * "This product includes software developed by the Apache Group
! 19: * for use in the Apache HTTP server project (http://www.apache.org/)."
! 20: *
! 21: * 4. The names "Apache Server" and "Apache Group" must not be used to
! 22: * endorse or promote products derived from this software without
! 23: * prior written permission.
! 24: *
! 25: * 5. Products derived from this software may not be called "Apache"
! 26: * nor may "Apache" appear in their names without prior written
! 27: * permission of the Apache Group.
! 28: *
! 29: * 6. Redistributions of any form whatsoever must retain the following
! 30: * acknowledgment:
! 31: * "This product includes software developed by the Apache Group
! 32: * for use in the Apache HTTP server project (http://www.apache.org/)."
! 33: *
! 34: * THIS SOFTWARE IS PROVIDED BY THE APACHE GROUP ``AS IS'' AND ANY
! 35: * EXPRESSED OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
! 36: * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
! 37: * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE APACHE GROUP OR
! 38: * ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
! 39: * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
! 40: * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
! 41: * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
! 42: * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
! 43: * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
! 44: * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
! 45: * OF THE POSSIBILITY OF SUCH DAMAGE.
! 46: * ====================================================================
! 47: *
! 48: * This software consists of voluntary contributions made by many
! 49: * individuals on behalf of the Apache Group and was originally based
! 50: * on public domain software written at the National Center for
! 51: * Supercomputing Applications, University of Illinois, Urbana-Champaign.
! 52: * For more information on the Apache Group and the Apache HTTP server
! 53: * project, please see <http://www.apache.org/>.
! 54: *
! 55: */
! 56:
! 57: /*
! 58: * util_uri.h: External Interface of util_uri.c
! 59: */
! 60:
! 61: #ifndef UTIL_URI_H
! 62: #define UTIL_URI_H
! 63:
! 64: #ifdef __cplusplus
! 65: extern "C" {
! 66: #endif
! 67:
! 68: typedef struct {
! 69: const char *name;
! 70: unsigned short default_port;
! 71: } schemes_t;
! 72:
! 73: #define DEFAULT_FTP_DATA_PORT 20
! 74: #define DEFAULT_FTP_PORT 21
! 75: #define DEFAULT_GOPHER_PORT 70
! 76: #define DEFAULT_NNTP_PORT 119
! 77: #define DEFAULT_WAIS_PORT 210
! 78: #define DEFAULT_SNEWS_PORT 563
! 79: #define DEFAULT_PROSPERO_PORT 1525 /* WARNING: conflict w/Oracle */
! 80:
! 81: /* Flags passed to unparse_uri_components(): */
! 82: #define UNP_OMITSITEPART (1U<<0) /* suppress "scheme://user@site:port" */
! 83: #define UNP_OMITUSER (1U<<1) /* Just omit user */
! 84: #define UNP_OMITPASSWORD (1U<<2) /* Just omit password */
! 85: #define UNP_OMITUSERINFO (UNP_OMITUSER|UNP_OMITPASSWORD) /* omit "user:password@" part */
! 86: #define UNP_REVEALPASSWORD (1U<<3) /* Show plain text password (default: show XXXXXXXX) */
! 87: #define UNP_OMITPATHINFO (1U<<4) /* Show "scheme://user@site:port" only */
! 88: #define UNP_OMITQUERY (1U<<5) /* Omit the "?queryarg" from the path */
! 89:
! 90: typedef struct {
! 91: char *scheme; /* scheme ("http"/"ftp"/...) */
! 92: char *hostinfo; /* combined [user[:password]@]host[:port] */
! 93: char *user; /* user name, as in http://user:passwd@host:port/ */
! 94: char *password; /* password, as in http://user:passwd@host:port/ */
! 95: char *hostname; /* hostname from URI (or from Host: header) */
! 96: char *port_str; /* port string (integer representation is in "port") */
! 97: char *path; /* the request path (or "/" if only scheme://host was given) */
! 98: char *query; /* Everything after a '?' in the path, if present */
! 99: char *fragment; /* Trailing "#fragment" string, if present */
! 100:
! 101: struct hostent *hostent;
! 102:
! 103: unsigned short port; /* The port number, numeric, valid only if port_str != NULL */
! 104:
! 105: unsigned is_initialized:1;
! 106:
! 107: unsigned dns_looked_up:1;
! 108: unsigned dns_resolved:1;
! 109:
! 110: } uri_components;
! 111:
! 112: /* util_uri.c */
! 113: API_EXPORT(unsigned short) ap_default_port_for_scheme(const char *scheme_str);
! 114: API_EXPORT(unsigned short) ap_default_port_for_request(const request_rec *r);
! 115: API_EXPORT(struct hostent *) ap_pduphostent(pool *p, const struct hostent *hp);
! 116: API_EXPORT(struct hostent *) ap_pgethostbyname(pool *p, const char *hostname);
! 117: API_EXPORT(char *) ap_unparse_uri_components(pool *p, const uri_components *uptr,
! 118: unsigned flags);
! 119: API_EXPORT(int) ap_parse_uri_components(pool *p, const char *uri, uri_components *uptr);
! 120: API_EXPORT(int) ap_parse_hostinfo_components(pool *p, const char *hostinfo, uri_components *uptr);
! 121: /* called by the core in main() */
! 122: extern void ap_util_uri_init(void);
! 123:
! 124: #ifdef __cplusplus
! 125: }
! 126: #endif
! 127:
! 128: #endif /*UTIL_URI_H*/
E-mail:
![[BACK]](/cvsweb/icons/back.gif){kind=icon}
Return to util_uri.h CVS log ![[TXT]](/cvsweb/icons/text.gif){kind=icon}
![[DIR]](/cvsweb/icons/dir.gif){kind=icon}
Up to [parser3project] / win32 / apache13 / src / include