blob: 9a8579fb3a30dbd8070c25bcd1b2c31281150d2e [file] [log] [blame]
Andrew Scullb4b6d4a2019-01-02 15:54:55 +00001/*
2 * fs/f2fs/recovery.c
3 *
4 * Copyright (c) 2012 Samsung Electronics Co., Ltd.
5 * http://www.samsung.com/
6 *
7 * This program is free software; you can redistribute it and/or modify
8 * it under the terms of the GNU General Public License version 2 as
9 * published by the Free Software Foundation.
10 */
11#include <linux/fs.h>
12#include <linux/f2fs_fs.h>
13#include "f2fs.h"
14#include "node.h"
15#include "segment.h"
16
17/*
18 * Roll forward recovery scenarios.
19 *
20 * [Term] F: fsync_mark, D: dentry_mark
21 *
22 * 1. inode(x) | CP | inode(x) | dnode(F)
23 * -> Update the latest inode(x).
24 *
25 * 2. inode(x) | CP | inode(F) | dnode(F)
26 * -> No problem.
27 *
28 * 3. inode(x) | CP | dnode(F) | inode(x)
29 * -> Recover to the latest dnode(F), and drop the last inode(x)
30 *
31 * 4. inode(x) | CP | dnode(F) | inode(F)
32 * -> No problem.
33 *
34 * 5. CP | inode(x) | dnode(F)
35 * -> The inode(DF) was missing. Should drop this dnode(F).
36 *
37 * 6. CP | inode(DF) | dnode(F)
38 * -> No problem.
39 *
40 * 7. CP | dnode(F) | inode(DF)
41 * -> If f2fs_iget fails, then goto next to find inode(DF).
42 *
43 * 8. CP | dnode(F) | inode(x)
44 * -> If f2fs_iget fails, then goto next to find inode(DF).
45 * But it will fail due to no inode(DF).
46 */
47
48static struct kmem_cache *fsync_entry_slab;
49
50bool f2fs_space_for_roll_forward(struct f2fs_sb_info *sbi)
51{
52 s64 nalloc = percpu_counter_sum_positive(&sbi->alloc_valid_block_count);
53
54 if (sbi->last_valid_block_count + nalloc > sbi->user_block_count)
55 return false;
56 return true;
57}
58
59static struct fsync_inode_entry *get_fsync_inode(struct list_head *head,
60 nid_t ino)
61{
62 struct fsync_inode_entry *entry;
63
64 list_for_each_entry(entry, head, list)
65 if (entry->inode->i_ino == ino)
66 return entry;
67
68 return NULL;
69}
70
71static struct fsync_inode_entry *add_fsync_inode(struct f2fs_sb_info *sbi,
72 struct list_head *head, nid_t ino, bool quota_inode)
73{
74 struct inode *inode;
75 struct fsync_inode_entry *entry;
76 int err;
77
78 inode = f2fs_iget_retry(sbi->sb, ino);
79 if (IS_ERR(inode))
80 return ERR_CAST(inode);
81
82 err = dquot_initialize(inode);
83 if (err)
84 goto err_out;
85
86 if (quota_inode) {
87 err = dquot_alloc_inode(inode);
88 if (err)
89 goto err_out;
90 }
91
92 entry = f2fs_kmem_cache_alloc(fsync_entry_slab, GFP_F2FS_ZERO);
93 entry->inode = inode;
94 list_add_tail(&entry->list, head);
95
96 return entry;
97err_out:
98 iput(inode);
99 return ERR_PTR(err);
100}
101
102static void del_fsync_inode(struct fsync_inode_entry *entry)
103{
104 iput(entry->inode);
105 list_del(&entry->list);
106 kmem_cache_free(fsync_entry_slab, entry);
107}
108
109static int recover_dentry(struct inode *inode, struct page *ipage,
110 struct list_head *dir_list)
111{
112 struct f2fs_inode *raw_inode = F2FS_INODE(ipage);
113 nid_t pino = le32_to_cpu(raw_inode->i_pino);
114 struct f2fs_dir_entry *de;
115 struct fscrypt_name fname;
116 struct page *page;
117 struct inode *dir, *einode;
118 struct fsync_inode_entry *entry;
119 int err = 0;
120 char *name;
121
122 entry = get_fsync_inode(dir_list, pino);
123 if (!entry) {
124 entry = add_fsync_inode(F2FS_I_SB(inode), dir_list,
125 pino, false);
126 if (IS_ERR(entry)) {
127 dir = ERR_CAST(entry);
128 err = PTR_ERR(entry);
129 goto out;
130 }
131 }
132
133 dir = entry->inode;
134
135 memset(&fname, 0, sizeof(struct fscrypt_name));
136 fname.disk_name.len = le32_to_cpu(raw_inode->i_namelen);
137 fname.disk_name.name = raw_inode->i_name;
138
139 if (unlikely(fname.disk_name.len > F2FS_NAME_LEN)) {
140 WARN_ON(1);
141 err = -ENAMETOOLONG;
142 goto out;
143 }
144retry:
145 de = __f2fs_find_entry(dir, &fname, &page);
146 if (de && inode->i_ino == le32_to_cpu(de->ino))
147 goto out_put;
148
149 if (de) {
150 einode = f2fs_iget_retry(inode->i_sb, le32_to_cpu(de->ino));
151 if (IS_ERR(einode)) {
152 WARN_ON(1);
153 err = PTR_ERR(einode);
154 if (err == -ENOENT)
155 err = -EEXIST;
156 goto out_put;
157 }
158
159 err = dquot_initialize(einode);
160 if (err) {
161 iput(einode);
162 goto out_put;
163 }
164
165 err = f2fs_acquire_orphan_inode(F2FS_I_SB(inode));
166 if (err) {
167 iput(einode);
168 goto out_put;
169 }
170 f2fs_delete_entry(de, page, dir, einode);
171 iput(einode);
172 goto retry;
173 } else if (IS_ERR(page)) {
174 err = PTR_ERR(page);
175 } else {
176 err = f2fs_add_dentry(dir, &fname, inode,
177 inode->i_ino, inode->i_mode);
178 }
179 if (err == -ENOMEM)
180 goto retry;
181 goto out;
182
183out_put:
184 f2fs_put_page(page, 0);
185out:
186 if (file_enc_name(inode))
187 name = "<encrypted>";
188 else
189 name = raw_inode->i_name;
190 f2fs_msg(inode->i_sb, KERN_NOTICE,
191 "%s: ino = %x, name = %s, dir = %lx, err = %d",
192 __func__, ino_of_node(ipage), name,
193 IS_ERR(dir) ? 0 : dir->i_ino, err);
194 return err;
195}
196
197static void recover_inline_flags(struct inode *inode, struct f2fs_inode *ri)
198{
199 if (ri->i_inline & F2FS_PIN_FILE)
200 set_inode_flag(inode, FI_PIN_FILE);
201 else
202 clear_inode_flag(inode, FI_PIN_FILE);
203 if (ri->i_inline & F2FS_DATA_EXIST)
204 set_inode_flag(inode, FI_DATA_EXIST);
205 else
206 clear_inode_flag(inode, FI_DATA_EXIST);
207}
208
209static void recover_inode(struct inode *inode, struct page *page)
210{
211 struct f2fs_inode *raw = F2FS_INODE(page);
212 char *name;
213
214 inode->i_mode = le16_to_cpu(raw->i_mode);
215 f2fs_i_size_write(inode, le64_to_cpu(raw->i_size));
216 inode->i_atime.tv_sec = le64_to_cpu(raw->i_atime);
217 inode->i_ctime.tv_sec = le64_to_cpu(raw->i_ctime);
218 inode->i_mtime.tv_sec = le64_to_cpu(raw->i_mtime);
219 inode->i_atime.tv_nsec = le32_to_cpu(raw->i_atime_nsec);
220 inode->i_ctime.tv_nsec = le32_to_cpu(raw->i_ctime_nsec);
221 inode->i_mtime.tv_nsec = le32_to_cpu(raw->i_mtime_nsec);
222
223 F2FS_I(inode)->i_advise = raw->i_advise;
224 F2FS_I(inode)->i_flags = le32_to_cpu(raw->i_flags);
225
226 recover_inline_flags(inode, raw);
227
228 if (file_enc_name(inode))
229 name = "<encrypted>";
230 else
231 name = F2FS_INODE(page)->i_name;
232
233 f2fs_msg(inode->i_sb, KERN_NOTICE,
234 "recover_inode: ino = %x, name = %s, inline = %x",
235 ino_of_node(page), name, raw->i_inline);
236}
237
238static int find_fsync_dnodes(struct f2fs_sb_info *sbi, struct list_head *head,
239 bool check_only)
240{
241 struct curseg_info *curseg;
242 struct page *page = NULL;
243 block_t blkaddr;
244 unsigned int loop_cnt = 0;
245 unsigned int free_blocks = MAIN_SEGS(sbi) * sbi->blocks_per_seg -
246 valid_user_blocks(sbi);
247 int err = 0;
248
249 /* get node pages in the current segment */
250 curseg = CURSEG_I(sbi, CURSEG_WARM_NODE);
251 blkaddr = NEXT_FREE_BLKADDR(sbi, curseg);
252
253 while (1) {
254 struct fsync_inode_entry *entry;
255
256 if (!f2fs_is_valid_blkaddr(sbi, blkaddr, META_POR))
257 return 0;
258
259 page = f2fs_get_tmp_page(sbi, blkaddr);
260 if (IS_ERR(page)) {
261 err = PTR_ERR(page);
262 break;
263 }
264
265 if (!is_recoverable_dnode(page))
266 break;
267
268 if (!is_fsync_dnode(page))
269 goto next;
270
271 entry = get_fsync_inode(head, ino_of_node(page));
272 if (!entry) {
273 bool quota_inode = false;
274
275 if (!check_only &&
276 IS_INODE(page) && is_dent_dnode(page)) {
277 err = f2fs_recover_inode_page(sbi, page);
278 if (err)
279 break;
280 quota_inode = true;
281 }
282
283 /*
284 * CP | dnode(F) | inode(DF)
285 * For this case, we should not give up now.
286 */
287 entry = add_fsync_inode(sbi, head, ino_of_node(page),
288 quota_inode);
289 if (IS_ERR(entry)) {
290 err = PTR_ERR(entry);
291 if (err == -ENOENT) {
292 err = 0;
293 goto next;
294 }
295 break;
296 }
297 }
298 entry->blkaddr = blkaddr;
299
300 if (IS_INODE(page) && is_dent_dnode(page))
301 entry->last_dentry = blkaddr;
302next:
303 /* sanity check in order to detect looped node chain */
304 if (++loop_cnt >= free_blocks ||
305 blkaddr == next_blkaddr_of_node(page)) {
306 f2fs_msg(sbi->sb, KERN_NOTICE,
307 "%s: detect looped node chain, "
308 "blkaddr:%u, next:%u",
309 __func__, blkaddr, next_blkaddr_of_node(page));
310 err = -EINVAL;
311 break;
312 }
313
314 /* check next segment */
315 blkaddr = next_blkaddr_of_node(page);
316 f2fs_put_page(page, 1);
317
318 f2fs_ra_meta_pages_cond(sbi, blkaddr);
319 }
320 f2fs_put_page(page, 1);
321 return err;
322}
323
324static void destroy_fsync_dnodes(struct list_head *head)
325{
326 struct fsync_inode_entry *entry, *tmp;
327
328 list_for_each_entry_safe(entry, tmp, head, list)
329 del_fsync_inode(entry);
330}
331
332static int check_index_in_prev_nodes(struct f2fs_sb_info *sbi,
333 block_t blkaddr, struct dnode_of_data *dn)
334{
335 struct seg_entry *sentry;
336 unsigned int segno = GET_SEGNO(sbi, blkaddr);
337 unsigned short blkoff = GET_BLKOFF_FROM_SEG0(sbi, blkaddr);
338 struct f2fs_summary_block *sum_node;
339 struct f2fs_summary sum;
340 struct page *sum_page, *node_page;
341 struct dnode_of_data tdn = *dn;
342 nid_t ino, nid;
343 struct inode *inode;
344 unsigned int offset;
345 block_t bidx;
346 int i;
347
348 sentry = get_seg_entry(sbi, segno);
349 if (!f2fs_test_bit(blkoff, sentry->cur_valid_map))
350 return 0;
351
352 /* Get the previous summary */
353 for (i = CURSEG_HOT_DATA; i <= CURSEG_COLD_DATA; i++) {
354 struct curseg_info *curseg = CURSEG_I(sbi, i);
355 if (curseg->segno == segno) {
356 sum = curseg->sum_blk->entries[blkoff];
357 goto got_it;
358 }
359 }
360
361 sum_page = f2fs_get_sum_page(sbi, segno);
362 sum_node = (struct f2fs_summary_block *)page_address(sum_page);
363 sum = sum_node->entries[blkoff];
364 f2fs_put_page(sum_page, 1);
365got_it:
366 /* Use the locked dnode page and inode */
367 nid = le32_to_cpu(sum.nid);
368 if (dn->inode->i_ino == nid) {
369 tdn.nid = nid;
370 if (!dn->inode_page_locked)
371 lock_page(dn->inode_page);
372 tdn.node_page = dn->inode_page;
373 tdn.ofs_in_node = le16_to_cpu(sum.ofs_in_node);
374 goto truncate_out;
375 } else if (dn->nid == nid) {
376 tdn.ofs_in_node = le16_to_cpu(sum.ofs_in_node);
377 goto truncate_out;
378 }
379
380 /* Get the node page */
381 node_page = f2fs_get_node_page(sbi, nid);
382 if (IS_ERR(node_page))
383 return PTR_ERR(node_page);
384
385 offset = ofs_of_node(node_page);
386 ino = ino_of_node(node_page);
387 f2fs_put_page(node_page, 1);
388
389 if (ino != dn->inode->i_ino) {
390 int ret;
391
392 /* Deallocate previous index in the node page */
393 inode = f2fs_iget_retry(sbi->sb, ino);
394 if (IS_ERR(inode))
395 return PTR_ERR(inode);
396
397 ret = dquot_initialize(inode);
398 if (ret) {
399 iput(inode);
400 return ret;
401 }
402 } else {
403 inode = dn->inode;
404 }
405
406 bidx = f2fs_start_bidx_of_node(offset, inode) +
407 le16_to_cpu(sum.ofs_in_node);
408
409 /*
410 * if inode page is locked, unlock temporarily, but its reference
411 * count keeps alive.
412 */
413 if (ino == dn->inode->i_ino && dn->inode_page_locked)
414 unlock_page(dn->inode_page);
415
416 set_new_dnode(&tdn, inode, NULL, NULL, 0);
417 if (f2fs_get_dnode_of_data(&tdn, bidx, LOOKUP_NODE))
418 goto out;
419
420 if (tdn.data_blkaddr == blkaddr)
421 f2fs_truncate_data_blocks_range(&tdn, 1);
422
423 f2fs_put_dnode(&tdn);
424out:
425 if (ino != dn->inode->i_ino)
426 iput(inode);
427 else if (dn->inode_page_locked)
428 lock_page(dn->inode_page);
429 return 0;
430
431truncate_out:
432 if (datablock_addr(tdn.inode, tdn.node_page,
433 tdn.ofs_in_node) == blkaddr)
434 f2fs_truncate_data_blocks_range(&tdn, 1);
435 if (dn->inode->i_ino == nid && !dn->inode_page_locked)
436 unlock_page(dn->inode_page);
437 return 0;
438}
439
440static int do_recover_data(struct f2fs_sb_info *sbi, struct inode *inode,
441 struct page *page)
442{
443 struct dnode_of_data dn;
444 struct node_info ni;
445 unsigned int start, end;
446 int err = 0, recovered = 0;
447
448 /* step 1: recover xattr */
449 if (IS_INODE(page)) {
450 f2fs_recover_inline_xattr(inode, page);
451 } else if (f2fs_has_xattr_block(ofs_of_node(page))) {
452 err = f2fs_recover_xattr_data(inode, page);
453 if (!err)
454 recovered++;
455 goto out;
456 }
457
458 /* step 2: recover inline data */
459 if (f2fs_recover_inline_data(inode, page))
460 goto out;
461
462 /* step 3: recover data indices */
463 start = f2fs_start_bidx_of_node(ofs_of_node(page), inode);
464 end = start + ADDRS_PER_PAGE(page, inode);
465
466 set_new_dnode(&dn, inode, NULL, NULL, 0);
467retry_dn:
468 err = f2fs_get_dnode_of_data(&dn, start, ALLOC_NODE);
469 if (err) {
470 if (err == -ENOMEM) {
471 congestion_wait(BLK_RW_ASYNC, HZ/50);
472 goto retry_dn;
473 }
474 goto out;
475 }
476
477 f2fs_wait_on_page_writeback(dn.node_page, NODE, true);
478
479 err = f2fs_get_node_info(sbi, dn.nid, &ni);
480 if (err)
481 goto err;
482
483 f2fs_bug_on(sbi, ni.ino != ino_of_node(page));
484 f2fs_bug_on(sbi, ofs_of_node(dn.node_page) != ofs_of_node(page));
485
486 for (; start < end; start++, dn.ofs_in_node++) {
487 block_t src, dest;
488
489 src = datablock_addr(dn.inode, dn.node_page, dn.ofs_in_node);
490 dest = datablock_addr(dn.inode, page, dn.ofs_in_node);
491
492 /* skip recovering if dest is the same as src */
493 if (src == dest)
494 continue;
495
496 /* dest is invalid, just invalidate src block */
497 if (dest == NULL_ADDR) {
498 f2fs_truncate_data_blocks_range(&dn, 1);
499 continue;
500 }
501
502 if (!file_keep_isize(inode) &&
503 (i_size_read(inode) <= ((loff_t)start << PAGE_SHIFT)))
504 f2fs_i_size_write(inode,
505 (loff_t)(start + 1) << PAGE_SHIFT);
506
507 /*
508 * dest is reserved block, invalidate src block
509 * and then reserve one new block in dnode page.
510 */
511 if (dest == NEW_ADDR) {
512 f2fs_truncate_data_blocks_range(&dn, 1);
513 f2fs_reserve_new_block(&dn);
514 continue;
515 }
516
517 /* dest is valid block, try to recover from src to dest */
518 if (f2fs_is_valid_blkaddr(sbi, dest, META_POR)) {
519
520 if (src == NULL_ADDR) {
521 err = f2fs_reserve_new_block(&dn);
522 while (err &&
523 IS_ENABLED(CONFIG_F2FS_FAULT_INJECTION))
524 err = f2fs_reserve_new_block(&dn);
525 /* We should not get -ENOSPC */
526 f2fs_bug_on(sbi, err);
527 if (err)
528 goto err;
529 }
530retry_prev:
531 /* Check the previous node page having this index */
532 err = check_index_in_prev_nodes(sbi, dest, &dn);
533 if (err) {
534 if (err == -ENOMEM) {
535 congestion_wait(BLK_RW_ASYNC, HZ/50);
536 goto retry_prev;
537 }
538 goto err;
539 }
540
541 /* write dummy data page */
542 f2fs_replace_block(sbi, &dn, src, dest,
543 ni.version, false, false);
544 recovered++;
545 }
546 }
547
548 copy_node_footer(dn.node_page, page);
549 fill_node_footer(dn.node_page, dn.nid, ni.ino,
550 ofs_of_node(page), false);
551 set_page_dirty(dn.node_page);
552err:
553 f2fs_put_dnode(&dn);
554out:
555 f2fs_msg(sbi->sb, KERN_NOTICE,
556 "recover_data: ino = %lx (i_size: %s) recovered = %d, err = %d",
557 inode->i_ino,
558 file_keep_isize(inode) ? "keep" : "recover",
559 recovered, err);
560 return err;
561}
562
563static int recover_data(struct f2fs_sb_info *sbi, struct list_head *inode_list,
564 struct list_head *dir_list)
565{
566 struct curseg_info *curseg;
567 struct page *page = NULL;
568 int err = 0;
569 block_t blkaddr;
570
571 /* get node pages in the current segment */
572 curseg = CURSEG_I(sbi, CURSEG_WARM_NODE);
573 blkaddr = NEXT_FREE_BLKADDR(sbi, curseg);
574
575 while (1) {
576 struct fsync_inode_entry *entry;
577
578 if (!f2fs_is_valid_blkaddr(sbi, blkaddr, META_POR))
579 break;
580
581 f2fs_ra_meta_pages_cond(sbi, blkaddr);
582
583 page = f2fs_get_tmp_page(sbi, blkaddr);
584 if (IS_ERR(page)) {
585 err = PTR_ERR(page);
586 break;
587 }
588
589 if (!is_recoverable_dnode(page)) {
590 f2fs_put_page(page, 1);
591 break;
592 }
593
594 entry = get_fsync_inode(inode_list, ino_of_node(page));
595 if (!entry)
596 goto next;
597 /*
598 * inode(x) | CP | inode(x) | dnode(F)
599 * In this case, we can lose the latest inode(x).
600 * So, call recover_inode for the inode update.
601 */
602 if (IS_INODE(page))
603 recover_inode(entry->inode, page);
604 if (entry->last_dentry == blkaddr) {
605 err = recover_dentry(entry->inode, page, dir_list);
606 if (err) {
607 f2fs_put_page(page, 1);
608 break;
609 }
610 }
611 err = do_recover_data(sbi, entry->inode, page);
612 if (err) {
613 f2fs_put_page(page, 1);
614 break;
615 }
616
617 if (entry->blkaddr == blkaddr)
618 del_fsync_inode(entry);
619next:
620 /* check next segment */
621 blkaddr = next_blkaddr_of_node(page);
622 f2fs_put_page(page, 1);
623 }
624 if (!err)
625 f2fs_allocate_new_segments(sbi);
626 return err;
627}
628
629int f2fs_recover_fsync_data(struct f2fs_sb_info *sbi, bool check_only)
630{
631 struct list_head inode_list;
632 struct list_head dir_list;
633 int err;
634 int ret = 0;
635 unsigned long s_flags = sbi->sb->s_flags;
636 bool need_writecp = false;
637#ifdef CONFIG_QUOTA
638 int quota_enabled;
639#endif
640
641 if (s_flags & SB_RDONLY) {
642 f2fs_msg(sbi->sb, KERN_INFO,
643 "recover fsync data on readonly fs");
644 sbi->sb->s_flags &= ~SB_RDONLY;
645 }
646
647#ifdef CONFIG_QUOTA
648 /* Needed for iput() to work correctly and not trash data */
649 sbi->sb->s_flags |= SB_ACTIVE;
650 /* Turn on quotas so that they are updated correctly */
651 quota_enabled = f2fs_enable_quota_files(sbi, s_flags & SB_RDONLY);
652#endif
653
654 fsync_entry_slab = f2fs_kmem_cache_create("f2fs_fsync_inode_entry",
655 sizeof(struct fsync_inode_entry));
656 if (!fsync_entry_slab) {
657 err = -ENOMEM;
658 goto out;
659 }
660
661 INIT_LIST_HEAD(&inode_list);
662 INIT_LIST_HEAD(&dir_list);
663
664 /* prevent checkpoint */
665 mutex_lock(&sbi->cp_mutex);
666
667 /* step #1: find fsynced inode numbers */
668 err = find_fsync_dnodes(sbi, &inode_list, check_only);
669 if (err || list_empty(&inode_list))
670 goto skip;
671
672 if (check_only) {
673 ret = 1;
674 goto skip;
675 }
676
677 need_writecp = true;
678
679 /* step #2: recover data */
680 err = recover_data(sbi, &inode_list, &dir_list);
681 if (!err)
682 f2fs_bug_on(sbi, !list_empty(&inode_list));
683skip:
684 destroy_fsync_dnodes(&inode_list);
685
686 /* truncate meta pages to be used by the recovery */
687 truncate_inode_pages_range(META_MAPPING(sbi),
688 (loff_t)MAIN_BLKADDR(sbi) << PAGE_SHIFT, -1);
689
690 if (err) {
691 truncate_inode_pages_final(NODE_MAPPING(sbi));
692 truncate_inode_pages_final(META_MAPPING(sbi));
693 }
694
695 clear_sbi_flag(sbi, SBI_POR_DOING);
696 mutex_unlock(&sbi->cp_mutex);
697
698 /* let's drop all the directory inodes for clean checkpoint */
699 destroy_fsync_dnodes(&dir_list);
700
701 if (need_writecp) {
702 set_sbi_flag(sbi, SBI_IS_RECOVERED);
703
704 if (!err) {
705 struct cp_control cpc = {
706 .reason = CP_RECOVERY,
707 };
708 err = f2fs_write_checkpoint(sbi, &cpc);
709 }
710 }
711
712 kmem_cache_destroy(fsync_entry_slab);
713out:
714#ifdef CONFIG_QUOTA
715 /* Turn quotas off */
716 if (quota_enabled)
717 f2fs_quota_off_umount(sbi->sb);
718#endif
719 sbi->sb->s_flags = s_flags; /* Restore SB_RDONLY status */
720
721 return ret ? ret: err;
722}