208807180a
The serial ops used a legacy calling convention that passed in just the pointer to the userdata pointer (ie the first argument to the functions was "void **userdata"). That's actually very inconvenient, because the custom IO data can not only contain other interesting information that was filled in by the custom IO provider, it also made it harder to chain these things together, as exemplified by the core to emulate serial over the packet interface in the subsurface bluetooth code. This also adds the 'dc_context_t' field that is passed to the packet routine open. That can allow the open routine to override the 'custom_io' details of the context at open time (to allow nested custom_io operation). Note that callers of the open function need to be aware that the 'custom_io' can be changed by the act of opening a custom_io, and the value shouldn't be cached in some local variable. Finally, this adds a new user-supplied opaque pointer dc_user_device_t *user_device; to the custom_io descriptor. The 'user_device' data is filled in when registering the custom_io with data that the custom IO open() routines can use. This is different from the existing 'userdata' in that the 'user_device' is filled in before dc_open_device() is called (and "open" can then use it to limit what kinds of devices it looks for, for example). In contrast, the existing 'userdata' field is filled in by the "xyz_open()" routines, and contains the data necessary for the IO itself. The SSRF_CUSTOM_IO define is updated to v2 to indicate the new interfaces. Signed-off-by: Linus Torvalds <torvalds@linux-foundation.org>
61 lines
1.7 KiB
C
61 lines
1.7 KiB
C
/*
|
|
* libdivecomputer
|
|
*
|
|
* Copyright (C) 2010 Jef Driesen
|
|
*
|
|
* 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; either
|
|
* 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 Street, Fifth Floor, Boston,
|
|
* MA 02110-1301 USA
|
|
*/
|
|
|
|
#ifndef DC_VERSION_H
|
|
#define DC_VERSION_H
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif /* __cplusplus */
|
|
|
|
/* use these defines to detect Subsurface specific features */
|
|
#define SSRF_LIBDC_VERSION 2
|
|
#define SSRF_CUSTOM_IO 2
|
|
|
|
#define DC_VERSION "@DC_VERSION@"
|
|
#define DC_VERSION_MAJOR @DC_VERSION_MAJOR@
|
|
#define DC_VERSION_MINOR @DC_VERSION_MINOR@
|
|
#define DC_VERSION_MICRO @DC_VERSION_MICRO@
|
|
|
|
#define DC_VERSION_CHECK(major,minor,micro) \
|
|
(DC_VERSION_MAJOR > (major) || \
|
|
(DC_VERSION_MAJOR == (major) && DC_VERSION_MINOR > (minor)) || \
|
|
(DC_VERSION_MAJOR == (major) && DC_VERSION_MINOR == (minor) && \
|
|
DC_VERSION_MICRO >= (micro)))
|
|
|
|
typedef struct dc_version_t {
|
|
unsigned int major;
|
|
unsigned int minor;
|
|
unsigned int micro;
|
|
} dc_version_t;
|
|
|
|
const char *
|
|
dc_version (dc_version_t *version);
|
|
|
|
int
|
|
dc_version_check (unsigned int major, unsigned int minor, unsigned int micro);
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif /* __cplusplus */
|
|
|
|
#endif /* DC_VERSION_H */
|