Sat Dec 17 21:24:41 2011 UTC ()
Use more markup. Bump date for previous.


(wiz)
diff -r1.4 -r1.5 src/share/man/man9/cprng.9
cvs diff -r1.4 -r1.5 src/share/man/man9/cprng.9 (expand / switch to unified diff)

--- src/share/man/man9/cprng.9 2011/12/17 20:05:38 1.4
+++ src/share/man/man9/cprng.9 2011/12/17 21:24:40 1.5
@@ -1,14 +1,14 @@ @@ -1,14 +1,14 @@
1.\" $NetBSD: cprng.9,v 1.4 2011/12/17 20:05:38 tls Exp $ 1.\" $NetBSD: cprng.9,v 1.5 2011/12/17 21:24:40 wiz Exp $
2.\" 2.\"
3.\" Copyright (c) 2011 The NetBSD Foundation, Inc. 3.\" Copyright (c) 2011 The NetBSD Foundation, Inc.
4.\" All rights reserved. 4.\" All rights reserved.
5.\" 5.\"
6.\" This code is derived from software contributed to The NetBSD Foundation 6.\" This code is derived from software contributed to The NetBSD Foundation
7.\" by Thor Lancelot Simon. 7.\" by Thor Lancelot Simon.
8.\" 8.\"
9.\" Redistribution and use in source and binary forms, with or without 9.\" Redistribution and use in source and binary forms, with or without
10.\" modification, are permitted provided that the following conditions 10.\" modification, are permitted provided that the following conditions
11.\" are met: 11.\" are met:
12.\" 1. Redistributions of source code must retain the above copyright 12.\" 1. Redistributions of source code must retain the above copyright
13.\" notice, this list of conditions and the following disclaimer. 13.\" notice, this list of conditions and the following disclaimer.
14.\" 2. Redistributions in binary form must reproduce the above copyright 14.\" 2. Redistributions in binary form must reproduce the above copyright
@@ -17,27 +17,27 @@ @@ -17,27 +17,27 @@
17.\" 17.\"
18.\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS 18.\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
19.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED 19.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
20.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR 20.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
21.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS 21.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
22.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR 22.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
23.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF 23.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
24.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS 24.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
25.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN 25.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
26.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) 26.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
27.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE 27.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
28.\" POSSIBILITY OF SUCH DAMAGE. 28.\" POSSIBILITY OF SUCH DAMAGE.
29.\" 29.\"
30.Dd November 28, 2011 30.Dd December 17, 2011
31.Dt CPRNG 9 31.Dt CPRNG 9
32.Os 32.Os
33.Sh NAME 33.Sh NAME
34.Nm cprng , 34.Nm cprng ,
35.Nm cprng_strong_create , 35.Nm cprng_strong_create ,
36.Nm cprng_strong , 36.Nm cprng_strong ,
37.Nm cprng_strong32 , 37.Nm cprng_strong32 ,
38.Nm cprng_strong64 , 38.Nm cprng_strong64 ,
39.Nm cprng_strong_getflags , 39.Nm cprng_strong_getflags ,
40.Nm cprng_strong_setflags , 40.Nm cprng_strong_setflags ,
41.Nm cprng_strong_ready , 41.Nm cprng_strong_ready ,
42.Nm cprng_strong_destroy , 42.Nm cprng_strong_destroy ,
43.Nm cprng_fast , 43.Nm cprng_fast ,
@@ -184,28 +184,29 @@ may cause rekeying. @@ -184,28 +184,29 @@ may cause rekeying.
184.Pp 184.Pp
185Destroy an instance of the cprng_strong generator. 185Destroy an instance of the cprng_strong generator.
186.It Fn cprng_strong "cprng" "buf" "len" "blocking" 186.It Fn cprng_strong "cprng" "buf" "len" "blocking"
187.Pp 187.Pp
188Fill memory location 188Fill memory location
189.Fa buf 189.Fa buf
190with 190with
191.Fa len 191.Fa len
192bytes from the generator 192bytes from the generator
193.Fa cprng . 193.Fa cprng .
194The 194The
195.Fa blocking 195.Fa blocking
196argument controls the blocking/non-blocking behavior of the 196argument controls the blocking/non-blocking behavior of the
197generator: if it is set to FNONBLOCK, the generator may return 197generator: if it is set to
198less than 198.Dv FNONBLOCK ,
 199the generator may return less than
199.Fa len 200.Fa len
200bytes if it requires rekeying. 201bytes if it requires rekeying.
201If the 202If the
202.Dv CPRNG_USE_CV 203.Dv CPRNG_USE_CV
203flag is set on the generator, the caller can wait on 204flag is set on the generator, the caller can wait on
204.Dv cprng->cv 205.Dv cprng->cv
205for notification that the generator can again supply bytes. 206for notification that the generator can again supply bytes.
206A maximum of 207A maximum of
207.Dv CPRNG_MAX_LEN 208.Dv CPRNG_MAX_LEN
208bytes may be requested at once; this is a restriction of the 209bytes may be requested at once; this is a restriction of the
209CTR_DRBG specification. 210CTR_DRBG specification.
210.It Fn cprng_strong32 "cprng" 211.It Fn cprng_strong32 "cprng"
211.Pp 212.Pp