Skip site navigation (1)Skip section navigation (2)
Date:      Tue, 17 May 2016 17:08:13 +0000 (UTC)
From:      Warner Losh <imp@FreeBSD.org>
To:        src-committers@freebsd.org, svn-src-all@freebsd.org, svn-src-head@freebsd.org
Subject:   svn commit: r300066 - head/share/man/man9
Message-ID:  <201605171708.u4HH8Dkk012799@repo.freebsd.org>

next in thread | raw e-mail | index | archive | help
Author: imp
Date: Tue May 17 17:08:13 2016
New Revision: 300066
URL: https://svnweb.freebsd.org/changeset/base/300066

Log:
  Per Ravi Pokala's suggestion, rewrite the g_reset_bio description to
  be clearer. It also describes it with more nuance. Add missing MLINKS
  noticed by trasz@. Bump the date.

Modified:
  head/share/man/man9/Makefile
  head/share/man/man9/g_bio.9

Modified: head/share/man/man9/Makefile
==============================================================================
--- head/share/man/man9/Makefile	Tue May 17 16:59:53 2016	(r300065)
+++ head/share/man/man9/Makefile	Tue May 17 17:08:13 2016	(r300066)
@@ -787,7 +787,8 @@ MLINKS+=g_bio.9 g_alloc_bio.9 \
 	g_bio.9 g_destroy_bio.9 \
 	g_bio.9 g_duplicate_bio.9 \
 	g_bio.9 g_new_bio.9 \
-	g_bio.9 g_print_bio.9
+	g_bio.9 g_print_bio.9 \
+	g_bio.9 g_reset_bio.9
 MLINKS+=g_consumer.9 g_destroy_consumer.9 \
 	g_consumer.9 g_new_consumer.9
 MLINKS+=g_data.9 g_read_data.9 \

Modified: head/share/man/man9/g_bio.9
==============================================================================
--- head/share/man/man9/g_bio.9	Tue May 17 16:59:53 2016	(r300065)
+++ head/share/man/man9/g_bio.9	Tue May 17 17:08:13 2016	(r300066)
@@ -24,7 +24,7 @@
 .\"
 .\" $FreeBSD$
 .\"
-.Dd May 9, 2016
+.Dd May 17, 2016
 .Dt G_BIO 9
 .Os
 .Sh NAME
@@ -213,27 +213,27 @@ The
 .Fn g_reset_bio
 function resets the given
 .Vt bio
-for reuse.
-Prior to
-.Fx 11
-a
-.Vt bio
-was reset for reuse with
-.Xr bzero 3 .
+structure back to its initial state.
 .Fn g_reset_bio
-preserves internal data structures, while resetting all
-user visible values.
-Its use is required for any
+preserves internal data structures, while setting all
+user visible fields to their initial values.
+When reusing a
 .Vt bio
-that has been returned by
+obtained from
 .Fn g_new_bio ,
 .Fn g_alloc_bio ,
 .Fn g_clone_bio ,
 or
-.Fn g_duplicate_bio .
-It may be used for a
+.Fn g_duplicate_bio
+for multiple transactions,
+.Fn g_reset_bio
+must be called between the transactions in lieu of
+.Fn bzero .
+While not strictly required for a
 .Vt bio
-created in another way, but that is not required.
+structure created by other means,
+.Fn g_reset_bio
+should be used to initialize it and between transactions.
 .Sh RETURN VALUES
 The
 .Fn g_new_bio



Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?201605171708.u4HH8Dkk012799>