]>
git.ipfire.org Git - thirdparty/squid.git/blob - src/comm/Connection.h
2 * DEBUG: section 05 Socket Functions
3 * AUTHOR: Amos Jeffries
4 * AUTHOR: Robert Collins
6 * SQUID Web Proxy Cache http://www.squid-cache.org/
7 * ----------------------------------------------------------
9 * Squid is the result of efforts by numerous individuals from
10 * the Internet community; see the CONTRIBUTORS file for full
11 * details. Many organizations have provided support for Squid's
12 * development; see the SPONSORS file for full details. Squid is
13 * Copyrighted (C) 2001 by the Regents of the University of
14 * California; see the COPYRIGHT file for full details. Squid
15 * incorporates software developed and/or copyrighted by other
16 * sources; see the CREDITS file for full details.
18 * This program is free software; you can redistribute it and/or modify
19 * it under the terms of the GNU General Public License as published by
20 * the Free Software Foundation; either version 2 of the License, or
21 * (at your option) any later version.
23 * This program is distributed in the hope that it will be useful,
24 * but WITHOUT ANY WARRANTY; without even the implied warranty of
25 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
26 * GNU General Public License for more details.
28 * You should have received a copy of the GNU General Public License
29 * along with this program; if not, write to the Free Software
30 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111, USA.
33 * Copyright (c) 2003, Robert Collins <robertc@squid-cache.org>
34 * Copyright (c) 2010, Amos Jeffries <amosjeffries@squid-cache.org>
37 #ifndef _SQUIDCONNECTIONDETAIL_H_
38 #define _SQUIDCONNECTIONDETAIL_H_
40 #include "base/RefCount.h"
41 #include "comm/forward.h"
43 #include "hier_code.h"
44 #include "ip/Address.h"
48 #include "eui/Eui48.h"
49 #include "eui/Eui64.h"
64 /* TODO: make these a struct of boolean flags members in the connection instead of a bitmap.
65 * we can't do that until all non-comm code uses Commm::Connection objects to create FD
66 * currently there is code still using comm_open() and comm_openex() synchronously!!
68 #define COMM_UNSET 0x00
69 #define COMM_NONBLOCKING 0x01 // default flag.
70 #define COMM_NOCLOEXEC 0x02
71 #define COMM_REUSEADDR 0x04 // shared FD may be both accept()ing and read()ing
72 #define COMM_DOBIND 0x08 // requires a bind()
73 #define COMM_TRANSPARENT 0x10 // arrived via TPROXY
74 #define COMM_INTERCEPTION 0x20 // arrived via NAT
77 * Store data about the physical and logical attributes of a connection.
79 * Some link state can be infered from the data, however this is not an
80 * object for state data. But a semantic equivalent for FD with easily
81 * accessible cached properties not requiring repeated complex lookups.
83 * Connection properties may be changed until the connection is opened.
84 * Properties should be considered read-only outside of the Comm layer
85 * code once the connection is open.
87 * These objects should not be passed around directly,
88 * but a Comm::ConnectionPointer should be passed instead.
90 class Connection
: public RefCountable
93 MEMPROXY_CLASS(Comm::Connection
);
97 /** Clear the connection properties and close any open socket. */
100 /** Copy an existing connections IP and properties.
101 * This excludes the FD. The new copy will be a closed connection.
103 ConnectionPointer
copyDetails() const;
105 /** Close any open socket. */
108 /** determine whether this object describes an active connection or not. */
109 bool isOpen() const { return (fd
>= 0); }
111 /** retrieve the CachePeer pointer for use.
112 * The caller is responsible for all CBDATA operations regarding the
113 * used of the pointer returned.
115 CachePeer
* getPeer() const;
117 /** alter the stored CachePeer pointer.
118 * Perform appropriate CBDATA operations for locking the CachePeer pointer
120 void setPeer(CachePeer
* p
);
123 /** These objects may not be exactly duplicated. Use copyDetails() instead. */
124 Connection(const Connection
&c
);
126 /** These objects may not be exactly duplicated. Use copyDetails() instead. */
127 Connection
& operator =(const Connection
&c
);
130 /** Address/Port for the Squid end of a TCP link. */
133 /** Address for the Remote end of a TCP link. */
136 /** Hierarchy code for this connection link */
139 /** Socket used by this connection. Negative if not open. */
142 /** Quality of Service TOS values currently sent on this connection */
145 /** Netfilter MARK values currently sent on this connection */
148 /** COMM flags set on this connection */
151 char rfc931
[USER_IDENT_SZ
];
154 Eui::Eui48 remoteEui48
;
155 Eui::Eui64 remoteEui64
;
159 /** cache_peer data object (if any) */
165 MEMPROXY_CLASS_INLINE(Comm::Connection
);
167 // NP: Order and namespace here is very important.
168 // * The second define inlines the first.
169 // * Stream inheritance overloading is searched in the global scope first.
171 inline std::ostream
&
172 operator << (std::ostream
&os
, const Comm::Connection
&conn
)
174 os
<< "local=" << conn
.local
<< " remote=" << conn
.remote
;
176 os
<< " FD " << conn
.fd
;
177 if (conn
.flags
!= COMM_UNSET
)
178 os
<< " flags=" << conn
.flags
;
181 os
<< " IDENT::" << conn
.rfc931
;
186 inline std::ostream
&
187 operator << (std::ostream
&os
, const Comm::ConnectionPointer
&conn
)