Home | History | Annotate | Line # | Download | only in kern
vfs_bio.c revision 1.41
      1  1.41  christos /*	$NetBSD: vfs_bio.c,v 1.41 1996/02/09 19:00:53 christos Exp $	*/
      2  1.31       cgd 
      3  1.31       cgd /*-
      4  1.31       cgd  * Copyright (c) 1994 Christopher G. Demetriou
      5  1.31       cgd  * Copyright (c) 1982, 1986, 1989, 1993
      6  1.31       cgd  *	The Regents of the University of California.  All rights reserved.
      7  1.31       cgd  * (c) UNIX System Laboratories, Inc.
      8  1.31       cgd  * All or some portions of this file are derived from material licensed
      9  1.31       cgd  * to the University of California by American Telephone and Telegraph
     10  1.31       cgd  * Co. or Unix System Laboratories, Inc. and are reproduced herein with
     11  1.31       cgd  * the permission of UNIX System Laboratories, Inc.
     12  1.31       cgd  *
     13  1.31       cgd  * Redistribution and use in source and binary forms, with or without
     14  1.31       cgd  * modification, are permitted provided that the following conditions
     15  1.31       cgd  * are met:
     16  1.31       cgd  * 1. Redistributions of source code must retain the above copyright
     17  1.31       cgd  *    notice, this list of conditions and the following disclaimer.
     18  1.31       cgd  * 2. Redistributions in binary form must reproduce the above copyright
     19  1.31       cgd  *    notice, this list of conditions and the following disclaimer in the
     20  1.31       cgd  *    documentation and/or other materials provided with the distribution.
     21  1.31       cgd  * 3. All advertising materials mentioning features or use of this software
     22  1.31       cgd  *    must display the following acknowledgement:
     23  1.31       cgd  *	This product includes software developed by the University of
     24  1.31       cgd  *	California, Berkeley and its contributors.
     25  1.31       cgd  * 4. Neither the name of the University nor the names of its contributors
     26  1.31       cgd  *    may be used to endorse or promote products derived from this software
     27  1.31       cgd  *    without specific prior written permission.
     28  1.31       cgd  *
     29  1.31       cgd  * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
     30  1.31       cgd  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
     31  1.31       cgd  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
     32  1.31       cgd  * ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
     33  1.31       cgd  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
     34  1.31       cgd  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
     35  1.31       cgd  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
     36  1.31       cgd  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
     37  1.31       cgd  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
     38  1.31       cgd  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
     39  1.31       cgd  * SUCH DAMAGE.
     40  1.31       cgd  *
     41  1.31       cgd  *	@(#)vfs_bio.c	8.6 (Berkeley) 1/11/94
     42  1.31       cgd  */
     43  1.31       cgd 
     44  1.31       cgd /*
     45  1.31       cgd  * Some references:
     46  1.31       cgd  *	Bach: The Design of the UNIX Operating System (Prentice Hall, 1986)
     47  1.31       cgd  *	Leffler, et al.: The Design and Implementation of the 4.3BSD
     48  1.31       cgd  *		UNIX Operating System (Addison Welley, 1989)
     49  1.31       cgd  */
     50  1.31       cgd 
     51  1.31       cgd #include <sys/param.h>
     52  1.31       cgd #include <sys/systm.h>
     53  1.31       cgd #include <sys/proc.h>
     54  1.31       cgd #include <sys/buf.h>
     55  1.31       cgd #include <sys/vnode.h>
     56  1.31       cgd #include <sys/mount.h>
     57  1.31       cgd #include <sys/trace.h>
     58  1.31       cgd #include <sys/malloc.h>
     59  1.31       cgd #include <sys/resourcevar.h>
     60  1.35   mycroft #include <sys/conf.h>
     61  1.41  christos #include <sys/cpu.h>
     62  1.40  christos 
     63  1.31       cgd /* Macros to clear/set/test flags. */
     64  1.31       cgd #define	SET(t, f)	(t) |= (f)
     65  1.31       cgd #define	CLR(t, f)	(t) &= ~(f)
     66  1.31       cgd #define	ISSET(t, f)	((t) & (f))
     67  1.31       cgd 
     68  1.31       cgd /*
     69  1.31       cgd  * Definitions for the buffer hash lists.
     70  1.31       cgd  */
     71  1.31       cgd #define	BUFHASH(dvp, lbn)	\
     72  1.33       cgd 	(&bufhashtbl[((long)(dvp) / sizeof(*(dvp)) + (int)(lbn)) & bufhash])
     73  1.31       cgd LIST_HEAD(bufhashhdr, buf) *bufhashtbl, invalhash;
     74  1.31       cgd u_long	bufhash;
     75  1.31       cgd 
     76  1.31       cgd /*
     77  1.31       cgd  * Insq/Remq for the buffer hash lists.
     78  1.31       cgd  */
     79  1.31       cgd #define	binshash(bp, dp)	LIST_INSERT_HEAD(dp, bp, b_hash)
     80  1.31       cgd #define	bremhash(bp)		LIST_REMOVE(bp, b_hash)
     81  1.31       cgd 
     82  1.31       cgd /*
     83  1.31       cgd  * Definitions for the buffer free lists.
     84  1.31       cgd  */
     85  1.31       cgd #define	BQUEUES		4		/* number of free buffer queues */
     86  1.31       cgd 
     87  1.31       cgd #define	BQ_LOCKED	0		/* super-blocks &c */
     88  1.31       cgd #define	BQ_LRU		1		/* lru, useful buffers */
     89  1.31       cgd #define	BQ_AGE		2		/* rubbish */
     90  1.31       cgd #define	BQ_EMPTY	3		/* buffer headers with no memory */
     91  1.31       cgd 
     92  1.31       cgd TAILQ_HEAD(bqueues, buf) bufqueues[BQUEUES];
     93  1.31       cgd int needbuffer;
     94  1.31       cgd 
     95  1.31       cgd /*
     96  1.31       cgd  * Insq/Remq for the buffer free lists.
     97  1.31       cgd  */
     98  1.31       cgd #define	binsheadfree(bp, dp)	TAILQ_INSERT_HEAD(dp, bp, b_freelist)
     99  1.31       cgd #define	binstailfree(bp, dp)	TAILQ_INSERT_TAIL(dp, bp, b_freelist)
    100  1.31       cgd 
    101  1.40  christos static __inline struct buf *bio_doread __P((struct vnode *, daddr_t, int,
    102  1.40  christos 					    struct ucred *, int));
    103  1.40  christos int count_lock_queue __P((void));
    104  1.40  christos 
    105  1.31       cgd void
    106  1.31       cgd bremfree(bp)
    107  1.31       cgd 	struct buf *bp;
    108  1.31       cgd {
    109  1.31       cgd 	struct bqueues *dp = NULL;
    110  1.31       cgd 
    111  1.31       cgd 	/*
    112  1.31       cgd 	 * We only calculate the head of the freelist when removing
    113  1.31       cgd 	 * the last element of the list as that is the only time that
    114  1.31       cgd 	 * it is needed (e.g. to reset the tail pointer).
    115  1.31       cgd 	 *
    116  1.31       cgd 	 * NB: This makes an assumption about how tailq's are implemented.
    117  1.31       cgd 	 */
    118  1.31       cgd 	if (bp->b_freelist.tqe_next == NULL) {
    119  1.31       cgd 		for (dp = bufqueues; dp < &bufqueues[BQUEUES]; dp++)
    120  1.31       cgd 			if (dp->tqh_last == &bp->b_freelist.tqe_next)
    121  1.31       cgd 				break;
    122  1.31       cgd 		if (dp == &bufqueues[BQUEUES])
    123  1.31       cgd 			panic("bremfree: lost tail");
    124  1.31       cgd 	}
    125  1.31       cgd 	TAILQ_REMOVE(dp, bp, b_freelist);
    126  1.31       cgd }
    127  1.31       cgd 
    128  1.31       cgd /*
    129  1.31       cgd  * Initialize buffers and hash links for buffers.
    130  1.31       cgd  */
    131  1.31       cgd void
    132  1.31       cgd bufinit()
    133  1.31       cgd {
    134  1.31       cgd 	register struct buf *bp;
    135  1.31       cgd 	struct bqueues *dp;
    136  1.31       cgd 	register int i;
    137  1.31       cgd 	int base, residual;
    138  1.31       cgd 
    139  1.31       cgd 	for (dp = bufqueues; dp < &bufqueues[BQUEUES]; dp++)
    140  1.31       cgd 		TAILQ_INIT(dp);
    141  1.31       cgd 	bufhashtbl = hashinit(nbuf, M_CACHE, &bufhash);
    142  1.31       cgd 	base = bufpages / nbuf;
    143  1.31       cgd 	residual = bufpages % nbuf;
    144  1.31       cgd 	for (i = 0; i < nbuf; i++) {
    145  1.31       cgd 		bp = &buf[i];
    146  1.31       cgd 		bzero((char *)bp, sizeof *bp);
    147  1.31       cgd 		bp->b_dev = NODEV;
    148  1.31       cgd 		bp->b_rcred = NOCRED;
    149  1.31       cgd 		bp->b_wcred = NOCRED;
    150  1.31       cgd 		bp->b_vnbufs.le_next = NOLIST;
    151  1.31       cgd 		bp->b_data = buffers + i * MAXBSIZE;
    152  1.31       cgd 		if (i < residual)
    153  1.31       cgd 			bp->b_bufsize = (base + 1) * CLBYTES;
    154  1.31       cgd 		else
    155  1.31       cgd 			bp->b_bufsize = base * CLBYTES;
    156  1.31       cgd 		bp->b_flags = B_INVAL;
    157  1.31       cgd 		dp = bp->b_bufsize ? &bufqueues[BQ_AGE] : &bufqueues[BQ_EMPTY];
    158  1.31       cgd 		binsheadfree(bp, dp);
    159  1.31       cgd 		binshash(bp, &invalhash);
    160  1.31       cgd 	}
    161  1.31       cgd }
    162  1.31       cgd 
    163  1.40  christos static __inline struct buf *
    164  1.34   mycroft bio_doread(vp, blkno, size, cred, async)
    165  1.31       cgd 	struct vnode *vp;
    166  1.31       cgd 	daddr_t blkno;
    167  1.31       cgd 	int size;
    168  1.31       cgd 	struct ucred *cred;
    169  1.34   mycroft 	int async;
    170  1.31       cgd {
    171  1.31       cgd 	register struct buf *bp;
    172  1.31       cgd 
    173  1.34   mycroft 	bp = getblk(vp, blkno, size, 0, 0);
    174  1.31       cgd 
    175  1.31       cgd 	/*
    176  1.34   mycroft 	 * If buffer does not have data valid, start a read.
    177  1.31       cgd 	 * Note that if buffer is B_INVAL, getblk() won't return it.
    178  1.31       cgd 	 * Therefore, it's valid if it's I/O has completed or been delayed.
    179  1.31       cgd 	 */
    180  1.34   mycroft 	if (!ISSET(bp->b_flags, (B_DONE | B_DELWRI))) {
    181  1.34   mycroft 		/* Start I/O for the buffer (keeping credentials). */
    182  1.34   mycroft 		SET(bp->b_flags, B_READ | async);
    183  1.34   mycroft 		if (cred != NOCRED && bp->b_rcred == NOCRED) {
    184  1.34   mycroft 			crhold(cred);
    185  1.34   mycroft 			bp->b_rcred = cred;
    186  1.34   mycroft 		}
    187  1.34   mycroft 		VOP_STRATEGY(bp);
    188  1.31       cgd 
    189  1.34   mycroft 		/* Pay for the read. */
    190  1.34   mycroft 		curproc->p_stats->p_ru.ru_inblock++;		/* XXX */
    191  1.34   mycroft 	} else if (async) {
    192  1.34   mycroft 		brelse(bp);
    193  1.31       cgd 	}
    194  1.31       cgd 
    195  1.34   mycroft 	return (bp);
    196  1.34   mycroft }
    197  1.34   mycroft 
    198  1.34   mycroft /*
    199  1.34   mycroft  * Read a disk block.
    200  1.34   mycroft  * This algorithm described in Bach (p.54).
    201  1.34   mycroft  */
    202  1.40  christos int
    203  1.34   mycroft bread(vp, blkno, size, cred, bpp)
    204  1.34   mycroft 	struct vnode *vp;
    205  1.34   mycroft 	daddr_t blkno;
    206  1.34   mycroft 	int size;
    207  1.34   mycroft 	struct ucred *cred;
    208  1.34   mycroft 	struct buf **bpp;
    209  1.34   mycroft {
    210  1.34   mycroft 	register struct buf *bp;
    211  1.34   mycroft 
    212  1.34   mycroft 	/* Get buffer for block. */
    213  1.34   mycroft 	bp = *bpp = bio_doread(vp, blkno, size, cred, 0);
    214  1.31       cgd 
    215  1.31       cgd 	/* Wait for the read to complete, and return result. */
    216  1.31       cgd 	return (biowait(bp));
    217  1.31       cgd }
    218  1.31       cgd 
    219  1.31       cgd /*
    220  1.31       cgd  * Read-ahead multiple disk blocks. The first is sync, the rest async.
    221  1.31       cgd  * Trivial modification to the breada algorithm presented in Bach (p.55).
    222  1.31       cgd  */
    223  1.40  christos int
    224  1.31       cgd breadn(vp, blkno, size, rablks, rasizes, nrablks, cred, bpp)
    225  1.31       cgd 	struct vnode *vp;
    226  1.31       cgd 	daddr_t blkno; int size;
    227  1.31       cgd 	daddr_t rablks[]; int rasizes[];
    228  1.31       cgd 	int nrablks;
    229  1.31       cgd 	struct ucred *cred;
    230  1.31       cgd 	struct buf **bpp;
    231  1.31       cgd {
    232  1.34   mycroft 	register struct buf *bp;
    233  1.31       cgd 	int i;
    234  1.31       cgd 
    235  1.34   mycroft 	bp = *bpp = bio_doread(vp, blkno, size, cred, 0);
    236  1.31       cgd 
    237  1.31       cgd 	/*
    238  1.31       cgd 	 * For each of the read-ahead blocks, start a read, if necessary.
    239  1.31       cgd 	 */
    240  1.31       cgd 	for (i = 0; i < nrablks; i++) {
    241  1.31       cgd 		/* If it's in the cache, just go on to next one. */
    242  1.31       cgd 		if (incore(vp, rablks[i]))
    243  1.31       cgd 			continue;
    244  1.31       cgd 
    245  1.31       cgd 		/* Get a buffer for the read-ahead block */
    246  1.34   mycroft 		(void) bio_doread(vp, rablks[i], rasizes[i], cred, B_ASYNC);
    247  1.31       cgd 	}
    248  1.31       cgd 
    249  1.31       cgd 	/* Otherwise, we had to start a read for it; wait until it's valid. */
    250  1.31       cgd 	return (biowait(bp));
    251  1.31       cgd }
    252  1.31       cgd 
    253  1.31       cgd /*
    254  1.31       cgd  * Read with single-block read-ahead.  Defined in Bach (p.55), but
    255  1.31       cgd  * implemented as a call to breadn().
    256  1.31       cgd  * XXX for compatibility with old file systems.
    257  1.31       cgd  */
    258  1.40  christos int
    259  1.31       cgd breada(vp, blkno, size, rablkno, rabsize, cred, bpp)
    260  1.31       cgd 	struct vnode *vp;
    261  1.31       cgd 	daddr_t blkno; int size;
    262  1.31       cgd 	daddr_t rablkno; int rabsize;
    263  1.31       cgd 	struct ucred *cred;
    264  1.31       cgd 	struct buf **bpp;
    265  1.31       cgd {
    266  1.34   mycroft 
    267  1.31       cgd 	return (breadn(vp, blkno, size, &rablkno, &rabsize, 1, cred, bpp));
    268  1.31       cgd }
    269  1.31       cgd 
    270  1.31       cgd /*
    271  1.31       cgd  * Block write.  Described in Bach (p.56)
    272  1.31       cgd  */
    273  1.40  christos int
    274  1.31       cgd bwrite(bp)
    275  1.31       cgd 	struct buf *bp;
    276  1.31       cgd {
    277  1.40  christos 	int rv, sync, wasdelayed;
    278  1.31       cgd 
    279  1.38       cgd 	/*
    280  1.38       cgd 	 * Remember buffer type, to switch on it later.  If the write was
    281  1.38       cgd 	 * synchronous, but the file system was mounted with MNT_ASYNC,
    282  1.38       cgd 	 * convert it to a delayed write.
    283  1.38       cgd 	 * XXX note that this relies on delayed tape writes being converted
    284  1.38       cgd 	 * to async, not sync writes (which is safe, but ugly).
    285  1.38       cgd 	 */
    286  1.31       cgd 	sync = !ISSET(bp->b_flags, B_ASYNC);
    287  1.37       cgd 	if (sync && bp->b_vp && bp->b_vp->v_mount &&
    288  1.37       cgd 	    ISSET(bp->b_vp->v_mount->mnt_flag, MNT_ASYNC)) {
    289  1.37       cgd 		bdwrite(bp);
    290  1.37       cgd 		return (0);
    291  1.37       cgd 	}
    292  1.31       cgd 	wasdelayed = ISSET(bp->b_flags, B_DELWRI);
    293  1.31       cgd 	CLR(bp->b_flags, (B_READ | B_DONE | B_ERROR | B_DELWRI));
    294  1.31       cgd 
    295  1.34   mycroft 	if (!sync) {
    296  1.34   mycroft 		/*
    297  1.34   mycroft 		 * If not synchronous, pay for the I/O operation and make
    298  1.34   mycroft 		 * sure the buf is on the correct vnode queue.  We have
    299  1.34   mycroft 		 * to do this now, because if we don't, the vnode may not
    300  1.34   mycroft 		 * be properly notified that its I/O has completed.
    301  1.34   mycroft 		 */
    302  1.32   mycroft 		if (wasdelayed)
    303  1.32   mycroft 			reassignbuf(bp, bp->b_vp);
    304  1.32   mycroft 		else
    305  1.32   mycroft 			curproc->p_stats->p_ru.ru_oublock++;
    306  1.34   mycroft 	}
    307  1.32   mycroft 
    308  1.31       cgd 	/* Initiate disk write.  Make sure the appropriate party is charged. */
    309  1.31       cgd 	SET(bp->b_flags, B_WRITEINPROG);
    310  1.31       cgd 	bp->b_vp->v_numoutput++;
    311  1.31       cgd 	VOP_STRATEGY(bp);
    312  1.31       cgd 
    313  1.34   mycroft 	if (sync) {
    314  1.34   mycroft 		/*
    315  1.34   mycroft 		 * If I/O was synchronous, wait for it to complete.
    316  1.34   mycroft 		 */
    317  1.31       cgd 		rv = biowait(bp);
    318  1.31       cgd 
    319  1.34   mycroft 		/*
    320  1.34   mycroft 		 * Pay for the I/O operation, if it's not been paid for, and
    321  1.34   mycroft 		 * make sure it's on the correct vnode queue. (async operatings
    322  1.34   mycroft 		 * were payed for above.)
    323  1.34   mycroft 		 */
    324  1.32   mycroft 		if (wasdelayed)
    325  1.32   mycroft 			reassignbuf(bp, bp->b_vp);
    326  1.32   mycroft 		else
    327  1.32   mycroft 			curproc->p_stats->p_ru.ru_oublock++;
    328  1.31       cgd 
    329  1.34   mycroft 		/* Release the buffer. */
    330  1.31       cgd 		brelse(bp);
    331  1.34   mycroft 
    332  1.34   mycroft 		return (rv);
    333  1.34   mycroft 	} else {
    334  1.34   mycroft 		return (0);
    335  1.31       cgd 	}
    336  1.31       cgd }
    337  1.31       cgd 
    338  1.31       cgd int
    339  1.40  christos vn_bwrite(v)
    340  1.40  christos 	void *v;
    341  1.31       cgd {
    342  1.40  christos 	struct vop_bwrite_args *ap = v;
    343  1.34   mycroft 
    344  1.31       cgd 	return (bwrite(ap->a_bp));
    345  1.31       cgd }
    346  1.31       cgd 
    347  1.31       cgd /*
    348  1.31       cgd  * Delayed write.
    349  1.31       cgd  *
    350  1.31       cgd  * The buffer is marked dirty, but is not queued for I/O.
    351  1.31       cgd  * This routine should be used when the buffer is expected
    352  1.31       cgd  * to be modified again soon, typically a small write that
    353  1.31       cgd  * partially fills a buffer.
    354  1.31       cgd  *
    355  1.31       cgd  * NB: magnetic tapes cannot be delayed; they must be
    356  1.31       cgd  * written in the order that the writes are requested.
    357  1.31       cgd  *
    358  1.31       cgd  * Described in Leffler, et al. (pp. 208-213).
    359  1.31       cgd  */
    360  1.31       cgd void
    361  1.31       cgd bdwrite(bp)
    362  1.31       cgd 	struct buf *bp;
    363  1.31       cgd {
    364  1.31       cgd 
    365  1.31       cgd 	/*
    366  1.31       cgd 	 * If the block hasn't been seen before:
    367  1.31       cgd 	 *	(1) Mark it as having been seen,
    368  1.31       cgd 	 *	(2) Charge for the write.
    369  1.31       cgd 	 *	(3) Make sure it's on its vnode's correct block list,
    370  1.31       cgd 	 */
    371  1.31       cgd 	if (!ISSET(bp->b_flags, B_DELWRI)) {
    372  1.31       cgd 		SET(bp->b_flags, B_DELWRI);
    373  1.31       cgd 		curproc->p_stats->p_ru.ru_oublock++;	/* XXX */
    374  1.31       cgd 		reassignbuf(bp, bp->b_vp);
    375  1.31       cgd 	}
    376  1.31       cgd 
    377  1.35   mycroft 	/* If this is a tape block, write the block now. */
    378  1.35   mycroft 	if (bdevsw[major(bp->b_dev)].d_type == D_TAPE) {
    379  1.38       cgd 		bawrite(bp);
    380  1.31       cgd 		return;
    381  1.31       cgd 	}
    382  1.31       cgd 
    383  1.31       cgd 	/* Otherwise, the "write" is done, so mark and release the buffer. */
    384  1.31       cgd 	SET(bp->b_flags, B_DONE);
    385  1.31       cgd 	brelse(bp);
    386  1.31       cgd }
    387  1.31       cgd 
    388  1.31       cgd /*
    389  1.31       cgd  * Asynchronous block write; just an asynchronous bwrite().
    390  1.31       cgd  */
    391  1.31       cgd void
    392  1.31       cgd bawrite(bp)
    393  1.31       cgd 	struct buf *bp;
    394  1.31       cgd {
    395  1.31       cgd 
    396  1.31       cgd 	SET(bp->b_flags, B_ASYNC);
    397  1.31       cgd 	VOP_BWRITE(bp);
    398  1.31       cgd }
    399  1.31       cgd 
    400  1.31       cgd /*
    401  1.31       cgd  * Release a buffer on to the free lists.
    402  1.31       cgd  * Described in Bach (p. 46).
    403  1.31       cgd  */
    404  1.31       cgd void
    405  1.31       cgd brelse(bp)
    406  1.31       cgd 	struct buf *bp;
    407  1.31       cgd {
    408  1.31       cgd 	struct bqueues *bufq;
    409  1.31       cgd 	int s;
    410  1.31       cgd 
    411  1.31       cgd 	/* Wake up any processes waiting for any buffer to become free. */
    412  1.31       cgd 	if (needbuffer) {
    413  1.31       cgd 		needbuffer = 0;
    414  1.31       cgd 		wakeup(&needbuffer);
    415  1.31       cgd 	}
    416  1.31       cgd 
    417  1.31       cgd 	/* Wake up any proceeses waiting for _this_ buffer to become free. */
    418  1.31       cgd 	if (ISSET(bp->b_flags, B_WANTED)) {
    419  1.31       cgd 		CLR(bp->b_flags, B_WANTED);
    420  1.31       cgd 		wakeup(bp);
    421  1.31       cgd 	}
    422  1.31       cgd 
    423  1.31       cgd 	/* Block disk interrupts. */
    424  1.31       cgd 	s = splbio();
    425  1.31       cgd 
    426  1.31       cgd 	/*
    427  1.31       cgd 	 * Determine which queue the buffer should be on, then put it there.
    428  1.31       cgd 	 */
    429  1.31       cgd 
    430  1.31       cgd 	/* If it's locked, don't report an error; try again later. */
    431  1.31       cgd 	if (ISSET(bp->b_flags, (B_LOCKED|B_ERROR)) == (B_LOCKED|B_ERROR))
    432  1.31       cgd 		CLR(bp->b_flags, B_ERROR);
    433  1.31       cgd 
    434  1.31       cgd 	/* If it's not cacheable, or an error, mark it invalid. */
    435  1.31       cgd 	if (ISSET(bp->b_flags, (B_NOCACHE|B_ERROR)))
    436  1.31       cgd 		SET(bp->b_flags, B_INVAL);
    437  1.31       cgd 
    438  1.31       cgd 	if ((bp->b_bufsize <= 0) || ISSET(bp->b_flags, B_INVAL)) {
    439  1.31       cgd 		/*
    440  1.31       cgd 		 * If it's invalid or empty, dissociate it from its vnode
    441  1.31       cgd 		 * and put on the head of the appropriate queue.
    442  1.31       cgd 		 */
    443  1.31       cgd 		if (bp->b_vp)
    444  1.31       cgd 			brelvp(bp);
    445  1.31       cgd 		CLR(bp->b_flags, B_DELWRI);
    446  1.31       cgd 		if (bp->b_bufsize <= 0)
    447  1.31       cgd 			/* no data */
    448  1.31       cgd 			bufq = &bufqueues[BQ_EMPTY];
    449  1.31       cgd 		else
    450  1.31       cgd 			/* invalid data */
    451  1.31       cgd 			bufq = &bufqueues[BQ_AGE];
    452  1.31       cgd 		binsheadfree(bp, bufq);
    453  1.31       cgd 	} else {
    454  1.31       cgd 		/*
    455  1.31       cgd 		 * It has valid data.  Put it on the end of the appropriate
    456  1.31       cgd 		 * queue, so that it'll stick around for as long as possible.
    457  1.31       cgd 		 */
    458  1.31       cgd 		if (ISSET(bp->b_flags, B_LOCKED))
    459  1.31       cgd 			/* locked in core */
    460  1.31       cgd 			bufq = &bufqueues[BQ_LOCKED];
    461  1.31       cgd 		else if (ISSET(bp->b_flags, B_AGE))
    462  1.31       cgd 			/* stale but valid data */
    463  1.31       cgd 			bufq = &bufqueues[BQ_AGE];
    464  1.31       cgd 		else
    465  1.31       cgd 			/* valid data */
    466  1.31       cgd 			bufq = &bufqueues[BQ_LRU];
    467  1.31       cgd 		binstailfree(bp, bufq);
    468  1.31       cgd 	}
    469  1.31       cgd 
    470  1.31       cgd 	/* Unlock the buffer. */
    471  1.31       cgd 	CLR(bp->b_flags, (B_AGE | B_ASYNC | B_BUSY | B_NOCACHE));
    472  1.31       cgd 
    473  1.31       cgd 	/* Allow disk interrupts. */
    474  1.31       cgd 	splx(s);
    475  1.31       cgd }
    476  1.31       cgd 
    477  1.31       cgd /*
    478  1.31       cgd  * Determine if a block is in the cache.
    479  1.31       cgd  * Just look on what would be its hash chain.  If it's there, return
    480  1.31       cgd  * a pointer to it, unless it's marked invalid.  If it's marked invalid,
    481  1.31       cgd  * we normally don't return the buffer, unless the caller explicitly
    482  1.31       cgd  * wants us to.
    483  1.31       cgd  */
    484  1.31       cgd struct buf *
    485  1.31       cgd incore(vp, blkno)
    486  1.31       cgd 	struct vnode *vp;
    487  1.31       cgd 	daddr_t blkno;
    488  1.31       cgd {
    489  1.31       cgd 	struct buf *bp;
    490  1.31       cgd 
    491  1.31       cgd 	bp = BUFHASH(vp, blkno)->lh_first;
    492  1.31       cgd 
    493  1.31       cgd 	/* Search hash chain */
    494  1.31       cgd 	for (; bp != NULL; bp = bp->b_hash.le_next) {
    495  1.31       cgd 		if (bp->b_lblkno == blkno && bp->b_vp == vp &&
    496  1.31       cgd 		    !ISSET(bp->b_flags, B_INVAL))
    497  1.31       cgd 		return (bp);
    498  1.31       cgd 	}
    499  1.31       cgd 
    500  1.31       cgd 	return (0);
    501  1.31       cgd }
    502  1.31       cgd 
    503  1.31       cgd /*
    504  1.31       cgd  * Get a block of requested size that is associated with
    505  1.31       cgd  * a given vnode and block offset. If it is found in the
    506  1.31       cgd  * block cache, mark it as having been found, make it busy
    507  1.31       cgd  * and return it. Otherwise, return an empty block of the
    508  1.31       cgd  * correct size. It is up to the caller to insure that the
    509  1.31       cgd  * cached blocks be of the correct size.
    510  1.31       cgd  */
    511  1.31       cgd struct buf *
    512  1.31       cgd getblk(vp, blkno, size, slpflag, slptimeo)
    513  1.31       cgd 	register struct vnode *vp;
    514  1.31       cgd 	daddr_t blkno;
    515  1.31       cgd 	int size, slpflag, slptimeo;
    516  1.31       cgd {
    517  1.39       cgd 	struct bufhashhdr *bh;
    518  1.31       cgd 	struct buf *bp;
    519  1.31       cgd 	int s, err;
    520  1.31       cgd 
    521  1.37       cgd 	/*
    522  1.37       cgd 	 * XXX
    523  1.37       cgd 	 * The following is an inlined version of 'incore()', but with
    524  1.37       cgd 	 * the 'invalid' test moved to after the 'busy' test.  It's
    525  1.37       cgd 	 * necessary because there are some cases in which the NFS
    526  1.37       cgd 	 * code sets B_INVAL prior to writing data to the server, but
    527  1.37       cgd 	 * in which the buffers actually contain valid data.  In this
    528  1.37       cgd 	 * case, we can't allow the system to allocate a new buffer for
    529  1.37       cgd 	 * the block until the write is finished.
    530  1.37       cgd 	 */
    531  1.39       cgd 	bh = BUFHASH(vp, blkno);
    532  1.39       cgd start:
    533  1.39       cgd         bp = bh->lh_first;
    534  1.37       cgd         for (; bp != NULL; bp = bp->b_hash.le_next) {
    535  1.37       cgd                 if (bp->b_lblkno != blkno || bp->b_vp != vp)
    536  1.37       cgd 			continue;
    537  1.37       cgd 
    538  1.39       cgd 		s = splbio();
    539  1.31       cgd 		if (ISSET(bp->b_flags, B_BUSY)) {
    540  1.31       cgd 			SET(bp->b_flags, B_WANTED);
    541  1.31       cgd 			err = tsleep(bp, slpflag | (PRIBIO + 1), "getblk",
    542  1.31       cgd 			    slptimeo);
    543  1.31       cgd 			splx(s);
    544  1.31       cgd 			if (err)
    545  1.31       cgd 				return (NULL);
    546  1.31       cgd 			goto start;
    547  1.31       cgd 		}
    548  1.37       cgd 
    549  1.39       cgd 		if (!ISSET(bp->b_flags, B_INVAL)) {
    550  1.39       cgd 			SET(bp->b_flags, (B_BUSY | B_CACHE));
    551  1.39       cgd 			bremfree(bp);
    552  1.39       cgd 			splx(s);
    553  1.37       cgd 			break;
    554  1.39       cgd 		}
    555  1.39       cgd 		splx(s);
    556  1.37       cgd         }
    557  1.37       cgd 
    558  1.39       cgd 	if (bp == NULL) {
    559  1.31       cgd 		if ((bp = getnewbuf(slpflag, slptimeo)) == NULL)
    560  1.31       cgd 			goto start;
    561  1.39       cgd 		binshash(bp, bh);
    562  1.31       cgd 		bp->b_blkno = bp->b_lblkno = blkno;
    563  1.31       cgd 		s = splbio();
    564  1.31       cgd 		bgetvp(vp, bp);
    565  1.31       cgd 		splx(s);
    566  1.31       cgd 	}
    567  1.39       cgd 	allocbuf(bp, size);
    568  1.31       cgd 	return (bp);
    569  1.31       cgd }
    570  1.31       cgd 
    571  1.31       cgd /*
    572  1.31       cgd  * Get an empty, disassociated buffer of given size.
    573  1.31       cgd  */
    574  1.31       cgd struct buf *
    575  1.31       cgd geteblk(size)
    576  1.31       cgd 	int size;
    577  1.31       cgd {
    578  1.31       cgd 	struct buf *bp;
    579  1.31       cgd 
    580  1.31       cgd 	while ((bp = getnewbuf(0, 0)) == 0)
    581  1.31       cgd 		;
    582  1.31       cgd 	SET(bp->b_flags, B_INVAL);
    583  1.31       cgd 	binshash(bp, &invalhash);
    584  1.31       cgd 	allocbuf(bp, size);
    585  1.31       cgd 
    586  1.31       cgd 	return (bp);
    587  1.31       cgd }
    588  1.31       cgd 
    589  1.31       cgd /*
    590  1.31       cgd  * Expand or contract the actual memory allocated to a buffer.
    591  1.31       cgd  *
    592  1.31       cgd  * If the buffer shrinks, data is lost, so it's up to the
    593  1.31       cgd  * caller to have written it out *first*; this routine will not
    594  1.31       cgd  * start a write.  If the buffer grows, it's the callers
    595  1.31       cgd  * responsibility to fill out the buffer's additional contents.
    596  1.31       cgd  */
    597  1.40  christos void
    598  1.31       cgd allocbuf(bp, size)
    599  1.31       cgd 	struct buf *bp;
    600  1.31       cgd 	int size;
    601  1.31       cgd {
    602  1.31       cgd 	struct buf      *nbp;
    603  1.31       cgd 	vm_size_t       desired_size;
    604  1.31       cgd 	int	     s;
    605  1.31       cgd 
    606  1.31       cgd 	desired_size = roundup(size, CLBYTES);
    607  1.31       cgd 	if (desired_size > MAXBSIZE)
    608  1.31       cgd 		panic("allocbuf: buffer larger than MAXBSIZE requested");
    609  1.31       cgd 
    610  1.31       cgd 	if (bp->b_bufsize == desired_size)
    611  1.31       cgd 		goto out;
    612  1.31       cgd 
    613  1.31       cgd 	/*
    614  1.31       cgd 	 * If the buffer is smaller than the desired size, we need to snarf
    615  1.31       cgd 	 * it from other buffers.  Get buffers (via getnewbuf()), and
    616  1.31       cgd 	 * steal their pages.
    617  1.31       cgd 	 */
    618  1.31       cgd 	while (bp->b_bufsize < desired_size) {
    619  1.31       cgd 		int amt;
    620  1.31       cgd 
    621  1.31       cgd 		/* find a buffer */
    622  1.31       cgd 		while ((nbp = getnewbuf(0, 0)) == NULL)
    623  1.31       cgd 			;
    624  1.34   mycroft 		SET(nbp->b_flags, B_INVAL);
    625  1.34   mycroft 		binshash(nbp, &invalhash);
    626  1.31       cgd 
    627  1.31       cgd 		/* and steal its pages, up to the amount we need */
    628  1.31       cgd 		amt = min(nbp->b_bufsize, (desired_size - bp->b_bufsize));
    629  1.31       cgd 		pagemove((nbp->b_data + nbp->b_bufsize - amt),
    630  1.40  christos 			 bp->b_data + bp->b_bufsize, amt);
    631  1.31       cgd 		bp->b_bufsize += amt;
    632  1.31       cgd 		nbp->b_bufsize -= amt;
    633  1.31       cgd 
    634  1.31       cgd 		/* reduce transfer count if we stole some data */
    635  1.31       cgd 		if (nbp->b_bcount > nbp->b_bufsize)
    636  1.31       cgd 			nbp->b_bcount = nbp->b_bufsize;
    637  1.31       cgd 
    638  1.31       cgd #ifdef DIAGNOSTIC
    639  1.31       cgd 		if (nbp->b_bufsize < 0)
    640  1.31       cgd 			panic("allocbuf: negative bufsize");
    641  1.31       cgd #endif
    642  1.34   mycroft 
    643  1.31       cgd 		brelse(nbp);
    644  1.31       cgd 	}
    645  1.31       cgd 
    646  1.31       cgd 	/*
    647  1.31       cgd 	 * If we want a buffer smaller than the current size,
    648  1.31       cgd 	 * shrink this buffer.  Grab a buf head from the EMPTY queue,
    649  1.31       cgd 	 * move a page onto it, and put it on front of the AGE queue.
    650  1.31       cgd 	 * If there are no free buffer headers, leave the buffer alone.
    651  1.31       cgd 	 */
    652  1.31       cgd 	if (bp->b_bufsize > desired_size) {
    653  1.31       cgd 		s = splbio();
    654  1.31       cgd 		if ((nbp = bufqueues[BQ_EMPTY].tqh_first) == NULL) {
    655  1.31       cgd 			/* No free buffer head */
    656  1.31       cgd 			splx(s);
    657  1.31       cgd 			goto out;
    658  1.31       cgd 		}
    659  1.31       cgd 		bremfree(nbp);
    660  1.31       cgd 		SET(nbp->b_flags, B_BUSY);
    661  1.31       cgd 		splx(s);
    662  1.31       cgd 
    663  1.31       cgd 		/* move the page to it and note this change */
    664  1.31       cgd 		pagemove(bp->b_data + desired_size,
    665  1.31       cgd 		    nbp->b_data, bp->b_bufsize - desired_size);
    666  1.31       cgd 		nbp->b_bufsize = bp->b_bufsize - desired_size;
    667  1.31       cgd 		bp->b_bufsize = desired_size;
    668  1.31       cgd 		nbp->b_bcount = 0;
    669  1.31       cgd 		SET(nbp->b_flags, B_INVAL);
    670  1.31       cgd 
    671  1.31       cgd 		/* release the newly-filled buffer and leave */
    672  1.31       cgd 		brelse(nbp);
    673  1.31       cgd 	}
    674  1.31       cgd 
    675  1.31       cgd out:
    676  1.31       cgd 	bp->b_bcount = size;
    677  1.31       cgd }
    678  1.31       cgd 
    679  1.31       cgd /*
    680  1.31       cgd  * Find a buffer which is available for use.
    681  1.31       cgd  * Select something from a free list.
    682  1.31       cgd  * Preference is to AGE list, then LRU list.
    683  1.31       cgd  */
    684  1.31       cgd struct buf *
    685  1.31       cgd getnewbuf(slpflag, slptimeo)
    686  1.31       cgd 	int slpflag, slptimeo;
    687  1.31       cgd {
    688  1.31       cgd 	register struct buf *bp;
    689  1.31       cgd 	int s;
    690  1.31       cgd 
    691  1.31       cgd start:
    692  1.31       cgd 	s = splbio();
    693  1.31       cgd 	if ((bp = bufqueues[BQ_AGE].tqh_first) != NULL ||
    694  1.31       cgd 	    (bp = bufqueues[BQ_LRU].tqh_first) != NULL) {
    695  1.31       cgd 		bremfree(bp);
    696  1.31       cgd 	} else {
    697  1.31       cgd 		/* wait for a free buffer of any kind */
    698  1.31       cgd 		needbuffer = 1;
    699  1.31       cgd 		tsleep(&needbuffer, slpflag|(PRIBIO+1), "getnewbuf", slptimeo);
    700  1.31       cgd 		splx(s);
    701  1.31       cgd 		return (0);
    702  1.31       cgd 	}
    703  1.31       cgd 
    704  1.31       cgd 	/* Buffer is no longer on free lists. */
    705  1.31       cgd 	SET(bp->b_flags, B_BUSY);
    706  1.31       cgd 
    707  1.31       cgd 	/* If buffer was a delayed write, start it, and go back to the top. */
    708  1.31       cgd 	if (ISSET(bp->b_flags, B_DELWRI)) {
    709  1.39       cgd 		splx(s);
    710  1.31       cgd 		bawrite (bp);
    711  1.31       cgd 		goto start;
    712  1.31       cgd 	}
    713  1.31       cgd 
    714  1.31       cgd 	/* disassociate us from our vnode, if we had one... */
    715  1.31       cgd 	if (bp->b_vp)
    716  1.31       cgd 		brelvp(bp);
    717  1.31       cgd 	splx(s);
    718  1.31       cgd 
    719  1.31       cgd 	/* clear out various other fields */
    720  1.31       cgd 	bp->b_flags = B_BUSY;
    721  1.31       cgd 	bp->b_dev = NODEV;
    722  1.31       cgd 	bp->b_blkno = bp->b_lblkno = 0;
    723  1.31       cgd 	bp->b_iodone = 0;
    724  1.31       cgd 	bp->b_error = 0;
    725  1.31       cgd 	bp->b_resid = 0;
    726  1.31       cgd 	bp->b_bcount = 0;
    727  1.31       cgd 	bp->b_dirtyoff = bp->b_dirtyend = 0;
    728  1.31       cgd 	bp->b_validoff = bp->b_validend = 0;
    729  1.31       cgd 
    730  1.31       cgd 	/* nuke any credentials we were holding */
    731  1.31       cgd 	if (bp->b_rcred != NOCRED) {
    732  1.31       cgd 		crfree(bp->b_rcred);
    733  1.31       cgd 		bp->b_rcred = NOCRED;
    734  1.31       cgd 	}
    735  1.31       cgd 	if (bp->b_wcred != NOCRED) {
    736  1.31       cgd 		crfree(bp->b_wcred);
    737  1.31       cgd 		bp->b_wcred = NOCRED;
    738  1.31       cgd 	}
    739  1.31       cgd 
    740  1.34   mycroft 	bremhash(bp);
    741  1.31       cgd 	return (bp);
    742  1.31       cgd }
    743  1.31       cgd 
    744  1.31       cgd /*
    745  1.31       cgd  * Wait for operations on the buffer to complete.
    746  1.31       cgd  * When they do, extract and return the I/O's error value.
    747  1.31       cgd  */
    748  1.31       cgd int
    749  1.31       cgd biowait(bp)
    750  1.31       cgd 	struct buf *bp;
    751  1.31       cgd {
    752  1.31       cgd 	int s;
    753  1.31       cgd 
    754  1.31       cgd 	s = splbio();
    755  1.31       cgd 	while (!ISSET(bp->b_flags, B_DONE))
    756  1.31       cgd 		tsleep(bp, PRIBIO + 1, "biowait", 0);
    757  1.31       cgd 	splx(s);
    758  1.31       cgd 
    759  1.31       cgd 	/* check for interruption of I/O (e.g. via NFS), then errors. */
    760  1.31       cgd 	if (ISSET(bp->b_flags, B_EINTR)) {
    761  1.31       cgd 		CLR(bp->b_flags, B_EINTR);
    762  1.31       cgd 		return (EINTR);
    763  1.31       cgd 	} else if (ISSET(bp->b_flags, B_ERROR))
    764  1.31       cgd 		return (bp->b_error ? bp->b_error : EIO);
    765  1.31       cgd 	else
    766  1.31       cgd 		return (0);
    767  1.31       cgd }
    768  1.31       cgd 
    769  1.31       cgd /*
    770  1.31       cgd  * Mark I/O complete on a buffer.
    771  1.31       cgd  *
    772  1.31       cgd  * If a callback has been requested, e.g. the pageout
    773  1.31       cgd  * daemon, do so. Otherwise, awaken waiting processes.
    774  1.31       cgd  *
    775  1.31       cgd  * [ Leffler, et al., says on p.247:
    776  1.31       cgd  *	"This routine wakes up the blocked process, frees the buffer
    777  1.31       cgd  *	for an asynchronous write, or, for a request by the pagedaemon
    778  1.31       cgd  *	process, invokes a procedure specified in the buffer structure" ]
    779  1.31       cgd  *
    780  1.31       cgd  * In real life, the pagedaemon (or other system processes) wants
    781  1.31       cgd  * to do async stuff to, and doesn't want the buffer brelse()'d.
    782  1.31       cgd  * (for swap pager, that puts swap buffers on the free lists (!!!),
    783  1.31       cgd  * for the vn device, that puts malloc'd buffers on the free lists!)
    784  1.31       cgd  */
    785  1.31       cgd void
    786  1.31       cgd biodone(bp)
    787  1.31       cgd 	struct buf *bp;
    788  1.31       cgd {
    789  1.31       cgd 	if (ISSET(bp->b_flags, B_DONE))
    790  1.31       cgd 		panic("biodone already");
    791  1.31       cgd 	SET(bp->b_flags, B_DONE);		/* note that it's done */
    792  1.31       cgd 
    793  1.31       cgd 	if (!ISSET(bp->b_flags, B_READ))	/* wake up reader */
    794  1.31       cgd 		vwakeup(bp);
    795  1.31       cgd 
    796  1.31       cgd 	if (ISSET(bp->b_flags, B_CALL)) {	/* if necessary, call out */
    797  1.31       cgd 		CLR(bp->b_flags, B_CALL);	/* but note callout done */
    798  1.31       cgd 		(*bp->b_iodone)(bp);
    799  1.31       cgd 	} else if (ISSET(bp->b_flags, B_ASYNC))	/* if async, release it */
    800  1.31       cgd 		brelse(bp);
    801  1.31       cgd 	else {					/* or just wakeup the buffer */
    802  1.31       cgd 		CLR(bp->b_flags, B_WANTED);
    803  1.31       cgd 		wakeup(bp);
    804  1.31       cgd 	}
    805  1.31       cgd }
    806  1.31       cgd 
    807  1.31       cgd /*
    808  1.31       cgd  * Return a count of buffers on the "locked" queue.
    809  1.31       cgd  */
    810  1.31       cgd int
    811  1.31       cgd count_lock_queue()
    812  1.31       cgd {
    813  1.31       cgd 	register struct buf *bp;
    814  1.31       cgd 	register int n = 0;
    815  1.31       cgd 
    816  1.31       cgd 	for (bp = bufqueues[BQ_LOCKED].tqh_first; bp;
    817  1.31       cgd 	    bp = bp->b_freelist.tqe_next)
    818  1.31       cgd 		n++;
    819  1.31       cgd 	return (n);
    820  1.31       cgd }
    821  1.31       cgd 
    822  1.36       cgd #ifdef DEBUG
    823  1.31       cgd /*
    824  1.31       cgd  * Print out statistics on the current allocation of the buffer pool.
    825  1.31       cgd  * Can be enabled to print out on every ``sync'' by setting "syncprt"
    826  1.31       cgd  * in vfs_syscalls.c using sysctl.
    827  1.31       cgd  */
    828  1.31       cgd void
    829  1.31       cgd vfs_bufstats()
    830  1.31       cgd {
    831  1.31       cgd 	int s, i, j, count;
    832  1.31       cgd 	register struct buf *bp;
    833  1.31       cgd 	register struct bqueues *dp;
    834  1.31       cgd 	int counts[MAXBSIZE/CLBYTES+1];
    835  1.31       cgd 	static char *bname[BQUEUES] = { "LOCKED", "LRU", "AGE", "EMPTY" };
    836  1.31       cgd 
    837  1.31       cgd 	for (dp = bufqueues, i = 0; dp < &bufqueues[BQUEUES]; dp++, i++) {
    838  1.31       cgd 		count = 0;
    839  1.31       cgd 		for (j = 0; j <= MAXBSIZE/CLBYTES; j++)
    840  1.31       cgd 			counts[j] = 0;
    841  1.31       cgd 		s = splbio();
    842  1.31       cgd 		for (bp = dp->tqh_first; bp; bp = bp->b_freelist.tqe_next) {
    843  1.31       cgd 			counts[bp->b_bufsize/CLBYTES]++;
    844  1.31       cgd 			count++;
    845  1.31       cgd 		}
    846  1.31       cgd 		splx(s);
    847  1.31       cgd 		printf("%s: total-%d", bname[i], count);
    848  1.31       cgd 		for (j = 0; j <= MAXBSIZE/CLBYTES; j++)
    849  1.31       cgd 			if (counts[j] != 0)
    850  1.31       cgd 				printf(", %d-%d", j * CLBYTES, counts[j]);
    851  1.31       cgd 		printf("\n");
    852  1.31       cgd 	}
    853  1.31       cgd }
    854  1.36       cgd #endif /* DEBUG */
    855