summaryrefslogtreecommitdiffstats
path: root/debian/manpages/tdb_chainlock.3
diff options
context:
space:
mode:
Diffstat (limited to 'debian/manpages/tdb_chainlock.3')
-rw-r--r--debian/manpages/tdb_chainlock.331
1 files changed, 31 insertions, 0 deletions
diff --git a/debian/manpages/tdb_chainlock.3 b/debian/manpages/tdb_chainlock.3
new file mode 100644
index 0000000..ffc56ff
--- /dev/null
+++ b/debian/manpages/tdb_chainlock.3
@@ -0,0 +1,31 @@
+.TH TDB_CHAINLOCK 3 "Oct 13, 2000" "Samba" "Linux Programmer's Manual"
+.SH NAME
+tdb_chainlock \- lock a group of keys
+tdb_chainunlock \- unlock a previously locked group of keys
+.SH SYNOPSIS
+.nf
+.B #include <tdb.h>
+.sp
+.BI "int tdb_chainlock(TDB_CONTEXT *" tdb ", TDB_DATA " key ");"
+.BI "void tdb_chainunlock(TDB_CONTEXT *" tdb ", TDB_DATA " key ");"
+.sp
+.SH DESCRIPTION
+.I tdb_chainlock
+is a low\-level function used to lock a particular key (and a number of
+other keys) without any checking: any other process attempting to
+perform tdb operations on those keys will block until
+.I tdb_chainunlock
+is called.
+.SH NOTES
+It is the user's responsibility to ensure that they do not deadlock
+the database using these functions: something which is impossible
+using the other access functions.
+.SH "RETURN VALUE"
+A return value of 0 indicates success and \-1 indicates failure.
+.SH AUTHORS
+Software: Andrew Tridgell <tridge@linuxcare.com>
+Man page: Rusty.
+.SH "SEE ALSO"
+.BR gdbm (3),
+.BR tdb (3),
+.BR tdb_lockall (3).