/usr/include/libdlm.h is in libdlm-dev 3.1.7-0ubuntu2.
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 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 | #ifndef __LIBDLM_H
#define __LIBDLM_H
/*
* Typedefs for things that are compatible with the kernel but replicated here
* so that users only need the libdlm include file. libdlm itself needs the
* full kernel file so shouldn't use these.
*/
#define DLM_LVB_LEN 32
#ifndef BUILDING_LIBDLM
/*
* These two lengths are copied from linux/dlmconstants.h
* They are the max length of a lockspace name and the max length of a
* resource name.
*/
#define DLM_LOCKSPACE_LEN 64
#define DLM_RESNAME_MAXLEN 64
struct dlm_lksb {
int sb_status;
uint32_t sb_lkid;
char sb_flags;
char *sb_lvbptr;
};
/* lksb flags */
#define DLM_SBF_DEMOTED 0x01
#define DLM_SBF_VALNOTVALID 0x02
#define DLM_SBF_ALTMODE 0x04
/* dlm_new_lockspace flags */
#define DLM_LSFL_NODIR 0x00000001
#define DLM_LSFL_TIMEWARN 0x00000002
#define DLM_LSFL_FS 0x00000004
#define DLM_LSFL_NEWEXCL 0x00000008
#endif
#if 0
/* Dummy definition to keep linkages */
struct dlm_queryinfo;
#endif
extern int dlm_kernel_version(uint32_t *maj, uint32_t *min, uint32_t *patch);
extern void dlm_library_version(uint32_t *maj, uint32_t *min, uint32_t *patch);
/*
* Using the default lockspace
*
* lock_resource() - simple sync request or convert (requires pthreads)
* unlock_resource() - simple sync unlock (requires pthreads)
* dlm_lock() - async request or convert
* dlm_unlock() - async unlock or cancel
* dlm_lock_wait() - sync request or convert
* dlm_unlock_wait() - sync unlock or cancel
*/
#ifdef _REENTRANT
extern int lock_resource(const char *resource, int mode, int flags, int *lockid);
extern int unlock_resource(int lockid);
#endif
extern int dlm_lock(uint32_t mode,
struct dlm_lksb *lksb,
uint32_t flags,
const void *name,
unsigned int namelen,
uint32_t parent, /* unusued */
void (*astaddr) (void *astarg),
void *astarg,
void (*bastaddr) (void *astarg),
void *range); /* unused */
extern int dlm_unlock(uint32_t lkid,
uint32_t flags,
struct dlm_lksb *lksb,
void *astarg);
extern int dlm_lock_wait(uint32_t mode,
struct dlm_lksb *lksb,
uint32_t flags,
const void *name,
unsigned int namelen,
uint32_t parent, /* unused */
void *bastarg,
void (*bastaddr) (void *bastarg),
void *range); /* unused */
extern int dlm_unlock_wait(uint32_t lkid,
uint32_t flags,
struct dlm_lksb *lksb);
/*
* These two are for users that want to do their own FD handling
*
* dlm_get_fd() - returns fd for the default lockspace for polling and dispatch
* dlm_dispatch() - dispatches pending asts and basts
*/
extern int dlm_get_fd(void);
extern int dlm_dispatch(int fd);
/*
* Creating your own lockspace
*
* dlm_create_lockspace() - create and open a lockspace and return a handle
* to it. Privileges are required to create/release.
* dlm_new_lockspace() - same as create but allows flags
* dlm_open_lockspace() - simply returns a handle for an existing lockspace and
* may be called by ordinary users.
* dlm_release_lockspace()
* dlm_close_lockspace()
* dlm_ls_get_fd()
*
* NOTE: that if you dlm_create_lockspace() then dlm_open_lockspace() you will
* have two open files on the same device. Hardly a major problem but I thought
* it worth pointing out.
*/
typedef void *dlm_lshandle_t;
extern dlm_lshandle_t dlm_create_lockspace(const char *name, mode_t mode);
extern int dlm_release_lockspace(const char *name, dlm_lshandle_t ls,
int force);
extern dlm_lshandle_t dlm_open_lockspace(const char *name);
extern int dlm_close_lockspace(dlm_lshandle_t ls);
extern int dlm_ls_get_fd(dlm_lshandle_t ls);
extern dlm_lshandle_t dlm_new_lockspace(const char *name, mode_t mode,
uint32_t flags);
/*
* Using your own lockspace
*
* dlm_ls_lock()
* dlm_ls_lockx()
* dlm_ls_unlock()
* dlm_ls_lock_wait()
* dlm_ls_unlock_wait()
* dlm_ls_deadlock_cancel()
* dlm_ls_purge()
*/
extern int dlm_ls_lock(dlm_lshandle_t lockspace,
uint32_t mode,
struct dlm_lksb *lksb,
uint32_t flags,
const void *name,
unsigned int namelen,
uint32_t parent, /* unused */
void (*astaddr) (void *astarg),
void *astarg,
void (*bastaddr) (void *astarg),
void *range); /* unused */
extern int dlm_ls_lockx(dlm_lshandle_t lockspace,
uint32_t mode,
struct dlm_lksb *lksb,
uint32_t flags,
const void *name,
unsigned int namelen,
uint32_t parent, /* unused */
void (*astaddr) (void *astarg),
void *astarg,
void (*bastaddr) (void *astarg),
uint64_t *xid,
uint64_t *timeout);
extern int dlm_ls_unlock(dlm_lshandle_t lockspace,
uint32_t lkid,
uint32_t flags,
struct dlm_lksb *lksb,
void *astarg);
extern int dlm_ls_lock_wait(dlm_lshandle_t lockspace,
uint32_t mode,
struct dlm_lksb *lksb,
uint32_t flags,
const void *name,
unsigned int namelen,
uint32_t parent, /* unused */
void *bastarg,
void (*bastaddr) (void *bastarg),
void *range); /* unused */
extern int dlm_ls_unlock_wait(dlm_lshandle_t lockspace,
uint32_t lkid,
uint32_t flags,
struct dlm_lksb *lksb);
extern int dlm_ls_deadlock_cancel(dlm_lshandle_t ls,
uint32_t lkid,
uint32_t flags);
extern int dlm_ls_purge(dlm_lshandle_t lockspace,
int nodeid,
int pid);
/*
* For threaded applications
*
* dlm_pthread_init()
* dlm_ls_pthread_init() - call this before any locking operations and the ASTs
* will be delivered in their own thread.
* dlm_pthread_cleanup() - call the cleanup routine at application exit
* (optional) or, if the locking functions are in a
* shared library that is to be unloaded.
*
* dlm_close/release_lockspace() will tidy the threads for a non-default
* lockspace
*/
#ifdef _REENTRANT
extern int dlm_pthread_init(void);
extern int dlm_ls_pthread_init(dlm_lshandle_t lockspace);
extern int dlm_pthread_cleanup(void);
#endif
/*
* Lock modes
*/
#define LKM_NLMODE 0 /* null lock */
#define LKM_CRMODE 1 /* concurrent read */
#define LKM_CWMODE 2 /* concurrent write */
#define LKM_PRMODE 3 /* protected read */
#define LKM_PWMODE 4 /* protected write */
#define LKM_EXMODE 5 /* exclusive */
/*
* Locking flags - these match the ones in dlm.h
*/
#define LKF_NOQUEUE 0x00000001
#define LKF_CANCEL 0x00000002
#define LKF_CONVERT 0x00000004
#define LKF_VALBLK 0x00000008
#define LKF_QUECVT 0x00000010
#define LKF_IVVALBLK 0x00000020
#define LKF_CONVDEADLK 0x00000040
#define LKF_PERSISTENT 0x00000080
#define LKF_NODLCKWT 0x00000100
#define LKF_NODLCKBLK 0x00000200
#define LKF_EXPEDITE 0x00000400
#define LKF_NOQUEUEBAST 0x00000800
#define LKF_HEADQUE 0x00001000
#define LKF_NOORDER 0x00002000
#define LKF_ORPHAN 0x00004000
#define LKF_ALTPR 0x00008000
#define LKF_ALTCW 0x00010000
#define LKF_FORCEUNLOCK 0x00020000
#define LKF_TIMEOUT 0x00040000
#define LKF_WAIT 0x80000000 /* Userspace only, for sync API calls */
/*
* Extra return codes used by the DLM
*/
#define ECANCEL 0x10001
#define EUNLOCK 0x10002
#define EINPROG 0x10003 /* lock operation is in progress */
#endif
|