/usr/include/libvdeplug_dyn.h is in libvdeplug2-dev 2.2.3-3build2.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
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 | /*
* libvdeplug - A library to connect to a VDE Switch.
* dynamic loading version (requires libdl).
*
* Copyright (C) 2006,2007 Renzo Davoli, University of Bologna
*
* This library is free software; you can redistribute it and/or modify it
* under the terms of the GNU Lesser General Public License as published by
* the Free Software Foundation version 2.1 of the License, or (at
* your option) any later version.
*
* This library is distributed in the hope that it will be useful, but
* WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser
* General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public
* License along with this library; if not, write to the Free Software
* Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA
*/
/* Use this include file when you need to write an application that can
* benefit from vde when available.
* Linking libvdeplug to your programs you force your application users
* to have the library installed (otherway the dynamic linker complies
* and the program does not start).
*
*
* usage:
* define a struct vdepluglib variable;
* eg:
* struct vdepluglib vdeplug;
*
* test the availability of the library and load it:
*
* libvdeplug_dynopen(vdeplug);
* if vdeplug.dl_handle is not NULL the library is ready otherwise it is
* not available in the target system.
*
* if libvdeplug does exist the library function can be called
* in this way:
* vdeplug.vde_open(....)
* vdeplug.vde_read(....)
* vdeplug.vde_open(....)
* vdeplug.vde_recv(....)
* vdeplug.vde_send(....)
* vdeplug.vde_datafd(....)
* vdeplug.vde_ctlfd(....)
* vdeplug.vde_close(....)
* libvdeplug_dynclose(vdeplug) can be used to deallocate the dynamic library
* when needed.
*************************************************/
#ifndef _VDEDYNLIB_H
#define _VDEDYNLIB_H
#include <sys/types.h>
#include <dlfcn.h>
#define LIBVDEPLUG_INTERFACE_VERSION 1
struct vdeconn;
typedef struct vdeconn VDECONN;
/* Open a VDE connection.
* vde_open_options:
* port: connect to a specific port of the switch (0=any)
* group: change the ownership of the communication port to a specific group
* (NULL=no change)
* mode: set communication port mode (if 0 standard socket mode applies)
*/
struct vde_open_args {
int port;
char *group;
mode_t mode;
};
/* vde_open args:
* vde_switch: switch id (path)
* descr: description (it will appear in the port description on the switch)
*/
#define vde_open(vde_switch,descr,open_args) \
vde_open_real((vde_switch),(descr),LIBVDEPLUG_INTERFACE_VERSION,(open_args))
struct vdepluglib {
void *dl_handle;
VDECONN * (*vde_open_real)(const char *vde_switch,char *descr,int interface_version, struct vde_open_args *open_args);
size_t (* vde_recv)(VDECONN *conn,void *buf,size_t len,int flags);
size_t (* vde_send)(VDECONN *conn,const void *buf,size_t len,int flags);
int (* vde_datafd)(VDECONN *conn);
int (* vde_ctlfd)(VDECONN *conn);
int (* vde_close)(VDECONN *conn);
};
typedef VDECONN * (* VDE_OPEN_REAL_T)(const char *vde_switch,char *descr,int interface_version, struct vde_open_args *open_args);
typedef size_t (* VDE_RECV_T)(VDECONN *conn,void *buf,size_t len,int flags);
typedef size_t (* VDE_SEND_T)(VDECONN *conn,const void *buf,size_t len,int flags);
typedef int (* VDE_INT_FUN)(VDECONN *conn);
#define libvdeplug_dynopen(x) ({ \
(x).dl_handle=dlopen("libvdeplug.so",RTLD_NOW); \
if ((x).dl_handle) { \
(x).vde_open_real=(VDE_OPEN_REAL_T) dlsym((x).dl_handle,"vde_open_real"); \
(x).vde_recv=(VDE_RECV_T) dlsym((x).dl_handle,"vde_recv"); \
(x).vde_send=(VDE_SEND_T) dlsym((x).dl_handle,"vde_send"); \
(x).vde_datafd=(VDE_INT_FUN) dlsym((x).dl_handle,"vde_datafd"); \
(x).vde_ctlfd=(VDE_INT_FUN) dlsym((x).dl_handle,"vde_ctlfd"); \
(x).vde_close=(VDE_INT_FUN) dlsym((x).dl_handle,"vde_close"); \
} else { \
(x).vde_open_real=NULL; \
(x).vde_send= NULL; \
(x).vde_recv= NULL; \
(x).vde_datafd= (x).vde_ctlfd= (x).vde_close= NULL; \
}\
})
#define libvdeplug_dynclose(x) ({ \
dlclose((x).dl_handle); \
})
#endif
|