summaryrefslogtreecommitdiffstats
path: root/lib/libc
diff options
context:
space:
mode:
authormillert <millert@openbsd.org>2002-10-15 17:53:18 +0000
committermillert <millert@openbsd.org>2002-10-15 17:53:18 +0000
commitaedb4394001a4d78a82e830652f5a0893dc715d5 (patch)
treeaa2719b9f714d82db7685d52b8e3c939c11c6164 /lib/libc
parentsync (diff)
downloadwireguard-openbsd-aedb4394001a4d78a82e830652f5a0893dc715d5.tar.xz
wireguard-openbsd-aedb4394001a4d78a82e830652f5a0893dc715d5.zip
Document the fact that calling auth_setitem() with a NULL value
clears (frees) the corresponding value in the auth session.
Diffstat (limited to 'lib/libc')
-rw-r--r--lib/libc/gen/auth_subr.317
1 files changed, 13 insertions, 4 deletions
diff --git a/lib/libc/gen/auth_subr.3 b/lib/libc/gen/auth_subr.3
index c31a37007e0..33b22eba227 100644
--- a/lib/libc/gen/auth_subr.3
+++ b/lib/libc/gen/auth_subr.3
@@ -1,4 +1,4 @@
-.\" $OpenBSD: auth_subr.3,v 1.8 2002/05/08 16:31:05 millert Exp $
+.\" $OpenBSD: auth_subr.3,v 1.9 2002/10/15 17:53:18 millert Exp $
.\"
.\" Copyright (c) 1997 Berkeley Software Design, Inc. All rights reserved.
.\"
@@ -363,6 +363,8 @@ The style of authentication being performed, as defined by the
.Pa /etc/login.conf file.
The style determines which login script should actually be used.
.El
+The value returned points to private memory and should not be
+freed by the caller.
.Pp
The
.Fn auth_getvalue
@@ -422,13 +424,20 @@ The items are described above with the
.Fn auth_getitem
function.
In addition, if
-.Fa item
+.Fa value
is
-.Li AUTH_ALL
-and
+.Dv NULL ,
+the
+.Fa item
+is cleared.
+If
.Fa value
is
.Dv NULL
+and
+.Fa item
+is
+.Li AUTH_ALL
then all items are cleared.
.Pp
The