buffer_head.h
上传用户:szlgq88
上传日期:2009-04-28
资源大小:48287k
文件大小:9k
源码类别:

嵌入式Linux

开发平台:

Unix_Linux

  1. /*
  2.  * include/linux/buffer_head.h
  3.  *
  4.  * Everything to do with buffer_heads.
  5.  */
  6. #ifndef _LINUX_BUFFER_HEAD_H
  7. #define _LINUX_BUFFER_HEAD_H
  8. #include <linux/types.h>
  9. #include <linux/fs.h>
  10. #include <linux/linkage.h>
  11. #include <linux/pagemap.h>
  12. #include <linux/wait.h>
  13. #include <asm/atomic.h>
  14. enum bh_state_bits {
  15. BH_Uptodate, /* Contains valid data */
  16. BH_Dirty, /* Is dirty */
  17. BH_Lock, /* Is locked */
  18. BH_Req, /* Has been submitted for I/O */
  19. BH_Uptodate_Lock,/* Used by the first bh in a page, to serialise
  20.   * IO completion of other buffers in the page
  21.   */
  22. BH_Mapped, /* Has a disk mapping */
  23. BH_New, /* Disk mapping was newly created by get_block */
  24. BH_Async_Read, /* Is under end_buffer_async_read I/O */
  25. BH_Async_Write, /* Is under end_buffer_async_write I/O */
  26. BH_Delay, /* Buffer is not yet allocated on disk */
  27. BH_Boundary, /* Block is followed by a discontiguity */
  28. BH_Write_EIO, /* I/O error on write */
  29. BH_Ordered, /* ordered write */
  30. BH_Eopnotsupp, /* operation not supported (barrier) */
  31. BH_PrivateStart,/* not a state bit, but the first bit available
  32.  * for private allocation by other entities
  33.  */
  34. };
  35. #define MAX_BUF_PER_PAGE (PAGE_CACHE_SIZE / 512)
  36. struct page;
  37. struct buffer_head;
  38. struct address_space;
  39. typedef void (bh_end_io_t)(struct buffer_head *bh, int uptodate);
  40. /*
  41.  * Keep related fields in common cachelines.  The most commonly accessed
  42.  * field (b_state) goes at the start so the compiler does not generate
  43.  * indexed addressing for it.
  44.  */
  45. struct buffer_head {
  46. /* First cache line: */
  47. unsigned long b_state; /* buffer state bitmap (see above) */
  48. struct buffer_head *b_this_page;/* circular list of page's buffers */
  49. struct page *b_page; /* the page this bh is mapped to */
  50. atomic_t b_count; /* users using this block */
  51. u32 b_size; /* block size */
  52. sector_t b_blocknr; /* block number */
  53. char *b_data; /* pointer to data block */
  54. struct block_device *b_bdev;
  55. bh_end_io_t *b_end_io; /* I/O completion */
  56.   void *b_private; /* reserved for b_end_io */
  57. struct list_head b_assoc_buffers; /* associated with another mapping */
  58. };
  59. /*
  60.  * macro tricks to expand the set_buffer_foo(), clear_buffer_foo()
  61.  * and buffer_foo() functions.
  62.  */
  63. #define BUFFER_FNS(bit, name)
  64. static inline void set_buffer_##name(struct buffer_head *bh)
  65. {
  66. set_bit(BH_##bit, &(bh)->b_state);
  67. }
  68. static inline void clear_buffer_##name(struct buffer_head *bh)
  69. {
  70. clear_bit(BH_##bit, &(bh)->b_state);
  71. }
  72. static inline int buffer_##name(const struct buffer_head *bh)
  73. {
  74. return test_bit(BH_##bit, &(bh)->b_state);
  75. }
  76. /*
  77.  * test_set_buffer_foo() and test_clear_buffer_foo()
  78.  */
  79. #define TAS_BUFFER_FNS(bit, name)
  80. static inline int test_set_buffer_##name(struct buffer_head *bh)
  81. {
  82. return test_and_set_bit(BH_##bit, &(bh)->b_state);
  83. }
  84. static inline int test_clear_buffer_##name(struct buffer_head *bh)
  85. {
  86. return test_and_clear_bit(BH_##bit, &(bh)->b_state);
  87. }
  88. /*
  89.  * Emit the buffer bitops functions.   Note that there are also functions
  90.  * of the form "mark_buffer_foo()".  These are higher-level functions which
  91.  * do something in addition to setting a b_state bit.
  92.  */
  93. BUFFER_FNS(Uptodate, uptodate)
  94. BUFFER_FNS(Dirty, dirty)
  95. TAS_BUFFER_FNS(Dirty, dirty)
  96. BUFFER_FNS(Lock, locked)
  97. TAS_BUFFER_FNS(Lock, locked)
  98. BUFFER_FNS(Req, req)
  99. TAS_BUFFER_FNS(Req, req)
  100. BUFFER_FNS(Mapped, mapped)
  101. BUFFER_FNS(New, new)
  102. BUFFER_FNS(Async_Read, async_read)
  103. BUFFER_FNS(Async_Write, async_write)
  104. BUFFER_FNS(Delay, delay)
  105. BUFFER_FNS(Boundary, boundary)
  106. BUFFER_FNS(Write_EIO, write_io_error)
  107. BUFFER_FNS(Ordered, ordered)
  108. BUFFER_FNS(Eopnotsupp, eopnotsupp)
  109. #define bh_offset(bh) ((unsigned long)(bh)->b_data & ~PAGE_MASK)
  110. #define touch_buffer(bh) mark_page_accessed(bh->b_page)
  111. /* If we *know* page->private refers to buffer_heads */
  112. #define page_buffers(page)
  113. ({
  114. BUG_ON(!PagePrivate(page));
  115. ((struct buffer_head *)(page)->private);
  116. })
  117. #define page_has_buffers(page) PagePrivate(page)
  118. /*
  119.  * Declarations
  120.  */
  121. void FASTCALL(mark_buffer_dirty(struct buffer_head *bh));
  122. void init_buffer(struct buffer_head *, bh_end_io_t *, void *);
  123. void set_bh_page(struct buffer_head *bh,
  124. struct page *page, unsigned long offset);
  125. int try_to_free_buffers(struct page *);
  126. struct buffer_head *alloc_page_buffers(struct page *page, unsigned long size,
  127. int retry);
  128. void create_empty_buffers(struct page *, unsigned long,
  129. unsigned long b_state);
  130. void end_buffer_read_sync(struct buffer_head *bh, int uptodate);
  131. void end_buffer_write_sync(struct buffer_head *bh, int uptodate);
  132. void end_buffer_async_write(struct buffer_head *bh, int uptodate);
  133. /* Things to do with buffers at mapping->private_list */
  134. void mark_buffer_dirty_inode(struct buffer_head *bh, struct inode *inode);
  135. int inode_has_buffers(struct inode *);
  136. void invalidate_inode_buffers(struct inode *);
  137. int remove_inode_buffers(struct inode *inode);
  138. int sync_mapping_buffers(struct address_space *mapping);
  139. void unmap_underlying_metadata(struct block_device *bdev, sector_t block);
  140. void mark_buffer_async_write(struct buffer_head *bh);
  141. void invalidate_bdev(struct block_device *, int);
  142. int sync_blockdev(struct block_device *bdev);
  143. void __wait_on_buffer(struct buffer_head *);
  144. wait_queue_head_t *bh_waitq_head(struct buffer_head *bh);
  145. int fsync_bdev(struct block_device *);
  146. struct super_block *freeze_bdev(struct block_device *);
  147. void thaw_bdev(struct block_device *, struct super_block *);
  148. int fsync_super(struct super_block *);
  149. int fsync_no_super(struct block_device *);
  150. struct buffer_head *__find_get_block(struct block_device *, sector_t, int);
  151. struct buffer_head * __getblk(struct block_device *, sector_t, int);
  152. void __brelse(struct buffer_head *);
  153. void __bforget(struct buffer_head *);
  154. void __breadahead(struct block_device *, sector_t block, int size);
  155. struct buffer_head *__bread(struct block_device *, sector_t block, int size);
  156. struct buffer_head *alloc_buffer_head(gfp_t gfp_flags);
  157. void free_buffer_head(struct buffer_head * bh);
  158. void FASTCALL(unlock_buffer(struct buffer_head *bh));
  159. void FASTCALL(__lock_buffer(struct buffer_head *bh));
  160. void ll_rw_block(int, int, struct buffer_head * bh[]);
  161. int sync_dirty_buffer(struct buffer_head *bh);
  162. int submit_bh(int, struct buffer_head *);
  163. void write_boundary_block(struct block_device *bdev,
  164. sector_t bblock, unsigned blocksize);
  165. extern int buffer_heads_over_limit;
  166. /*
  167.  * Generic address_space_operations implementations for buffer_head-backed
  168.  * address_spaces.
  169.  */
  170. int try_to_release_page(struct page * page, int gfp_mask);
  171. int block_invalidatepage(struct page *page, unsigned long offset);
  172. int block_write_full_page(struct page *page, get_block_t *get_block,
  173. struct writeback_control *wbc);
  174. int block_read_full_page(struct page*, get_block_t*);
  175. int block_prepare_write(struct page*, unsigned, unsigned, get_block_t*);
  176. int cont_prepare_write(struct page*, unsigned, unsigned, get_block_t*,
  177. loff_t *);
  178. int generic_cont_expand(struct inode *inode, loff_t size) ;
  179. int block_commit_write(struct page *page, unsigned from, unsigned to);
  180. int block_sync_page(struct page *);
  181. sector_t generic_block_bmap(struct address_space *, sector_t, get_block_t *);
  182. int generic_commit_write(struct file *, struct page *, unsigned, unsigned);
  183. int block_truncate_page(struct address_space *, loff_t, get_block_t *);
  184. int file_fsync(struct file *, struct dentry *, int);
  185. int nobh_prepare_write(struct page*, unsigned, unsigned, get_block_t*);
  186. int nobh_commit_write(struct file *, struct page *, unsigned, unsigned);
  187. int nobh_truncate_page(struct address_space *, loff_t);
  188. int nobh_writepage(struct page *page, get_block_t *get_block,
  189.                         struct writeback_control *wbc);
  190. /*
  191.  * inline definitions
  192.  */
  193. static inline void attach_page_buffers(struct page *page,
  194. struct buffer_head *head)
  195. {
  196. page_cache_get(page);
  197. SetPagePrivate(page);
  198. page->private = (unsigned long)head;
  199. }
  200. static inline void get_bh(struct buffer_head *bh)
  201. {
  202.         atomic_inc(&bh->b_count);
  203. }
  204. static inline void put_bh(struct buffer_head *bh)
  205. {
  206.         smp_mb__before_atomic_dec();
  207.         atomic_dec(&bh->b_count);
  208. }
  209. static inline void brelse(struct buffer_head *bh)
  210. {
  211. if (bh)
  212. __brelse(bh);
  213. }
  214. static inline void bforget(struct buffer_head *bh)
  215. {
  216. if (bh)
  217. __bforget(bh);
  218. }
  219. static inline struct buffer_head *
  220. sb_bread(struct super_block *sb, sector_t block)
  221. {
  222. return __bread(sb->s_bdev, block, sb->s_blocksize);
  223. }
  224. static inline void
  225. sb_breadahead(struct super_block *sb, sector_t block)
  226. {
  227. __breadahead(sb->s_bdev, block, sb->s_blocksize);
  228. }
  229. static inline struct buffer_head *
  230. sb_getblk(struct super_block *sb, sector_t block)
  231. {
  232. return __getblk(sb->s_bdev, block, sb->s_blocksize);
  233. }
  234. static inline struct buffer_head *
  235. sb_find_get_block(struct super_block *sb, sector_t block)
  236. {
  237. return __find_get_block(sb->s_bdev, block, sb->s_blocksize);
  238. }
  239. static inline void
  240. map_bh(struct buffer_head *bh, struct super_block *sb, sector_t block)
  241. {
  242. set_buffer_mapped(bh);
  243. bh->b_bdev = sb->s_bdev;
  244. bh->b_blocknr = block;
  245. }
  246. /*
  247.  * Calling wait_on_buffer() for a zero-ref buffer is illegal, so we call into
  248.  * __wait_on_buffer() just to trip a debug check.  Because debug code in inline
  249.  * functions is bloaty.
  250.  */
  251. static inline void wait_on_buffer(struct buffer_head *bh)
  252. {
  253. might_sleep();
  254. if (buffer_locked(bh) || atomic_read(&bh->b_count) == 0)
  255. __wait_on_buffer(bh);
  256. }
  257. static inline void lock_buffer(struct buffer_head *bh)
  258. {
  259. might_sleep();
  260. if (test_set_buffer_locked(bh))
  261. __lock_buffer(bh);
  262. }
  263. #endif /* _LINUX_BUFFER_HEAD_H */