summaryrefslogtreecommitdiffstats
path: root/lib/libc
diff options
context:
space:
mode:
authorjmc <jmc@openbsd.org>2013-08-14 08:39:24 +0000
committerjmc <jmc@openbsd.org>2013-08-14 08:39:24 +0000
commit720a7a94e09f2fa9b3979870e0f199a15d3a66d3 (patch)
tree5567e8f2aba2c28a136428138dfd3a19c60604e1 /lib/libc
parentno longer any need to quote macro lines with >9 args; (diff)
downloadwireguard-openbsd-720a7a94e09f2fa9b3979870e0f199a15d3a66d3.tar.xz
wireguard-openbsd-720a7a94e09f2fa9b3979870e0f199a15d3a66d3.zip
some Bx/Ox conversion;
From: Jan Stary
Diffstat (limited to 'lib/libc')
-rw-r--r--lib/libc/gen/auth_subr.327
-rw-r--r--lib/libc/gen/authenticate.340
-rw-r--r--lib/libc/sys/sigreturn.28
3 files changed, 51 insertions, 24 deletions
diff --git a/lib/libc/gen/auth_subr.3 b/lib/libc/gen/auth_subr.3
index 3bdc69abb08..2b0d9f912ff 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.20 2013/06/05 03:39:22 tedu Exp $
+.\" $OpenBSD: auth_subr.3,v 1.21 2013/08/14 08:39:24 jmc Exp $
.\"
.\" Copyright (c) 1997 Berkeley Software Design, Inc. All rights reserved.
.\"
@@ -31,7 +31,7 @@
.\" SUCH DAMAGE.
.\"
.\" BSDI $From: auth_subr.3,v 2.5 2000/03/30 19:11:27 polk Exp $
-.Dd $Mdocdate: June 5 2013 $
+.Dd $Mdocdate: August 14 2013 $
.Dt BSD_AUTH 3
.Os
.Sh NAME
@@ -104,14 +104,19 @@
.Ft void
.Fn auth_setstate "auth_session_t *as" "int state"
.Sh DESCRIPTION
-These functions provide the lower level interface to the BSD
+These functions provide the lower level interface to the
+.Bx
Authentication system.
-They all operate on a BSD Authentication session pointer,
+They all operate on a
+.Bx
+Authentication session pointer,
.Fa as ,
which is returned by
.Fn auth_open .
The session pointer
-must be passed to all other BSD Authentication functions called.
+must be passed to all other
+.Bx
+Authentication functions called.
The
.Fn auth_open
function returns
@@ -173,9 +178,13 @@ is called.
.Pp
The remaining functions are described in alphabetical order.
.Pp
-The fundamental function for doing BSD Authentication is
+The fundamental function for doing
+.Bx
+Authentication is
.Fn auth_call .
-In addition to the pointer to the BSD Authentication session, it takes
+In addition to the pointer to the
+.Bx
+Authentication session, it takes
the following parameters:
.Bl -tag -width indent
.It Ar path
@@ -372,7 +381,9 @@ The latest challenge, if any, set for the session.
The class of the user, as defined by the
.Pa /etc/login.conf
file.
-This value is not directly used by BSD Authentication, rather, it is
+This value is not directly used by
+.Bx
+Authentication, rather, it is
passed to the login scripts for their possible use.
.It Dv AUTH_INTERACTIVE
If set to any value, then the session is tagged as interactive.
diff --git a/lib/libc/gen/authenticate.3 b/lib/libc/gen/authenticate.3
index 2ef92e6f9f8..3caa738002c 100644
--- a/lib/libc/gen/authenticate.3
+++ b/lib/libc/gen/authenticate.3
@@ -1,4 +1,4 @@
-.\" $OpenBSD: authenticate.3,v 1.14 2013/06/05 03:39:22 tedu Exp $
+.\" $OpenBSD: authenticate.3,v 1.15 2013/08/14 08:39:24 jmc Exp $
.\"
.\" Copyright (c) 1997 Berkeley Software Design, Inc. All rights reserved.
.\"
@@ -31,7 +31,7 @@
.\" SUCH DAMAGE.
.\"
.\" BSDI $From: authenticate.3,v 2.7 1998/09/03 20:27:20 prb Exp $
-.Dd $Mdocdate: June 5 2013 $
+.Dd $Mdocdate: August 14 2013 $
.Dt AUTHENTICATE 3
.Os
.Sh NAME
@@ -68,8 +68,9 @@
.Ft auth_session_t *
.Fn auth_verify "auth_session_t *as" "char *style" "char *name" "..."
.Sh DESCRIPTION
-These functions provide a simplified interface to the BSD Authentication
-system
+These functions provide a simplified interface to the
+.Bx
+Authentication system
.Pq see Xr bsd_auth 3 .
The
.Fn auth_userokay
@@ -130,9 +131,13 @@ The
.Fn auth_usercheck
function operates the same as the
.Fn auth_userokay
-function except that it does not close the BSD Authentication session created.
+function except that it does not close the
+.Bx
+Authentication session created.
Rather than returning the status of the session, it returns
-a pointer to the newly created BSD Authentication session.
+a pointer to the newly created
+.Bx
+Authentication session.
.Pp
The
.Fn auth_userchallenge
@@ -146,7 +151,8 @@ However, rather than authenticating the user, it returns a possible
challenge in the pointer pointed to by
.Ar challengep .
The return value of the function is a pointer to a newly created
-BSD Authentication session.
+.Bx
+Authentication session.
This challenge, if not
.Dv NULL ,
should be displayed to the user.
@@ -167,7 +173,9 @@ If
is zero then the session will be closed.
The
.Fn auth_userresponse
-function closes the BSD Authentication session and has the same
+function closes the
+.Bx
+Authentication session and has the same
return value as
.Fn auth_userokay .
For security reasons, when a
@@ -250,14 +258,18 @@ The
function is a front end to the
.Xr auth_call 3
function.
-It will open a BSD Authentication session, if needed, and will set
+It will open a
+.Bx
+Authentication session, if needed, and will set
the style and user name based on the
.Ar style
and
.Ar name
arguments, if not
.Dv NULL .
-Values for the style and user name in an existing BSD Authentication
+Values for the style and user name in an existing
+.Bx
+Authentication
session will be replaced and the old values freed (if the calling program
has obtained pointers to the style or user name via
.Xr auth_getitem 3 ,
@@ -267,7 +279,9 @@ The variable arguments are passed to
via the
.Xr auth_set_va_list 3
function.
-The, possibly created, BSD Authentication session is returned.
+The, possibly created,
+.Bx
+Authentication session is returned.
The
.Xr auth_getstate 3
or
@@ -315,7 +329,9 @@ and
.Fn auth_usercheck
only, use the
.Xr auth_setpwd 3
-function to copy the passwd struct into a BSD Authentication session structure
+function to copy the passwd struct into a
+.Bx
+Authentication session structure
which can then be passed to
.Fn auth_approval
or
diff --git a/lib/libc/sys/sigreturn.2 b/lib/libc/sys/sigreturn.2
index 2420dd3c6b5..f908fe13385 100644
--- a/lib/libc/sys/sigreturn.2
+++ b/lib/libc/sys/sigreturn.2
@@ -1,4 +1,4 @@
-.\" $OpenBSD: sigreturn.2,v 1.9 2007/05/31 19:19:34 jmc Exp $
+.\" $OpenBSD: sigreturn.2,v 1.10 2013/08/14 08:39:25 jmc Exp $
.\" $NetBSD: sigreturn.2,v 1.6 1995/02/27 12:37:40 cgd Exp $
.\"
.\" Copyright (c) 1985, 1991, 1993
@@ -30,7 +30,7 @@
.\"
.\" @(#)sigreturn.2 8.1 (Berkeley) 6/4/93
.\"
-.Dd $Mdocdate: May 31 2007 $
+.Dd $Mdocdate: August 14 2013 $
.Dt SIGRETURN 2
.Os
.Sh NAME
@@ -56,8 +56,8 @@ when returning from a signal to the previously executing program.
.Pp
Note that sigcontext contains machine dependent information.
.Sh NOTES
-This system call is not available in 4.2
-.Tn BSD
+This system call is not available in
+.Bx 4.2
hence it should not be used if backward compatibility is needed.
.Sh RETURN VALUES
If successful, the system call does not return.