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
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
|
/*
* Copyright (c) 1997, 1998, 1999, 2000, 2001, 2004, 2008, 2009, 2010, 2011,
* 2013, 2016
* Inferno Nettverk A/S, Norway. All rights reserved.
*
* Redistribution and use in source and binary forms, with or without
* modification, are permitted provided that the following conditions
* are met:
* 1. The above copyright notice, this list of conditions and the following
* disclaimer must appear in all copies of the software, derivative works
* or modified versions, and any portions thereof, aswell as in all
* supporting documentation.
* 2. All advertising materials mentioning features or use of this software
* must display the following acknowledgement:
* This product includes software developed by
* Inferno Nettverk A/S, Norway.
* 3. The name of the author may not be used to endorse or promote products
* derived from this software without specific prior written permission.
*
* THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
* IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
* OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
* IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
* INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
* NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
* DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
* THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
* (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
* THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
*
* Inferno Nettverk A/S requests users of this software to return to
*
* Software Distribution Coordinator or sdc@inet.no
* Inferno Nettverk A/S
* Oslo Research Park
* Gaustadallen 21
* NO-0349 Oslo
* Norway
*
* any improvements or extensions that they make and grant Inferno Nettverk A/S
* the rights to redistribute these changes.
*
*/
/* $Id: interposition.h,v 1.86.6.6 2017/02/03 06:26:44 michaels Exp $ */
#ifndef _INTERPOSITION_H_
#define _INTERPOSITION_H_
#include "symbols.h"
typedef enum { pid = 0, thread } which_id_t;
typedef struct socks_id_t {
which_id_t whichid;
union {
pid_t pid;
#if HAVE_PTHREAD_H
pthread_t thread;
#endif /* HAVE_PTHREAD_H */
} id;
struct socks_id_t *next;
} socks_id_t;
typedef struct {
char *symbol; /* name of the symbol. */
char *library; /* library symbol is in. */
void *handle; /* handle to the library. */
void *function; /* the bound symbol. */
socks_id_t *dosyscall; /*
* if this value is not set, the corresponding
* syscall should be used for the given id.
* This is for cases where we are unable to
* base the decision concerning whether the
* function should resolve to a R*() function
* or a syscall in other ways.
*/
} libsymbol_t;
#if SOCKSLIBRARY_DYNAMIC
int
socks_shouldcallasnative(const char *functionname);
/*
* If calls to the function with the name "functionname" should at the
* moment, for the calling thread/process, always resolve to the
* corresponding system call/native function, return true.
* Otherwise, return false.
*/
#else
#define socks_shouldcallasnative(functioname) (0)
#endif /* !SOCKSLIBRARY_DYNAMIC */
void socks_mark_io_as_native(void);
void socks_mark_io_as_normal(void);
/*
* Marks i/o calls as native or normal,
* using the socks_markas{native,normal}() functions.
*/
#if SOCKS_CLIENT
void socks_syscall_start(const int s);
/*
* Marks that functions involving the descriptor "s" should resolve
* to system calls.
*/
void socks_syscall_end(const int s);
/*
* Removes the marking that functions involving the descriptor "s" should
* resolve to system calls.
*/
int
socks_issyscall(const int s, const char *name);
/*
* Checks whether the function with the name "name" should resolve
* to a system call when used with the file descriptor "s".
*
* Returns true if so, false otherwise.
*/
socks_id_t *
socks_whoami(socks_id_t *id);
/*
* Returns a unique id identifying the calling thread or process,
* depending on whether the process is threaded or not.
* The id is stored in the object "id".
* Returns "id".
*/
#else /* !SOCKS_CLIENT */
#define socks_syscall_start(s)
#define socks_syscall_end(s)
#define socks_whoami(_id) \
do { \
(_id)->whichid = pid; \
(_id)->id.pid = sockscf.state.pid; \
(_id)->next = NULL; \
} while (/* CONSTCOND */ 0)
#endif /* !SOCKSLIBRARY_DYNAMIC || !SOCKS_CLIENT */
void
socks_markasnative(const char *functionname);
/*
* Marks the function "functionname" as a function that should
* always resolve to the native system call for the calling thread,
* process if not threaded, regardless of anything else.
*/
void
socks_markasnormal(const char *functionname);
/*
* Removes the "mark as native" marker set by socks_markasnative(),
* meaning the usual semantics will again be used to determine whether
* the native system call or the corresponding R*() function should be
* used when resolving "functionname".
*/
void *
symbolfunction(const char *symbol);
/*
* Returns the address binding of the symbol "symbol" and updates
* libsymbol_t structure "symbol" is defined in if necessary.
* Exits on failure.
*/
void
symbolcheck(void);
/*
* Checks that all defined symbols are loadable (and loads them).
* Note that this might open file descriptors (and keep them open).
*/
#endif /* !_INTERPOSITION_H_ */
|
