2 * Copyright (c) 2017 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:
7 * http://www.apache.org/licenses/LICENSE-2.0
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.
16 #ifndef included_vcom_h
17 #define included_vcom_h
19 /* VCOM DEBUG flag. Setting this to 1 or 0 turns off
20 ASSERT & other debugging code. */
25 #include <vcl/vcom_glibc_socket.h>
27 #define MAX_VCOM_APP_NAME 256
29 /* Returns 0 on success or -1 on error. */
30 extern int vcom_set_app_name (char *__app_name);
34 * File descriptor based APIs
39 * vpp implementation of glibc APIs from <unistd.h>
41 extern int vcom_close (int __fd);
43 extern ssize_t __wur vcom_read (int __fd, void *__buf, size_t __nbytes);
45 extern ssize_t __wur vcom_write (int __fd, const void *__buf, size_t __n);
47 extern ssize_t __wur vcom_readv (int __fd, const struct iovec *__iov,
50 extern ssize_t __wur vcom_writev (int __fd, const struct iovec *__iov,
54 * vpp implementation of glibc APIs from <fcntl.h>
56 extern int vcom_fcntl (int __fd, int __cmd, ...);
59 * VPP implementation of glibc APIs ioctl
61 extern int vcom_ioctl (int __fd, unsigned long int __cmd, ...);
64 * vpp implementation of glibc APIs from <sys/select.h>
67 vcom_select (int __nfds, fd_set * __restrict __readfds,
68 fd_set * __restrict __writefds,
69 fd_set * __restrict __exceptfds,
70 struct timeval *__restrict __timeout);
74 vcom_pselect (int __nfds, fd_set * __restrict __readfds,
75 fd_set * __restrict __writefds,
76 fd_set * __restrict __exceptfds,
77 const struct timespec *__restrict __timeout,
78 const __sigset_t * __restrict __sigmask);
82 * vpp implementation of glibc APIs from <sys/socket.h>
84 extern int __THROW vcom_socket (int __domain, int __type, int __protocol);
86 /* On Linux, the only supported domain for this call is AF_UNIX
87 * (or synonymously, AF_LOCAL). Most implementations have the
89 * vpp does not implement AF_UNIX domain in this release.
92 vcom_socketpair (int __domain, int __type, int __protocol, int __fds[2]);
95 vcom_bind (int __fd, __CONST_SOCKADDR_ARG __addr, socklen_t __len);
98 vcom_getsockname (int __fd, __SOCKADDR_ARG __addr,
99 socklen_t * __restrict __len);
102 vcom_connect (int __fd, __CONST_SOCKADDR_ARG __addr, socklen_t __len);
105 vcom_getpeername (int __fd, __SOCKADDR_ARG __addr,
106 socklen_t * __restrict __len);
109 vcom_send (int __fd, const void *__buf, size_t __n, int __flags);
111 extern ssize_t vcom_recv (int __fd, void *__buf, size_t __n, int __flags);
114 vcom_sendto (int __fd, const void *__buf, size_t __n,
115 int __flags, __CONST_SOCKADDR_ARG __addr, socklen_t __addr_len);
118 vcom_recvfrom (int __fd, void *__restrict __buf,
119 size_t __n, int __flags,
120 __SOCKADDR_ARG __addr, socklen_t * __restrict __addr_len);
123 vcom_sendmsg (int __fd, const struct msghdr *__message, int __flags);
127 sendmmsg (int __fd, struct mmsghdr *__vmessages,
128 unsigned int __vlen, int __flags);
131 extern ssize_t vcom_recvmsg (int __fd, struct msghdr *__message, int __flags);
135 vcom_recvmmsg (int __fd, struct mmsghdr *__vmessages,
136 unsigned int __vlen, int __flags, struct timespec *__tmo);
140 vcom_getsockopt (int __fd, int __level, int __optname,
141 void *__restrict __optval, socklen_t * __restrict __optlen);
144 vcom_setsockopt (int __fd, int __level, int __optname,
145 const void *__optval, socklen_t __optlen);
147 extern int __THROW vcom_listen (int __fd, int __n);
150 vcom_accept (int __fd, __SOCKADDR_ARG __addr,
151 socklen_t * __restrict __addr_len);
155 * Similar to 'accept' but takes an additional parameter to specify
158 /* TBD: implemented later */
160 vcom_accept4 (int __fd, __SOCKADDR_ARG __addr,
161 socklen_t * __restrict __addr_len, int __flags);
164 extern int __THROW vcom_shutdown (int __fd, int __how);
166 extern int __THROW vcom_epoll_create (int __size);
168 extern int __THROW vcom_epoll_create1 (int __flags);
171 vcom_epoll_ctl (int __epfd, int __op, int __fd, struct epoll_event *__event);
174 vcom_epoll_wait (int __epfd, struct epoll_event *__events,
175 int __maxevents, int __timeout);
178 vcom_epoll_pwait (int __epfd, struct epoll_event *__events,
179 int __maxevents, int __timeout, const __sigset_t * __ss);
182 * NOTE: observed __nfds is less than 128 from kubecon strace files
183 * for the POC, it's fair to assume that nfds is less than 1024.
184 * TBD: make it thread safe and design to scale.
186 #define MAX_POLL_NFDS_DEFAULT 1024
187 extern int vcom_poll (struct pollfd *__fds, nfds_t __nfds, int __timeout);
191 vcom_ppoll (struct pollfd *__fds, nfds_t __nfds,
192 const struct timespec *__timeout, const __sigset_t * __ss);
196 #endif /* included_vcom_h */
199 * fd.io coding-style-patch-verification: ON
202 * eval: (c-set-style "gnu")