summaryrefslogtreecommitdiffstats
path: root/lib/libc/gen/getcap.3
diff options
context:
space:
mode:
authormillert <millert@openbsd.org>2001-06-18 18:11:12 +0000
committermillert <millert@openbsd.org>2001-06-18 18:11:12 +0000
commit9fcb004c764af8db0c7100d692ccdec12a8e89e3 (patch)
tree50d2c4935c532cb6fdf946371026a87eb07eae91 /lib/libc/gen/getcap.3
parentcompile libc with -Werror since any warnings gcc produces without extra -Wfoo directives is something we care about (diff)
downloadwireguard-openbsd-9fcb004c764af8db0c7100d692ccdec12a8e89e3.tar.xz
wireguard-openbsd-9fcb004c764af8db0c7100d692ccdec12a8e89e3.zip
Add new cgetusedb() function to toggle reading of .db files in getcap(3).
Needed for cap_mkdb to really DRT when given several input files or an output file with a different name from the input file. cvs: ----------------------------------------------------------------------
Diffstat (limited to 'lib/libc/gen/getcap.3')
-rw-r--r--lib/libc/gen/getcap.326
1 files changed, 24 insertions, 2 deletions
diff --git a/lib/libc/gen/getcap.3 b/lib/libc/gen/getcap.3
index 75a1af6269d..07b31baf59b 100644
--- a/lib/libc/gen/getcap.3
+++ b/lib/libc/gen/getcap.3
@@ -1,4 +1,4 @@
-.\" $OpenBSD: getcap.3,v 1.20 2000/12/24 00:30:47 aaron Exp $
+.\" $OpenBSD: getcap.3,v 1.21 2001/06/18 18:11:14 millert Exp $
.\"
.\" Copyright (c) 1992, 1993
.\" The Regents of the University of California. All rights reserved.
@@ -47,7 +47,8 @@
.Nm cgetustr ,
.Nm cgetfirst ,
.Nm cgetnext ,
-.Nm cgetclose
+.Nm cgetclose ,
+.Nm cgetusedb
.Nd capability database access routines
.Sh SYNOPSIS
.Fd #include <stdlib.h>
@@ -71,6 +72,8 @@
.Fn cgetnext "char **buf" "char **db_array"
.Ft int
.Fn cgetclose "void"
+.Ft int
+.Fn cgetusedb "int usedb"
.Sh DESCRIPTION
The
.Fn cgetent
@@ -256,6 +259,25 @@ closes the sequential access and frees any memory and file descriptors
being used.
Note that it does not erase the buffer pushed by a call to
.Fn cgetset .
+.Pp
+.Fn cgetusedb
+allows the user to specify whether use or ignore database files ending in
+.Dq .db .
+If
+.Ar usedb
+is zero, files ending in
+.Dq .db
+will be ignored.
+If
+.Ar usedb
+is non-zero, files ending in
+.Dq .db
+will be used in preference to the text version.
+The default is to process
+.Dq .db
+files.
+.Fn cgetusedb
+returns the previous setting.
.Ss Capability database syntax
Capability databases are normally
.Tn ASCII