1 /* 2 * Copyright (c) 1982, 1986, 1989, 1993 3 * The Regents of the University of California. All rights reserved. 4 * 5 * %sccs.include.redist.c% 6 * 7 * @(#)buf.h 8.3 (Berkeley) 09/23/93 8 */ 9 10 #ifndef _BUF_H_ 11 #define _BUF_H_ 12 #include <sys/queue.h> 13 14 /* 15 * The buffer header describes an I/O operation in the kernel. 16 */ 17 struct buf { 18 struct queue_entry b_hash; /* Hash chain. */ 19 struct queue_entry b_vnbufs; /* Buffer's associated vnode. */ 20 struct queue_entry b_freelist; /* Free list position if not active. */ 21 struct buf *b_actf, **b_actb; /* Device driver queue when active. */ 22 struct proc *b_proc; /* Associated proc; NULL if kernel. */ 23 volatile long b_flags; /* B_* flags. */ 24 int b_error; /* Errno value. */ 25 long b_bufsize; /* Allocated buffer size. */ 26 long b_bcount; /* Valid bytes in buffer. */ 27 long b_resid; /* Remaining I/O. */ 28 dev_t b_dev; /* Device associated with buffer. */ 29 struct { 30 caddr_t b_addr; /* Memory, superblocks, indirect etc. */ 31 } b_un; 32 void *b_saveaddr; /* Original b_addr for physio. */ 33 daddr_t b_lblkno; /* Logical block number. */ 34 daddr_t b_blkno; /* Underlying physical block number. */ 35 /* Function to call upon completion. */ 36 void (*b_iodone) __P((struct buf *)); 37 struct vnode *b_vp; /* Device vnode. */ 38 int b_pfcent; /* Center page when swapping cluster. */ 39 int b_dirtyoff; /* Offset in buffer of dirty region. */ 40 int b_dirtyend; /* Offset of end of dirty region. */ 41 struct ucred *b_rcred; /* Read credentials reference. */ 42 struct ucred *b_wcred; /* Write credentials reference. */ 43 int b_validoff; /* Offset in buffer of valid region. */ 44 int b_validend; /* Offset of end of valid region. */ 45 }; 46 47 /* Device driver compatibility definitions. */ 48 #define b_active b_bcount /* Driver queue head: drive active. */ 49 #define b_data b_un.b_addr /* b_un.b_addr is not changeable. */ 50 #define b_errcnt b_resid /* Retry count while I/O in progress. */ 51 #define iodone biodone /* Old name for biodone. */ 52 #define iowait biowait /* Old name for biowait. */ 53 54 /* 55 * These flags are kept in b_flags. 56 */ 57 #define B_AGE 0x00000001 /* Move to age queue when I/O done. */ 58 #define B_APPENDWRITE 0x00000002 /* Append-write in progress. */ 59 #define B_ASYNC 0x00000004 /* Start I/O, do not wait. */ 60 #define B_BAD 0x00000008 /* Bad block revectoring in progress. */ 61 #define B_BUSY 0x00000010 /* I/O in progress. */ 62 #define B_CACHE 0x00000020 /* Bread found us in the cache. */ 63 #define B_CALL 0x00000040 /* Call b_iodone from biodone. */ 64 #define B_DELWRI 0x00000080 /* Delay I/O until buffer reused. */ 65 #define B_DIRTY 0x00000100 /* Dirty page to be pushed out async. */ 66 #define B_DONE 0x00000200 /* I/O completed. */ 67 #define B_EINTR 0x00000400 /* I/O was interrupted */ 68 #define B_ERROR 0x00000800 /* I/O error occurred. */ 69 #define B_GATHERED 0x00001000 /* LFS: already in a segment. */ 70 #define B_INVAL 0x00002000 /* Does not contain valid info. */ 71 #define B_LOCKED 0x00004000 /* Locked in core (not reusable). */ 72 #define B_NOCACHE 0x00008000 /* Do not cache block after use. */ 73 #define B_PAGET 0x00010000 /* Page in/out of page table space. */ 74 #define B_PGIN 0x00020000 /* Pagein op, so swap() can count it. */ 75 #define B_PHYS 0x00040000 /* I/O to user memory. */ 76 #define B_RAW 0x00080000 /* Set by physio for raw transfers. */ 77 #define B_READ 0x00100000 /* Read buffer. */ 78 #define B_TAPE 0x00200000 /* Magnetic tape I/O. */ 79 #define B_UAREA 0x00400000 /* Buffer describes Uarea I/O. */ 80 #define B_WANTED 0x00800000 /* Process wants this buffer. */ 81 #define B_WRITE 0x00000000 /* Write buffer (pseudo flag). */ 82 #define B_WRITEINPROG 0x01000000 /* Write in progress. */ 83 #define B_XXX 0x02000000 /* Debugging flag. */ 84 85 /* 86 * This structure describes a clustered I/O. It is stored in the b_saveaddr 87 * field of the buffer on which I/O is done. At I/O completion, cluster 88 * callback uses the structure to parcel I/O's to individual buffers, and 89 * then free's this structure. 90 */ 91 struct cluster_save { 92 long bs_bcount; /* Saved b_bcount. */ 93 long bs_bufsize; /* Saved b_bufsize. */ 94 void *bs_saveaddr; /* Saved b_addr. */ 95 int bs_nchildren; /* Number of associated buffers. */ 96 struct buf **bs_children; /* List of associated buffers. */ 97 }; 98 99 /* 100 * Zero out the buffer's data area. 101 */ 102 #define clrbuf(bp) { \ 103 blkclr((bp)->b_data, (u_int)(bp)->b_bcount); \ 104 (bp)->b_resid = 0; \ 105 } 106 107 /* Flags to low-level allocation routines. */ 108 #define B_CLRBUF 0x01 /* Request allocated buffer be cleared. */ 109 #define B_SYNC 0x02 /* Do all allocations synchronously. */ 110 111 #ifdef KERNEL 112 int nbuf; /* The number of buffer headers */ 113 struct buf *buf; /* The buffer headers. */ 114 char *buffers; /* The buffer contents. */ 115 int bufpages; /* Number of memory pages in the buffer pool. */ 116 struct buf *swbuf; /* Swap I/O buffer headers. */ 117 int nswbuf; /* Number of swap I/O buffer headers. */ 118 struct buf bswlist; /* Head of swap I/O buffer headers free list. */ 119 struct buf *bclnlist; /* Head of cleaned page list. */ 120 121 __BEGIN_DECLS 122 int allocbuf __P((struct buf *, int)); 123 int bawrite __P((struct buf *)); 124 int bdwrite __P((struct buf *)); 125 void biodone __P((struct buf *)); 126 int biowait __P((struct buf *)); 127 int bread __P((struct vnode *, daddr_t, int, 128 struct ucred *, struct buf **)); 129 int breadn __P((struct vnode *, daddr_t, int, daddr_t *, int *, int, 130 struct ucred *, struct buf **)); 131 int brelse __P((struct buf *)); 132 void bufinit __P((void)); 133 int bwrite __P((struct buf *)); 134 void cluster_callback __P((struct buf *)); 135 int cluster_read __P((struct vnode *, u_quad_t, daddr_t, long, 136 struct ucred *, struct buf **)); 137 void cluster_write __P((struct buf *, u_quad_t)); 138 struct buf *getblk __P((struct vnode *, daddr_t, int, int, int)); 139 struct buf *geteblk __P((int)); 140 struct buf *getnewbuf __P((int slpflag, int slptimeo)); 141 struct buf *incore __P((struct vnode *, daddr_t)); 142 u_int minphys __P((struct buf *bp)); 143 __END_DECLS 144 #endif 145 #endif /* !_BUF_H_ */ 146