fullock man page
fullock — Fast User Level LOCK (FULLOCK) library for C/C++
Please see fullock.h for full description.
fullock is an open-source software for user level lock library supported by Yahoo! JAPAN. It runs on user level and provides two types lock. One is a shared reader/writer lock which has the same functionality with pthread_rwlock. Another is a shared mutex lock which also has the same functionality with pthread_mutex.
Here is primary fullock features:
- fullock is a thread safety library which can be used for multi-processing as well as for multi-threading.
- fullock releases a mutex lock safely even if a lock owner process exit with 0 in which case OS doesn't release the lock.
- fullock provides a shared reader/writer lock. A lock owner thread can get another lock again without deadlock.
Please visit our website and get more details at:
- FULLOCK provides following programming interface:
void fullock_print_version(...) bool fullock_set_no_robust(...) bool fullock_set_low_robust(...) bool fullock_set_high_robust(...) bool fullock_set_noretry_allow_nomap(...) bool fullock_set_noretry_deny_nomap(...) bool fullock_set_retry_allow_nomap(...) bool fullock_set_retry_deny_nomap(...) bool fullock_set_no_freeunit(...) bool fullock_set_fd_freeunit(...) bool fullock_set_offset_freeunit(...) bool fullock_set_robust_check_count(...) bool fullock_reinitialize(...) bool fullock_reinitialize_ex(...) int fullock_mutex_lock(...) int fullock_mutex_trylock(...) int fullock_mutex_timedlock(...) int fullock_mutex_unlock(...) int fullock_rwlock_rdlock(...) int fullock_rwlock_tryrdlock(...) int fullock_rwlock_timedrdlock(...) int fullock_rwlock_wrlock(...) int fullock_rwlock_trywrlock(...) int fullock_rwlock_timedwrlock(...) int fullock_rwlock_unrwlock(...) bool fullock_rwlock_islocked(...) int fullock_cond_timedwait(...) int fullock_cond_wait(...) int fullock_cond_signal(...) int fullock_cond_broadcast(...)
fullock uses useful environments for debug that change its behaviour.
specifies debugging level: INFO/WAN/ERR/SILENT
output file path for message(default: stderr)
specify YES/NO, if this environment has YES, fullock does not initialize shared memory file. This environment is for debugging.
specify NO/LOW/HIGH for robust mode.
specify ALLOW(ALLOW_NORETRY) / DENY(DENY_NORETRY) / ALLOW_RETRY / DENY_RETRY for fault tolerant. This value determines the behavior of the case can not be mapped.
specify NO/FD/OFFSET/ALWAYS, it specifies the open method of unit management area to be used in the reader/writer lock.
If fullock is operating in a high robust mode, this value sets the processing frequency for the deadlock detection.
specify umask for the shared memory file which is made by fullock.
specify directory path for the shared memory file which is made by fullock.
specify the shared memory file name which is made by fullock.
specify file count for the reader/writer lock.
specify offset count for the reader/writer lock.
specify the process(thread) count for the reader/writer lock and mutex at same time.
specify count for named mutex.
specify count for named condition variable.
specify named condition waiter count for named condition variable.
The web site can be found at:
Please make sure you use the latest version in the web site:
Then, please submit your questions or comments here:
Takeshi Nakatani <email@example.com>
Copyright (C) 2015 Yahoo Japan Corporation
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE Authors OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.