1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
|
/* Licensed to the Apache Software Foundation (ASF) under one or more
* contributor license agreements. See the NOTICE file distributed with
* this work for additional information regarding copyright ownership.
* The ASF licenses this file to You under the Apache License, Version 2.0
* (the "License"); you may not use this file except in compliance with
* the License. You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
/**
* @file http_vhost.h
* @brief Virtual Host package
*
* @defgroup APACHE_CORE_VHOST Virtual Host Package
* @ingroup APACHE_CORE
* @{
*/
#ifndef APACHE_HTTP_VHOST_H
#define APACHE_HTTP_VHOST_H
#ifdef __cplusplus
extern "C" {
#endif
/**
* called before any config is read
* @param p Pool to allocate out of
*/
AP_DECLARE(void) ap_init_vhost_config(apr_pool_t *p);
/**
* called after the config has been read to compile the tables needed to do
* the run-time vhost lookups
* @param p The pool to allocate out of
* @param main_server The start of the virtual host list
*/
AP_DECLARE(void) ap_fini_vhost_config(apr_pool_t *p, server_rec *main_server);
/**
* handle addresses in "<VirtualHost>" statement
* @param p The pool to allocate out of
* @param hostname The hostname in the VirtualHost statement
* @param s The list of Virtual Hosts.
*/
AP_DECLARE(const char *) ap_parse_vhost_addrs(apr_pool_t *p, const char *hostname, server_rec *s);
/**
* handle NameVirtualHost directive
* @param cmd Command Parameters structure
* @param dummy NOT USED
* @param arg a host of the form "<address>[:port]"
*/
AP_DECLARE_NONSTD(const char *)ap_set_name_virtual_host(cmd_parms *cmd,
void *dummy,
const char *arg);
/**
* Callback function for every Name Based Virtual Host.
* @param baton Opaque user object
* @param conn The current Connection
* @param s The current Server
* @see ap_vhost_iterate_given_conn
* @return 0 on success, any non-zero return will stop the iteration.
*/
typedef int(*ap_vhost_iterate_conn_cb)(void* baton, conn_rec* conn, server_rec* s);
/**
* For every virtual host on this connection, call func_cb.
* @param conn The current connection
* @param func_cb Function called for every Name Based Virtual Host for this
* connection.
* @param baton Opaque object passed to func_cb.
* @return The return value from func_cb.
* @note If func_cb returns non-zero, the function will return at this point,
* and not continue iterating the virtual hosts.
*/
AP_DECLARE(int) ap_vhost_iterate_given_conn(conn_rec *conn,
ap_vhost_iterate_conn_cb func_cb,
void* baton);
/**
* given an ip address only, give our best guess as to what vhost it is
* @param conn The current connection
*/
AP_DECLARE(void) ap_update_vhost_given_ip(conn_rec *conn);
/**
* ap_update_vhost_given_ip is never enough, and this is always called after
* the headers have been read. It may change r->server.
* @param r The current request
*/
AP_DECLARE(void) ap_update_vhost_from_headers(request_rec *r);
/**
* Updates r->server with the best name-based virtual host match, within
* the chain of matching virtual hosts selected by ap_update_vhost_given_ip.
* @param r The current request
* @param require_match 1 to return an HTTP error if the requested hostname is
* not explicitly matched to a VirtualHost.
* @return return HTTP_OK unless require_match was specified and the requested
* hostname did not match any ServerName, ServerAlias, or VirtualHost
* address-spec.
*/
AP_DECLARE(int) ap_update_vhost_from_headers_ex(request_rec *r, int require_match);
/**
* Match the host in the header with the hostname of the server for this
* request.
* @param r The current request
* @param host The hostname in the headers
* @param port The port from the headers
* @return return 1 if the host:port matches any of the aliases of r->server,
* return 0 otherwise
*/
AP_DECLARE(int) ap_matches_request_vhost(request_rec *r, const char *host,
apr_port_t port);
#ifdef __cplusplus
}
#endif
#endif /* !APACHE_HTTP_VHOST_H */
/** @} */
|
