diff options
author | 2013-08-14 08:39:24 +0000 | |
---|---|---|
committer | 2013-08-14 08:39:24 +0000 | |
commit | 720a7a94e09f2fa9b3979870e0f199a15d3a66d3 (patch) | |
tree | 5567e8f2aba2c28a136428138dfd3a19c60604e1 /lib | |
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')
-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 | ||||
-rw-r--r-- | lib/libkvm/kvm.3 | 12 | ||||
-rw-r--r-- | lib/libkvm/kvm_open.3 | 12 | ||||
-rw-r--r-- | lib/libutil/check_expire.3 | 8 |
6 files changed, 72 insertions, 35 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. diff --git a/lib/libkvm/kvm.3 b/lib/libkvm/kvm.3 index dfeffec876a..c101f72721b 100644 --- a/lib/libkvm/kvm.3 +++ b/lib/libkvm/kvm.3 @@ -1,4 +1,4 @@ -.\" $OpenBSD: kvm.3,v 1.8 2011/08/18 13:01:26 jmc Exp $ +.\" $OpenBSD: kvm.3,v 1.9 2013/08/14 08:39:25 jmc Exp $ .\" $NetBSD: kvm.3,v 1.2 1996/03/18 22:33:11 thorpej Exp $ .\" .\" Copyright (c) 1992, 1993 @@ -34,7 +34,7 @@ .\" .\" @(#)kvm.3 8.1 (Berkeley) 6/4/93 .\" -.Dd $Mdocdate: August 18 2011 $ +.Dd $Mdocdate: August 14 2013 $ .Dt KVM 3 .Os .Sh NAME @@ -81,7 +81,9 @@ Accordingly, the generic portion of the interface (i.e., .Fn kvm_write , and .Fn kvm_nlist ) -has been incorporated into the BSD interface. +has been incorporated into the +.Bx +interface. Indeed, many kvm applications (i.e., debuggers and statistical monitors) use only this subset of the interface. @@ -95,7 +97,9 @@ Finally, the Sun kvm error reporting semantics are poorly defined. The library can be configured either to print errors to stderr automatically, or to print no error messages at all. In the latter case, the nature of the error cannot be determined. -To overcome this, the BSD interface includes a +To overcome this, the +.Bx +interface includes a routine, .Xr kvm_geterr 3 , to return (not print out) the error message diff --git a/lib/libkvm/kvm_open.3 b/lib/libkvm/kvm_open.3 index 0309847df4c..b597eca9849 100644 --- a/lib/libkvm/kvm_open.3 +++ b/lib/libkvm/kvm_open.3 @@ -1,4 +1,4 @@ -.\" $OpenBSD: kvm_open.3,v 1.15 2013/06/05 03:40:26 tedu Exp $ +.\" $OpenBSD: kvm_open.3,v 1.16 2013/08/14 08:39:25 jmc Exp $ .\" $NetBSD: kvm_open.3,v 1.2 1996/03/18 22:33:52 thorpej Exp $ .\" .\" Copyright (c) 1992, 1993 @@ -34,7 +34,7 @@ .\" .\" @(#)kvm_open.3 8.3 (Berkeley) 4/19/94 .\" -.Dd $Mdocdate: June 5 2013 $ +.Dd $Mdocdate: August 14 2013 $ .Dt KVM_OPEN 3 .Os .Sh NAME @@ -142,7 +142,9 @@ call. .Pp The .Fn kvm_openfiles -function provides BSD style error reporting. +function provides +.Bx +style error reporting. Here, error messages are not printed out by the library. Instead, the application obtains the error message corresponding to the most recent kvm library call using @@ -195,4 +197,6 @@ function returns 0 on success and \-1 on failure. .Sh BUGS There should not be two open calls. The ill-defined error semantics of the Sun library and the desire to have -a backward-compatible library for BSD left little choice. +a backward-compatible library for +.Bx +left little choice. diff --git a/lib/libutil/check_expire.3 b/lib/libutil/check_expire.3 index b033bb9a262..5405bac73e4 100644 --- a/lib/libutil/check_expire.3 +++ b/lib/libutil/check_expire.3 @@ -1,4 +1,4 @@ -.\" $OpenBSD: check_expire.3,v 1.8 2013/06/05 03:40:26 tedu Exp $ +.\" $OpenBSD: check_expire.3,v 1.9 2013/08/14 08:39:26 jmc Exp $ .\" .\" Copyright (c) 2000 Todd C. Miller <Todd.Miller@courtesan.com> .\" @@ -14,7 +14,7 @@ .\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF .\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. .\" -.Dd $Mdocdate: June 5 2013 $ +.Dd $Mdocdate: August 14 2013 $ .Dt CHECK_EXPIRE 3 .Os .Sh NAME @@ -28,7 +28,9 @@ .Sh DESCRIPTION The .Fn login_check_expire -function is called by a BSD authentication login script to +function is called by a +.Bx +Authentication login script to check whether the user's password entry, as described by .Fa pwd , has expired. |