1 /*
2  * Copyright (c) 2007, XenSource Inc.
3  * All rights reserved.
4  *
5  * Redistribution and use in source and binary forms, with or without
6  * modification, are permitted provided that the following conditions are met:
7  *     * Redistributions of source code must retain the above copyright
8  *       notice, this list of conditions and the following disclaimer.
9  *     * Redistributions in binary form must reproduce the above copyright
10  *       notice, this list of conditions and the following disclaimer in the
11  *       documentation and/or other materials provided with the distribution.
12  *     * Neither the name of XenSource Inc. nor the names of its contributors
13  *       may be used to endorse or promote products derived from this software
14  *       without specific prior written permission.
15  *
16  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
17  * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
18  * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
19  * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER
20  * OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
21  * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
22  * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
23  * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
24  * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
25  * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
26  * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
27  */
28 
29 #define DEFAULT_LEASE_TIME_SECS 30
30 
31 int lock(char *fn_to_lock, char *uuid, int force, int readonly, int *lease_time, int *retstat);
32 int unlock(char *fn_to_unlock, char *uuid, int readonly, int *retstat);
33 int lock_delta(char *fn_to_check, int *cur_lease_time, int *max_lease_time);
34 
35 typedef enum {
36     LOCK_OK          =  0,
37     LOCK_EBADPARM    = -1,
38     LOCK_ENOMEM      = -2,
39     LOCK_ESTAT       = -3,
40     LOCK_EHELD_WR    = -4,
41     LOCK_EHELD_RD    = -5,
42     LOCK_EOPEN       = -6,
43     LOCK_EXLOCK_OPEN = -7,
44     LOCK_EXLOCK_WRITE= -8,
45     LOCK_EINODE      = -9,
46     LOCK_EUPDATE     = -10,
47     LOCK_EREAD       = -11,
48     LOCK_EREMOVE     = -12,
49     LOCK_ENOLOCK     = -13,
50     LOCK_EUSAGE      = -14,
51 } lock_error;
52