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
133
|
/*
* 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.
*/
package org.apache.tomcat.jni;
/**
* Address.
*
* @deprecated The scope of the APR/Native Library will be reduced in Tomcat 9.1.x / Tomcat Native 2.x and has been
* reduced in Tomcat 10.1.x / Tomcat Native 2.x onwards to only include those components required to
* provide OpenSSL integration with the NIO and NIO2 connectors.
*/
@Deprecated
public class Address {
public static final String APR_ANYADDR = "0.0.0.0";
/**
* Fill the Sockaddr class from apr_sockaddr_t
*
* @param info Sockaddr class to fill
* @param sa Structure pointer
*
* @return <code>true</code> if the operation was successful
*/
public static native boolean fill(Sockaddr info, long sa);
/**
* Create the Sockaddr object from apr_sockaddr_t
*
* @param sa Structure pointer
*
* @return the socket address
*/
public static native Sockaddr getInfo(long sa);
/**
* Create apr_sockaddr_t from hostname, address family, and port.
*
* @param hostname The hostname or numeric address string to resolve/parse, the path of the Unix Domain Socket, or
* NULL to build an address that corresponds to 0.0.0.0 or ::
* @param family The address family to use, or APR_UNSPEC if the system should decide.
* @param port The port number.
* @param flags Special processing flags:
*
* <PRE>
* APR_IPV4_ADDR_OK first query for IPv4 addresses; only look
* for IPv6 addresses if the first query failed;
* only valid if family is APR_UNSPEC and hostname
* isn't NULL; mutually exclusive with
* APR_IPV6_ADDR_OK
* APR_IPV6_ADDR_OK first query for IPv6 addresses; only look
* for IPv4 addresses if the first query failed;
* only valid if family is APR_UNSPEC and hostname
* isn't NULL and APR_HAVE_IPV6; mutually exclusive
* with APR_IPV4_ADDR_OK
* </PRE>
*
* @param p The pool for the apr_sockaddr_t and associated storage.
*
* @return The new apr_sockaddr_t.
*
* @throws Exception Operation failed
*/
public static native long info(String hostname, int family, int port, int flags, long p) throws Exception;
/**
* Look up the host name from an apr_sockaddr_t.
*
* @param sa The apr_sockaddr_t.
* @param flags Special processing flags.
*
* @return The hostname.
*/
public static native String getnameinfo(long sa, int flags);
/**
* Return the IP address (in numeric address string format) in an APR socket address. APR will allocate storage for
* the IP address string from the pool of the apr_sockaddr_t.
*
* @param sa The socket address to reference.
*
* @return The IP address.
*/
public static native String getip(long sa);
/**
* Given an apr_sockaddr_t and a service name, set the port for the service
*
* @param sockaddr The apr_sockaddr_t that will have its port set
* @param servname The name of the service you wish to use
*
* @return APR status code.
*/
public static native int getservbyname(long sockaddr, String servname);
/**
* Return an apr_sockaddr_t from an apr_socket_t
*
* @param which Which interface do we want the apr_sockaddr_t for?
* @param sock The socket to use
*
* @return The returned apr_sockaddr_t.
*
* @throws Exception An error occurred
*/
public static native long get(int which, long sock) throws Exception;
/**
* See if the IP addresses in two APR socket addresses are equivalent. Appropriate logic is present for comparing
* IPv4-mapped IPv6 addresses with IPv4 addresses.
*
* @param a One of the APR socket addresses.
* @param b The other APR socket address.
*
* @return <code>true</code> if the addresses are equal
*/
public static native boolean equal(long a, long b);
}
|
