diff options
author | 2013-08-14 08:39:24 +0000 | |
---|---|---|
committer | 2013-08-14 08:39:24 +0000 | |
commit | 720a7a94e09f2fa9b3979870e0f199a15d3a66d3 (patch) | |
tree | 5567e8f2aba2c28a136428138dfd3a19c60604e1 /lib/libc | |
parent | no longer any need to quote macro lines with >9 args; (diff) | |
download | wireguard-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.3 | 27 | ||||
-rw-r--r-- | lib/libc/gen/authenticate.3 | 40 | ||||
-rw-r--r-- | lib/libc/sys/sigreturn.2 | 8 |
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. |