/usr/include/mysql/mysql/service_locking.h is in libmysqlclient-dev 5.7.11-0ubuntu6.
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 | /*
Copyright (c) 2015, Oracle and/or its affiliates. All rights reserved.
This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; version 2 of the License.
This program 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 General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
*/
#ifndef SERVICE_LOCKING_INCLUDED
#define SERVICE_LOCKING_INCLUDED
/*
This service provides support for taking read/write locks.
It is intended for use with fabric, but it is still a general
service. The locks are in a separate namespace from other
locks in the server, and there is also no interactions with
transactions (i.e. locks are not released on commit/abort).
These locks are implemented using the metadata lock (MDL) subsystem
and thus deadlocks involving locking service locks and other types
of metadata will be detected using the MDL deadlock detector.
*/
#ifdef __cplusplus
class THD;
#define MYSQL_THD THD*
#else
#define MYSQL_THD void*
#endif
#ifdef __cplusplus
extern "C" {
#endif
/**
Types of locking service locks.
LOCKING_SERVICE_READ is compatible with LOCKING_SERVICE_READ.
All other combinations are incompatible.
*/
enum enum_locking_service_lock_type
{ LOCKING_SERVICE_READ, LOCKING_SERVICE_WRITE };
extern struct mysql_locking_service_st {
/**
Acquire locking service locks.
@param opaque_thd Thread handle. If NULL, current_thd will be used.
@param lock_namespace Namespace of the locks to acquire.
@param lock_names Array of names of the locks to acquire.
@param lock_num Number of elements in 'lock_names'.
@param lock_type Lock type to acquire. LOCKING_SERVICE_READ or _WRITE.
@param lock_timeout Number of seconds to wait before giving up.
@retval 1 Acquisition failed, error has been reported.
@retval 0 Acquisition successful, all locks acquired.
@note both lock_namespace and lock_names are limited to 64 characters max.
Names are compared using binary comparison.
*/
int (*mysql_acquire_locks)(MYSQL_THD opaque_thd, const char* lock_namespace,
const char**lock_names, size_t lock_num,
enum enum_locking_service_lock_type lock_type,
unsigned long lock_timeout);
/**
Release all lock service locks taken by the given connection
in the given namespace.
@param opaque_thd Thread handle. If NULL, current_thd will be used.
@param lock_namespace Namespace of the locks to release.
@retval 1 Release failed, error has been reported.
@retval 0 Release successful, all locks acquired.
*/
int (*mysql_release_locks)(MYSQL_THD opaque_thd, const char* lock_namespace);
} *mysql_locking_service;
#ifdef MYSQL_DYNAMIC_PLUGIN
#define mysql_acquire_locking_service_locks(_THD, _NAMESPACE, _NAMES, _NUM, \
_TYPE, _TIMEOUT) \
mysql_locking_service->mysql_acquire_locks(_THD, _NAMESPACE, _NAMES, _NUM, \
_TYPE, _TIMEOUT)
#define mysql_release_locking_service_locks(_THD, _NAMESPACE) \
mysql_locking_service->mysql_release_locks(_THD, _NAMESPACE)
#else
int mysql_acquire_locking_service_locks(MYSQL_THD opaque_thd,
const char* lock_namespace,
const char**lock_names,
size_t lock_num,
enum enum_locking_service_lock_type lock_type,
unsigned long lock_timeout);
int mysql_release_locking_service_locks(MYSQL_THD opaque_thd,
const char* lock_namespace);
#endif /* MYSQL_DYNAMIC_PLUGIN */
#ifdef __cplusplus
}
#endif
#endif /* SERVICE_LOCKING_INCLUDED */
|