mirror of
https://github.com/ibm-s390-linux/s390-tools.git
synced 2026-08-05 02:14:52 +00:00
af730c79a6
Provide a mechanism via which a caller can query the pid of the process currently holding the file lock. Reviewed-by: Jan Höppner <hoeppner@linux.ibm.com> Reviewed-by: Boris Fiuczynski <fiuczy@linux.ibm.com> Acked-by: Steffen Eiden <seiden@linux.ibm.com> Signed-off-by: Matthew Rosato <mjrosato@linux.ibm.com> Signed-off-by: Steffen Eiden <seiden@linux.ibm.com>
29 lines
1000 B
C
29 lines
1000 B
C
/**
|
|
* @defgroup util_lockfile_h util_lockfile: File locking utility
|
|
* @{
|
|
* @brief Create file-based locks
|
|
*
|
|
* Copyright IBM Corp. 2022
|
|
*
|
|
* s390-tools is free software; you can redistribute it and/or modify
|
|
* it under the terms of the MIT license. See LICENSE for details.
|
|
*/
|
|
#ifndef LIB_UTIL_LOCKFILE_H
|
|
#define LIB_UTIL_LOCKFILE_H
|
|
|
|
#define UTIL_LOCKFILE_OK 0 /* Lock acquired/released successfully */
|
|
#define UTIL_LOCKFILE_LOCK_FAIL 1 /* Lock already held, ran out of retries */
|
|
#define UTIL_LOCKFILE_RELEASE_NONE 2 /* Lock not held */
|
|
#define UTIL_LOCKFILE_RELEASE_FAIL 3 /* Lock not held by specified pid */
|
|
#define UTIL_LOCKFILE_ERR 4 /* Other, unexpected error conditions */
|
|
|
|
int util_lockfile_lock(char *lockfile, int retries);
|
|
int util_lockfile_parent_lock(char *lockfile, int retries);
|
|
|
|
int util_lockfile_release(char *lockfile);
|
|
int util_lockfile_parent_release(char *lockfile);
|
|
|
|
int util_lockfile_peek_owner(char *lockfile, int *pid);
|
|
|
|
#endif /** LIB_UTIL_LOCKFILE_H @} */
|