[src/trunk]: src/share/man/man9 Clarify that getiobuf must be paired with put...

[riastradh <riastradh%NetBSD.org@localhost>]

details:   https://anonhg.NetBSD.org/src/rev/8c0053653db3
branches:  trunk
changeset: 807141:8c0053653db3
user:      riastradh <riastradh%NetBSD.org@localhost>
date:      Sun Mar 29 21:05:21 2015 +0000

description:
Clarify that getiobuf must be paired with putiobuf, not brelse.

diffstat:

 share/man/man9/bufferio.9 |  12 +++++++++++-
 1 files changed, 11 insertions(+), 1 deletions(-)

diffs (26 lines):

diff -r 63d96b4f1af3 -r 8c0053653db3 share/man/man9/bufferio.9
--- a/share/man/man9/bufferio.9 Sun Mar 29 21:02:06 2015 +0000
+++ b/share/man/man9/bufferio.9 Sun Mar 29 21:05:21 2015 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: bufferio.9,v 1.1 2015/03/29 20:56:01 riastradh Exp $
+.\"    $NetBSD: bufferio.9,v 1.2 2015/03/29 21:05:21 riastradh Exp $
 .\"
 .\" Copyright (c) 2015 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -341,6 +341,16 @@
 is false,
 returns null if none can be allocated immediately.
 .Pp
+The resulting
+.Li struct buf
+pointer must eventually be passed to
+.Fn putiobuf
+to release it.
+Do
+.Em not
+use
+.Xr brelse 9 .
+.Pp
 May sleep if
 .Fa waitok
 is true.