api: API trace improvements
[vpp.git] / src / vcl / ldp_socket_wrapper.h
1 /*
2  * Copyright (c) 2017-2019 Cisco and/or its affiliates.
3  * Licensed under the Apache License, Version 2.0 (the "License");
4  * you may not use this file except in compliance with the License.
5  * You may obtain a copy of the License at:
6  *
7  *     http://www.apache.org/licenses/LICENSE-2.0
8  *
9  * Unless required by applicable law or agreed to in writing, software
10  * distributed under the License is distributed on an "AS IS" BASIS,
11  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12  * See the License for the specific language governing permissions and
13  * limitations under the License.
14  */
15
16 /*
17  * Copyright (c) 2005-2008 Jelmer Vernooij <jelmer@samba.org>
18  * Copyright (C) 2006-2014 Stefan Metzmacher <metze@samba.org>
19  * Copyright (C) 2013-2014 Andreas Schneider <asn@samba.org>
20  *
21  * All rights reserved.
22  *
23  * Redistribution and use in source and binary forms, with or without
24  * modification, are permitted provided that the following conditions
25  * are met:
26  *
27  * 1. Redistributions of source code must retain the above copyright
28  *    notice, this list of conditions and the following disclaimer.
29  *
30  * 2. Redistributions in binary form must reproduce the above copyright
31  *    notice, this list of conditions and the following disclaimer in the
32  *    documentation and/or other materials provided with the distribution.
33  *
34  * 3. Neither the name of the author nor the names of its contributors
35  *    may be used to endorse or promote products derived from this software
36  *    without specific prior written permission.
37  *
38  * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
39  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
40  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
41  * ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
42  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
43  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
44  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
45  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
46  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
47  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
48  * SUCH DAMAGE.
49  *
50  */
51
52 /*
53    Socket wrapper library. Passes all socket communication over
54    unix domain sockets if the environment variable SOCKET_WRAPPER_DIR
55    is set.
56 */
57
58 #ifndef included_ldp_socket_wrapper_h
59 #define included_ldp_socket_wrapper_h
60
61 #include <sys/types.h>
62 #include <sys/socket.h>
63 #include <sys/ioctl.h>
64 #include <sys/select.h>
65 #include <sys/epoll.h>
66 #include <poll.h>
67 #include <sys/uio.h>
68 #include <stdlib.h>
69 #include <vcl/ldp.h>
70
71
72 /* GCC have printf type attribute check. */
73 #ifdef HAVE_FUNCTION_ATTRIBUTE_FORMAT
74 #define PRINTF_ATTRIBUTE(a,b) __attribute__ ((__format__ (__printf__, a, b)))
75 #else
76 #define PRINTF_ATTRIBUTE(a,b)
77 #endif /* HAVE_FUNCTION_ATTRIBUTE_FORMAT */
78
79 #define HAVE_CONSTRUCTOR_ATTRIBUTE
80 #ifdef HAVE_CONSTRUCTOR_ATTRIBUTE
81 #define CONSTRUCTOR_ATTRIBUTE __attribute__ ((constructor))
82 #else
83 #define CONSTRUCTOR_ATTRIBUTE
84 #endif /* HAVE_CONSTRUCTOR_ATTRIBUTE */
85
86 #define HAVE_DESTRUCTOR_ATTRIBUTE
87 #ifdef HAVE_DESTRUCTOR_ATTRIBUTE
88 #define DESTRUCTOR_ATTRIBUTE __attribute__ ((destructor))
89 #else
90 #define DESTRUCTOR_ATTRIBUTE
91 #endif
92
93 /*
94  * IMPORTANT
95  *
96  * Functions especially from libc need to be loaded individually, you can't load
97  * all at once or gdb will segfault at startup. The same applies to valgrind and
98  * has probably something todo with with the linker.
99  * So we need load each function at the point it is called the first time.
100  */
101 int libc_accept4 (int sockfd, struct sockaddr *addr, socklen_t * addrlen,
102                   int flags);
103
104 int libc_accept (int sockfd, struct sockaddr *addr, socklen_t * addrlen);
105
106 int libc_bind (int sockfd, const struct sockaddr *addr, socklen_t addrlen);
107
108 int libc_close (int fd);
109
110 int libc_connect (int sockfd, const struct sockaddr *addr, socklen_t addrlen);
111
112 #if 0
113 /* TBD: dup and dup2 to be implemented later */
114 int libc_dup (int fd);
115
116 int libc_dup2 (int oldfd, int newfd);
117 #endif
118
119 #ifdef HAVE_EVENTFD
120 int libc_eventfd (int count, int flags);
121 #endif
122
123 int libc_vfcntl (int fd, int cmd, va_list ap);
124
125 #ifdef HAVE_FCNTL64
126 int libc_vfcntl64 (int fd, int cmd, va_list ap);
127 #endif
128
129 int libc_vioctl (int fd, int cmd, va_list ap);
130
131 int libc_getpeername (int sockfd, struct sockaddr *addr, socklen_t * addrlen);
132
133 int libc_getsockname (int sockfd, struct sockaddr *addr, socklen_t * addrlen);
134
135 int
136 libc_getsockopt (int sockfd,
137                  int level, int optname, void *optval, socklen_t * optlen);
138
139 int libc_listen (int sockfd, int backlog);
140
141 int libc_read (int fd, void *buf, size_t count);
142
143 ssize_t libc_readv (int fd, const struct iovec *iov, int iovcnt);
144
145 int libc_recv (int sockfd, void *buf, size_t len, int flags);
146
147 int
148 libc_recvfrom (int sockfd,
149                void *buf,
150                size_t len,
151                int flags, struct sockaddr *src_addr, socklen_t * addrlen);
152
153 int libc_recvmsg (int sockfd, struct msghdr *msg, int flags);
154
155 int libc_send (int sockfd, const void *buf, size_t len, int flags);
156
157 ssize_t libc_sendfile (int out_fd, int in_fd, off_t * offset, size_t len);
158
159 int libc_sendmsg (int sockfd, const struct msghdr *msg, int flags);
160
161 int
162 libc_sendto (int sockfd,
163              const void *buf,
164              size_t len,
165              int flags, const struct sockaddr *dst_addr, socklen_t addrlen);
166
167 int
168 libc_setsockopt (int sockfd,
169                  int level, int optname, const void *optval,
170                  socklen_t optlen);
171
172 int libc_socket (int domain, int type, int protocol);
173
174 int libc_socketpair (int domain, int type, int protocol, int sv[2]);
175
176 ssize_t libc_write (int fd, const void *buf, size_t count);
177
178 ssize_t libc_writev (int fd, const struct iovec *iov, int iovcnt);
179
180 int libc_shutdown (int fd, int how);
181
182 int
183 libc_select (int __nfds, fd_set * __restrict __readfds,
184              fd_set * __restrict __writefds,
185              fd_set * __restrict __exceptfds,
186              struct timeval *__restrict __timeout);
187
188 #ifdef __USE_XOPEN2K
189 int
190 libc_pselect (int __nfds, fd_set * __restrict __readfds,
191               fd_set * __restrict __writefds,
192               fd_set * __restrict __exceptfds,
193               const struct timespec *__restrict __timeout,
194               const __sigset_t * __restrict __sigmask);
195 #endif
196
197 int libc_epoll_create (int __size);
198
199 int libc_epoll_create1 (int __flags);
200
201 int libc_epoll_ctl (int __epfd, int __op, int __fd,
202                     struct epoll_event *__event);
203
204 int libc_epoll_wait (int __epfd, struct epoll_event *__events,
205                      int __maxevents, int __timeout);
206
207 int libc_epoll_pwait (int __epfd, struct epoll_event *__events,
208                       int __maxevents, int __timeout,
209                       const __sigset_t * __ss);
210
211 int libc_poll (struct pollfd *__fds, nfds_t __nfds, int __timeout);
212
213 #ifdef __USE_GNU
214 int libc_ppoll (struct pollfd *__fds, nfds_t __nfds,
215                 const struct timespec *__timeout, const __sigset_t * __ss);
216 #endif
217
218 void swrap_constructor (void);
219
220 void swrap_destructor (void);
221
222 #endif /* included_ldp_socket_wrapper_h */
223
224 /*
225  * fd.io coding-style-patch-verification: ON
226  *
227  * Local Variables:
228  * eval: (c-set-style "gnu")
229  * End:
230  */