182ed18acSAlfred Perlstein.\" 282ed18acSAlfred Perlstein.\" Copyright (C) 2001 Chad David <davidc@acns.ab.ca>. All rights reserved. 382ed18acSAlfred Perlstein.\" 482ed18acSAlfred Perlstein.\" Redistribution and use in source and binary forms, with or without 582ed18acSAlfred Perlstein.\" modification, are permitted provided that the following conditions 682ed18acSAlfred Perlstein.\" are met: 782ed18acSAlfred Perlstein.\" 1. Redistributions of source code must retain the above copyright 882ed18acSAlfred Perlstein.\" notice(s), this list of conditions and the following disclaimer as 982ed18acSAlfred Perlstein.\" the first lines of this file unmodified other than the possible 1082ed18acSAlfred Perlstein.\" addition of one or more copyright notices. 1182ed18acSAlfred Perlstein.\" 2. Redistributions in binary form must reproduce the above copyright 1282ed18acSAlfred Perlstein.\" notice(s), this list of conditions and the following disclaimer in the 1382ed18acSAlfred Perlstein.\" documentation and/or other materials provided with the distribution. 1482ed18acSAlfred Perlstein.\" 1582ed18acSAlfred Perlstein.\" THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDER(S) ``AS IS'' AND ANY 1682ed18acSAlfred Perlstein.\" EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED 1782ed18acSAlfred Perlstein.\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE 1882ed18acSAlfred Perlstein.\" DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER(S) BE LIABLE FOR ANY 1982ed18acSAlfred Perlstein.\" DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES 2082ed18acSAlfred Perlstein.\" (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR 2182ed18acSAlfred Perlstein.\" SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER 2282ed18acSAlfred Perlstein.\" CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 2382ed18acSAlfred Perlstein.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 2482ed18acSAlfred Perlstein.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH 2582ed18acSAlfred Perlstein.\" DAMAGE. 2682ed18acSAlfred Perlstein.\" 2782ed18acSAlfred Perlstein.\" $FreeBSD$ 2882ed18acSAlfred Perlstein.\" 2982ed18acSAlfred Perlstein.Dd July 9, 2001 3082ed18acSAlfred Perlstein.Dt BUF_LOCK 9 3182ed18acSAlfred Perlstein.Os 3282ed18acSAlfred Perlstein.Sh NAME 3382ed18acSAlfred Perlstein.Nm BUF_LOCK 344bc6a387SRuslan Ermilov.Nd "locks a buffer" 3582ed18acSAlfred Perlstein.Sh SYNOPSIS 364bc6a387SRuslan Ermilov.In sys/param.h 37f16b3c0dSChad David.In sys/systm.h 38f16b3c0dSChad David.In sys/uio.h 39f16b3c0dSChad David.In sys/bio.h 404bc6a387SRuslan Ermilov.In sys/buf.h 4182ed18acSAlfred Perlstein.Ft int 420ef36920SAlfred Perlstein.Fn BUF_LOCK "struct buf *bp" "int locktype" 4382ed18acSAlfred Perlstein.Sh DESCRIPTION 4482ed18acSAlfred PerlsteinThe 454bc6a387SRuslan Ermilov.Fn BUF_LOCK 464bc6a387SRuslan Ermilovfunction locks the given buffer. 474bc6a387SRuslan ErmilovIf the lock is already held this 4860f79c3cSRuslan Ermilovcall will block until it can acquire the lock unless 494bc6a387SRuslan Ermilov.Dv LK_NOWAIT 504bc6a387SRuslan Ermilovis set. 5182ed18acSAlfred Perlstein.Pp 5282ed18acSAlfred PerlsteinIts arguments are: 53e8b02a42SRuslan Ermilov.Bl -tag -width ".Fa locktype" 544bc6a387SRuslan Ermilov.It Fa bp 5582ed18acSAlfred PerlsteinThe buffer to lock. 564bc6a387SRuslan Ermilov.It Fa locktype 574bc6a387SRuslan ErmilovFlags controlling the type of lock. 584bc6a387SRuslan ErmilovSee 594bc6a387SRuslan Ermilov.Xr lockmgr 9 604bc6a387SRuslan Ermilovfor details. 6182ed18acSAlfred Perlstein.El 6282ed18acSAlfred Perlstein.Sh RETURN VALUES 634bc6a387SRuslan ErmilovA value of 0 is returned upon success. 644bc6a387SRuslan ErmilovSee 654bc6a387SRuslan Ermilov.Xr lockmgr 9 664bc6a387SRuslan Ermilovfor 6782ed18acSAlfred Perlsteininformation on non-zero return values. 6882ed18acSAlfred Perlstein.Sh SEE ALSO 694bc6a387SRuslan Ermilov.Xr buf 9 , 704bc6a387SRuslan Ermilov.Xr BUF_TIMELOCK 9 , 714bc6a387SRuslan Ermilov.Xr BUF_UNLOCK 9 , 7282ed18acSAlfred Perlstein.Xr lockmgr 9 7382ed18acSAlfred Perlstein.Sh AUTHORS 74571dba6eSHiten PandyaThis manual page was written by 75034709cbSRuslan Ermilov.An Chad David Aq davidc@acns.ab.ca . 76