/usr/include/gwenhywfar4/gwenhywfar/fslock.h is in libgwenhywfar-core-dev 4.15.3-5+b1.
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 | /***************************************************************************
$RCSfile$
-------------------
cvs : $Id$
begin : Wed Mar 24 2004
copyright : (C) 2004 by Martin Preuss
email : martin@libchipcard.de
***************************************************************************
* *
* 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., 59 Temple Place, Suite 330, Boston, *
* MA 02111-1307 USA *
* *
***************************************************************************/
#ifndef GWEN_FSLOCK_H
#define GWEN_FSLOCK_H
/** @defgroup MOD_FSLOCK Simple File/Folder Lock Management
* @ingroup MOD_OS
*
* @brief This group contains the definition of a GWEN_FSLOCK.
*
* The files in this group provide a very simple lock mechanism.
* When a file is to be locked a lockfile is created exclusively. If this
* lockfile can not be created exclusively (because it already exists) the
* file is assumed to be locked.
* This group can lock files and folders. For folders the lockfile name
* consists of the foldername plus "/.dir.lck", for files it is the filename
* plus ".lck". This only works if you have write-access to the folder or,
* if locking a file, to the folder containing the file to be locked.
*/
/*@{*/
#ifdef __cplusplus
extern "C" {
#endif
#include <gwenhywfar/gwenhywfarapi.h>
#include <gwenhywfar/types.h>
#include <gwenhywfar/list1.h>
#include <gwenhywfar/list2.h>
typedef struct GWEN_FSLOCK GWEN_FSLOCK;
GWEN_LIST_FUNCTION_LIB_DEFS(GWEN_FSLOCK, GWEN_FSLock, GWENHYWFAR_API)
GWEN_LIST2_FUNCTION_LIB_DEFS(GWEN_FSLOCK, GWEN_FSLock, GWENHYWFAR_API)
typedef enum {
GWEN_FSLock_TypeUnknown=0,
GWEN_FSLock_TypeFile,
GWEN_FSLock_TypeDir
} GWEN_FSLOCK_TYPE;
typedef enum {
GWEN_FSLock_ResultOk=0,
GWEN_FSLock_ResultError,
GWEN_FSLock_ResultTimeout,
GWEN_FSLock_ResultBusy,
GWEN_FSLock_ResultNoLock,
GWEN_FSLock_ResultUserAbort
} GWEN_FSLOCK_RESULT;
#include <gwenhywfar/db.h>
#include <gwenhywfar/gui.h>
GWENHYWFAR_API
GWEN_FSLOCK *GWEN_FSLock_new(const char *fname, GWEN_FSLOCK_TYPE t);
GWENHYWFAR_API
void GWEN_FSLock_free(GWEN_FSLOCK *fl);
GWENHYWFAR_API
void GWEN_FSLock_Attach(GWEN_FSLOCK *fl);
/**
* This function tries to acquire a lock for the given file/folder.
* It waits if necessary (using @ref GWEN_Gui_ProgressStart) while waiting.
* @param fl fslock object
* @param timeout timeout in milliseconds (special values are
* @ref GWEN_TIMEOUT_NONE (which does not wait at all) and
* @ref GWEN_TIMEOUT_FOREVER (which waits forever).
*/
GWENHYWFAR_API
GWEN_FSLOCK_RESULT GWEN_FSLock_Lock(GWEN_FSLOCK *fl, int timeout, uint32_t gid);
/**
* This function removes a lock.
* @param fl fslock object
*/
GWENHYWFAR_API
GWEN_FSLOCK_RESULT GWEN_FSLock_Unlock(GWEN_FSLOCK *fl);
GWENHYWFAR_API
const char *GWEN_FSLock_GetName(const GWEN_FSLOCK *fl);
#ifdef __cplusplus
}
#endif
/*@}*/ /* defgroup */
#endif
|