1 // SPDX-License-Identifier: GPL-2.0
2 /*
3 * Copyright (c) 2000-2006 Silicon Graphics, Inc.
4 * Copyright (c) 2012 Red Hat, Inc.
5 * All Rights Reserved.
6 */
7 #include "xfs.h"
8 #include "xfs_fs.h"
9 #include "xfs_shared.h"
10 #include "xfs_format.h"
11 #include "xfs_log_format.h"
12 #include "xfs_trans_resv.h"
13 #include "xfs_bit.h"
14 #include "xfs_mount.h"
15 #include "xfs_defer.h"
16 #include "xfs_inode.h"
17 #include "xfs_btree.h"
18 #include "xfs_trans.h"
19 #include "xfs_alloc.h"
20 #include "xfs_bmap.h"
21 #include "xfs_bmap_util.h"
22 #include "xfs_bmap_btree.h"
23 #include "xfs_rtalloc.h"
24 #include "xfs_error.h"
25 #include "xfs_quota.h"
26 #include "xfs_trans_space.h"
27 #include "xfs_trace.h"
28 #include "xfs_icache.h"
29 #include "xfs_iomap.h"
30 #include "xfs_reflink.h"
31
32 /* Kernel only BMAP related definitions and functions */
33
34 /*
35 * Convert the given file system block to a disk block. We have to treat it
36 * differently based on whether the file is a real time file or not, because the
37 * bmap code does.
38 */
39 xfs_daddr_t
xfs_fsb_to_db(struct xfs_inode * ip,xfs_fsblock_t fsb)40 xfs_fsb_to_db(struct xfs_inode *ip, xfs_fsblock_t fsb)
41 {
42 if (XFS_IS_REALTIME_INODE(ip))
43 return XFS_FSB_TO_BB(ip->i_mount, fsb);
44 return XFS_FSB_TO_DADDR(ip->i_mount, fsb);
45 }
46
47 /*
48 * Routine to zero an extent on disk allocated to the specific inode.
49 *
50 * The VFS functions take a linearised filesystem block offset, so we have to
51 * convert the sparse xfs fsb to the right format first.
52 * VFS types are real funky, too.
53 */
54 int
xfs_zero_extent(struct xfs_inode * ip,xfs_fsblock_t start_fsb,xfs_off_t count_fsb)55 xfs_zero_extent(
56 struct xfs_inode *ip,
57 xfs_fsblock_t start_fsb,
58 xfs_off_t count_fsb)
59 {
60 struct xfs_mount *mp = ip->i_mount;
61 struct xfs_buftarg *target = xfs_inode_buftarg(ip);
62 xfs_daddr_t sector = xfs_fsb_to_db(ip, start_fsb);
63 sector_t block = XFS_BB_TO_FSBT(mp, sector);
64
65 return blkdev_issue_zeroout(target->bt_bdev,
66 block << (mp->m_super->s_blocksize_bits - 9),
67 count_fsb << (mp->m_super->s_blocksize_bits - 9),
68 GFP_NOFS, 0);
69 }
70
71 #ifdef CONFIG_XFS_RT
72 int
xfs_bmap_rtalloc(struct xfs_bmalloca * ap)73 xfs_bmap_rtalloc(
74 struct xfs_bmalloca *ap)
75 {
76 struct xfs_mount *mp = ap->ip->i_mount;
77 xfs_fileoff_t orig_offset = ap->offset;
78 xfs_rtblock_t rtb;
79 xfs_extlen_t prod = 0; /* product factor for allocators */
80 xfs_extlen_t mod = 0; /* product factor for allocators */
81 xfs_extlen_t ralen = 0; /* realtime allocation length */
82 xfs_extlen_t align; /* minimum allocation alignment */
83 xfs_extlen_t orig_length = ap->length;
84 xfs_extlen_t minlen = mp->m_sb.sb_rextsize;
85 xfs_extlen_t raminlen;
86 bool rtlocked = false;
87 bool ignore_locality = false;
88 int error;
89
90 align = xfs_get_extsz_hint(ap->ip);
91 retry:
92 prod = align / mp->m_sb.sb_rextsize;
93 error = xfs_bmap_extsize_align(mp, &ap->got, &ap->prev,
94 align, 1, ap->eof, 0,
95 ap->conv, &ap->offset, &ap->length);
96 if (error)
97 return error;
98 ASSERT(ap->length);
99 ASSERT(ap->length % mp->m_sb.sb_rextsize == 0);
100
101 /*
102 * If we shifted the file offset downward to satisfy an extent size
103 * hint, increase minlen by that amount so that the allocator won't
104 * give us an allocation that's too short to cover at least one of the
105 * blocks that the caller asked for.
106 */
107 if (ap->offset != orig_offset)
108 minlen += orig_offset - ap->offset;
109
110 /*
111 * If the offset & length are not perfectly aligned
112 * then kill prod, it will just get us in trouble.
113 */
114 div_u64_rem(ap->offset, align, &mod);
115 if (mod || ap->length % align)
116 prod = 1;
117 /*
118 * Set ralen to be the actual requested length in rtextents.
119 */
120 ralen = ap->length / mp->m_sb.sb_rextsize;
121 /*
122 * If the old value was close enough to XFS_BMBT_MAX_EXTLEN that
123 * we rounded up to it, cut it back so it's valid again.
124 * Note that if it's a really large request (bigger than
125 * XFS_BMBT_MAX_EXTLEN), we don't hear about that number, and can't
126 * adjust the starting point to match it.
127 */
128 if (ralen * mp->m_sb.sb_rextsize >= XFS_MAX_BMBT_EXTLEN)
129 ralen = XFS_MAX_BMBT_EXTLEN / mp->m_sb.sb_rextsize;
130
131 /*
132 * Lock out modifications to both the RT bitmap and summary inodes
133 */
134 if (!rtlocked) {
135 xfs_ilock(mp->m_rbmip, XFS_ILOCK_EXCL|XFS_ILOCK_RTBITMAP);
136 xfs_trans_ijoin(ap->tp, mp->m_rbmip, XFS_ILOCK_EXCL);
137 xfs_ilock(mp->m_rsumip, XFS_ILOCK_EXCL|XFS_ILOCK_RTSUM);
138 xfs_trans_ijoin(ap->tp, mp->m_rsumip, XFS_ILOCK_EXCL);
139 rtlocked = true;
140 }
141
142 /*
143 * If it's an allocation to an empty file at offset 0,
144 * pick an extent that will space things out in the rt area.
145 */
146 if (ap->eof && ap->offset == 0) {
147 xfs_rtblock_t rtx; /* realtime extent no */
148
149 error = xfs_rtpick_extent(mp, ap->tp, ralen, &rtx);
150 if (error)
151 return error;
152 ap->blkno = rtx * mp->m_sb.sb_rextsize;
153 } else {
154 ap->blkno = 0;
155 }
156
157 xfs_bmap_adjacent(ap);
158
159 /*
160 * Realtime allocation, done through xfs_rtallocate_extent.
161 */
162 if (ignore_locality)
163 ap->blkno = 0;
164 else
165 do_div(ap->blkno, mp->m_sb.sb_rextsize);
166 rtb = ap->blkno;
167 ap->length = ralen;
168 raminlen = max_t(xfs_extlen_t, 1, minlen / mp->m_sb.sb_rextsize);
169 error = xfs_rtallocate_extent(ap->tp, ap->blkno, raminlen, ap->length,
170 &ralen, ap->wasdel, prod, &rtb);
171 if (error)
172 return error;
173
174 if (rtb != NULLRTBLOCK) {
175 ap->blkno = rtb * mp->m_sb.sb_rextsize;
176 ap->length = ralen * mp->m_sb.sb_rextsize;
177 ap->ip->i_nblocks += ap->length;
178 xfs_trans_log_inode(ap->tp, ap->ip, XFS_ILOG_CORE);
179 if (ap->wasdel)
180 ap->ip->i_delayed_blks -= ap->length;
181 /*
182 * Adjust the disk quota also. This was reserved
183 * earlier.
184 */
185 xfs_trans_mod_dquot_byino(ap->tp, ap->ip,
186 ap->wasdel ? XFS_TRANS_DQ_DELRTBCOUNT :
187 XFS_TRANS_DQ_RTBCOUNT, ap->length);
188 return 0;
189 }
190
191 if (align > mp->m_sb.sb_rextsize) {
192 /*
193 * We previously enlarged the request length to try to satisfy
194 * an extent size hint. The allocator didn't return anything,
195 * so reset the parameters to the original values and try again
196 * without alignment criteria.
197 */
198 ap->offset = orig_offset;
199 ap->length = orig_length;
200 minlen = align = mp->m_sb.sb_rextsize;
201 goto retry;
202 }
203
204 if (!ignore_locality && ap->blkno != 0) {
205 /*
206 * If we can't allocate near a specific rt extent, try again
207 * without locality criteria.
208 */
209 ignore_locality = true;
210 goto retry;
211 }
212
213 ap->blkno = NULLFSBLOCK;
214 ap->length = 0;
215 return 0;
216 }
217 #endif /* CONFIG_XFS_RT */
218
219 /*
220 * Extent tree block counting routines.
221 */
222
223 /*
224 * Count leaf blocks given a range of extent records. Delayed allocation
225 * extents are not counted towards the totals.
226 */
227 xfs_extnum_t
xfs_bmap_count_leaves(struct xfs_ifork * ifp,xfs_filblks_t * count)228 xfs_bmap_count_leaves(
229 struct xfs_ifork *ifp,
230 xfs_filblks_t *count)
231 {
232 struct xfs_iext_cursor icur;
233 struct xfs_bmbt_irec got;
234 xfs_extnum_t numrecs = 0;
235
236 for_each_xfs_iext(ifp, &icur, &got) {
237 if (!isnullstartblock(got.br_startblock)) {
238 *count += got.br_blockcount;
239 numrecs++;
240 }
241 }
242
243 return numrecs;
244 }
245
246 /*
247 * Count fsblocks of the given fork. Delayed allocation extents are
248 * not counted towards the totals.
249 */
250 int
xfs_bmap_count_blocks(struct xfs_trans * tp,struct xfs_inode * ip,int whichfork,xfs_extnum_t * nextents,xfs_filblks_t * count)251 xfs_bmap_count_blocks(
252 struct xfs_trans *tp,
253 struct xfs_inode *ip,
254 int whichfork,
255 xfs_extnum_t *nextents,
256 xfs_filblks_t *count)
257 {
258 struct xfs_mount *mp = ip->i_mount;
259 struct xfs_ifork *ifp = xfs_ifork_ptr(ip, whichfork);
260 struct xfs_btree_cur *cur;
261 xfs_extlen_t btblocks = 0;
262 int error;
263
264 *nextents = 0;
265 *count = 0;
266
267 if (!ifp)
268 return 0;
269
270 switch (ifp->if_format) {
271 case XFS_DINODE_FMT_BTREE:
272 error = xfs_iread_extents(tp, ip, whichfork);
273 if (error)
274 return error;
275
276 cur = xfs_bmbt_init_cursor(mp, tp, ip, whichfork);
277 error = xfs_btree_count_blocks(cur, &btblocks);
278 xfs_btree_del_cursor(cur, error);
279 if (error)
280 return error;
281
282 /*
283 * xfs_btree_count_blocks includes the root block contained in
284 * the inode fork in @btblocks, so subtract one because we're
285 * only interested in allocated disk blocks.
286 */
287 *count += btblocks - 1;
288
289 fallthrough;
290 case XFS_DINODE_FMT_EXTENTS:
291 *nextents = xfs_bmap_count_leaves(ifp, count);
292 break;
293 }
294
295 return 0;
296 }
297
298 static int
xfs_getbmap_report_one(struct xfs_inode * ip,struct getbmapx * bmv,struct kgetbmap * out,int64_t bmv_end,struct xfs_bmbt_irec * got)299 xfs_getbmap_report_one(
300 struct xfs_inode *ip,
301 struct getbmapx *bmv,
302 struct kgetbmap *out,
303 int64_t bmv_end,
304 struct xfs_bmbt_irec *got)
305 {
306 struct kgetbmap *p = out + bmv->bmv_entries;
307 bool shared = false;
308 int error;
309
310 error = xfs_reflink_trim_around_shared(ip, got, &shared);
311 if (error)
312 return error;
313
314 if (isnullstartblock(got->br_startblock) ||
315 got->br_startblock == DELAYSTARTBLOCK) {
316 /*
317 * Take the flush completion as being a point-in-time snapshot
318 * where there are no delalloc extents, and if any new ones
319 * have been created racily, just skip them as being 'after'
320 * the flush and so don't get reported.
321 */
322 if (!(bmv->bmv_iflags & BMV_IF_DELALLOC))
323 return 0;
324
325 p->bmv_oflags |= BMV_OF_DELALLOC;
326 p->bmv_block = -2;
327 } else {
328 p->bmv_block = xfs_fsb_to_db(ip, got->br_startblock);
329 }
330
331 if (got->br_state == XFS_EXT_UNWRITTEN &&
332 (bmv->bmv_iflags & BMV_IF_PREALLOC))
333 p->bmv_oflags |= BMV_OF_PREALLOC;
334
335 if (shared)
336 p->bmv_oflags |= BMV_OF_SHARED;
337
338 p->bmv_offset = XFS_FSB_TO_BB(ip->i_mount, got->br_startoff);
339 p->bmv_length = XFS_FSB_TO_BB(ip->i_mount, got->br_blockcount);
340
341 bmv->bmv_offset = p->bmv_offset + p->bmv_length;
342 bmv->bmv_length = max(0LL, bmv_end - bmv->bmv_offset);
343 bmv->bmv_entries++;
344 return 0;
345 }
346
347 static void
xfs_getbmap_report_hole(struct xfs_inode * ip,struct getbmapx * bmv,struct kgetbmap * out,int64_t bmv_end,xfs_fileoff_t bno,xfs_fileoff_t end)348 xfs_getbmap_report_hole(
349 struct xfs_inode *ip,
350 struct getbmapx *bmv,
351 struct kgetbmap *out,
352 int64_t bmv_end,
353 xfs_fileoff_t bno,
354 xfs_fileoff_t end)
355 {
356 struct kgetbmap *p = out + bmv->bmv_entries;
357
358 if (bmv->bmv_iflags & BMV_IF_NO_HOLES)
359 return;
360
361 p->bmv_block = -1;
362 p->bmv_offset = XFS_FSB_TO_BB(ip->i_mount, bno);
363 p->bmv_length = XFS_FSB_TO_BB(ip->i_mount, end - bno);
364
365 bmv->bmv_offset = p->bmv_offset + p->bmv_length;
366 bmv->bmv_length = max(0LL, bmv_end - bmv->bmv_offset);
367 bmv->bmv_entries++;
368 }
369
370 static inline bool
xfs_getbmap_full(struct getbmapx * bmv)371 xfs_getbmap_full(
372 struct getbmapx *bmv)
373 {
374 return bmv->bmv_length == 0 || bmv->bmv_entries >= bmv->bmv_count - 1;
375 }
376
377 static bool
xfs_getbmap_next_rec(struct xfs_bmbt_irec * rec,xfs_fileoff_t total_end)378 xfs_getbmap_next_rec(
379 struct xfs_bmbt_irec *rec,
380 xfs_fileoff_t total_end)
381 {
382 xfs_fileoff_t end = rec->br_startoff + rec->br_blockcount;
383
384 if (end == total_end)
385 return false;
386
387 rec->br_startoff += rec->br_blockcount;
388 if (!isnullstartblock(rec->br_startblock) &&
389 rec->br_startblock != DELAYSTARTBLOCK)
390 rec->br_startblock += rec->br_blockcount;
391 rec->br_blockcount = total_end - end;
392 return true;
393 }
394
395 /*
396 * Get inode's extents as described in bmv, and format for output.
397 * Calls formatter to fill the user's buffer until all extents
398 * are mapped, until the passed-in bmv->bmv_count slots have
399 * been filled, or until the formatter short-circuits the loop,
400 * if it is tracking filled-in extents on its own.
401 */
402 int /* error code */
xfs_getbmap(struct xfs_inode * ip,struct getbmapx * bmv,struct kgetbmap * out)403 xfs_getbmap(
404 struct xfs_inode *ip,
405 struct getbmapx *bmv, /* user bmap structure */
406 struct kgetbmap *out)
407 {
408 struct xfs_mount *mp = ip->i_mount;
409 int iflags = bmv->bmv_iflags;
410 int whichfork, lock, error = 0;
411 int64_t bmv_end, max_len;
412 xfs_fileoff_t bno, first_bno;
413 struct xfs_ifork *ifp;
414 struct xfs_bmbt_irec got, rec;
415 xfs_filblks_t len;
416 struct xfs_iext_cursor icur;
417
418 if (bmv->bmv_iflags & ~BMV_IF_VALID)
419 return -EINVAL;
420 #ifndef DEBUG
421 /* Only allow CoW fork queries if we're debugging. */
422 if (iflags & BMV_IF_COWFORK)
423 return -EINVAL;
424 #endif
425 if ((iflags & BMV_IF_ATTRFORK) && (iflags & BMV_IF_COWFORK))
426 return -EINVAL;
427
428 if (bmv->bmv_length < -1)
429 return -EINVAL;
430 bmv->bmv_entries = 0;
431 if (bmv->bmv_length == 0)
432 return 0;
433
434 if (iflags & BMV_IF_ATTRFORK)
435 whichfork = XFS_ATTR_FORK;
436 else if (iflags & BMV_IF_COWFORK)
437 whichfork = XFS_COW_FORK;
438 else
439 whichfork = XFS_DATA_FORK;
440
441 xfs_ilock(ip, XFS_IOLOCK_SHARED);
442 switch (whichfork) {
443 case XFS_ATTR_FORK:
444 lock = xfs_ilock_attr_map_shared(ip);
445 if (!xfs_inode_has_attr_fork(ip))
446 goto out_unlock_ilock;
447
448 max_len = 1LL << 32;
449 break;
450 case XFS_COW_FORK:
451 lock = XFS_ILOCK_SHARED;
452 xfs_ilock(ip, lock);
453
454 /* No CoW fork? Just return */
455 if (!xfs_ifork_ptr(ip, whichfork))
456 goto out_unlock_ilock;
457
458 if (xfs_get_cowextsz_hint(ip))
459 max_len = mp->m_super->s_maxbytes;
460 else
461 max_len = XFS_ISIZE(ip);
462 break;
463 case XFS_DATA_FORK:
464 if (!(iflags & BMV_IF_DELALLOC) &&
465 (ip->i_delayed_blks || XFS_ISIZE(ip) > ip->i_disk_size)) {
466 error = filemap_write_and_wait(VFS_I(ip)->i_mapping);
467 if (error)
468 goto out_unlock_iolock;
469
470 /*
471 * Even after flushing the inode, there can still be
472 * delalloc blocks on the inode beyond EOF due to
473 * speculative preallocation. These are not removed
474 * until the release function is called or the inode
475 * is inactivated. Hence we cannot assert here that
476 * ip->i_delayed_blks == 0.
477 */
478 }
479
480 if (xfs_get_extsz_hint(ip) ||
481 (ip->i_diflags &
482 (XFS_DIFLAG_PREALLOC | XFS_DIFLAG_APPEND)))
483 max_len = mp->m_super->s_maxbytes;
484 else
485 max_len = XFS_ISIZE(ip);
486
487 lock = xfs_ilock_data_map_shared(ip);
488 break;
489 }
490
491 ifp = xfs_ifork_ptr(ip, whichfork);
492
493 switch (ifp->if_format) {
494 case XFS_DINODE_FMT_EXTENTS:
495 case XFS_DINODE_FMT_BTREE:
496 break;
497 case XFS_DINODE_FMT_LOCAL:
498 /* Local format inode forks report no extents. */
499 goto out_unlock_ilock;
500 default:
501 error = -EINVAL;
502 goto out_unlock_ilock;
503 }
504
505 if (bmv->bmv_length == -1) {
506 max_len = XFS_FSB_TO_BB(mp, XFS_B_TO_FSB(mp, max_len));
507 bmv->bmv_length = max(0LL, max_len - bmv->bmv_offset);
508 }
509
510 bmv_end = bmv->bmv_offset + bmv->bmv_length;
511
512 first_bno = bno = XFS_BB_TO_FSBT(mp, bmv->bmv_offset);
513 len = XFS_BB_TO_FSB(mp, bmv->bmv_length);
514
515 error = xfs_iread_extents(NULL, ip, whichfork);
516 if (error)
517 goto out_unlock_ilock;
518
519 if (!xfs_iext_lookup_extent(ip, ifp, bno, &icur, &got)) {
520 /*
521 * Report a whole-file hole if the delalloc flag is set to
522 * stay compatible with the old implementation.
523 */
524 if (iflags & BMV_IF_DELALLOC)
525 xfs_getbmap_report_hole(ip, bmv, out, bmv_end, bno,
526 XFS_B_TO_FSB(mp, XFS_ISIZE(ip)));
527 goto out_unlock_ilock;
528 }
529
530 while (!xfs_getbmap_full(bmv)) {
531 xfs_trim_extent(&got, first_bno, len);
532
533 /*
534 * Report an entry for a hole if this extent doesn't directly
535 * follow the previous one.
536 */
537 if (got.br_startoff > bno) {
538 xfs_getbmap_report_hole(ip, bmv, out, bmv_end, bno,
539 got.br_startoff);
540 if (xfs_getbmap_full(bmv))
541 break;
542 }
543
544 /*
545 * In order to report shared extents accurately, we report each
546 * distinct shared / unshared part of a single bmbt record with
547 * an individual getbmapx record.
548 */
549 bno = got.br_startoff + got.br_blockcount;
550 rec = got;
551 do {
552 error = xfs_getbmap_report_one(ip, bmv, out, bmv_end,
553 &rec);
554 if (error || xfs_getbmap_full(bmv))
555 goto out_unlock_ilock;
556 } while (xfs_getbmap_next_rec(&rec, bno));
557
558 if (!xfs_iext_next_extent(ifp, &icur, &got)) {
559 xfs_fileoff_t end = XFS_B_TO_FSB(mp, XFS_ISIZE(ip));
560
561 if (bmv->bmv_entries > 0)
562 out[bmv->bmv_entries - 1].bmv_oflags |=
563 BMV_OF_LAST;
564
565 if (whichfork != XFS_ATTR_FORK && bno < end &&
566 !xfs_getbmap_full(bmv)) {
567 xfs_getbmap_report_hole(ip, bmv, out, bmv_end,
568 bno, end);
569 }
570 break;
571 }
572
573 if (bno >= first_bno + len)
574 break;
575 }
576
577 out_unlock_ilock:
578 xfs_iunlock(ip, lock);
579 out_unlock_iolock:
580 xfs_iunlock(ip, XFS_IOLOCK_SHARED);
581 return error;
582 }
583
584 /*
585 * Dead simple method of punching delalyed allocation blocks from a range in
586 * the inode. This will always punch out both the start and end blocks, even
587 * if the ranges only partially overlap them, so it is up to the caller to
588 * ensure that partial blocks are not passed in.
589 */
590 int
xfs_bmap_punch_delalloc_range(struct xfs_inode * ip,xfs_off_t start_byte,xfs_off_t end_byte)591 xfs_bmap_punch_delalloc_range(
592 struct xfs_inode *ip,
593 xfs_off_t start_byte,
594 xfs_off_t end_byte)
595 {
596 struct xfs_mount *mp = ip->i_mount;
597 struct xfs_ifork *ifp = &ip->i_df;
598 xfs_fileoff_t start_fsb = XFS_B_TO_FSBT(mp, start_byte);
599 xfs_fileoff_t end_fsb = XFS_B_TO_FSB(mp, end_byte);
600 struct xfs_bmbt_irec got, del;
601 struct xfs_iext_cursor icur;
602 int error = 0;
603
604 ASSERT(!xfs_need_iread_extents(ifp));
605
606 xfs_ilock(ip, XFS_ILOCK_EXCL);
607 if (!xfs_iext_lookup_extent_before(ip, ifp, &end_fsb, &icur, &got))
608 goto out_unlock;
609
610 while (got.br_startoff + got.br_blockcount > start_fsb) {
611 del = got;
612 xfs_trim_extent(&del, start_fsb, end_fsb - start_fsb);
613
614 /*
615 * A delete can push the cursor forward. Step back to the
616 * previous extent on non-delalloc or extents outside the
617 * target range.
618 */
619 if (!del.br_blockcount ||
620 !isnullstartblock(del.br_startblock)) {
621 if (!xfs_iext_prev_extent(ifp, &icur, &got))
622 break;
623 continue;
624 }
625
626 error = xfs_bmap_del_extent_delay(ip, XFS_DATA_FORK, &icur,
627 &got, &del);
628 if (error || !xfs_iext_get_extent(ifp, &icur, &got))
629 break;
630 }
631
632 out_unlock:
633 xfs_iunlock(ip, XFS_ILOCK_EXCL);
634 return error;
635 }
636
637 /*
638 * Test whether it is appropriate to check an inode for and free post EOF
639 * blocks.
640 */
641 bool
xfs_can_free_eofblocks(struct xfs_inode * ip)642 xfs_can_free_eofblocks(
643 struct xfs_inode *ip)
644 {
645 struct xfs_bmbt_irec imap;
646 struct xfs_mount *mp = ip->i_mount;
647 xfs_fileoff_t end_fsb;
648 xfs_fileoff_t last_fsb;
649 int nimaps = 1;
650 int error;
651
652 /*
653 * Caller must either hold the exclusive io lock; or be inactivating
654 * the inode, which guarantees there are no other users of the inode.
655 */
656 ASSERT(xfs_isilocked(ip, XFS_IOLOCK_EXCL) ||
657 (VFS_I(ip)->i_state & I_FREEING));
658
659 /* prealloc/delalloc exists only on regular files */
660 if (!S_ISREG(VFS_I(ip)->i_mode))
661 return false;
662
663 /*
664 * Zero sized files with no cached pages and delalloc blocks will not
665 * have speculative prealloc/delalloc blocks to remove.
666 */
667 if (VFS_I(ip)->i_size == 0 &&
668 VFS_I(ip)->i_mapping->nrpages == 0 &&
669 ip->i_delayed_blks == 0)
670 return false;
671
672 /* If we haven't read in the extent list, then don't do it now. */
673 if (xfs_need_iread_extents(&ip->i_df))
674 return false;
675
676 /*
677 * Only free real extents for inodes with persistent preallocations or
678 * the append-only flag.
679 */
680 if (ip->i_diflags & (XFS_DIFLAG_PREALLOC | XFS_DIFLAG_APPEND))
681 if (ip->i_delayed_blks == 0)
682 return false;
683
684 /*
685 * Do not try to free post-EOF blocks if EOF is beyond the end of the
686 * range supported by the page cache, because the truncation will loop
687 * forever.
688 */
689 end_fsb = XFS_B_TO_FSB(mp, (xfs_ufsize_t)XFS_ISIZE(ip));
690 if (XFS_IS_REALTIME_INODE(ip) && mp->m_sb.sb_rextsize > 1)
691 end_fsb = roundup_64(end_fsb, mp->m_sb.sb_rextsize);
692 last_fsb = XFS_B_TO_FSB(mp, mp->m_super->s_maxbytes);
693 if (last_fsb <= end_fsb)
694 return false;
695
696 /*
697 * Look up the mapping for the first block past EOF. If we can't find
698 * it, there's nothing to free.
699 */
700 xfs_ilock(ip, XFS_ILOCK_SHARED);
701 error = xfs_bmapi_read(ip, end_fsb, last_fsb - end_fsb, &imap, &nimaps,
702 0);
703 xfs_iunlock(ip, XFS_ILOCK_SHARED);
704 if (error || nimaps == 0)
705 return false;
706
707 /*
708 * If there's a real mapping there or there are delayed allocation
709 * reservations, then we have post-EOF blocks to try to free.
710 */
711 return imap.br_startblock != HOLESTARTBLOCK || ip->i_delayed_blks;
712 }
713
714 /*
715 * This is called to free any blocks beyond eof. The caller must hold
716 * IOLOCK_EXCL unless we are in the inode reclaim path and have the only
717 * reference to the inode.
718 */
719 int
xfs_free_eofblocks(struct xfs_inode * ip)720 xfs_free_eofblocks(
721 struct xfs_inode *ip)
722 {
723 struct xfs_trans *tp;
724 struct xfs_mount *mp = ip->i_mount;
725 int error;
726
727 /* Attach the dquots to the inode up front. */
728 error = xfs_qm_dqattach(ip);
729 if (error)
730 return error;
731
732 /* Wait on dio to ensure i_size has settled. */
733 inode_dio_wait(VFS_I(ip));
734
735 /*
736 * For preallocated files only free delayed allocations.
737 *
738 * Note that this means we also leave speculative preallocations in
739 * place for preallocated files.
740 */
741 if (ip->i_diflags & (XFS_DIFLAG_PREALLOC | XFS_DIFLAG_APPEND)) {
742 if (ip->i_delayed_blks) {
743 xfs_bmap_punch_delalloc_range(ip,
744 round_up(XFS_ISIZE(ip), mp->m_sb.sb_blocksize),
745 LLONG_MAX);
746 }
747 xfs_inode_clear_eofblocks_tag(ip);
748 return 0;
749 }
750
751 error = xfs_trans_alloc(mp, &M_RES(mp)->tr_itruncate, 0, 0, 0, &tp);
752 if (error) {
753 ASSERT(xfs_is_shutdown(mp));
754 return error;
755 }
756
757 xfs_ilock(ip, XFS_ILOCK_EXCL);
758 xfs_trans_ijoin(tp, ip, 0);
759
760 /*
761 * Do not update the on-disk file size. If we update the on-disk file
762 * size and then the system crashes before the contents of the file are
763 * flushed to disk then the files may be full of holes (ie NULL files
764 * bug).
765 */
766 error = xfs_itruncate_extents_flags(&tp, ip, XFS_DATA_FORK,
767 XFS_ISIZE(ip), XFS_BMAPI_NODISCARD);
768 if (error)
769 goto err_cancel;
770
771 error = xfs_trans_commit(tp);
772 if (error)
773 goto out_unlock;
774
775 xfs_inode_clear_eofblocks_tag(ip);
776 goto out_unlock;
777
778 err_cancel:
779 /*
780 * If we get an error at this point we simply don't
781 * bother truncating the file.
782 */
783 xfs_trans_cancel(tp);
784 out_unlock:
785 xfs_iunlock(ip, XFS_ILOCK_EXCL);
786 return error;
787 }
788
789 int
xfs_alloc_file_space(struct xfs_inode * ip,xfs_off_t offset,xfs_off_t len)790 xfs_alloc_file_space(
791 struct xfs_inode *ip,
792 xfs_off_t offset,
793 xfs_off_t len)
794 {
795 xfs_mount_t *mp = ip->i_mount;
796 xfs_off_t count;
797 xfs_filblks_t allocatesize_fsb;
798 xfs_extlen_t extsz, temp;
799 xfs_fileoff_t startoffset_fsb;
800 xfs_fileoff_t endoffset_fsb;
801 int rt;
802 xfs_trans_t *tp;
803 xfs_bmbt_irec_t imaps[1], *imapp;
804 int error;
805
806 trace_xfs_alloc_file_space(ip);
807
808 if (xfs_is_shutdown(mp))
809 return -EIO;
810
811 error = xfs_qm_dqattach(ip);
812 if (error)
813 return error;
814
815 if (len <= 0)
816 return -EINVAL;
817
818 rt = XFS_IS_REALTIME_INODE(ip);
819 extsz = xfs_get_extsz_hint(ip);
820
821 count = len;
822 imapp = &imaps[0];
823 startoffset_fsb = XFS_B_TO_FSBT(mp, offset);
824 endoffset_fsb = XFS_B_TO_FSB(mp, offset + count);
825 allocatesize_fsb = endoffset_fsb - startoffset_fsb;
826
827 /*
828 * Allocate file space until done or until there is an error
829 */
830 while (allocatesize_fsb && !error) {
831 xfs_fileoff_t s, e;
832 unsigned int dblocks, rblocks, resblks;
833 int nimaps = 1;
834
835 /*
836 * Determine space reservations for data/realtime.
837 */
838 if (unlikely(extsz)) {
839 s = startoffset_fsb;
840 do_div(s, extsz);
841 s *= extsz;
842 e = startoffset_fsb + allocatesize_fsb;
843 div_u64_rem(startoffset_fsb, extsz, &temp);
844 if (temp)
845 e += temp;
846 div_u64_rem(e, extsz, &temp);
847 if (temp)
848 e += extsz - temp;
849 } else {
850 s = 0;
851 e = allocatesize_fsb;
852 }
853
854 /*
855 * The transaction reservation is limited to a 32-bit block
856 * count, hence we need to limit the number of blocks we are
857 * trying to reserve to avoid an overflow. We can't allocate
858 * more than @nimaps extents, and an extent is limited on disk
859 * to XFS_BMBT_MAX_EXTLEN (21 bits), so use that to enforce the
860 * limit.
861 */
862 resblks = min_t(xfs_fileoff_t, (e - s),
863 (XFS_MAX_BMBT_EXTLEN * nimaps));
864 if (unlikely(rt)) {
865 dblocks = XFS_DIOSTRAT_SPACE_RES(mp, 0);
866 rblocks = resblks;
867 } else {
868 dblocks = XFS_DIOSTRAT_SPACE_RES(mp, resblks);
869 rblocks = 0;
870 }
871
872 error = xfs_trans_alloc_inode(ip, &M_RES(mp)->tr_write,
873 dblocks, rblocks, false, &tp);
874 if (error)
875 break;
876
877 error = xfs_iext_count_may_overflow(ip, XFS_DATA_FORK,
878 XFS_IEXT_ADD_NOSPLIT_CNT);
879 if (error == -EFBIG)
880 error = xfs_iext_count_upgrade(tp, ip,
881 XFS_IEXT_ADD_NOSPLIT_CNT);
882 if (error)
883 goto error;
884
885 /*
886 * If the allocator cannot find a single free extent large
887 * enough to cover the start block of the requested range,
888 * xfs_bmapi_write will return -ENOSR.
889 *
890 * In that case we simply need to keep looping with the same
891 * startoffset_fsb so that one of the following allocations
892 * will eventually reach the requested range.
893 */
894 error = xfs_bmapi_write(tp, ip, startoffset_fsb,
895 allocatesize_fsb, XFS_BMAPI_PREALLOC, 0, imapp,
896 &nimaps);
897 if (error) {
898 if (error != -ENOSR)
899 goto error;
900 error = 0;
901 } else {
902 startoffset_fsb += imapp->br_blockcount;
903 allocatesize_fsb -= imapp->br_blockcount;
904 }
905
906 ip->i_diflags |= XFS_DIFLAG_PREALLOC;
907 xfs_trans_log_inode(tp, ip, XFS_ILOG_CORE);
908
909 error = xfs_trans_commit(tp);
910 xfs_iunlock(ip, XFS_ILOCK_EXCL);
911 }
912
913 return error;
914
915 error:
916 xfs_trans_cancel(tp);
917 xfs_iunlock(ip, XFS_ILOCK_EXCL);
918 return error;
919 }
920
921 static int
xfs_unmap_extent(struct xfs_inode * ip,xfs_fileoff_t startoffset_fsb,xfs_filblks_t len_fsb,int * done)922 xfs_unmap_extent(
923 struct xfs_inode *ip,
924 xfs_fileoff_t startoffset_fsb,
925 xfs_filblks_t len_fsb,
926 int *done)
927 {
928 struct xfs_mount *mp = ip->i_mount;
929 struct xfs_trans *tp;
930 uint resblks = XFS_DIOSTRAT_SPACE_RES(mp, 0);
931 int error;
932
933 error = xfs_trans_alloc_inode(ip, &M_RES(mp)->tr_write, resblks, 0,
934 false, &tp);
935 if (error)
936 return error;
937
938 error = xfs_iext_count_may_overflow(ip, XFS_DATA_FORK,
939 XFS_IEXT_PUNCH_HOLE_CNT);
940 if (error == -EFBIG)
941 error = xfs_iext_count_upgrade(tp, ip, XFS_IEXT_PUNCH_HOLE_CNT);
942 if (error)
943 goto out_trans_cancel;
944
945 error = xfs_bunmapi(tp, ip, startoffset_fsb, len_fsb, 0, 2, done);
946 if (error)
947 goto out_trans_cancel;
948
949 error = xfs_trans_commit(tp);
950 out_unlock:
951 xfs_iunlock(ip, XFS_ILOCK_EXCL);
952 return error;
953
954 out_trans_cancel:
955 xfs_trans_cancel(tp);
956 goto out_unlock;
957 }
958
959 /* Caller must first wait for the completion of any pending DIOs if required. */
960 int
xfs_flush_unmap_range(struct xfs_inode * ip,xfs_off_t offset,xfs_off_t len)961 xfs_flush_unmap_range(
962 struct xfs_inode *ip,
963 xfs_off_t offset,
964 xfs_off_t len)
965 {
966 struct xfs_mount *mp = ip->i_mount;
967 struct inode *inode = VFS_I(ip);
968 xfs_off_t rounding, start, end;
969 int error;
970
971 rounding = max_t(xfs_off_t, mp->m_sb.sb_blocksize, PAGE_SIZE);
972 start = round_down(offset, rounding);
973 end = round_up(offset + len, rounding) - 1;
974
975 error = filemap_write_and_wait_range(inode->i_mapping, start, end);
976 if (error)
977 return error;
978 truncate_pagecache_range(inode, start, end);
979 return 0;
980 }
981
982 int
xfs_free_file_space(struct xfs_inode * ip,xfs_off_t offset,xfs_off_t len)983 xfs_free_file_space(
984 struct xfs_inode *ip,
985 xfs_off_t offset,
986 xfs_off_t len)
987 {
988 struct xfs_mount *mp = ip->i_mount;
989 xfs_fileoff_t startoffset_fsb;
990 xfs_fileoff_t endoffset_fsb;
991 int done = 0, error;
992
993 trace_xfs_free_file_space(ip);
994
995 error = xfs_qm_dqattach(ip);
996 if (error)
997 return error;
998
999 if (len <= 0) /* if nothing being freed */
1000 return 0;
1001
1002 startoffset_fsb = XFS_B_TO_FSB(mp, offset);
1003 endoffset_fsb = XFS_B_TO_FSBT(mp, offset + len);
1004
1005 /* We can only free complete realtime extents. */
1006 if (XFS_IS_REALTIME_INODE(ip) && mp->m_sb.sb_rextsize > 1) {
1007 startoffset_fsb = roundup_64(startoffset_fsb,
1008 mp->m_sb.sb_rextsize);
1009 endoffset_fsb = rounddown_64(endoffset_fsb,
1010 mp->m_sb.sb_rextsize);
1011 }
1012
1013 /*
1014 * Need to zero the stuff we're not freeing, on disk.
1015 */
1016 if (endoffset_fsb > startoffset_fsb) {
1017 while (!done) {
1018 error = xfs_unmap_extent(ip, startoffset_fsb,
1019 endoffset_fsb - startoffset_fsb, &done);
1020 if (error)
1021 return error;
1022 }
1023 }
1024
1025 /*
1026 * Now that we've unmap all full blocks we'll have to zero out any
1027 * partial block at the beginning and/or end. xfs_zero_range is smart
1028 * enough to skip any holes, including those we just created, but we
1029 * must take care not to zero beyond EOF and enlarge i_size.
1030 */
1031 if (offset >= XFS_ISIZE(ip))
1032 return 0;
1033 if (offset + len > XFS_ISIZE(ip))
1034 len = XFS_ISIZE(ip) - offset;
1035 error = xfs_zero_range(ip, offset, len, NULL);
1036 if (error)
1037 return error;
1038
1039 /*
1040 * If we zeroed right up to EOF and EOF straddles a page boundary we
1041 * must make sure that the post-EOF area is also zeroed because the
1042 * page could be mmap'd and xfs_zero_range doesn't do that for us.
1043 * Writeback of the eof page will do this, albeit clumsily.
1044 */
1045 if (offset + len >= XFS_ISIZE(ip) && offset_in_page(offset + len) > 0) {
1046 error = filemap_write_and_wait_range(VFS_I(ip)->i_mapping,
1047 round_down(offset + len, PAGE_SIZE), LLONG_MAX);
1048 }
1049
1050 return error;
1051 }
1052
1053 static int
xfs_prepare_shift(struct xfs_inode * ip,loff_t offset)1054 xfs_prepare_shift(
1055 struct xfs_inode *ip,
1056 loff_t offset)
1057 {
1058 struct xfs_mount *mp = ip->i_mount;
1059 int error;
1060
1061 /*
1062 * Trim eofblocks to avoid shifting uninitialized post-eof preallocation
1063 * into the accessible region of the file.
1064 */
1065 if (xfs_can_free_eofblocks(ip)) {
1066 error = xfs_free_eofblocks(ip);
1067 if (error)
1068 return error;
1069 }
1070
1071 /*
1072 * Shift operations must stabilize the start block offset boundary along
1073 * with the full range of the operation. If we don't, a COW writeback
1074 * completion could race with an insert, front merge with the start
1075 * extent (after split) during the shift and corrupt the file. Start
1076 * with the block just prior to the start to stabilize the boundary.
1077 */
1078 offset = round_down(offset, mp->m_sb.sb_blocksize);
1079 if (offset)
1080 offset -= mp->m_sb.sb_blocksize;
1081
1082 /*
1083 * Writeback and invalidate cache for the remainder of the file as we're
1084 * about to shift down every extent from offset to EOF.
1085 */
1086 error = xfs_flush_unmap_range(ip, offset, XFS_ISIZE(ip));
1087 if (error)
1088 return error;
1089
1090 /*
1091 * Clean out anything hanging around in the cow fork now that
1092 * we've flushed all the dirty data out to disk to avoid having
1093 * CoW extents at the wrong offsets.
1094 */
1095 if (xfs_inode_has_cow_data(ip)) {
1096 error = xfs_reflink_cancel_cow_range(ip, offset, NULLFILEOFF,
1097 true);
1098 if (error)
1099 return error;
1100 }
1101
1102 return 0;
1103 }
1104
1105 /*
1106 * xfs_collapse_file_space()
1107 * This routine frees disk space and shift extent for the given file.
1108 * The first thing we do is to free data blocks in the specified range
1109 * by calling xfs_free_file_space(). It would also sync dirty data
1110 * and invalidate page cache over the region on which collapse range
1111 * is working. And Shift extent records to the left to cover a hole.
1112 * RETURNS:
1113 * 0 on success
1114 * errno on error
1115 *
1116 */
1117 int
xfs_collapse_file_space(struct xfs_inode * ip,xfs_off_t offset,xfs_off_t len)1118 xfs_collapse_file_space(
1119 struct xfs_inode *ip,
1120 xfs_off_t offset,
1121 xfs_off_t len)
1122 {
1123 struct xfs_mount *mp = ip->i_mount;
1124 struct xfs_trans *tp;
1125 int error;
1126 xfs_fileoff_t next_fsb = XFS_B_TO_FSB(mp, offset + len);
1127 xfs_fileoff_t shift_fsb = XFS_B_TO_FSB(mp, len);
1128 bool done = false;
1129
1130 ASSERT(xfs_isilocked(ip, XFS_IOLOCK_EXCL));
1131 ASSERT(xfs_isilocked(ip, XFS_MMAPLOCK_EXCL));
1132
1133 trace_xfs_collapse_file_space(ip);
1134
1135 error = xfs_free_file_space(ip, offset, len);
1136 if (error)
1137 return error;
1138
1139 error = xfs_prepare_shift(ip, offset);
1140 if (error)
1141 return error;
1142
1143 error = xfs_trans_alloc(mp, &M_RES(mp)->tr_write, 0, 0, 0, &tp);
1144 if (error)
1145 return error;
1146
1147 xfs_ilock(ip, XFS_ILOCK_EXCL);
1148 xfs_trans_ijoin(tp, ip, 0);
1149
1150 while (!done) {
1151 error = xfs_bmap_collapse_extents(tp, ip, &next_fsb, shift_fsb,
1152 &done);
1153 if (error)
1154 goto out_trans_cancel;
1155 if (done)
1156 break;
1157
1158 /* finish any deferred frees and roll the transaction */
1159 error = xfs_defer_finish(&tp);
1160 if (error)
1161 goto out_trans_cancel;
1162 }
1163
1164 error = xfs_trans_commit(tp);
1165 xfs_iunlock(ip, XFS_ILOCK_EXCL);
1166 return error;
1167
1168 out_trans_cancel:
1169 xfs_trans_cancel(tp);
1170 xfs_iunlock(ip, XFS_ILOCK_EXCL);
1171 return error;
1172 }
1173
1174 /*
1175 * xfs_insert_file_space()
1176 * This routine create hole space by shifting extents for the given file.
1177 * The first thing we do is to sync dirty data and invalidate page cache
1178 * over the region on which insert range is working. And split an extent
1179 * to two extents at given offset by calling xfs_bmap_split_extent.
1180 * And shift all extent records which are laying between [offset,
1181 * last allocated extent] to the right to reserve hole range.
1182 * RETURNS:
1183 * 0 on success
1184 * errno on error
1185 */
1186 int
xfs_insert_file_space(struct xfs_inode * ip,loff_t offset,loff_t len)1187 xfs_insert_file_space(
1188 struct xfs_inode *ip,
1189 loff_t offset,
1190 loff_t len)
1191 {
1192 struct xfs_mount *mp = ip->i_mount;
1193 struct xfs_trans *tp;
1194 int error;
1195 xfs_fileoff_t stop_fsb = XFS_B_TO_FSB(mp, offset);
1196 xfs_fileoff_t next_fsb = NULLFSBLOCK;
1197 xfs_fileoff_t shift_fsb = XFS_B_TO_FSB(mp, len);
1198 bool done = false;
1199
1200 ASSERT(xfs_isilocked(ip, XFS_IOLOCK_EXCL));
1201 ASSERT(xfs_isilocked(ip, XFS_MMAPLOCK_EXCL));
1202
1203 trace_xfs_insert_file_space(ip);
1204
1205 error = xfs_bmap_can_insert_extents(ip, stop_fsb, shift_fsb);
1206 if (error)
1207 return error;
1208
1209 error = xfs_prepare_shift(ip, offset);
1210 if (error)
1211 return error;
1212
1213 error = xfs_trans_alloc(mp, &M_RES(mp)->tr_write,
1214 XFS_DIOSTRAT_SPACE_RES(mp, 0), 0, 0, &tp);
1215 if (error)
1216 return error;
1217
1218 xfs_ilock(ip, XFS_ILOCK_EXCL);
1219 xfs_trans_ijoin(tp, ip, 0);
1220
1221 error = xfs_iext_count_may_overflow(ip, XFS_DATA_FORK,
1222 XFS_IEXT_PUNCH_HOLE_CNT);
1223 if (error == -EFBIG)
1224 error = xfs_iext_count_upgrade(tp, ip, XFS_IEXT_PUNCH_HOLE_CNT);
1225 if (error)
1226 goto out_trans_cancel;
1227
1228 /*
1229 * The extent shifting code works on extent granularity. So, if stop_fsb
1230 * is not the starting block of extent, we need to split the extent at
1231 * stop_fsb.
1232 */
1233 error = xfs_bmap_split_extent(tp, ip, stop_fsb);
1234 if (error)
1235 goto out_trans_cancel;
1236
1237 do {
1238 error = xfs_defer_finish(&tp);
1239 if (error)
1240 goto out_trans_cancel;
1241
1242 error = xfs_bmap_insert_extents(tp, ip, &next_fsb, shift_fsb,
1243 &done, stop_fsb);
1244 if (error)
1245 goto out_trans_cancel;
1246 } while (!done);
1247
1248 error = xfs_trans_commit(tp);
1249 xfs_iunlock(ip, XFS_ILOCK_EXCL);
1250 return error;
1251
1252 out_trans_cancel:
1253 xfs_trans_cancel(tp);
1254 xfs_iunlock(ip, XFS_ILOCK_EXCL);
1255 return error;
1256 }
1257
1258 /*
1259 * We need to check that the format of the data fork in the temporary inode is
1260 * valid for the target inode before doing the swap. This is not a problem with
1261 * attr1 because of the fixed fork offset, but attr2 has a dynamically sized
1262 * data fork depending on the space the attribute fork is taking so we can get
1263 * invalid formats on the target inode.
1264 *
1265 * E.g. target has space for 7 extents in extent format, temp inode only has
1266 * space for 6. If we defragment down to 7 extents, then the tmp format is a
1267 * btree, but when swapped it needs to be in extent format. Hence we can't just
1268 * blindly swap data forks on attr2 filesystems.
1269 *
1270 * Note that we check the swap in both directions so that we don't end up with
1271 * a corrupt temporary inode, either.
1272 *
1273 * Note that fixing the way xfs_fsr sets up the attribute fork in the source
1274 * inode will prevent this situation from occurring, so all we do here is
1275 * reject and log the attempt. basically we are putting the responsibility on
1276 * userspace to get this right.
1277 */
1278 static int
xfs_swap_extents_check_format(struct xfs_inode * ip,struct xfs_inode * tip)1279 xfs_swap_extents_check_format(
1280 struct xfs_inode *ip, /* target inode */
1281 struct xfs_inode *tip) /* tmp inode */
1282 {
1283 struct xfs_ifork *ifp = &ip->i_df;
1284 struct xfs_ifork *tifp = &tip->i_df;
1285
1286 /* User/group/project quota ids must match if quotas are enforced. */
1287 if (XFS_IS_QUOTA_ON(ip->i_mount) &&
1288 (!uid_eq(VFS_I(ip)->i_uid, VFS_I(tip)->i_uid) ||
1289 !gid_eq(VFS_I(ip)->i_gid, VFS_I(tip)->i_gid) ||
1290 ip->i_projid != tip->i_projid))
1291 return -EINVAL;
1292
1293 /* Should never get a local format */
1294 if (ifp->if_format == XFS_DINODE_FMT_LOCAL ||
1295 tifp->if_format == XFS_DINODE_FMT_LOCAL)
1296 return -EINVAL;
1297
1298 /*
1299 * if the target inode has less extents that then temporary inode then
1300 * why did userspace call us?
1301 */
1302 if (ifp->if_nextents < tifp->if_nextents)
1303 return -EINVAL;
1304
1305 /*
1306 * If we have to use the (expensive) rmap swap method, we can
1307 * handle any number of extents and any format.
1308 */
1309 if (xfs_has_rmapbt(ip->i_mount))
1310 return 0;
1311
1312 /*
1313 * if the target inode is in extent form and the temp inode is in btree
1314 * form then we will end up with the target inode in the wrong format
1315 * as we already know there are less extents in the temp inode.
1316 */
1317 if (ifp->if_format == XFS_DINODE_FMT_EXTENTS &&
1318 tifp->if_format == XFS_DINODE_FMT_BTREE)
1319 return -EINVAL;
1320
1321 /* Check temp in extent form to max in target */
1322 if (tifp->if_format == XFS_DINODE_FMT_EXTENTS &&
1323 tifp->if_nextents > XFS_IFORK_MAXEXT(ip, XFS_DATA_FORK))
1324 return -EINVAL;
1325
1326 /* Check target in extent form to max in temp */
1327 if (ifp->if_format == XFS_DINODE_FMT_EXTENTS &&
1328 ifp->if_nextents > XFS_IFORK_MAXEXT(tip, XFS_DATA_FORK))
1329 return -EINVAL;
1330
1331 /*
1332 * If we are in a btree format, check that the temp root block will fit
1333 * in the target and that it has enough extents to be in btree format
1334 * in the target.
1335 *
1336 * Note that we have to be careful to allow btree->extent conversions
1337 * (a common defrag case) which will occur when the temp inode is in
1338 * extent format...
1339 */
1340 if (tifp->if_format == XFS_DINODE_FMT_BTREE) {
1341 if (xfs_inode_has_attr_fork(ip) &&
1342 XFS_BMAP_BMDR_SPACE(tifp->if_broot) > xfs_inode_fork_boff(ip))
1343 return -EINVAL;
1344 if (tifp->if_nextents <= XFS_IFORK_MAXEXT(ip, XFS_DATA_FORK))
1345 return -EINVAL;
1346 }
1347
1348 /* Reciprocal target->temp btree format checks */
1349 if (ifp->if_format == XFS_DINODE_FMT_BTREE) {
1350 if (xfs_inode_has_attr_fork(tip) &&
1351 XFS_BMAP_BMDR_SPACE(ip->i_df.if_broot) > xfs_inode_fork_boff(tip))
1352 return -EINVAL;
1353 if (ifp->if_nextents <= XFS_IFORK_MAXEXT(tip, XFS_DATA_FORK))
1354 return -EINVAL;
1355 }
1356
1357 return 0;
1358 }
1359
1360 static int
xfs_swap_extent_flush(struct xfs_inode * ip)1361 xfs_swap_extent_flush(
1362 struct xfs_inode *ip)
1363 {
1364 int error;
1365
1366 error = filemap_write_and_wait(VFS_I(ip)->i_mapping);
1367 if (error)
1368 return error;
1369 truncate_pagecache_range(VFS_I(ip), 0, -1);
1370
1371 /* Verify O_DIRECT for ftmp */
1372 if (VFS_I(ip)->i_mapping->nrpages)
1373 return -EINVAL;
1374 return 0;
1375 }
1376
1377 /*
1378 * Move extents from one file to another, when rmap is enabled.
1379 */
1380 STATIC int
xfs_swap_extent_rmap(struct xfs_trans ** tpp,struct xfs_inode * ip,struct xfs_inode * tip)1381 xfs_swap_extent_rmap(
1382 struct xfs_trans **tpp,
1383 struct xfs_inode *ip,
1384 struct xfs_inode *tip)
1385 {
1386 struct xfs_trans *tp = *tpp;
1387 struct xfs_bmbt_irec irec;
1388 struct xfs_bmbt_irec uirec;
1389 struct xfs_bmbt_irec tirec;
1390 xfs_fileoff_t offset_fsb;
1391 xfs_fileoff_t end_fsb;
1392 xfs_filblks_t count_fsb;
1393 int error;
1394 xfs_filblks_t ilen;
1395 xfs_filblks_t rlen;
1396 int nimaps;
1397 uint64_t tip_flags2;
1398
1399 /*
1400 * If the source file has shared blocks, we must flag the donor
1401 * file as having shared blocks so that we get the shared-block
1402 * rmap functions when we go to fix up the rmaps. The flags
1403 * will be switch for reals later.
1404 */
1405 tip_flags2 = tip->i_diflags2;
1406 if (ip->i_diflags2 & XFS_DIFLAG2_REFLINK)
1407 tip->i_diflags2 |= XFS_DIFLAG2_REFLINK;
1408
1409 offset_fsb = 0;
1410 end_fsb = XFS_B_TO_FSB(ip->i_mount, i_size_read(VFS_I(ip)));
1411 count_fsb = (xfs_filblks_t)(end_fsb - offset_fsb);
1412
1413 while (count_fsb) {
1414 /* Read extent from the donor file */
1415 nimaps = 1;
1416 error = xfs_bmapi_read(tip, offset_fsb, count_fsb, &tirec,
1417 &nimaps, 0);
1418 if (error)
1419 goto out;
1420 ASSERT(nimaps == 1);
1421 ASSERT(tirec.br_startblock != DELAYSTARTBLOCK);
1422
1423 trace_xfs_swap_extent_rmap_remap(tip, &tirec);
1424 ilen = tirec.br_blockcount;
1425
1426 /* Unmap the old blocks in the source file. */
1427 while (tirec.br_blockcount) {
1428 ASSERT(tp->t_highest_agno == NULLAGNUMBER);
1429 trace_xfs_swap_extent_rmap_remap_piece(tip, &tirec);
1430
1431 /* Read extent from the source file */
1432 nimaps = 1;
1433 error = xfs_bmapi_read(ip, tirec.br_startoff,
1434 tirec.br_blockcount, &irec,
1435 &nimaps, 0);
1436 if (error)
1437 goto out;
1438 ASSERT(nimaps == 1);
1439 ASSERT(tirec.br_startoff == irec.br_startoff);
1440 trace_xfs_swap_extent_rmap_remap_piece(ip, &irec);
1441
1442 /* Trim the extent. */
1443 uirec = tirec;
1444 uirec.br_blockcount = rlen = min_t(xfs_filblks_t,
1445 tirec.br_blockcount,
1446 irec.br_blockcount);
1447 trace_xfs_swap_extent_rmap_remap_piece(tip, &uirec);
1448
1449 if (xfs_bmap_is_real_extent(&uirec)) {
1450 error = xfs_iext_count_may_overflow(ip,
1451 XFS_DATA_FORK,
1452 XFS_IEXT_SWAP_RMAP_CNT);
1453 if (error == -EFBIG)
1454 error = xfs_iext_count_upgrade(tp, ip,
1455 XFS_IEXT_SWAP_RMAP_CNT);
1456 if (error)
1457 goto out;
1458 }
1459
1460 if (xfs_bmap_is_real_extent(&irec)) {
1461 error = xfs_iext_count_may_overflow(tip,
1462 XFS_DATA_FORK,
1463 XFS_IEXT_SWAP_RMAP_CNT);
1464 if (error == -EFBIG)
1465 error = xfs_iext_count_upgrade(tp, ip,
1466 XFS_IEXT_SWAP_RMAP_CNT);
1467 if (error)
1468 goto out;
1469 }
1470
1471 /* Remove the mapping from the donor file. */
1472 xfs_bmap_unmap_extent(tp, tip, &uirec);
1473
1474 /* Remove the mapping from the source file. */
1475 xfs_bmap_unmap_extent(tp, ip, &irec);
1476
1477 /* Map the donor file's blocks into the source file. */
1478 xfs_bmap_map_extent(tp, ip, &uirec);
1479
1480 /* Map the source file's blocks into the donor file. */
1481 xfs_bmap_map_extent(tp, tip, &irec);
1482
1483 error = xfs_defer_finish(tpp);
1484 tp = *tpp;
1485 if (error)
1486 goto out;
1487
1488 tirec.br_startoff += rlen;
1489 if (tirec.br_startblock != HOLESTARTBLOCK &&
1490 tirec.br_startblock != DELAYSTARTBLOCK)
1491 tirec.br_startblock += rlen;
1492 tirec.br_blockcount -= rlen;
1493 }
1494
1495 /* Roll on... */
1496 count_fsb -= ilen;
1497 offset_fsb += ilen;
1498 }
1499
1500 tip->i_diflags2 = tip_flags2;
1501 return 0;
1502
1503 out:
1504 trace_xfs_swap_extent_rmap_error(ip, error, _RET_IP_);
1505 tip->i_diflags2 = tip_flags2;
1506 return error;
1507 }
1508
1509 /* Swap the extents of two files by swapping data forks. */
1510 STATIC int
xfs_swap_extent_forks(struct xfs_trans * tp,struct xfs_inode * ip,struct xfs_inode * tip,int * src_log_flags,int * target_log_flags)1511 xfs_swap_extent_forks(
1512 struct xfs_trans *tp,
1513 struct xfs_inode *ip,
1514 struct xfs_inode *tip,
1515 int *src_log_flags,
1516 int *target_log_flags)
1517 {
1518 xfs_filblks_t aforkblks = 0;
1519 xfs_filblks_t taforkblks = 0;
1520 xfs_extnum_t junk;
1521 uint64_t tmp;
1522 int error;
1523
1524 /*
1525 * Count the number of extended attribute blocks
1526 */
1527 if (xfs_inode_has_attr_fork(ip) && ip->i_af.if_nextents > 0 &&
1528 ip->i_af.if_format != XFS_DINODE_FMT_LOCAL) {
1529 error = xfs_bmap_count_blocks(tp, ip, XFS_ATTR_FORK, &junk,
1530 &aforkblks);
1531 if (error)
1532 return error;
1533 }
1534 if (xfs_inode_has_attr_fork(tip) && tip->i_af.if_nextents > 0 &&
1535 tip->i_af.if_format != XFS_DINODE_FMT_LOCAL) {
1536 error = xfs_bmap_count_blocks(tp, tip, XFS_ATTR_FORK, &junk,
1537 &taforkblks);
1538 if (error)
1539 return error;
1540 }
1541
1542 /*
1543 * Btree format (v3) inodes have the inode number stamped in the bmbt
1544 * block headers. We can't start changing the bmbt blocks until the
1545 * inode owner change is logged so recovery does the right thing in the
1546 * event of a crash. Set the owner change log flags now and leave the
1547 * bmbt scan as the last step.
1548 */
1549 if (xfs_has_v3inodes(ip->i_mount)) {
1550 if (ip->i_df.if_format == XFS_DINODE_FMT_BTREE)
1551 (*target_log_flags) |= XFS_ILOG_DOWNER;
1552 if (tip->i_df.if_format == XFS_DINODE_FMT_BTREE)
1553 (*src_log_flags) |= XFS_ILOG_DOWNER;
1554 }
1555
1556 /*
1557 * Swap the data forks of the inodes
1558 */
1559 swap(ip->i_df, tip->i_df);
1560
1561 /*
1562 * Fix the on-disk inode values
1563 */
1564 tmp = (uint64_t)ip->i_nblocks;
1565 ip->i_nblocks = tip->i_nblocks - taforkblks + aforkblks;
1566 tip->i_nblocks = tmp + taforkblks - aforkblks;
1567
1568 /*
1569 * The extents in the source inode could still contain speculative
1570 * preallocation beyond EOF (e.g. the file is open but not modified
1571 * while defrag is in progress). In that case, we need to copy over the
1572 * number of delalloc blocks the data fork in the source inode is
1573 * tracking beyond EOF so that when the fork is truncated away when the
1574 * temporary inode is unlinked we don't underrun the i_delayed_blks
1575 * counter on that inode.
1576 */
1577 ASSERT(tip->i_delayed_blks == 0);
1578 tip->i_delayed_blks = ip->i_delayed_blks;
1579 ip->i_delayed_blks = 0;
1580
1581 switch (ip->i_df.if_format) {
1582 case XFS_DINODE_FMT_EXTENTS:
1583 (*src_log_flags) |= XFS_ILOG_DEXT;
1584 break;
1585 case XFS_DINODE_FMT_BTREE:
1586 ASSERT(!xfs_has_v3inodes(ip->i_mount) ||
1587 (*src_log_flags & XFS_ILOG_DOWNER));
1588 (*src_log_flags) |= XFS_ILOG_DBROOT;
1589 break;
1590 }
1591
1592 switch (tip->i_df.if_format) {
1593 case XFS_DINODE_FMT_EXTENTS:
1594 (*target_log_flags) |= XFS_ILOG_DEXT;
1595 break;
1596 case XFS_DINODE_FMT_BTREE:
1597 (*target_log_flags) |= XFS_ILOG_DBROOT;
1598 ASSERT(!xfs_has_v3inodes(ip->i_mount) ||
1599 (*target_log_flags & XFS_ILOG_DOWNER));
1600 break;
1601 }
1602
1603 return 0;
1604 }
1605
1606 /*
1607 * Fix up the owners of the bmbt blocks to refer to the current inode. The
1608 * change owner scan attempts to order all modified buffers in the current
1609 * transaction. In the event of ordered buffer failure, the offending buffer is
1610 * physically logged as a fallback and the scan returns -EAGAIN. We must roll
1611 * the transaction in this case to replenish the fallback log reservation and
1612 * restart the scan. This process repeats until the scan completes.
1613 */
1614 static int
xfs_swap_change_owner(struct xfs_trans ** tpp,struct xfs_inode * ip,struct xfs_inode * tmpip)1615 xfs_swap_change_owner(
1616 struct xfs_trans **tpp,
1617 struct xfs_inode *ip,
1618 struct xfs_inode *tmpip)
1619 {
1620 int error;
1621 struct xfs_trans *tp = *tpp;
1622
1623 do {
1624 error = xfs_bmbt_change_owner(tp, ip, XFS_DATA_FORK, ip->i_ino,
1625 NULL);
1626 /* success or fatal error */
1627 if (error != -EAGAIN)
1628 break;
1629
1630 error = xfs_trans_roll(tpp);
1631 if (error)
1632 break;
1633 tp = *tpp;
1634
1635 /*
1636 * Redirty both inodes so they can relog and keep the log tail
1637 * moving forward.
1638 */
1639 xfs_trans_ijoin(tp, ip, 0);
1640 xfs_trans_ijoin(tp, tmpip, 0);
1641 xfs_trans_log_inode(tp, ip, XFS_ILOG_CORE);
1642 xfs_trans_log_inode(tp, tmpip, XFS_ILOG_CORE);
1643 } while (true);
1644
1645 return error;
1646 }
1647
1648 int
xfs_swap_extents(struct xfs_inode * ip,struct xfs_inode * tip,struct xfs_swapext * sxp)1649 xfs_swap_extents(
1650 struct xfs_inode *ip, /* target inode */
1651 struct xfs_inode *tip, /* tmp inode */
1652 struct xfs_swapext *sxp)
1653 {
1654 struct xfs_mount *mp = ip->i_mount;
1655 struct xfs_trans *tp;
1656 struct xfs_bstat *sbp = &sxp->sx_stat;
1657 int src_log_flags, target_log_flags;
1658 int error = 0;
1659 uint64_t f;
1660 int resblks = 0;
1661 unsigned int flags = 0;
1662 struct timespec64 ctime;
1663
1664 /*
1665 * Lock the inodes against other IO, page faults and truncate to
1666 * begin with. Then we can ensure the inodes are flushed and have no
1667 * page cache safely. Once we have done this we can take the ilocks and
1668 * do the rest of the checks.
1669 */
1670 lock_two_nondirectories(VFS_I(ip), VFS_I(tip));
1671 filemap_invalidate_lock_two(VFS_I(ip)->i_mapping,
1672 VFS_I(tip)->i_mapping);
1673
1674 /* Verify that both files have the same format */
1675 if ((VFS_I(ip)->i_mode & S_IFMT) != (VFS_I(tip)->i_mode & S_IFMT)) {
1676 error = -EINVAL;
1677 goto out_unlock;
1678 }
1679
1680 /* Verify both files are either real-time or non-realtime */
1681 if (XFS_IS_REALTIME_INODE(ip) != XFS_IS_REALTIME_INODE(tip)) {
1682 error = -EINVAL;
1683 goto out_unlock;
1684 }
1685
1686 error = xfs_qm_dqattach(ip);
1687 if (error)
1688 goto out_unlock;
1689
1690 error = xfs_qm_dqattach(tip);
1691 if (error)
1692 goto out_unlock;
1693
1694 error = xfs_swap_extent_flush(ip);
1695 if (error)
1696 goto out_unlock;
1697 error = xfs_swap_extent_flush(tip);
1698 if (error)
1699 goto out_unlock;
1700
1701 if (xfs_inode_has_cow_data(tip)) {
1702 error = xfs_reflink_cancel_cow_range(tip, 0, NULLFILEOFF, true);
1703 if (error)
1704 goto out_unlock;
1705 }
1706
1707 /*
1708 * Extent "swapping" with rmap requires a permanent reservation and
1709 * a block reservation because it's really just a remap operation
1710 * performed with log redo items!
1711 */
1712 if (xfs_has_rmapbt(mp)) {
1713 int w = XFS_DATA_FORK;
1714 uint32_t ipnext = ip->i_df.if_nextents;
1715 uint32_t tipnext = tip->i_df.if_nextents;
1716
1717 /*
1718 * Conceptually this shouldn't affect the shape of either bmbt,
1719 * but since we atomically move extents one by one, we reserve
1720 * enough space to rebuild both trees.
1721 */
1722 resblks = XFS_SWAP_RMAP_SPACE_RES(mp, ipnext, w);
1723 resblks += XFS_SWAP_RMAP_SPACE_RES(mp, tipnext, w);
1724
1725 /*
1726 * If either inode straddles a bmapbt block allocation boundary,
1727 * the rmapbt algorithm triggers repeated allocs and frees as
1728 * extents are remapped. This can exhaust the block reservation
1729 * prematurely and cause shutdown. Return freed blocks to the
1730 * transaction reservation to counter this behavior.
1731 */
1732 flags |= XFS_TRANS_RES_FDBLKS;
1733 }
1734 error = xfs_trans_alloc(mp, &M_RES(mp)->tr_write, resblks, 0, flags,
1735 &tp);
1736 if (error)
1737 goto out_unlock;
1738
1739 /*
1740 * Lock and join the inodes to the tansaction so that transaction commit
1741 * or cancel will unlock the inodes from this point onwards.
1742 */
1743 xfs_lock_two_inodes(ip, XFS_ILOCK_EXCL, tip, XFS_ILOCK_EXCL);
1744 xfs_trans_ijoin(tp, ip, 0);
1745 xfs_trans_ijoin(tp, tip, 0);
1746
1747
1748 /* Verify all data are being swapped */
1749 if (sxp->sx_offset != 0 ||
1750 sxp->sx_length != ip->i_disk_size ||
1751 sxp->sx_length != tip->i_disk_size) {
1752 error = -EFAULT;
1753 goto out_trans_cancel;
1754 }
1755
1756 trace_xfs_swap_extent_before(ip, 0);
1757 trace_xfs_swap_extent_before(tip, 1);
1758
1759 /* check inode formats now that data is flushed */
1760 error = xfs_swap_extents_check_format(ip, tip);
1761 if (error) {
1762 xfs_notice(mp,
1763 "%s: inode 0x%llx format is incompatible for exchanging.",
1764 __func__, ip->i_ino);
1765 goto out_trans_cancel;
1766 }
1767
1768 /*
1769 * Compare the current change & modify times with that
1770 * passed in. If they differ, we abort this swap.
1771 * This is the mechanism used to ensure the calling
1772 * process that the file was not changed out from
1773 * under it.
1774 */
1775 ctime = inode_get_ctime(VFS_I(ip));
1776 if ((sbp->bs_ctime.tv_sec != ctime.tv_sec) ||
1777 (sbp->bs_ctime.tv_nsec != ctime.tv_nsec) ||
1778 (sbp->bs_mtime.tv_sec != VFS_I(ip)->i_mtime.tv_sec) ||
1779 (sbp->bs_mtime.tv_nsec != VFS_I(ip)->i_mtime.tv_nsec)) {
1780 error = -EBUSY;
1781 goto out_trans_cancel;
1782 }
1783
1784 /*
1785 * Note the trickiness in setting the log flags - we set the owner log
1786 * flag on the opposite inode (i.e. the inode we are setting the new
1787 * owner to be) because once we swap the forks and log that, log
1788 * recovery is going to see the fork as owned by the swapped inode,
1789 * not the pre-swapped inodes.
1790 */
1791 src_log_flags = XFS_ILOG_CORE;
1792 target_log_flags = XFS_ILOG_CORE;
1793
1794 if (xfs_has_rmapbt(mp))
1795 error = xfs_swap_extent_rmap(&tp, ip, tip);
1796 else
1797 error = xfs_swap_extent_forks(tp, ip, tip, &src_log_flags,
1798 &target_log_flags);
1799 if (error)
1800 goto out_trans_cancel;
1801
1802 /* Do we have to swap reflink flags? */
1803 if ((ip->i_diflags2 & XFS_DIFLAG2_REFLINK) ^
1804 (tip->i_diflags2 & XFS_DIFLAG2_REFLINK)) {
1805 f = ip->i_diflags2 & XFS_DIFLAG2_REFLINK;
1806 ip->i_diflags2 &= ~XFS_DIFLAG2_REFLINK;
1807 ip->i_diflags2 |= tip->i_diflags2 & XFS_DIFLAG2_REFLINK;
1808 tip->i_diflags2 &= ~XFS_DIFLAG2_REFLINK;
1809 tip->i_diflags2 |= f & XFS_DIFLAG2_REFLINK;
1810 }
1811
1812 /* Swap the cow forks. */
1813 if (xfs_has_reflink(mp)) {
1814 ASSERT(!ip->i_cowfp ||
1815 ip->i_cowfp->if_format == XFS_DINODE_FMT_EXTENTS);
1816 ASSERT(!tip->i_cowfp ||
1817 tip->i_cowfp->if_format == XFS_DINODE_FMT_EXTENTS);
1818
1819 swap(ip->i_cowfp, tip->i_cowfp);
1820
1821 if (ip->i_cowfp && ip->i_cowfp->if_bytes)
1822 xfs_inode_set_cowblocks_tag(ip);
1823 else
1824 xfs_inode_clear_cowblocks_tag(ip);
1825 if (tip->i_cowfp && tip->i_cowfp->if_bytes)
1826 xfs_inode_set_cowblocks_tag(tip);
1827 else
1828 xfs_inode_clear_cowblocks_tag(tip);
1829 }
1830
1831 xfs_trans_log_inode(tp, ip, src_log_flags);
1832 xfs_trans_log_inode(tp, tip, target_log_flags);
1833
1834 /*
1835 * The extent forks have been swapped, but crc=1,rmapbt=0 filesystems
1836 * have inode number owner values in the bmbt blocks that still refer to
1837 * the old inode. Scan each bmbt to fix up the owner values with the
1838 * inode number of the current inode.
1839 */
1840 if (src_log_flags & XFS_ILOG_DOWNER) {
1841 error = xfs_swap_change_owner(&tp, ip, tip);
1842 if (error)
1843 goto out_trans_cancel;
1844 }
1845 if (target_log_flags & XFS_ILOG_DOWNER) {
1846 error = xfs_swap_change_owner(&tp, tip, ip);
1847 if (error)
1848 goto out_trans_cancel;
1849 }
1850
1851 /*
1852 * If this is a synchronous mount, make sure that the
1853 * transaction goes to disk before returning to the user.
1854 */
1855 if (xfs_has_wsync(mp))
1856 xfs_trans_set_sync(tp);
1857
1858 error = xfs_trans_commit(tp);
1859
1860 trace_xfs_swap_extent_after(ip, 0);
1861 trace_xfs_swap_extent_after(tip, 1);
1862
1863 out_unlock_ilock:
1864 xfs_iunlock(ip, XFS_ILOCK_EXCL);
1865 xfs_iunlock(tip, XFS_ILOCK_EXCL);
1866 out_unlock:
1867 filemap_invalidate_unlock_two(VFS_I(ip)->i_mapping,
1868 VFS_I(tip)->i_mapping);
1869 unlock_two_nondirectories(VFS_I(ip), VFS_I(tip));
1870 return error;
1871
1872 out_trans_cancel:
1873 xfs_trans_cancel(tp);
1874 goto out_unlock_ilock;
1875 }
1876