2 * Copyright (c) 2000-2006 Silicon Graphics, Inc.
5 * This program is free software; you can redistribute it and/or
6 * modify it under the terms of the GNU General Public License as
7 * published by the Free Software Foundation.
9 * This program is distributed in the hope that it would be useful,
10 * but WITHOUT ANY WARRANTY; without even the implied warranty of
11 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
12 * GNU General Public License for more details.
14 * You should have received a copy of the GNU General Public License
15 * along with this program; if not, write the Free Software Foundation,
16 * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
19 #include <linux/stddef.h>
20 #include <linux/errno.h>
21 #include <linux/gfp.h>
22 #include <linux/pagemap.h>
23 #include <linux/init.h>
24 #include <linux/vmalloc.h>
25 #include <linux/bio.h>
26 #include <linux/sysctl.h>
27 #include <linux/proc_fs.h>
28 #include <linux/workqueue.h>
29 #include <linux/percpu.h>
30 #include <linux/blkdev.h>
31 #include <linux/hash.h>
32 #include <linux/kthread.h>
33 #include <linux/migrate.h>
34 #include <linux/backing-dev.h>
35 #include <linux/freezer.h>
40 #include "xfs_mount.h"
41 #include "xfs_trace.h"
43 static kmem_zone_t
*xfs_buf_zone
;
45 static struct workqueue_struct
*xfslogd_workqueue
;
47 #ifdef XFS_BUF_LOCK_TRACKING
48 # define XB_SET_OWNER(bp) ((bp)->b_last_holder = current->pid)
49 # define XB_CLEAR_OWNER(bp) ((bp)->b_last_holder = -1)
50 # define XB_GET_OWNER(bp) ((bp)->b_last_holder)
52 # define XB_SET_OWNER(bp) do { } while (0)
53 # define XB_CLEAR_OWNER(bp) do { } while (0)
54 # define XB_GET_OWNER(bp) do { } while (0)
57 #define xb_to_gfp(flags) \
58 ((((flags) & XBF_READ_AHEAD) ? __GFP_NORETRY : GFP_NOFS) | __GFP_NOWARN)
66 * Return true if the buffer is vmapped.
68 * b_addr is null if the buffer is not mapped, but the code is clever
69 * enough to know it doesn't have to map a single page, so the check has
70 * to be both for b_addr and bp->b_page_count > 1.
72 return bp
->b_addr
&& bp
->b_page_count
> 1;
79 return (bp
->b_page_count
* PAGE_SIZE
) - bp
->b_offset
;
83 * xfs_buf_lru_add - add a buffer to the LRU.
85 * The LRU takes a new reference to the buffer so that it will only be freed
86 * once the shrinker takes the buffer off the LRU.
92 struct xfs_buftarg
*btp
= bp
->b_target
;
94 spin_lock(&btp
->bt_lru_lock
);
95 if (list_empty(&bp
->b_lru
)) {
96 atomic_inc(&bp
->b_hold
);
97 list_add_tail(&bp
->b_lru
, &btp
->bt_lru
);
99 bp
->b_lru_flags
&= ~_XBF_LRU_DISPOSE
;
101 spin_unlock(&btp
->bt_lru_lock
);
105 * xfs_buf_lru_del - remove a buffer from the LRU
107 * The unlocked check is safe here because it only occurs when there are not
108 * b_lru_ref counts left on the inode under the pag->pag_buf_lock. it is there
109 * to optimise the shrinker removing the buffer from the LRU and calling
110 * xfs_buf_free(). i.e. it removes an unnecessary round trip on the
117 struct xfs_buftarg
*btp
= bp
->b_target
;
119 if (list_empty(&bp
->b_lru
))
122 spin_lock(&btp
->bt_lru_lock
);
123 if (!list_empty(&bp
->b_lru
)) {
124 list_del_init(&bp
->b_lru
);
127 spin_unlock(&btp
->bt_lru_lock
);
131 * When we mark a buffer stale, we remove the buffer from the LRU and clear the
132 * b_lru_ref count so that the buffer is freed immediately when the buffer
133 * reference count falls to zero. If the buffer is already on the LRU, we need
134 * to remove the reference that LRU holds on the buffer.
136 * This prevents build-up of stale buffers on the LRU.
142 ASSERT(xfs_buf_islocked(bp
));
144 bp
->b_flags
|= XBF_STALE
;
147 * Clear the delwri status so that a delwri queue walker will not
148 * flush this buffer to disk now that it is stale. The delwri queue has
149 * a reference to the buffer, so this is safe to do.
151 bp
->b_flags
&= ~_XBF_DELWRI_Q
;
153 atomic_set(&(bp
)->b_lru_ref
, 0);
154 if (!list_empty(&bp
->b_lru
)) {
155 struct xfs_buftarg
*btp
= bp
->b_target
;
157 spin_lock(&btp
->bt_lru_lock
);
158 if (!list_empty(&bp
->b_lru
) &&
159 !(bp
->b_lru_flags
& _XBF_LRU_DISPOSE
)) {
160 list_del_init(&bp
->b_lru
);
162 atomic_dec(&bp
->b_hold
);
164 spin_unlock(&btp
->bt_lru_lock
);
166 ASSERT(atomic_read(&bp
->b_hold
) >= 1);
174 ASSERT(bp
->b_maps
== NULL
);
175 bp
->b_map_count
= map_count
;
177 if (map_count
== 1) {
178 bp
->b_maps
= &bp
->__b_map
;
182 bp
->b_maps
= kmem_zalloc(map_count
* sizeof(struct xfs_buf_map
),
190 * Frees b_pages if it was allocated.
196 if (bp
->b_maps
!= &bp
->__b_map
) {
197 kmem_free(bp
->b_maps
);
204 struct xfs_buftarg
*target
,
205 struct xfs_buf_map
*map
,
207 xfs_buf_flags_t flags
)
213 bp
= kmem_zone_zalloc(xfs_buf_zone
, KM_NOFS
);
218 * We don't want certain flags to appear in b_flags unless they are
219 * specifically set by later operations on the buffer.
221 flags
&= ~(XBF_UNMAPPED
| XBF_TRYLOCK
| XBF_ASYNC
| XBF_READ_AHEAD
);
223 atomic_set(&bp
->b_hold
, 1);
224 atomic_set(&bp
->b_lru_ref
, 1);
225 init_completion(&bp
->b_iowait
);
226 INIT_LIST_HEAD(&bp
->b_lru
);
227 INIT_LIST_HEAD(&bp
->b_list
);
228 RB_CLEAR_NODE(&bp
->b_rbnode
);
229 sema_init(&bp
->b_sema
, 0); /* held, no waiters */
231 bp
->b_target
= target
;
235 * Set length and io_length to the same value initially.
236 * I/O routines should use io_length, which will be the same in
237 * most cases but may be reset (e.g. XFS recovery).
239 error
= xfs_buf_get_maps(bp
, nmaps
);
241 kmem_zone_free(xfs_buf_zone
, bp
);
245 bp
->b_bn
= map
[0].bm_bn
;
247 for (i
= 0; i
< nmaps
; i
++) {
248 bp
->b_maps
[i
].bm_bn
= map
[i
].bm_bn
;
249 bp
->b_maps
[i
].bm_len
= map
[i
].bm_len
;
250 bp
->b_length
+= map
[i
].bm_len
;
252 bp
->b_io_length
= bp
->b_length
;
254 atomic_set(&bp
->b_pin_count
, 0);
255 init_waitqueue_head(&bp
->b_waiters
);
257 XFS_STATS_INC(xb_create
);
258 trace_xfs_buf_init(bp
, _RET_IP_
);
264 * Allocate a page array capable of holding a specified number
265 * of pages, and point the page buf at it.
271 xfs_buf_flags_t flags
)
273 /* Make sure that we have a page list */
274 if (bp
->b_pages
== NULL
) {
275 bp
->b_page_count
= page_count
;
276 if (page_count
<= XB_PAGES
) {
277 bp
->b_pages
= bp
->b_page_array
;
279 bp
->b_pages
= kmem_alloc(sizeof(struct page
*) *
280 page_count
, KM_NOFS
);
281 if (bp
->b_pages
== NULL
)
284 memset(bp
->b_pages
, 0, sizeof(struct page
*) * page_count
);
290 * Frees b_pages if it was allocated.
296 if (bp
->b_pages
!= bp
->b_page_array
) {
297 kmem_free(bp
->b_pages
);
303 * Releases the specified buffer.
305 * The modification state of any associated pages is left unchanged.
306 * The buffer most not be on any hash - use xfs_buf_rele instead for
307 * hashed and refcounted buffers
313 trace_xfs_buf_free(bp
, _RET_IP_
);
315 ASSERT(list_empty(&bp
->b_lru
));
317 if (bp
->b_flags
& _XBF_PAGES
) {
320 if (xfs_buf_is_vmapped(bp
))
321 vm_unmap_ram(bp
->b_addr
- bp
->b_offset
,
324 for (i
= 0; i
< bp
->b_page_count
; i
++) {
325 struct page
*page
= bp
->b_pages
[i
];
329 } else if (bp
->b_flags
& _XBF_KMEM
)
330 kmem_free(bp
->b_addr
);
331 _xfs_buf_free_pages(bp
);
332 xfs_buf_free_maps(bp
);
333 kmem_zone_free(xfs_buf_zone
, bp
);
337 * Allocates all the pages for buffer in question and builds it's page list.
340 xfs_buf_allocate_memory(
345 size_t nbytes
, offset
;
346 gfp_t gfp_mask
= xb_to_gfp(flags
);
347 unsigned short page_count
, i
;
348 xfs_off_t start
, end
;
352 * for buffers that are contained within a single page, just allocate
353 * the memory from the heap - there's no need for the complexity of
354 * page arrays to keep allocation down to order 0.
356 size
= BBTOB(bp
->b_length
);
357 if (size
< PAGE_SIZE
) {
358 bp
->b_addr
= kmem_alloc(size
, KM_NOFS
);
360 /* low memory - use alloc_page loop instead */
364 if (((unsigned long)(bp
->b_addr
+ size
- 1) & PAGE_MASK
) !=
365 ((unsigned long)bp
->b_addr
& PAGE_MASK
)) {
366 /* b_addr spans two pages - use alloc_page instead */
367 kmem_free(bp
->b_addr
);
371 bp
->b_offset
= offset_in_page(bp
->b_addr
);
372 bp
->b_pages
= bp
->b_page_array
;
373 bp
->b_pages
[0] = virt_to_page(bp
->b_addr
);
374 bp
->b_page_count
= 1;
375 bp
->b_flags
|= _XBF_KMEM
;
380 start
= BBTOB(bp
->b_maps
[0].bm_bn
) >> PAGE_SHIFT
;
381 end
= (BBTOB(bp
->b_maps
[0].bm_bn
+ bp
->b_length
) + PAGE_SIZE
- 1)
383 page_count
= end
- start
;
384 error
= _xfs_buf_get_pages(bp
, page_count
, flags
);
388 offset
= bp
->b_offset
;
389 bp
->b_flags
|= _XBF_PAGES
;
391 for (i
= 0; i
< bp
->b_page_count
; i
++) {
395 page
= alloc_page(gfp_mask
);
396 if (unlikely(page
== NULL
)) {
397 if (flags
& XBF_READ_AHEAD
) {
398 bp
->b_page_count
= i
;
404 * This could deadlock.
406 * But until all the XFS lowlevel code is revamped to
407 * handle buffer allocation failures we can't do much.
409 if (!(++retries
% 100))
411 "possible memory allocation deadlock in %s (mode:0x%x)",
414 XFS_STATS_INC(xb_page_retries
);
415 congestion_wait(BLK_RW_ASYNC
, HZ
/50);
419 XFS_STATS_INC(xb_page_found
);
421 nbytes
= min_t(size_t, size
, PAGE_SIZE
- offset
);
423 bp
->b_pages
[i
] = page
;
429 for (i
= 0; i
< bp
->b_page_count
; i
++)
430 __free_page(bp
->b_pages
[i
]);
435 * Map buffer into kernel address-space if necessary.
442 ASSERT(bp
->b_flags
& _XBF_PAGES
);
443 if (bp
->b_page_count
== 1) {
444 /* A single page buffer is always mappable */
445 bp
->b_addr
= page_address(bp
->b_pages
[0]) + bp
->b_offset
;
446 } else if (flags
& XBF_UNMAPPED
) {
452 bp
->b_addr
= vm_map_ram(bp
->b_pages
, bp
->b_page_count
,
457 } while (retried
++ <= 1);
461 bp
->b_addr
+= bp
->b_offset
;
468 * Finding and Reading Buffers
472 * Look up, and creates if absent, a lockable buffer for
473 * a given range of an inode. The buffer is returned
474 * locked. No I/O is implied by this call.
478 struct xfs_buftarg
*btp
,
479 struct xfs_buf_map
*map
,
481 xfs_buf_flags_t flags
,
485 struct xfs_perag
*pag
;
486 struct rb_node
**rbp
;
487 struct rb_node
*parent
;
489 xfs_daddr_t blkno
= map
[0].bm_bn
;
494 for (i
= 0; i
< nmaps
; i
++)
495 numblks
+= map
[i
].bm_len
;
496 numbytes
= BBTOB(numblks
);
498 /* Check for IOs smaller than the sector size / not sector aligned */
499 ASSERT(!(numbytes
< (1 << btp
->bt_sshift
)));
500 ASSERT(!(BBTOB(blkno
) & (xfs_off_t
)btp
->bt_smask
));
503 * Corrupted block numbers can get through to here, unfortunately, so we
504 * have to check that the buffer falls within the filesystem bounds.
506 eofs
= XFS_FSB_TO_BB(btp
->bt_mount
, btp
->bt_mount
->m_sb
.sb_dblocks
);
509 * XXX (dgc): we should really be returning EFSCORRUPTED here,
510 * but none of the higher level infrastructure supports
511 * returning a specific error on buffer lookup failures.
513 xfs_alert(btp
->bt_mount
,
514 "%s: Block out of range: block 0x%llx, EOFS 0x%llx ",
515 __func__
, blkno
, eofs
);
521 pag
= xfs_perag_get(btp
->bt_mount
,
522 xfs_daddr_to_agno(btp
->bt_mount
, blkno
));
525 spin_lock(&pag
->pag_buf_lock
);
526 rbp
= &pag
->pag_buf_tree
.rb_node
;
531 bp
= rb_entry(parent
, struct xfs_buf
, b_rbnode
);
533 if (blkno
< bp
->b_bn
)
534 rbp
= &(*rbp
)->rb_left
;
535 else if (blkno
> bp
->b_bn
)
536 rbp
= &(*rbp
)->rb_right
;
539 * found a block number match. If the range doesn't
540 * match, the only way this is allowed is if the buffer
541 * in the cache is stale and the transaction that made
542 * it stale has not yet committed. i.e. we are
543 * reallocating a busy extent. Skip this buffer and
544 * continue searching to the right for an exact match.
546 if (bp
->b_length
!= numblks
) {
547 ASSERT(bp
->b_flags
& XBF_STALE
);
548 rbp
= &(*rbp
)->rb_right
;
551 atomic_inc(&bp
->b_hold
);
558 rb_link_node(&new_bp
->b_rbnode
, parent
, rbp
);
559 rb_insert_color(&new_bp
->b_rbnode
, &pag
->pag_buf_tree
);
560 /* the buffer keeps the perag reference until it is freed */
562 spin_unlock(&pag
->pag_buf_lock
);
564 XFS_STATS_INC(xb_miss_locked
);
565 spin_unlock(&pag
->pag_buf_lock
);
571 spin_unlock(&pag
->pag_buf_lock
);
574 if (!xfs_buf_trylock(bp
)) {
575 if (flags
& XBF_TRYLOCK
) {
577 XFS_STATS_INC(xb_busy_locked
);
581 XFS_STATS_INC(xb_get_locked_waited
);
585 * if the buffer is stale, clear all the external state associated with
586 * it. We need to keep flags such as how we allocated the buffer memory
589 if (bp
->b_flags
& XBF_STALE
) {
590 ASSERT((bp
->b_flags
& _XBF_DELWRI_Q
) == 0);
591 ASSERT(bp
->b_iodone
== NULL
);
592 bp
->b_flags
&= _XBF_KMEM
| _XBF_PAGES
;
596 trace_xfs_buf_find(bp
, flags
, _RET_IP_
);
597 XFS_STATS_INC(xb_get_locked
);
602 * Assembles a buffer covering the specified range. The code is optimised for
603 * cache hits, as metadata intensive workloads will see 3 orders of magnitude
604 * more hits than misses.
608 struct xfs_buftarg
*target
,
609 struct xfs_buf_map
*map
,
611 xfs_buf_flags_t flags
)
614 struct xfs_buf
*new_bp
;
617 bp
= _xfs_buf_find(target
, map
, nmaps
, flags
, NULL
);
621 new_bp
= _xfs_buf_alloc(target
, map
, nmaps
, flags
);
622 if (unlikely(!new_bp
))
625 error
= xfs_buf_allocate_memory(new_bp
, flags
);
627 xfs_buf_free(new_bp
);
631 bp
= _xfs_buf_find(target
, map
, nmaps
, flags
, new_bp
);
633 xfs_buf_free(new_bp
);
638 xfs_buf_free(new_bp
);
642 error
= _xfs_buf_map_pages(bp
, flags
);
643 if (unlikely(error
)) {
644 xfs_warn(target
->bt_mount
,
645 "%s: failed to map pages\n", __func__
);
651 XFS_STATS_INC(xb_get
);
652 trace_xfs_buf_get(bp
, flags
, _RET_IP_
);
659 xfs_buf_flags_t flags
)
661 ASSERT(!(flags
& XBF_WRITE
));
662 ASSERT(bp
->b_maps
[0].bm_bn
!= XFS_BUF_DADDR_NULL
);
664 bp
->b_flags
&= ~(XBF_WRITE
| XBF_ASYNC
| XBF_READ_AHEAD
);
665 bp
->b_flags
|= flags
& (XBF_READ
| XBF_ASYNC
| XBF_READ_AHEAD
);
667 xfs_buf_iorequest(bp
);
668 if (flags
& XBF_ASYNC
)
670 return xfs_buf_iowait(bp
);
675 struct xfs_buftarg
*target
,
676 struct xfs_buf_map
*map
,
678 xfs_buf_flags_t flags
,
679 const struct xfs_buf_ops
*ops
)
685 bp
= xfs_buf_get_map(target
, map
, nmaps
, flags
);
687 trace_xfs_buf_read(bp
, flags
, _RET_IP_
);
689 if (!XFS_BUF_ISDONE(bp
)) {
690 XFS_STATS_INC(xb_get_read
);
692 _xfs_buf_read(bp
, flags
);
693 } else if (flags
& XBF_ASYNC
) {
695 * Read ahead call which is already satisfied,
701 /* We do not want read in the flags */
702 bp
->b_flags
&= ~XBF_READ
;
710 * If we are not low on memory then do the readahead in a deadlock
714 xfs_buf_readahead_map(
715 struct xfs_buftarg
*target
,
716 struct xfs_buf_map
*map
,
718 const struct xfs_buf_ops
*ops
)
720 if (bdi_read_congested(target
->bt_bdi
))
723 xfs_buf_read_map(target
, map
, nmaps
,
724 XBF_TRYLOCK
|XBF_ASYNC
|XBF_READ_AHEAD
, ops
);
728 * Read an uncached buffer from disk. Allocates and returns a locked
729 * buffer containing the disk contents or nothing.
732 xfs_buf_read_uncached(
733 struct xfs_buftarg
*target
,
737 const struct xfs_buf_ops
*ops
)
741 bp
= xfs_buf_get_uncached(target
, numblks
, flags
);
745 /* set up the buffer for a read IO */
746 ASSERT(bp
->b_map_count
== 1);
748 bp
->b_maps
[0].bm_bn
= daddr
;
749 bp
->b_flags
|= XBF_READ
;
752 xfsbdstrat(target
->bt_mount
, bp
);
758 * Return a buffer allocated as an empty buffer and associated to external
759 * memory via xfs_buf_associate_memory() back to it's empty state.
767 _xfs_buf_free_pages(bp
);
770 bp
->b_page_count
= 0;
772 bp
->b_length
= numblks
;
773 bp
->b_io_length
= numblks
;
775 ASSERT(bp
->b_map_count
== 1);
776 bp
->b_bn
= XFS_BUF_DADDR_NULL
;
777 bp
->b_maps
[0].bm_bn
= XFS_BUF_DADDR_NULL
;
778 bp
->b_maps
[0].bm_len
= bp
->b_length
;
781 static inline struct page
*
785 if ((!is_vmalloc_addr(addr
))) {
786 return virt_to_page(addr
);
788 return vmalloc_to_page(addr
);
793 xfs_buf_associate_memory(
800 unsigned long pageaddr
;
801 unsigned long offset
;
805 pageaddr
= (unsigned long)mem
& PAGE_MASK
;
806 offset
= (unsigned long)mem
- pageaddr
;
807 buflen
= PAGE_ALIGN(len
+ offset
);
808 page_count
= buflen
>> PAGE_SHIFT
;
810 /* Free any previous set of page pointers */
812 _xfs_buf_free_pages(bp
);
817 rval
= _xfs_buf_get_pages(bp
, page_count
, 0);
821 bp
->b_offset
= offset
;
823 for (i
= 0; i
< bp
->b_page_count
; i
++) {
824 bp
->b_pages
[i
] = mem_to_page((void *)pageaddr
);
825 pageaddr
+= PAGE_SIZE
;
828 bp
->b_io_length
= BTOBB(len
);
829 bp
->b_length
= BTOBB(buflen
);
835 xfs_buf_get_uncached(
836 struct xfs_buftarg
*target
,
840 unsigned long page_count
;
843 DEFINE_SINGLE_BUF_MAP(map
, XFS_BUF_DADDR_NULL
, numblks
);
845 bp
= _xfs_buf_alloc(target
, &map
, 1, 0);
846 if (unlikely(bp
== NULL
))
849 page_count
= PAGE_ALIGN(numblks
<< BBSHIFT
) >> PAGE_SHIFT
;
850 error
= _xfs_buf_get_pages(bp
, page_count
, 0);
854 for (i
= 0; i
< page_count
; i
++) {
855 bp
->b_pages
[i
] = alloc_page(xb_to_gfp(flags
));
859 bp
->b_flags
|= _XBF_PAGES
;
861 error
= _xfs_buf_map_pages(bp
, 0);
862 if (unlikely(error
)) {
863 xfs_warn(target
->bt_mount
,
864 "%s: failed to map pages\n", __func__
);
868 trace_xfs_buf_get_uncached(bp
, _RET_IP_
);
873 __free_page(bp
->b_pages
[i
]);
874 _xfs_buf_free_pages(bp
);
876 xfs_buf_free_maps(bp
);
877 kmem_zone_free(xfs_buf_zone
, bp
);
883 * Increment reference count on buffer, to hold the buffer concurrently
884 * with another thread which may release (free) the buffer asynchronously.
885 * Must hold the buffer already to call this function.
891 trace_xfs_buf_hold(bp
, _RET_IP_
);
892 atomic_inc(&bp
->b_hold
);
896 * Releases a hold on the specified buffer. If the
897 * the hold count is 1, calls xfs_buf_free.
903 struct xfs_perag
*pag
= bp
->b_pag
;
905 trace_xfs_buf_rele(bp
, _RET_IP_
);
908 ASSERT(list_empty(&bp
->b_lru
));
909 ASSERT(RB_EMPTY_NODE(&bp
->b_rbnode
));
910 if (atomic_dec_and_test(&bp
->b_hold
))
915 ASSERT(!RB_EMPTY_NODE(&bp
->b_rbnode
));
917 ASSERT(atomic_read(&bp
->b_hold
) > 0);
918 if (atomic_dec_and_lock(&bp
->b_hold
, &pag
->pag_buf_lock
)) {
919 if (!(bp
->b_flags
& XBF_STALE
) &&
920 atomic_read(&bp
->b_lru_ref
)) {
922 spin_unlock(&pag
->pag_buf_lock
);
925 ASSERT(!(bp
->b_flags
& _XBF_DELWRI_Q
));
926 rb_erase(&bp
->b_rbnode
, &pag
->pag_buf_tree
);
927 spin_unlock(&pag
->pag_buf_lock
);
936 * Lock a buffer object, if it is not already locked.
938 * If we come across a stale, pinned, locked buffer, we know that we are
939 * being asked to lock a buffer that has been reallocated. Because it is
940 * pinned, we know that the log has not been pushed to disk and hence it
941 * will still be locked. Rather than continuing to have trylock attempts
942 * fail until someone else pushes the log, push it ourselves before
943 * returning. This means that the xfsaild will not get stuck trying
944 * to push on stale inode buffers.
952 locked
= down_trylock(&bp
->b_sema
) == 0;
956 trace_xfs_buf_trylock(bp
, _RET_IP_
);
961 * Lock a buffer object.
963 * If we come across a stale, pinned, locked buffer, we know that we
964 * are being asked to lock a buffer that has been reallocated. Because
965 * it is pinned, we know that the log has not been pushed to disk and
966 * hence it will still be locked. Rather than sleeping until someone
967 * else pushes the log, push it ourselves before trying to get the lock.
973 trace_xfs_buf_lock(bp
, _RET_IP_
);
975 if (atomic_read(&bp
->b_pin_count
) && (bp
->b_flags
& XBF_STALE
))
976 xfs_log_force(bp
->b_target
->bt_mount
, 0);
980 trace_xfs_buf_lock_done(bp
, _RET_IP_
);
990 trace_xfs_buf_unlock(bp
, _RET_IP_
);
997 DECLARE_WAITQUEUE (wait
, current
);
999 if (atomic_read(&bp
->b_pin_count
) == 0)
1002 add_wait_queue(&bp
->b_waiters
, &wait
);
1004 set_current_state(TASK_UNINTERRUPTIBLE
);
1005 if (atomic_read(&bp
->b_pin_count
) == 0)
1009 remove_wait_queue(&bp
->b_waiters
, &wait
);
1010 set_current_state(TASK_RUNNING
);
1014 * Buffer Utility Routines
1018 xfs_buf_iodone_work(
1019 struct work_struct
*work
)
1021 struct xfs_buf
*bp
=
1022 container_of(work
, xfs_buf_t
, b_iodone_work
);
1023 bool read
= !!(bp
->b_flags
& XBF_READ
);
1025 bp
->b_flags
&= ~(XBF_READ
| XBF_WRITE
| XBF_READ_AHEAD
);
1027 /* only validate buffers that were read without errors */
1028 if (read
&& bp
->b_ops
&& !bp
->b_error
&& (bp
->b_flags
& XBF_DONE
))
1029 bp
->b_ops
->verify_read(bp
);
1032 (*(bp
->b_iodone
))(bp
);
1033 else if (bp
->b_flags
& XBF_ASYNC
)
1036 ASSERT(read
&& bp
->b_ops
);
1037 complete(&bp
->b_iowait
);
1046 bool read
= !!(bp
->b_flags
& XBF_READ
);
1048 trace_xfs_buf_iodone(bp
, _RET_IP_
);
1050 if (bp
->b_error
== 0)
1051 bp
->b_flags
|= XBF_DONE
;
1053 if (bp
->b_iodone
|| (read
&& bp
->b_ops
) || (bp
->b_flags
& XBF_ASYNC
)) {
1055 INIT_WORK(&bp
->b_iodone_work
, xfs_buf_iodone_work
);
1056 queue_work(xfslogd_workqueue
, &bp
->b_iodone_work
);
1058 xfs_buf_iodone_work(&bp
->b_iodone_work
);
1061 bp
->b_flags
&= ~(XBF_READ
| XBF_WRITE
| XBF_READ_AHEAD
);
1062 complete(&bp
->b_iowait
);
1071 ASSERT(error
>= 0 && error
<= 0xffff);
1072 bp
->b_error
= (unsigned short)error
;
1073 trace_xfs_buf_ioerror(bp
, error
, _RET_IP_
);
1077 xfs_buf_ioerror_alert(
1081 xfs_alert(bp
->b_target
->bt_mount
,
1082 "metadata I/O error: block 0x%llx (\"%s\") error %d numblks %d",
1083 (__uint64_t
)XFS_BUF_ADDR(bp
), func
, bp
->b_error
, bp
->b_length
);
1087 * Called when we want to stop a buffer from getting written or read.
1088 * We attach the EIO error, muck with its flags, and call xfs_buf_ioend
1089 * so that the proper iodone callbacks get called.
1095 #ifdef XFSERRORDEBUG
1096 ASSERT(XFS_BUF_ISREAD(bp
) || bp
->b_iodone
);
1100 * No need to wait until the buffer is unpinned, we aren't flushing it.
1102 xfs_buf_ioerror(bp
, EIO
);
1105 * We're calling xfs_buf_ioend, so delete XBF_DONE flag.
1111 xfs_buf_ioend(bp
, 0);
1117 * Same as xfs_bioerror, except that we are releasing the buffer
1118 * here ourselves, and avoiding the xfs_buf_ioend call.
1119 * This is meant for userdata errors; metadata bufs come with
1120 * iodone functions attached, so that we can track down errors.
1126 int64_t fl
= bp
->b_flags
;
1128 * No need to wait until the buffer is unpinned.
1129 * We aren't flushing it.
1131 * chunkhold expects B_DONE to be set, whether
1132 * we actually finish the I/O or not. We don't want to
1133 * change that interface.
1138 bp
->b_iodone
= NULL
;
1139 if (!(fl
& XBF_ASYNC
)) {
1141 * Mark b_error and B_ERROR _both_.
1142 * Lot's of chunkcache code assumes that.
1143 * There's no reason to mark error for
1146 xfs_buf_ioerror(bp
, EIO
);
1147 complete(&bp
->b_iowait
);
1159 if (XFS_FORCED_SHUTDOWN(bp
->b_target
->bt_mount
)) {
1160 trace_xfs_bdstrat_shut(bp
, _RET_IP_
);
1162 * Metadata write that didn't get logged but
1163 * written delayed anyway. These aren't associated
1164 * with a transaction, and can be ignored.
1166 if (!bp
->b_iodone
&& !XFS_BUF_ISREAD(bp
))
1167 return xfs_bioerror_relse(bp
);
1169 return xfs_bioerror(bp
);
1172 xfs_buf_iorequest(bp
);
1182 ASSERT(xfs_buf_islocked(bp
));
1184 bp
->b_flags
|= XBF_WRITE
;
1185 bp
->b_flags
&= ~(XBF_ASYNC
| XBF_READ
| _XBF_DELWRI_Q
);
1189 error
= xfs_buf_iowait(bp
);
1191 xfs_force_shutdown(bp
->b_target
->bt_mount
,
1192 SHUTDOWN_META_IO_ERROR
);
1198 * Wrapper around bdstrat so that we can stop data from going to disk in case
1199 * we are shutting down the filesystem. Typically user data goes thru this
1200 * path; one of the exceptions is the superblock.
1204 struct xfs_mount
*mp
,
1207 if (XFS_FORCED_SHUTDOWN(mp
)) {
1208 trace_xfs_bdstrat_shut(bp
, _RET_IP_
);
1209 xfs_bioerror_relse(bp
);
1213 xfs_buf_iorequest(bp
);
1221 if (atomic_dec_and_test(&bp
->b_io_remaining
) == 1)
1222 xfs_buf_ioend(bp
, schedule
);
1230 xfs_buf_t
*bp
= (xfs_buf_t
*)bio
->bi_private
;
1233 * don't overwrite existing errors - otherwise we can lose errors on
1234 * buffers that require multiple bios to complete.
1237 xfs_buf_ioerror(bp
, -error
);
1239 if (!bp
->b_error
&& xfs_buf_is_vmapped(bp
) && (bp
->b_flags
& XBF_READ
))
1240 invalidate_kernel_vmap_range(bp
->b_addr
, xfs_buf_vmap_len(bp
));
1242 _xfs_buf_ioend(bp
, 1);
1247 xfs_buf_ioapply_map(
1255 int total_nr_pages
= bp
->b_page_count
;
1258 sector_t sector
= bp
->b_maps
[map
].bm_bn
;
1262 total_nr_pages
= bp
->b_page_count
;
1264 /* skip the pages in the buffer before the start offset */
1266 offset
= *buf_offset
;
1267 while (offset
>= PAGE_SIZE
) {
1269 offset
-= PAGE_SIZE
;
1273 * Limit the IO size to the length of the current vector, and update the
1274 * remaining IO count for the next time around.
1276 size
= min_t(int, BBTOB(bp
->b_maps
[map
].bm_len
), *count
);
1278 *buf_offset
+= size
;
1281 atomic_inc(&bp
->b_io_remaining
);
1282 nr_pages
= BIO_MAX_SECTORS
>> (PAGE_SHIFT
- BBSHIFT
);
1283 if (nr_pages
> total_nr_pages
)
1284 nr_pages
= total_nr_pages
;
1286 bio
= bio_alloc(GFP_NOIO
, nr_pages
);
1287 bio
->bi_bdev
= bp
->b_target
->bt_bdev
;
1288 bio
->bi_sector
= sector
;
1289 bio
->bi_end_io
= xfs_buf_bio_end_io
;
1290 bio
->bi_private
= bp
;
1293 for (; size
&& nr_pages
; nr_pages
--, page_index
++) {
1294 int rbytes
, nbytes
= PAGE_SIZE
- offset
;
1299 rbytes
= bio_add_page(bio
, bp
->b_pages
[page_index
], nbytes
,
1301 if (rbytes
< nbytes
)
1305 sector
+= BTOBB(nbytes
);
1310 if (likely(bio
->bi_size
)) {
1311 if (xfs_buf_is_vmapped(bp
)) {
1312 flush_kernel_vmap_range(bp
->b_addr
,
1313 xfs_buf_vmap_len(bp
));
1315 submit_bio(rw
, bio
);
1320 * This is guaranteed not to be the last io reference count
1321 * because the caller (xfs_buf_iorequest) holds a count itself.
1323 atomic_dec(&bp
->b_io_remaining
);
1324 xfs_buf_ioerror(bp
, EIO
);
1334 struct blk_plug plug
;
1341 * Make sure we capture only current IO errors rather than stale errors
1342 * left over from previous use of the buffer (e.g. failed readahead).
1346 if (bp
->b_flags
& XBF_WRITE
) {
1347 if (bp
->b_flags
& XBF_SYNCIO
)
1351 if (bp
->b_flags
& XBF_FUA
)
1353 if (bp
->b_flags
& XBF_FLUSH
)
1357 * Run the write verifier callback function if it exists. If
1358 * this function fails it will mark the buffer with an error and
1359 * the IO should not be dispatched.
1362 bp
->b_ops
->verify_write(bp
);
1364 xfs_force_shutdown(bp
->b_target
->bt_mount
,
1365 SHUTDOWN_CORRUPT_INCORE
);
1369 } else if (bp
->b_flags
& XBF_READ_AHEAD
) {
1375 /* we only use the buffer cache for meta-data */
1379 * Walk all the vectors issuing IO on them. Set up the initial offset
1380 * into the buffer and the desired IO size before we start -
1381 * _xfs_buf_ioapply_vec() will modify them appropriately for each
1384 offset
= bp
->b_offset
;
1385 size
= BBTOB(bp
->b_io_length
);
1386 blk_start_plug(&plug
);
1387 for (i
= 0; i
< bp
->b_map_count
; i
++) {
1388 xfs_buf_ioapply_map(bp
, i
, &offset
, &size
, rw
);
1392 break; /* all done */
1394 blk_finish_plug(&plug
);
1401 trace_xfs_buf_iorequest(bp
, _RET_IP_
);
1403 ASSERT(!(bp
->b_flags
& _XBF_DELWRI_Q
));
1405 if (bp
->b_flags
& XBF_WRITE
)
1406 xfs_buf_wait_unpin(bp
);
1409 /* Set the count to 1 initially, this will stop an I/O
1410 * completion callout which happens before we have started
1411 * all the I/O from calling xfs_buf_ioend too early.
1413 atomic_set(&bp
->b_io_remaining
, 1);
1414 _xfs_buf_ioapply(bp
);
1415 _xfs_buf_ioend(bp
, 1);
1421 * Waits for I/O to complete on the buffer supplied. It returns immediately if
1422 * no I/O is pending or there is already a pending error on the buffer. It
1423 * returns the I/O error code, if any, or 0 if there was no error.
1429 trace_xfs_buf_iowait(bp
, _RET_IP_
);
1432 wait_for_completion(&bp
->b_iowait
);
1434 trace_xfs_buf_iowait_done(bp
, _RET_IP_
);
1446 return bp
->b_addr
+ offset
;
1448 offset
+= bp
->b_offset
;
1449 page
= bp
->b_pages
[offset
>> PAGE_SHIFT
];
1450 return (xfs_caddr_t
)page_address(page
) + (offset
& (PAGE_SIZE
-1));
1454 * Move data into or out of a buffer.
1458 xfs_buf_t
*bp
, /* buffer to process */
1459 size_t boff
, /* starting buffer offset */
1460 size_t bsize
, /* length to copy */
1461 void *data
, /* data address */
1462 xfs_buf_rw_t mode
) /* read/write/zero flag */
1466 bend
= boff
+ bsize
;
1467 while (boff
< bend
) {
1469 int page_index
, page_offset
, csize
;
1471 page_index
= (boff
+ bp
->b_offset
) >> PAGE_SHIFT
;
1472 page_offset
= (boff
+ bp
->b_offset
) & ~PAGE_MASK
;
1473 page
= bp
->b_pages
[page_index
];
1474 csize
= min_t(size_t, PAGE_SIZE
- page_offset
,
1475 BBTOB(bp
->b_io_length
) - boff
);
1477 ASSERT((csize
+ page_offset
) <= PAGE_SIZE
);
1481 memset(page_address(page
) + page_offset
, 0, csize
);
1484 memcpy(data
, page_address(page
) + page_offset
, csize
);
1487 memcpy(page_address(page
) + page_offset
, data
, csize
);
1496 * Handling of buffer targets (buftargs).
1500 * Wait for any bufs with callbacks that have been submitted but have not yet
1501 * returned. These buffers will have an elevated hold count, so wait on those
1502 * while freeing all the buffers only held by the LRU.
1506 struct xfs_buftarg
*btp
)
1511 spin_lock(&btp
->bt_lru_lock
);
1512 while (!list_empty(&btp
->bt_lru
)) {
1513 bp
= list_first_entry(&btp
->bt_lru
, struct xfs_buf
, b_lru
);
1514 if (atomic_read(&bp
->b_hold
) > 1) {
1515 trace_xfs_buf_wait_buftarg(bp
, _RET_IP_
);
1516 list_move_tail(&bp
->b_lru
, &btp
->bt_lru
);
1517 spin_unlock(&btp
->bt_lru_lock
);
1522 * clear the LRU reference count so the buffer doesn't get
1523 * ignored in xfs_buf_rele().
1525 atomic_set(&bp
->b_lru_ref
, 0);
1526 spin_unlock(&btp
->bt_lru_lock
);
1528 spin_lock(&btp
->bt_lru_lock
);
1530 spin_unlock(&btp
->bt_lru_lock
);
1535 struct shrinker
*shrink
,
1536 struct shrink_control
*sc
)
1538 struct xfs_buftarg
*btp
= container_of(shrink
,
1539 struct xfs_buftarg
, bt_shrinker
);
1541 int nr_to_scan
= sc
->nr_to_scan
;
1545 return btp
->bt_lru_nr
;
1547 spin_lock(&btp
->bt_lru_lock
);
1548 while (!list_empty(&btp
->bt_lru
)) {
1549 if (nr_to_scan
-- <= 0)
1552 bp
= list_first_entry(&btp
->bt_lru
, struct xfs_buf
, b_lru
);
1555 * Decrement the b_lru_ref count unless the value is already
1556 * zero. If the value is already zero, we need to reclaim the
1557 * buffer, otherwise it gets another trip through the LRU.
1559 if (!atomic_add_unless(&bp
->b_lru_ref
, -1, 0)) {
1560 list_move_tail(&bp
->b_lru
, &btp
->bt_lru
);
1565 * remove the buffer from the LRU now to avoid needing another
1566 * lock round trip inside xfs_buf_rele().
1568 list_move(&bp
->b_lru
, &dispose
);
1570 bp
->b_lru_flags
|= _XBF_LRU_DISPOSE
;
1572 spin_unlock(&btp
->bt_lru_lock
);
1574 while (!list_empty(&dispose
)) {
1575 bp
= list_first_entry(&dispose
, struct xfs_buf
, b_lru
);
1576 list_del_init(&bp
->b_lru
);
1580 return btp
->bt_lru_nr
;
1585 struct xfs_mount
*mp
,
1586 struct xfs_buftarg
*btp
)
1588 unregister_shrinker(&btp
->bt_shrinker
);
1590 if (mp
->m_flags
& XFS_MOUNT_BARRIER
)
1591 xfs_blkdev_issue_flush(btp
);
1597 xfs_setsize_buftarg_flags(
1599 unsigned int blocksize
,
1600 unsigned int sectorsize
,
1603 btp
->bt_bsize
= blocksize
;
1604 btp
->bt_sshift
= ffs(sectorsize
) - 1;
1605 btp
->bt_smask
= sectorsize
- 1;
1607 if (set_blocksize(btp
->bt_bdev
, sectorsize
)) {
1608 char name
[BDEVNAME_SIZE
];
1610 bdevname(btp
->bt_bdev
, name
);
1612 xfs_warn(btp
->bt_mount
,
1613 "Cannot set_blocksize to %u on device %s\n",
1622 * When allocating the initial buffer target we have not yet
1623 * read in the superblock, so don't know what sized sectors
1624 * are being used is at this early stage. Play safe.
1627 xfs_setsize_buftarg_early(
1629 struct block_device
*bdev
)
1631 return xfs_setsize_buftarg_flags(btp
,
1632 PAGE_SIZE
, bdev_logical_block_size(bdev
), 0);
1636 xfs_setsize_buftarg(
1638 unsigned int blocksize
,
1639 unsigned int sectorsize
)
1641 return xfs_setsize_buftarg_flags(btp
, blocksize
, sectorsize
, 1);
1646 struct xfs_mount
*mp
,
1647 struct block_device
*bdev
,
1653 btp
= kmem_zalloc(sizeof(*btp
), KM_SLEEP
| KM_NOFS
);
1656 btp
->bt_dev
= bdev
->bd_dev
;
1657 btp
->bt_bdev
= bdev
;
1658 btp
->bt_bdi
= blk_get_backing_dev_info(bdev
);
1662 INIT_LIST_HEAD(&btp
->bt_lru
);
1663 spin_lock_init(&btp
->bt_lru_lock
);
1664 if (xfs_setsize_buftarg_early(btp
, bdev
))
1666 btp
->bt_shrinker
.shrink
= xfs_buftarg_shrink
;
1667 btp
->bt_shrinker
.seeks
= DEFAULT_SEEKS
;
1668 register_shrinker(&btp
->bt_shrinker
);
1677 * Add a buffer to the delayed write list.
1679 * This queues a buffer for writeout if it hasn't already been. Note that
1680 * neither this routine nor the buffer list submission functions perform
1681 * any internal synchronization. It is expected that the lists are thread-local
1684 * Returns true if we queued up the buffer, or false if it already had
1685 * been on the buffer list.
1688 xfs_buf_delwri_queue(
1690 struct list_head
*list
)
1692 ASSERT(xfs_buf_islocked(bp
));
1693 ASSERT(!(bp
->b_flags
& XBF_READ
));
1696 * If the buffer is already marked delwri it already is queued up
1697 * by someone else for imediate writeout. Just ignore it in that
1700 if (bp
->b_flags
& _XBF_DELWRI_Q
) {
1701 trace_xfs_buf_delwri_queued(bp
, _RET_IP_
);
1705 trace_xfs_buf_delwri_queue(bp
, _RET_IP_
);
1708 * If a buffer gets written out synchronously or marked stale while it
1709 * is on a delwri list we lazily remove it. To do this, the other party
1710 * clears the _XBF_DELWRI_Q flag but otherwise leaves the buffer alone.
1711 * It remains referenced and on the list. In a rare corner case it
1712 * might get readded to a delwri list after the synchronous writeout, in
1713 * which case we need just need to re-add the flag here.
1715 bp
->b_flags
|= _XBF_DELWRI_Q
;
1716 if (list_empty(&bp
->b_list
)) {
1717 atomic_inc(&bp
->b_hold
);
1718 list_add_tail(&bp
->b_list
, list
);
1725 * Compare function is more complex than it needs to be because
1726 * the return value is only 32 bits and we are doing comparisons
1732 struct list_head
*a
,
1733 struct list_head
*b
)
1735 struct xfs_buf
*ap
= container_of(a
, struct xfs_buf
, b_list
);
1736 struct xfs_buf
*bp
= container_of(b
, struct xfs_buf
, b_list
);
1739 diff
= ap
->b_maps
[0].bm_bn
- bp
->b_maps
[0].bm_bn
;
1748 __xfs_buf_delwri_submit(
1749 struct list_head
*buffer_list
,
1750 struct list_head
*io_list
,
1753 struct blk_plug plug
;
1754 struct xfs_buf
*bp
, *n
;
1757 list_for_each_entry_safe(bp
, n
, buffer_list
, b_list
) {
1759 if (xfs_buf_ispinned(bp
)) {
1763 if (!xfs_buf_trylock(bp
))
1770 * Someone else might have written the buffer synchronously or
1771 * marked it stale in the meantime. In that case only the
1772 * _XBF_DELWRI_Q flag got cleared, and we have to drop the
1773 * reference and remove it from the list here.
1775 if (!(bp
->b_flags
& _XBF_DELWRI_Q
)) {
1776 list_del_init(&bp
->b_list
);
1781 list_move_tail(&bp
->b_list
, io_list
);
1782 trace_xfs_buf_delwri_split(bp
, _RET_IP_
);
1785 list_sort(NULL
, io_list
, xfs_buf_cmp
);
1787 blk_start_plug(&plug
);
1788 list_for_each_entry_safe(bp
, n
, io_list
, b_list
) {
1789 bp
->b_flags
&= ~(_XBF_DELWRI_Q
| XBF_ASYNC
);
1790 bp
->b_flags
|= XBF_WRITE
;
1793 bp
->b_flags
|= XBF_ASYNC
;
1794 list_del_init(&bp
->b_list
);
1798 blk_finish_plug(&plug
);
1804 * Write out a buffer list asynchronously.
1806 * This will take the @buffer_list, write all non-locked and non-pinned buffers
1807 * out and not wait for I/O completion on any of the buffers. This interface
1808 * is only safely useable for callers that can track I/O completion by higher
1809 * level means, e.g. AIL pushing as the @buffer_list is consumed in this
1813 xfs_buf_delwri_submit_nowait(
1814 struct list_head
*buffer_list
)
1816 LIST_HEAD (io_list
);
1817 return __xfs_buf_delwri_submit(buffer_list
, &io_list
, false);
1821 * Write out a buffer list synchronously.
1823 * This will take the @buffer_list, write all buffers out and wait for I/O
1824 * completion on all of the buffers. @buffer_list is consumed by the function,
1825 * so callers must have some other way of tracking buffers if they require such
1829 xfs_buf_delwri_submit(
1830 struct list_head
*buffer_list
)
1832 LIST_HEAD (io_list
);
1833 int error
= 0, error2
;
1836 __xfs_buf_delwri_submit(buffer_list
, &io_list
, true);
1838 /* Wait for IO to complete. */
1839 while (!list_empty(&io_list
)) {
1840 bp
= list_first_entry(&io_list
, struct xfs_buf
, b_list
);
1842 list_del_init(&bp
->b_list
);
1843 error2
= xfs_buf_iowait(bp
);
1855 xfs_buf_zone
= kmem_zone_init_flags(sizeof(xfs_buf_t
), "xfs_buf",
1856 KM_ZONE_HWALIGN
, NULL
);
1860 xfslogd_workqueue
= alloc_workqueue("xfslogd",
1861 WQ_MEM_RECLAIM
| WQ_HIGHPRI
, 1);
1862 if (!xfslogd_workqueue
)
1863 goto out_free_buf_zone
;
1868 kmem_zone_destroy(xfs_buf_zone
);
1874 xfs_buf_terminate(void)
1876 destroy_workqueue(xfslogd_workqueue
);
1877 kmem_zone_destroy(xfs_buf_zone
);