1 // SPDX-License-Identifier: GPL-2.0-only 2 /* 3 * This file is part of UBIFS. 4 * 5 * Copyright (C) 2006-2008 Nokia Corporation. 6 * 7 * Authors: Artem Bityutskiy (Битюцкий Артём) 8 * Adrian Hunter 9 */ 10 11 /* 12 * This file implements UBIFS journal. 13 * 14 * The journal consists of 2 parts - the log and bud LEBs. The log has fixed 15 * length and position, while a bud logical eraseblock is any LEB in the main 16 * area. Buds contain file system data - data nodes, inode nodes, etc. The log 17 * contains only references to buds and some other stuff like commit 18 * start node. The idea is that when we commit the journal, we do 19 * not copy the data, the buds just become indexed. Since after the commit the 20 * nodes in bud eraseblocks become leaf nodes of the file system index tree, we 21 * use term "bud". Analogy is obvious, bud eraseblocks contain nodes which will 22 * become leafs in the future. 23 * 24 * The journal is multi-headed because we want to write data to the journal as 25 * optimally as possible. It is nice to have nodes belonging to the same inode 26 * in one LEB, so we may write data owned by different inodes to different 27 * journal heads, although at present only one data head is used. 28 * 29 * For recovery reasons, the base head contains all inode nodes, all directory 30 * entry nodes and all truncate nodes. This means that the other heads contain 31 * only data nodes. 32 * 33 * Bud LEBs may be half-indexed. For example, if the bud was not full at the 34 * time of commit, the bud is retained to continue to be used in the journal, 35 * even though the "front" of the LEB is now indexed. In that case, the log 36 * reference contains the offset where the bud starts for the purposes of the 37 * journal. 38 * 39 * The journal size has to be limited, because the larger is the journal, the 40 * longer it takes to mount UBIFS (scanning the journal) and the more memory it 41 * takes (indexing in the TNC). 42 * 43 * All the journal write operations like 'ubifs_jnl_update()' here, which write 44 * multiple UBIFS nodes to the journal at one go, are atomic with respect to 45 * unclean reboots. Should the unclean reboot happen, the recovery code drops 46 * all the nodes. 47 */ 48 49 #include "ubifs.h" 50 51 /** 52 * zero_ino_node_unused - zero out unused fields of an on-flash inode node. 53 * @ino: the inode to zero out 54 */ 55 static inline void zero_ino_node_unused(struct ubifs_ino_node *ino) 56 { 57 memset(ino->padding1, 0, 4); 58 memset(ino->padding2, 0, 26); 59 } 60 61 /** 62 * zero_dent_node_unused - zero out unused fields of an on-flash directory 63 * entry node. 64 * @dent: the directory entry to zero out 65 */ 66 static inline void zero_dent_node_unused(struct ubifs_dent_node *dent) 67 { 68 dent->padding1 = 0; 69 } 70 71 /** 72 * zero_trun_node_unused - zero out unused fields of an on-flash truncation 73 * node. 74 * @trun: the truncation node to zero out 75 */ 76 static inline void zero_trun_node_unused(struct ubifs_trun_node *trun) 77 { 78 memset(trun->padding, 0, 12); 79 } 80 81 static void ubifs_add_auth_dirt(struct ubifs_info *c, int lnum) 82 { 83 if (ubifs_authenticated(c)) 84 ubifs_add_dirt(c, lnum, ubifs_auth_node_sz(c)); 85 } 86 87 /** 88 * reserve_space - reserve space in the journal. 89 * @c: UBIFS file-system description object 90 * @jhead: journal head number 91 * @len: node length 92 * 93 * This function reserves space in journal head @head. If the reservation 94 * succeeded, the journal head stays locked and later has to be unlocked using 95 * 'release_head()'. Returns zero in case of success, %-EAGAIN if commit has to 96 * be done, and other negative error codes in case of other failures. 97 */ 98 static int reserve_space(struct ubifs_info *c, int jhead, int len) 99 { 100 int err = 0, err1, retries = 0, avail, lnum, offs, squeeze; 101 struct ubifs_wbuf *wbuf = &c->jheads[jhead].wbuf; 102 103 /* 104 * Typically, the base head has smaller nodes written to it, so it is 105 * better to try to allocate space at the ends of eraseblocks. This is 106 * what the squeeze parameter does. 107 */ 108 ubifs_assert(c, !c->ro_media && !c->ro_mount); 109 squeeze = (jhead == BASEHD); 110 again: 111 mutex_lock_nested(&wbuf->io_mutex, wbuf->jhead); 112 113 if (c->ro_error) { 114 err = -EROFS; 115 goto out_unlock; 116 } 117 118 avail = c->leb_size - wbuf->offs - wbuf->used; 119 if (wbuf->lnum != -1 && avail >= len) 120 return 0; 121 122 /* 123 * Write buffer wasn't seek'ed or there is no enough space - look for an 124 * LEB with some empty space. 125 */ 126 lnum = ubifs_find_free_space(c, len, &offs, squeeze); 127 if (lnum >= 0) 128 goto out; 129 130 err = lnum; 131 if (err != -ENOSPC) 132 goto out_unlock; 133 134 /* 135 * No free space, we have to run garbage collector to make 136 * some. But the write-buffer mutex has to be unlocked because 137 * GC also takes it. 138 */ 139 dbg_jnl("no free space in jhead %s, run GC", dbg_jhead(jhead)); 140 mutex_unlock(&wbuf->io_mutex); 141 142 lnum = ubifs_garbage_collect(c, 0); 143 if (lnum < 0) { 144 err = lnum; 145 if (err != -ENOSPC) 146 return err; 147 148 /* 149 * GC could not make a free LEB. But someone else may 150 * have allocated new bud for this journal head, 151 * because we dropped @wbuf->io_mutex, so try once 152 * again. 153 */ 154 dbg_jnl("GC couldn't make a free LEB for jhead %s", 155 dbg_jhead(jhead)); 156 if (retries++ < 2) { 157 dbg_jnl("retry (%d)", retries); 158 goto again; 159 } 160 161 dbg_jnl("return -ENOSPC"); 162 return err; 163 } 164 165 mutex_lock_nested(&wbuf->io_mutex, wbuf->jhead); 166 dbg_jnl("got LEB %d for jhead %s", lnum, dbg_jhead(jhead)); 167 avail = c->leb_size - wbuf->offs - wbuf->used; 168 169 if (wbuf->lnum != -1 && avail >= len) { 170 /* 171 * Someone else has switched the journal head and we have 172 * enough space now. This happens when more than one process is 173 * trying to write to the same journal head at the same time. 174 */ 175 dbg_jnl("return LEB %d back, already have LEB %d:%d", 176 lnum, wbuf->lnum, wbuf->offs + wbuf->used); 177 err = ubifs_return_leb(c, lnum); 178 if (err) 179 goto out_unlock; 180 return 0; 181 } 182 183 offs = 0; 184 185 out: 186 /* 187 * Make sure we synchronize the write-buffer before we add the new bud 188 * to the log. Otherwise we may have a power cut after the log 189 * reference node for the last bud (@lnum) is written but before the 190 * write-buffer data are written to the next-to-last bud 191 * (@wbuf->lnum). And the effect would be that the recovery would see 192 * that there is corruption in the next-to-last bud. 193 */ 194 err = ubifs_wbuf_sync_nolock(wbuf); 195 if (err) 196 goto out_return; 197 err = ubifs_add_bud_to_log(c, jhead, lnum, offs); 198 if (err) 199 goto out_return; 200 err = ubifs_wbuf_seek_nolock(wbuf, lnum, offs); 201 if (err) 202 goto out_unlock; 203 204 return 0; 205 206 out_unlock: 207 mutex_unlock(&wbuf->io_mutex); 208 return err; 209 210 out_return: 211 /* An error occurred and the LEB has to be returned to lprops */ 212 ubifs_assert(c, err < 0); 213 err1 = ubifs_return_leb(c, lnum); 214 if (err1 && err == -EAGAIN) 215 /* 216 * Return original error code only if it is not %-EAGAIN, 217 * which is not really an error. Otherwise, return the error 218 * code of 'ubifs_return_leb()'. 219 */ 220 err = err1; 221 mutex_unlock(&wbuf->io_mutex); 222 return err; 223 } 224 225 static int ubifs_hash_nodes(struct ubifs_info *c, void *node, 226 int len, struct shash_desc *hash) 227 { 228 int auth_node_size = ubifs_auth_node_sz(c); 229 int err; 230 231 while (1) { 232 const struct ubifs_ch *ch = node; 233 int nodelen = le32_to_cpu(ch->len); 234 235 ubifs_assert(c, len >= auth_node_size); 236 237 if (len == auth_node_size) 238 break; 239 240 ubifs_assert(c, len > nodelen); 241 ubifs_assert(c, ch->magic == cpu_to_le32(UBIFS_NODE_MAGIC)); 242 243 err = ubifs_shash_update(c, hash, (void *)node, nodelen); 244 if (err) 245 return err; 246 247 node += ALIGN(nodelen, 8); 248 len -= ALIGN(nodelen, 8); 249 } 250 251 return ubifs_prepare_auth_node(c, node, hash); 252 } 253 254 /** 255 * write_head - write data to a journal head. 256 * @c: UBIFS file-system description object 257 * @jhead: journal head 258 * @buf: buffer to write 259 * @len: length to write 260 * @lnum: LEB number written is returned here 261 * @offs: offset written is returned here 262 * @sync: non-zero if the write-buffer has to by synchronized 263 * 264 * This function writes data to the reserved space of journal head @jhead. 265 * Returns zero in case of success and a negative error code in case of 266 * failure. 267 */ 268 static int write_head(struct ubifs_info *c, int jhead, void *buf, int len, 269 int *lnum, int *offs, int sync) 270 { 271 int err; 272 struct ubifs_wbuf *wbuf = &c->jheads[jhead].wbuf; 273 274 ubifs_assert(c, jhead != GCHD); 275 276 *lnum = c->jheads[jhead].wbuf.lnum; 277 *offs = c->jheads[jhead].wbuf.offs + c->jheads[jhead].wbuf.used; 278 dbg_jnl("jhead %s, LEB %d:%d, len %d", 279 dbg_jhead(jhead), *lnum, *offs, len); 280 281 if (ubifs_authenticated(c)) { 282 err = ubifs_hash_nodes(c, buf, len, c->jheads[jhead].log_hash); 283 if (err) 284 return err; 285 } 286 287 err = ubifs_wbuf_write_nolock(wbuf, buf, len); 288 if (err) 289 return err; 290 if (sync) 291 err = ubifs_wbuf_sync_nolock(wbuf); 292 return err; 293 } 294 295 /** 296 * make_reservation - reserve journal space. 297 * @c: UBIFS file-system description object 298 * @jhead: journal head 299 * @len: how many bytes to reserve 300 * 301 * This function makes space reservation in journal head @jhead. The function 302 * takes the commit lock and locks the journal head, and the caller has to 303 * unlock the head and finish the reservation with 'finish_reservation()'. 304 * Returns zero in case of success and a negative error code in case of 305 * failure. 306 * 307 * Note, the journal head may be unlocked as soon as the data is written, while 308 * the commit lock has to be released after the data has been added to the 309 * TNC. 310 */ 311 static int make_reservation(struct ubifs_info *c, int jhead, int len) 312 { 313 int err, cmt_retries = 0, nospc_retries = 0; 314 315 again: 316 down_read(&c->commit_sem); 317 err = reserve_space(c, jhead, len); 318 if (!err) 319 /* c->commit_sem will get released via finish_reservation(). */ 320 return 0; 321 up_read(&c->commit_sem); 322 323 if (err == -ENOSPC) { 324 /* 325 * GC could not make any progress. We should try to commit 326 * once because it could make some dirty space and GC would 327 * make progress, so make the error -EAGAIN so that the below 328 * will commit and re-try. 329 */ 330 if (nospc_retries++ < 2) { 331 dbg_jnl("no space, retry"); 332 err = -EAGAIN; 333 } 334 335 /* 336 * This means that the budgeting is incorrect. We always have 337 * to be able to write to the media, because all operations are 338 * budgeted. Deletions are not budgeted, though, but we reserve 339 * an extra LEB for them. 340 */ 341 } 342 343 if (err != -EAGAIN) 344 goto out; 345 346 /* 347 * -EAGAIN means that the journal is full or too large, or the above 348 * code wants to do one commit. Do this and re-try. 349 */ 350 if (cmt_retries > 128) { 351 /* 352 * This should not happen unless the journal size limitations 353 * are too tough. 354 */ 355 ubifs_err(c, "stuck in space allocation"); 356 err = -ENOSPC; 357 goto out; 358 } else if (cmt_retries > 32) 359 ubifs_warn(c, "too many space allocation re-tries (%d)", 360 cmt_retries); 361 362 dbg_jnl("-EAGAIN, commit and retry (retried %d times)", 363 cmt_retries); 364 cmt_retries += 1; 365 366 err = ubifs_run_commit(c); 367 if (err) 368 return err; 369 goto again; 370 371 out: 372 ubifs_err(c, "cannot reserve %d bytes in jhead %d, error %d", 373 len, jhead, err); 374 if (err == -ENOSPC) { 375 /* This are some budgeting problems, print useful information */ 376 down_write(&c->commit_sem); 377 dump_stack(); 378 ubifs_dump_budg(c, &c->bi); 379 ubifs_dump_lprops(c); 380 cmt_retries = dbg_check_lprops(c); 381 up_write(&c->commit_sem); 382 } 383 return err; 384 } 385 386 /** 387 * release_head - release a journal head. 388 * @c: UBIFS file-system description object 389 * @jhead: journal head 390 * 391 * This function releases journal head @jhead which was locked by 392 * the 'make_reservation()' function. It has to be called after each successful 393 * 'make_reservation()' invocation. 394 */ 395 static inline void release_head(struct ubifs_info *c, int jhead) 396 { 397 mutex_unlock(&c->jheads[jhead].wbuf.io_mutex); 398 } 399 400 /** 401 * finish_reservation - finish a reservation. 402 * @c: UBIFS file-system description object 403 * 404 * This function finishes journal space reservation. It must be called after 405 * 'make_reservation()'. 406 */ 407 static void finish_reservation(struct ubifs_info *c) 408 { 409 up_read(&c->commit_sem); 410 } 411 412 /** 413 * get_dent_type - translate VFS inode mode to UBIFS directory entry type. 414 * @mode: inode mode 415 */ 416 static int get_dent_type(int mode) 417 { 418 switch (mode & S_IFMT) { 419 case S_IFREG: 420 return UBIFS_ITYPE_REG; 421 case S_IFDIR: 422 return UBIFS_ITYPE_DIR; 423 case S_IFLNK: 424 return UBIFS_ITYPE_LNK; 425 case S_IFBLK: 426 return UBIFS_ITYPE_BLK; 427 case S_IFCHR: 428 return UBIFS_ITYPE_CHR; 429 case S_IFIFO: 430 return UBIFS_ITYPE_FIFO; 431 case S_IFSOCK: 432 return UBIFS_ITYPE_SOCK; 433 default: 434 BUG(); 435 } 436 return 0; 437 } 438 439 /** 440 * pack_inode - pack an inode node. 441 * @c: UBIFS file-system description object 442 * @ino: buffer in which to pack inode node 443 * @inode: inode to pack 444 * @last: indicates the last node of the group 445 */ 446 static void pack_inode(struct ubifs_info *c, struct ubifs_ino_node *ino, 447 const struct inode *inode, int last) 448 { 449 int data_len = 0, last_reference = !inode->i_nlink; 450 struct ubifs_inode *ui = ubifs_inode(inode); 451 452 ino->ch.node_type = UBIFS_INO_NODE; 453 ino_key_init_flash(c, &ino->key, inode->i_ino); 454 ino->creat_sqnum = cpu_to_le64(ui->creat_sqnum); 455 ino->atime_sec = cpu_to_le64(inode->i_atime.tv_sec); 456 ino->atime_nsec = cpu_to_le32(inode->i_atime.tv_nsec); 457 ino->ctime_sec = cpu_to_le64(inode->i_ctime.tv_sec); 458 ino->ctime_nsec = cpu_to_le32(inode->i_ctime.tv_nsec); 459 ino->mtime_sec = cpu_to_le64(inode->i_mtime.tv_sec); 460 ino->mtime_nsec = cpu_to_le32(inode->i_mtime.tv_nsec); 461 ino->uid = cpu_to_le32(i_uid_read(inode)); 462 ino->gid = cpu_to_le32(i_gid_read(inode)); 463 ino->mode = cpu_to_le32(inode->i_mode); 464 ino->flags = cpu_to_le32(ui->flags); 465 ino->size = cpu_to_le64(ui->ui_size); 466 ino->nlink = cpu_to_le32(inode->i_nlink); 467 ino->compr_type = cpu_to_le16(ui->compr_type); 468 ino->data_len = cpu_to_le32(ui->data_len); 469 ino->xattr_cnt = cpu_to_le32(ui->xattr_cnt); 470 ino->xattr_size = cpu_to_le32(ui->xattr_size); 471 ino->xattr_names = cpu_to_le32(ui->xattr_names); 472 zero_ino_node_unused(ino); 473 474 /* 475 * Drop the attached data if this is a deletion inode, the data is not 476 * needed anymore. 477 */ 478 if (!last_reference) { 479 memcpy(ino->data, ui->data, ui->data_len); 480 data_len = ui->data_len; 481 } 482 483 ubifs_prep_grp_node(c, ino, UBIFS_INO_NODE_SZ + data_len, last); 484 } 485 486 /** 487 * mark_inode_clean - mark UBIFS inode as clean. 488 * @c: UBIFS file-system description object 489 * @ui: UBIFS inode to mark as clean 490 * 491 * This helper function marks UBIFS inode @ui as clean by cleaning the 492 * @ui->dirty flag and releasing its budget. Note, VFS may still treat the 493 * inode as dirty and try to write it back, but 'ubifs_write_inode()' would 494 * just do nothing. 495 */ 496 static void mark_inode_clean(struct ubifs_info *c, struct ubifs_inode *ui) 497 { 498 if (ui->dirty) 499 ubifs_release_dirty_inode_budget(c, ui); 500 ui->dirty = 0; 501 } 502 503 static void set_dent_cookie(struct ubifs_info *c, struct ubifs_dent_node *dent) 504 { 505 if (c->double_hash) 506 dent->cookie = (__force __le32) prandom_u32(); 507 else 508 dent->cookie = 0; 509 } 510 511 /** 512 * ubifs_jnl_update - update inode. 513 * @c: UBIFS file-system description object 514 * @dir: parent inode or host inode in case of extended attributes 515 * @nm: directory entry name 516 * @inode: inode to update 517 * @deletion: indicates a directory entry deletion i.e unlink or rmdir 518 * @xent: non-zero if the directory entry is an extended attribute entry 519 * 520 * This function updates an inode by writing a directory entry (or extended 521 * attribute entry), the inode itself, and the parent directory inode (or the 522 * host inode) to the journal. 523 * 524 * The function writes the host inode @dir last, which is important in case of 525 * extended attributes. Indeed, then we guarantee that if the host inode gets 526 * synchronized (with 'fsync()'), and the write-buffer it sits in gets flushed, 527 * the extended attribute inode gets flushed too. And this is exactly what the 528 * user expects - synchronizing the host inode synchronizes its extended 529 * attributes. Similarly, this guarantees that if @dir is synchronized, its 530 * directory entry corresponding to @nm gets synchronized too. 531 * 532 * If the inode (@inode) or the parent directory (@dir) are synchronous, this 533 * function synchronizes the write-buffer. 534 * 535 * This function marks the @dir and @inode inodes as clean and returns zero on 536 * success. In case of failure, a negative error code is returned. 537 */ 538 int ubifs_jnl_update(struct ubifs_info *c, const struct inode *dir, 539 const struct fscrypt_name *nm, const struct inode *inode, 540 int deletion, int xent) 541 { 542 int err, dlen, ilen, len, lnum, ino_offs, dent_offs, orphan_added = 0; 543 int aligned_dlen, aligned_ilen, sync = IS_DIRSYNC(dir); 544 int last_reference = !!(deletion && inode->i_nlink == 0); 545 struct ubifs_inode *ui = ubifs_inode(inode); 546 struct ubifs_inode *host_ui = ubifs_inode(dir); 547 struct ubifs_dent_node *dent; 548 struct ubifs_ino_node *ino; 549 union ubifs_key dent_key, ino_key; 550 u8 hash_dent[UBIFS_HASH_ARR_SZ]; 551 u8 hash_ino[UBIFS_HASH_ARR_SZ]; 552 u8 hash_ino_host[UBIFS_HASH_ARR_SZ]; 553 554 ubifs_assert(c, mutex_is_locked(&host_ui->ui_mutex)); 555 556 dlen = UBIFS_DENT_NODE_SZ + fname_len(nm) + 1; 557 ilen = UBIFS_INO_NODE_SZ; 558 559 /* 560 * If the last reference to the inode is being deleted, then there is 561 * no need to attach and write inode data, it is being deleted anyway. 562 * And if the inode is being deleted, no need to synchronize 563 * write-buffer even if the inode is synchronous. 564 */ 565 if (!last_reference) { 566 ilen += ui->data_len; 567 sync |= IS_SYNC(inode); 568 } 569 570 aligned_dlen = ALIGN(dlen, 8); 571 aligned_ilen = ALIGN(ilen, 8); 572 573 len = aligned_dlen + aligned_ilen + UBIFS_INO_NODE_SZ; 574 /* Make sure to also account for extended attributes */ 575 if (ubifs_authenticated(c)) 576 len += ALIGN(host_ui->data_len, 8) + ubifs_auth_node_sz(c); 577 else 578 len += host_ui->data_len; 579 580 dent = kzalloc(len, GFP_NOFS); 581 if (!dent) 582 return -ENOMEM; 583 584 /* Make reservation before allocating sequence numbers */ 585 err = make_reservation(c, BASEHD, len); 586 if (err) 587 goto out_free; 588 589 if (!xent) { 590 dent->ch.node_type = UBIFS_DENT_NODE; 591 if (fname_name(nm) == NULL) 592 dent_key_init_hash(c, &dent_key, dir->i_ino, nm->hash); 593 else 594 dent_key_init(c, &dent_key, dir->i_ino, nm); 595 } else { 596 dent->ch.node_type = UBIFS_XENT_NODE; 597 xent_key_init(c, &dent_key, dir->i_ino, nm); 598 } 599 600 key_write(c, &dent_key, dent->key); 601 dent->inum = deletion ? 0 : cpu_to_le64(inode->i_ino); 602 dent->type = get_dent_type(inode->i_mode); 603 dent->nlen = cpu_to_le16(fname_len(nm)); 604 memcpy(dent->name, fname_name(nm), fname_len(nm)); 605 dent->name[fname_len(nm)] = '\0'; 606 set_dent_cookie(c, dent); 607 608 zero_dent_node_unused(dent); 609 ubifs_prep_grp_node(c, dent, dlen, 0); 610 err = ubifs_node_calc_hash(c, dent, hash_dent); 611 if (err) 612 goto out_release; 613 614 ino = (void *)dent + aligned_dlen; 615 pack_inode(c, ino, inode, 0); 616 err = ubifs_node_calc_hash(c, ino, hash_ino); 617 if (err) 618 goto out_release; 619 620 ino = (void *)ino + aligned_ilen; 621 pack_inode(c, ino, dir, 1); 622 err = ubifs_node_calc_hash(c, ino, hash_ino_host); 623 if (err) 624 goto out_release; 625 626 if (last_reference) { 627 err = ubifs_add_orphan(c, inode->i_ino); 628 if (err) { 629 release_head(c, BASEHD); 630 goto out_finish; 631 } 632 ui->del_cmtno = c->cmt_no; 633 orphan_added = 1; 634 } 635 636 err = write_head(c, BASEHD, dent, len, &lnum, &dent_offs, sync); 637 if (err) 638 goto out_release; 639 if (!sync) { 640 struct ubifs_wbuf *wbuf = &c->jheads[BASEHD].wbuf; 641 642 ubifs_wbuf_add_ino_nolock(wbuf, inode->i_ino); 643 ubifs_wbuf_add_ino_nolock(wbuf, dir->i_ino); 644 } 645 release_head(c, BASEHD); 646 kfree(dent); 647 ubifs_add_auth_dirt(c, lnum); 648 649 if (deletion) { 650 if (fname_name(nm) == NULL) 651 err = ubifs_tnc_remove_dh(c, &dent_key, nm->minor_hash); 652 else 653 err = ubifs_tnc_remove_nm(c, &dent_key, nm); 654 if (err) 655 goto out_ro; 656 err = ubifs_add_dirt(c, lnum, dlen); 657 } else 658 err = ubifs_tnc_add_nm(c, &dent_key, lnum, dent_offs, dlen, 659 hash_dent, nm); 660 if (err) 661 goto out_ro; 662 663 /* 664 * Note, we do not remove the inode from TNC even if the last reference 665 * to it has just been deleted, because the inode may still be opened. 666 * Instead, the inode has been added to orphan lists and the orphan 667 * subsystem will take further care about it. 668 */ 669 ino_key_init(c, &ino_key, inode->i_ino); 670 ino_offs = dent_offs + aligned_dlen; 671 err = ubifs_tnc_add(c, &ino_key, lnum, ino_offs, ilen, hash_ino); 672 if (err) 673 goto out_ro; 674 675 ino_key_init(c, &ino_key, dir->i_ino); 676 ino_offs += aligned_ilen; 677 err = ubifs_tnc_add(c, &ino_key, lnum, ino_offs, 678 UBIFS_INO_NODE_SZ + host_ui->data_len, hash_ino_host); 679 if (err) 680 goto out_ro; 681 682 finish_reservation(c); 683 spin_lock(&ui->ui_lock); 684 ui->synced_i_size = ui->ui_size; 685 spin_unlock(&ui->ui_lock); 686 if (xent) { 687 spin_lock(&host_ui->ui_lock); 688 host_ui->synced_i_size = host_ui->ui_size; 689 spin_unlock(&host_ui->ui_lock); 690 } 691 mark_inode_clean(c, ui); 692 mark_inode_clean(c, host_ui); 693 return 0; 694 695 out_finish: 696 finish_reservation(c); 697 out_free: 698 kfree(dent); 699 return err; 700 701 out_release: 702 release_head(c, BASEHD); 703 kfree(dent); 704 out_ro: 705 ubifs_ro_mode(c, err); 706 if (orphan_added) 707 ubifs_delete_orphan(c, inode->i_ino); 708 finish_reservation(c); 709 return err; 710 } 711 712 /** 713 * ubifs_jnl_write_data - write a data node to the journal. 714 * @c: UBIFS file-system description object 715 * @inode: inode the data node belongs to 716 * @key: node key 717 * @buf: buffer to write 718 * @len: data length (must not exceed %UBIFS_BLOCK_SIZE) 719 * 720 * This function writes a data node to the journal. Returns %0 if the data node 721 * was successfully written, and a negative error code in case of failure. 722 */ 723 int ubifs_jnl_write_data(struct ubifs_info *c, const struct inode *inode, 724 const union ubifs_key *key, const void *buf, int len) 725 { 726 struct ubifs_data_node *data; 727 int err, lnum, offs, compr_type, out_len, compr_len, auth_len; 728 int dlen = COMPRESSED_DATA_NODE_BUF_SZ, allocated = 1; 729 int write_len; 730 struct ubifs_inode *ui = ubifs_inode(inode); 731 bool encrypted = IS_ENCRYPTED(inode); 732 u8 hash[UBIFS_HASH_ARR_SZ]; 733 734 dbg_jnlk(key, "ino %lu, blk %u, len %d, key ", 735 (unsigned long)key_inum(c, key), key_block(c, key), len); 736 ubifs_assert(c, len <= UBIFS_BLOCK_SIZE); 737 738 if (encrypted) 739 dlen += UBIFS_CIPHER_BLOCK_SIZE; 740 741 auth_len = ubifs_auth_node_sz(c); 742 743 data = kmalloc(dlen + auth_len, GFP_NOFS | __GFP_NOWARN); 744 if (!data) { 745 /* 746 * Fall-back to the write reserve buffer. Note, we might be 747 * currently on the memory reclaim path, when the kernel is 748 * trying to free some memory by writing out dirty pages. The 749 * write reserve buffer helps us to guarantee that we are 750 * always able to write the data. 751 */ 752 allocated = 0; 753 mutex_lock(&c->write_reserve_mutex); 754 data = c->write_reserve_buf; 755 } 756 757 data->ch.node_type = UBIFS_DATA_NODE; 758 key_write(c, key, &data->key); 759 data->size = cpu_to_le32(len); 760 761 if (!(ui->flags & UBIFS_COMPR_FL)) 762 /* Compression is disabled for this inode */ 763 compr_type = UBIFS_COMPR_NONE; 764 else 765 compr_type = ui->compr_type; 766 767 out_len = compr_len = dlen - UBIFS_DATA_NODE_SZ; 768 ubifs_compress(c, buf, len, &data->data, &compr_len, &compr_type); 769 ubifs_assert(c, compr_len <= UBIFS_BLOCK_SIZE); 770 771 if (encrypted) { 772 err = ubifs_encrypt(inode, data, compr_len, &out_len, key_block(c, key)); 773 if (err) 774 goto out_free; 775 776 } else { 777 data->compr_size = 0; 778 out_len = compr_len; 779 } 780 781 dlen = UBIFS_DATA_NODE_SZ + out_len; 782 if (ubifs_authenticated(c)) 783 write_len = ALIGN(dlen, 8) + auth_len; 784 else 785 write_len = dlen; 786 787 data->compr_type = cpu_to_le16(compr_type); 788 789 /* Make reservation before allocating sequence numbers */ 790 err = make_reservation(c, DATAHD, write_len); 791 if (err) 792 goto out_free; 793 794 ubifs_prepare_node(c, data, dlen, 0); 795 err = write_head(c, DATAHD, data, write_len, &lnum, &offs, 0); 796 if (err) 797 goto out_release; 798 799 err = ubifs_node_calc_hash(c, data, hash); 800 if (err) 801 goto out_release; 802 803 ubifs_wbuf_add_ino_nolock(&c->jheads[DATAHD].wbuf, key_inum(c, key)); 804 release_head(c, DATAHD); 805 806 ubifs_add_auth_dirt(c, lnum); 807 808 err = ubifs_tnc_add(c, key, lnum, offs, dlen, hash); 809 if (err) 810 goto out_ro; 811 812 finish_reservation(c); 813 if (!allocated) 814 mutex_unlock(&c->write_reserve_mutex); 815 else 816 kfree(data); 817 return 0; 818 819 out_release: 820 release_head(c, DATAHD); 821 out_ro: 822 ubifs_ro_mode(c, err); 823 finish_reservation(c); 824 out_free: 825 if (!allocated) 826 mutex_unlock(&c->write_reserve_mutex); 827 else 828 kfree(data); 829 return err; 830 } 831 832 /** 833 * ubifs_jnl_write_inode - flush inode to the journal. 834 * @c: UBIFS file-system description object 835 * @inode: inode to flush 836 * 837 * This function writes inode @inode to the journal. If the inode is 838 * synchronous, it also synchronizes the write-buffer. Returns zero in case of 839 * success and a negative error code in case of failure. 840 */ 841 int ubifs_jnl_write_inode(struct ubifs_info *c, const struct inode *inode) 842 { 843 int err, lnum, offs; 844 struct ubifs_ino_node *ino, *ino_start; 845 struct ubifs_inode *ui = ubifs_inode(inode); 846 int sync = 0, write_len = 0, ilen = UBIFS_INO_NODE_SZ; 847 int last_reference = !inode->i_nlink; 848 int kill_xattrs = ui->xattr_cnt && last_reference; 849 u8 hash[UBIFS_HASH_ARR_SZ]; 850 851 dbg_jnl("ino %lu, nlink %u", inode->i_ino, inode->i_nlink); 852 853 /* 854 * If the inode is being deleted, do not write the attached data. No 855 * need to synchronize the write-buffer either. 856 */ 857 if (!last_reference) { 858 ilen += ui->data_len; 859 sync = IS_SYNC(inode); 860 } else if (kill_xattrs) { 861 write_len += UBIFS_INO_NODE_SZ * ui->xattr_cnt; 862 } 863 864 if (ubifs_authenticated(c)) 865 write_len += ALIGN(ilen, 8) + ubifs_auth_node_sz(c); 866 else 867 write_len += ilen; 868 869 ino_start = ino = kmalloc(write_len, GFP_NOFS); 870 if (!ino) 871 return -ENOMEM; 872 873 /* Make reservation before allocating sequence numbers */ 874 err = make_reservation(c, BASEHD, write_len); 875 if (err) 876 goto out_free; 877 878 if (kill_xattrs) { 879 union ubifs_key key; 880 struct fscrypt_name nm = {0}; 881 struct inode *xino; 882 struct ubifs_dent_node *xent, *pxent = NULL; 883 884 if (ui->xattr_cnt >= ubifs_xattr_max_cnt(c)) { 885 ubifs_err(c, "Cannot delete inode, it has too much xattrs!"); 886 goto out_release; 887 } 888 889 lowest_xent_key(c, &key, inode->i_ino); 890 while (1) { 891 xent = ubifs_tnc_next_ent(c, &key, &nm); 892 if (IS_ERR(xent)) { 893 err = PTR_ERR(xent); 894 if (err == -ENOENT) 895 break; 896 897 goto out_release; 898 } 899 900 fname_name(&nm) = xent->name; 901 fname_len(&nm) = le16_to_cpu(xent->nlen); 902 903 xino = ubifs_iget(c->vfs_sb, le64_to_cpu(xent->inum)); 904 if (IS_ERR(xino)) { 905 err = PTR_ERR(xino); 906 ubifs_err(c, "dead directory entry '%s', error %d", 907 xent->name, err); 908 ubifs_ro_mode(c, err); 909 kfree(xent); 910 goto out_release; 911 } 912 ubifs_assert(c, ubifs_inode(xino)->xattr); 913 914 clear_nlink(xino); 915 pack_inode(c, ino, xino, 0); 916 ino = (void *)ino + UBIFS_INO_NODE_SZ; 917 iput(xino); 918 919 kfree(pxent); 920 pxent = xent; 921 key_read(c, &xent->key, &key); 922 } 923 kfree(pxent); 924 } 925 926 pack_inode(c, ino, inode, 1); 927 err = ubifs_node_calc_hash(c, ino, hash); 928 if (err) 929 goto out_release; 930 931 err = write_head(c, BASEHD, ino_start, write_len, &lnum, &offs, sync); 932 if (err) 933 goto out_release; 934 if (!sync) 935 ubifs_wbuf_add_ino_nolock(&c->jheads[BASEHD].wbuf, 936 inode->i_ino); 937 release_head(c, BASEHD); 938 939 ubifs_add_auth_dirt(c, lnum); 940 941 if (last_reference) { 942 err = ubifs_tnc_remove_ino(c, inode->i_ino); 943 if (err) 944 goto out_ro; 945 ubifs_delete_orphan(c, inode->i_ino); 946 err = ubifs_add_dirt(c, lnum, write_len); 947 } else { 948 union ubifs_key key; 949 950 ino_key_init(c, &key, inode->i_ino); 951 err = ubifs_tnc_add(c, &key, lnum, offs, ilen, hash); 952 } 953 if (err) 954 goto out_ro; 955 956 finish_reservation(c); 957 spin_lock(&ui->ui_lock); 958 ui->synced_i_size = ui->ui_size; 959 spin_unlock(&ui->ui_lock); 960 kfree(ino_start); 961 return 0; 962 963 out_release: 964 release_head(c, BASEHD); 965 out_ro: 966 ubifs_ro_mode(c, err); 967 finish_reservation(c); 968 out_free: 969 kfree(ino_start); 970 return err; 971 } 972 973 /** 974 * ubifs_jnl_delete_inode - delete an inode. 975 * @c: UBIFS file-system description object 976 * @inode: inode to delete 977 * 978 * This function deletes inode @inode which includes removing it from orphans, 979 * deleting it from TNC and, in some cases, writing a deletion inode to the 980 * journal. 981 * 982 * When regular file inodes are unlinked or a directory inode is removed, the 983 * 'ubifs_jnl_update()' function writes a corresponding deletion inode and 984 * direntry to the media, and adds the inode to orphans. After this, when the 985 * last reference to this inode has been dropped, this function is called. In 986 * general, it has to write one more deletion inode to the media, because if 987 * a commit happened between 'ubifs_jnl_update()' and 988 * 'ubifs_jnl_delete_inode()', the deletion inode is not in the journal 989 * anymore, and in fact it might not be on the flash anymore, because it might 990 * have been garbage-collected already. And for optimization reasons UBIFS does 991 * not read the orphan area if it has been unmounted cleanly, so it would have 992 * no indication in the journal that there is a deleted inode which has to be 993 * removed from TNC. 994 * 995 * However, if there was no commit between 'ubifs_jnl_update()' and 996 * 'ubifs_jnl_delete_inode()', then there is no need to write the deletion 997 * inode to the media for the second time. And this is quite a typical case. 998 * 999 * This function returns zero in case of success and a negative error code in 1000 * case of failure. 1001 */ 1002 int ubifs_jnl_delete_inode(struct ubifs_info *c, const struct inode *inode) 1003 { 1004 int err; 1005 struct ubifs_inode *ui = ubifs_inode(inode); 1006 1007 ubifs_assert(c, inode->i_nlink == 0); 1008 1009 if (ui->xattr_cnt || ui->del_cmtno != c->cmt_no) 1010 /* A commit happened for sure or inode hosts xattrs */ 1011 return ubifs_jnl_write_inode(c, inode); 1012 1013 down_read(&c->commit_sem); 1014 /* 1015 * Check commit number again, because the first test has been done 1016 * without @c->commit_sem, so a commit might have happened. 1017 */ 1018 if (ui->del_cmtno != c->cmt_no) { 1019 up_read(&c->commit_sem); 1020 return ubifs_jnl_write_inode(c, inode); 1021 } 1022 1023 err = ubifs_tnc_remove_ino(c, inode->i_ino); 1024 if (err) 1025 ubifs_ro_mode(c, err); 1026 else 1027 ubifs_delete_orphan(c, inode->i_ino); 1028 up_read(&c->commit_sem); 1029 return err; 1030 } 1031 1032 /** 1033 * ubifs_jnl_xrename - cross rename two directory entries. 1034 * @c: UBIFS file-system description object 1035 * @fst_dir: parent inode of 1st directory entry to exchange 1036 * @fst_inode: 1st inode to exchange 1037 * @fst_nm: name of 1st inode to exchange 1038 * @snd_dir: parent inode of 2nd directory entry to exchange 1039 * @snd_inode: 2nd inode to exchange 1040 * @snd_nm: name of 2nd inode to exchange 1041 * @sync: non-zero if the write-buffer has to be synchronized 1042 * 1043 * This function implements the cross rename operation which may involve 1044 * writing 2 inodes and 2 directory entries. It marks the written inodes as clean 1045 * and returns zero on success. In case of failure, a negative error code is 1046 * returned. 1047 */ 1048 int ubifs_jnl_xrename(struct ubifs_info *c, const struct inode *fst_dir, 1049 const struct inode *fst_inode, 1050 const struct fscrypt_name *fst_nm, 1051 const struct inode *snd_dir, 1052 const struct inode *snd_inode, 1053 const struct fscrypt_name *snd_nm, int sync) 1054 { 1055 union ubifs_key key; 1056 struct ubifs_dent_node *dent1, *dent2; 1057 int err, dlen1, dlen2, lnum, offs, len, plen = UBIFS_INO_NODE_SZ; 1058 int aligned_dlen1, aligned_dlen2; 1059 int twoparents = (fst_dir != snd_dir); 1060 void *p; 1061 u8 hash_dent1[UBIFS_HASH_ARR_SZ]; 1062 u8 hash_dent2[UBIFS_HASH_ARR_SZ]; 1063 u8 hash_p1[UBIFS_HASH_ARR_SZ]; 1064 u8 hash_p2[UBIFS_HASH_ARR_SZ]; 1065 1066 ubifs_assert(c, ubifs_inode(fst_dir)->data_len == 0); 1067 ubifs_assert(c, ubifs_inode(snd_dir)->data_len == 0); 1068 ubifs_assert(c, mutex_is_locked(&ubifs_inode(fst_dir)->ui_mutex)); 1069 ubifs_assert(c, mutex_is_locked(&ubifs_inode(snd_dir)->ui_mutex)); 1070 1071 dlen1 = UBIFS_DENT_NODE_SZ + fname_len(snd_nm) + 1; 1072 dlen2 = UBIFS_DENT_NODE_SZ + fname_len(fst_nm) + 1; 1073 aligned_dlen1 = ALIGN(dlen1, 8); 1074 aligned_dlen2 = ALIGN(dlen2, 8); 1075 1076 len = aligned_dlen1 + aligned_dlen2 + ALIGN(plen, 8); 1077 if (twoparents) 1078 len += plen; 1079 1080 len += ubifs_auth_node_sz(c); 1081 1082 dent1 = kzalloc(len, GFP_NOFS); 1083 if (!dent1) 1084 return -ENOMEM; 1085 1086 /* Make reservation before allocating sequence numbers */ 1087 err = make_reservation(c, BASEHD, len); 1088 if (err) 1089 goto out_free; 1090 1091 /* Make new dent for 1st entry */ 1092 dent1->ch.node_type = UBIFS_DENT_NODE; 1093 dent_key_init_flash(c, &dent1->key, snd_dir->i_ino, snd_nm); 1094 dent1->inum = cpu_to_le64(fst_inode->i_ino); 1095 dent1->type = get_dent_type(fst_inode->i_mode); 1096 dent1->nlen = cpu_to_le16(fname_len(snd_nm)); 1097 memcpy(dent1->name, fname_name(snd_nm), fname_len(snd_nm)); 1098 dent1->name[fname_len(snd_nm)] = '\0'; 1099 set_dent_cookie(c, dent1); 1100 zero_dent_node_unused(dent1); 1101 ubifs_prep_grp_node(c, dent1, dlen1, 0); 1102 err = ubifs_node_calc_hash(c, dent1, hash_dent1); 1103 if (err) 1104 goto out_release; 1105 1106 /* Make new dent for 2nd entry */ 1107 dent2 = (void *)dent1 + aligned_dlen1; 1108 dent2->ch.node_type = UBIFS_DENT_NODE; 1109 dent_key_init_flash(c, &dent2->key, fst_dir->i_ino, fst_nm); 1110 dent2->inum = cpu_to_le64(snd_inode->i_ino); 1111 dent2->type = get_dent_type(snd_inode->i_mode); 1112 dent2->nlen = cpu_to_le16(fname_len(fst_nm)); 1113 memcpy(dent2->name, fname_name(fst_nm), fname_len(fst_nm)); 1114 dent2->name[fname_len(fst_nm)] = '\0'; 1115 set_dent_cookie(c, dent2); 1116 zero_dent_node_unused(dent2); 1117 ubifs_prep_grp_node(c, dent2, dlen2, 0); 1118 err = ubifs_node_calc_hash(c, dent2, hash_dent2); 1119 if (err) 1120 goto out_release; 1121 1122 p = (void *)dent2 + aligned_dlen2; 1123 if (!twoparents) { 1124 pack_inode(c, p, fst_dir, 1); 1125 err = ubifs_node_calc_hash(c, p, hash_p1); 1126 if (err) 1127 goto out_release; 1128 } else { 1129 pack_inode(c, p, fst_dir, 0); 1130 err = ubifs_node_calc_hash(c, p, hash_p1); 1131 if (err) 1132 goto out_release; 1133 p += ALIGN(plen, 8); 1134 pack_inode(c, p, snd_dir, 1); 1135 err = ubifs_node_calc_hash(c, p, hash_p2); 1136 if (err) 1137 goto out_release; 1138 } 1139 1140 err = write_head(c, BASEHD, dent1, len, &lnum, &offs, sync); 1141 if (err) 1142 goto out_release; 1143 if (!sync) { 1144 struct ubifs_wbuf *wbuf = &c->jheads[BASEHD].wbuf; 1145 1146 ubifs_wbuf_add_ino_nolock(wbuf, fst_dir->i_ino); 1147 ubifs_wbuf_add_ino_nolock(wbuf, snd_dir->i_ino); 1148 } 1149 release_head(c, BASEHD); 1150 1151 ubifs_add_auth_dirt(c, lnum); 1152 1153 dent_key_init(c, &key, snd_dir->i_ino, snd_nm); 1154 err = ubifs_tnc_add_nm(c, &key, lnum, offs, dlen1, hash_dent1, snd_nm); 1155 if (err) 1156 goto out_ro; 1157 1158 offs += aligned_dlen1; 1159 dent_key_init(c, &key, fst_dir->i_ino, fst_nm); 1160 err = ubifs_tnc_add_nm(c, &key, lnum, offs, dlen2, hash_dent2, fst_nm); 1161 if (err) 1162 goto out_ro; 1163 1164 offs += aligned_dlen2; 1165 1166 ino_key_init(c, &key, fst_dir->i_ino); 1167 err = ubifs_tnc_add(c, &key, lnum, offs, plen, hash_p1); 1168 if (err) 1169 goto out_ro; 1170 1171 if (twoparents) { 1172 offs += ALIGN(plen, 8); 1173 ino_key_init(c, &key, snd_dir->i_ino); 1174 err = ubifs_tnc_add(c, &key, lnum, offs, plen, hash_p2); 1175 if (err) 1176 goto out_ro; 1177 } 1178 1179 finish_reservation(c); 1180 1181 mark_inode_clean(c, ubifs_inode(fst_dir)); 1182 if (twoparents) 1183 mark_inode_clean(c, ubifs_inode(snd_dir)); 1184 kfree(dent1); 1185 return 0; 1186 1187 out_release: 1188 release_head(c, BASEHD); 1189 out_ro: 1190 ubifs_ro_mode(c, err); 1191 finish_reservation(c); 1192 out_free: 1193 kfree(dent1); 1194 return err; 1195 } 1196 1197 /** 1198 * ubifs_jnl_rename - rename a directory entry. 1199 * @c: UBIFS file-system description object 1200 * @old_dir: parent inode of directory entry to rename 1201 * @old_dentry: directory entry to rename 1202 * @new_dir: parent inode of directory entry to rename 1203 * @new_dentry: new directory entry (or directory entry to replace) 1204 * @sync: non-zero if the write-buffer has to be synchronized 1205 * 1206 * This function implements the re-name operation which may involve writing up 1207 * to 4 inodes and 2 directory entries. It marks the written inodes as clean 1208 * and returns zero on success. In case of failure, a negative error code is 1209 * returned. 1210 */ 1211 int ubifs_jnl_rename(struct ubifs_info *c, const struct inode *old_dir, 1212 const struct inode *old_inode, 1213 const struct fscrypt_name *old_nm, 1214 const struct inode *new_dir, 1215 const struct inode *new_inode, 1216 const struct fscrypt_name *new_nm, 1217 const struct inode *whiteout, int sync) 1218 { 1219 void *p; 1220 union ubifs_key key; 1221 struct ubifs_dent_node *dent, *dent2; 1222 int err, dlen1, dlen2, ilen, lnum, offs, len, orphan_added = 0; 1223 int aligned_dlen1, aligned_dlen2, plen = UBIFS_INO_NODE_SZ; 1224 int last_reference = !!(new_inode && new_inode->i_nlink == 0); 1225 int move = (old_dir != new_dir); 1226 struct ubifs_inode *new_ui; 1227 u8 hash_old_dir[UBIFS_HASH_ARR_SZ]; 1228 u8 hash_new_dir[UBIFS_HASH_ARR_SZ]; 1229 u8 hash_new_inode[UBIFS_HASH_ARR_SZ]; 1230 u8 hash_dent1[UBIFS_HASH_ARR_SZ]; 1231 u8 hash_dent2[UBIFS_HASH_ARR_SZ]; 1232 1233 ubifs_assert(c, ubifs_inode(old_dir)->data_len == 0); 1234 ubifs_assert(c, ubifs_inode(new_dir)->data_len == 0); 1235 ubifs_assert(c, mutex_is_locked(&ubifs_inode(old_dir)->ui_mutex)); 1236 ubifs_assert(c, mutex_is_locked(&ubifs_inode(new_dir)->ui_mutex)); 1237 1238 dlen1 = UBIFS_DENT_NODE_SZ + fname_len(new_nm) + 1; 1239 dlen2 = UBIFS_DENT_NODE_SZ + fname_len(old_nm) + 1; 1240 if (new_inode) { 1241 new_ui = ubifs_inode(new_inode); 1242 ubifs_assert(c, mutex_is_locked(&new_ui->ui_mutex)); 1243 ilen = UBIFS_INO_NODE_SZ; 1244 if (!last_reference) 1245 ilen += new_ui->data_len; 1246 } else 1247 ilen = 0; 1248 1249 aligned_dlen1 = ALIGN(dlen1, 8); 1250 aligned_dlen2 = ALIGN(dlen2, 8); 1251 len = aligned_dlen1 + aligned_dlen2 + ALIGN(ilen, 8) + ALIGN(plen, 8); 1252 if (move) 1253 len += plen; 1254 1255 len += ubifs_auth_node_sz(c); 1256 1257 dent = kzalloc(len, GFP_NOFS); 1258 if (!dent) 1259 return -ENOMEM; 1260 1261 /* Make reservation before allocating sequence numbers */ 1262 err = make_reservation(c, BASEHD, len); 1263 if (err) 1264 goto out_free; 1265 1266 /* Make new dent */ 1267 dent->ch.node_type = UBIFS_DENT_NODE; 1268 dent_key_init_flash(c, &dent->key, new_dir->i_ino, new_nm); 1269 dent->inum = cpu_to_le64(old_inode->i_ino); 1270 dent->type = get_dent_type(old_inode->i_mode); 1271 dent->nlen = cpu_to_le16(fname_len(new_nm)); 1272 memcpy(dent->name, fname_name(new_nm), fname_len(new_nm)); 1273 dent->name[fname_len(new_nm)] = '\0'; 1274 set_dent_cookie(c, dent); 1275 zero_dent_node_unused(dent); 1276 ubifs_prep_grp_node(c, dent, dlen1, 0); 1277 err = ubifs_node_calc_hash(c, dent, hash_dent1); 1278 if (err) 1279 goto out_release; 1280 1281 dent2 = (void *)dent + aligned_dlen1; 1282 dent2->ch.node_type = UBIFS_DENT_NODE; 1283 dent_key_init_flash(c, &dent2->key, old_dir->i_ino, old_nm); 1284 1285 if (whiteout) { 1286 dent2->inum = cpu_to_le64(whiteout->i_ino); 1287 dent2->type = get_dent_type(whiteout->i_mode); 1288 } else { 1289 /* Make deletion dent */ 1290 dent2->inum = 0; 1291 dent2->type = DT_UNKNOWN; 1292 } 1293 dent2->nlen = cpu_to_le16(fname_len(old_nm)); 1294 memcpy(dent2->name, fname_name(old_nm), fname_len(old_nm)); 1295 dent2->name[fname_len(old_nm)] = '\0'; 1296 set_dent_cookie(c, dent2); 1297 zero_dent_node_unused(dent2); 1298 ubifs_prep_grp_node(c, dent2, dlen2, 0); 1299 err = ubifs_node_calc_hash(c, dent2, hash_dent2); 1300 if (err) 1301 goto out_release; 1302 1303 p = (void *)dent2 + aligned_dlen2; 1304 if (new_inode) { 1305 pack_inode(c, p, new_inode, 0); 1306 err = ubifs_node_calc_hash(c, p, hash_new_inode); 1307 if (err) 1308 goto out_release; 1309 1310 p += ALIGN(ilen, 8); 1311 } 1312 1313 if (!move) { 1314 pack_inode(c, p, old_dir, 1); 1315 err = ubifs_node_calc_hash(c, p, hash_old_dir); 1316 if (err) 1317 goto out_release; 1318 } else { 1319 pack_inode(c, p, old_dir, 0); 1320 err = ubifs_node_calc_hash(c, p, hash_old_dir); 1321 if (err) 1322 goto out_release; 1323 1324 p += ALIGN(plen, 8); 1325 pack_inode(c, p, new_dir, 1); 1326 err = ubifs_node_calc_hash(c, p, hash_new_dir); 1327 if (err) 1328 goto out_release; 1329 } 1330 1331 if (last_reference) { 1332 err = ubifs_add_orphan(c, new_inode->i_ino); 1333 if (err) { 1334 release_head(c, BASEHD); 1335 goto out_finish; 1336 } 1337 new_ui->del_cmtno = c->cmt_no; 1338 orphan_added = 1; 1339 } 1340 1341 err = write_head(c, BASEHD, dent, len, &lnum, &offs, sync); 1342 if (err) 1343 goto out_release; 1344 if (!sync) { 1345 struct ubifs_wbuf *wbuf = &c->jheads[BASEHD].wbuf; 1346 1347 ubifs_wbuf_add_ino_nolock(wbuf, new_dir->i_ino); 1348 ubifs_wbuf_add_ino_nolock(wbuf, old_dir->i_ino); 1349 if (new_inode) 1350 ubifs_wbuf_add_ino_nolock(&c->jheads[BASEHD].wbuf, 1351 new_inode->i_ino); 1352 } 1353 release_head(c, BASEHD); 1354 1355 ubifs_add_auth_dirt(c, lnum); 1356 1357 dent_key_init(c, &key, new_dir->i_ino, new_nm); 1358 err = ubifs_tnc_add_nm(c, &key, lnum, offs, dlen1, hash_dent1, new_nm); 1359 if (err) 1360 goto out_ro; 1361 1362 offs += aligned_dlen1; 1363 if (whiteout) { 1364 dent_key_init(c, &key, old_dir->i_ino, old_nm); 1365 err = ubifs_tnc_add_nm(c, &key, lnum, offs, dlen2, hash_dent2, old_nm); 1366 if (err) 1367 goto out_ro; 1368 1369 ubifs_delete_orphan(c, whiteout->i_ino); 1370 } else { 1371 err = ubifs_add_dirt(c, lnum, dlen2); 1372 if (err) 1373 goto out_ro; 1374 1375 dent_key_init(c, &key, old_dir->i_ino, old_nm); 1376 err = ubifs_tnc_remove_nm(c, &key, old_nm); 1377 if (err) 1378 goto out_ro; 1379 } 1380 1381 offs += aligned_dlen2; 1382 if (new_inode) { 1383 ino_key_init(c, &key, new_inode->i_ino); 1384 err = ubifs_tnc_add(c, &key, lnum, offs, ilen, hash_new_inode); 1385 if (err) 1386 goto out_ro; 1387 offs += ALIGN(ilen, 8); 1388 } 1389 1390 ino_key_init(c, &key, old_dir->i_ino); 1391 err = ubifs_tnc_add(c, &key, lnum, offs, plen, hash_old_dir); 1392 if (err) 1393 goto out_ro; 1394 1395 if (move) { 1396 offs += ALIGN(plen, 8); 1397 ino_key_init(c, &key, new_dir->i_ino); 1398 err = ubifs_tnc_add(c, &key, lnum, offs, plen, hash_new_dir); 1399 if (err) 1400 goto out_ro; 1401 } 1402 1403 finish_reservation(c); 1404 if (new_inode) { 1405 mark_inode_clean(c, new_ui); 1406 spin_lock(&new_ui->ui_lock); 1407 new_ui->synced_i_size = new_ui->ui_size; 1408 spin_unlock(&new_ui->ui_lock); 1409 } 1410 mark_inode_clean(c, ubifs_inode(old_dir)); 1411 if (move) 1412 mark_inode_clean(c, ubifs_inode(new_dir)); 1413 kfree(dent); 1414 return 0; 1415 1416 out_release: 1417 release_head(c, BASEHD); 1418 out_ro: 1419 ubifs_ro_mode(c, err); 1420 if (orphan_added) 1421 ubifs_delete_orphan(c, new_inode->i_ino); 1422 out_finish: 1423 finish_reservation(c); 1424 out_free: 1425 kfree(dent); 1426 return err; 1427 } 1428 1429 /** 1430 * truncate_data_node - re-compress/encrypt a truncated data node. 1431 * @c: UBIFS file-system description object 1432 * @inode: inode which referes to the data node 1433 * @block: data block number 1434 * @dn: data node to re-compress 1435 * @new_len: new length 1436 * 1437 * This function is used when an inode is truncated and the last data node of 1438 * the inode has to be re-compressed/encrypted and re-written. 1439 */ 1440 static int truncate_data_node(const struct ubifs_info *c, const struct inode *inode, 1441 unsigned int block, struct ubifs_data_node *dn, 1442 int *new_len) 1443 { 1444 void *buf; 1445 int err, dlen, compr_type, out_len, old_dlen; 1446 1447 out_len = le32_to_cpu(dn->size); 1448 buf = kmalloc_array(out_len, WORST_COMPR_FACTOR, GFP_NOFS); 1449 if (!buf) 1450 return -ENOMEM; 1451 1452 dlen = old_dlen = le32_to_cpu(dn->ch.len) - UBIFS_DATA_NODE_SZ; 1453 compr_type = le16_to_cpu(dn->compr_type); 1454 1455 if (IS_ENCRYPTED(inode)) { 1456 err = ubifs_decrypt(inode, dn, &dlen, block); 1457 if (err) 1458 goto out; 1459 } 1460 1461 if (compr_type == UBIFS_COMPR_NONE) { 1462 out_len = *new_len; 1463 } else { 1464 err = ubifs_decompress(c, &dn->data, dlen, buf, &out_len, compr_type); 1465 if (err) 1466 goto out; 1467 1468 ubifs_compress(c, buf, *new_len, &dn->data, &out_len, &compr_type); 1469 } 1470 1471 if (IS_ENCRYPTED(inode)) { 1472 err = ubifs_encrypt(inode, dn, out_len, &old_dlen, block); 1473 if (err) 1474 goto out; 1475 1476 out_len = old_dlen; 1477 } else { 1478 dn->compr_size = 0; 1479 } 1480 1481 ubifs_assert(c, out_len <= UBIFS_BLOCK_SIZE); 1482 dn->compr_type = cpu_to_le16(compr_type); 1483 dn->size = cpu_to_le32(*new_len); 1484 *new_len = UBIFS_DATA_NODE_SZ + out_len; 1485 err = 0; 1486 out: 1487 kfree(buf); 1488 return err; 1489 } 1490 1491 /** 1492 * ubifs_jnl_truncate - update the journal for a truncation. 1493 * @c: UBIFS file-system description object 1494 * @inode: inode to truncate 1495 * @old_size: old size 1496 * @new_size: new size 1497 * 1498 * When the size of a file decreases due to truncation, a truncation node is 1499 * written, the journal tree is updated, and the last data block is re-written 1500 * if it has been affected. The inode is also updated in order to synchronize 1501 * the new inode size. 1502 * 1503 * This function marks the inode as clean and returns zero on success. In case 1504 * of failure, a negative error code is returned. 1505 */ 1506 int ubifs_jnl_truncate(struct ubifs_info *c, const struct inode *inode, 1507 loff_t old_size, loff_t new_size) 1508 { 1509 union ubifs_key key, to_key; 1510 struct ubifs_ino_node *ino; 1511 struct ubifs_trun_node *trun; 1512 struct ubifs_data_node *dn; 1513 int err, dlen, len, lnum, offs, bit, sz, sync = IS_SYNC(inode); 1514 struct ubifs_inode *ui = ubifs_inode(inode); 1515 ino_t inum = inode->i_ino; 1516 unsigned int blk; 1517 u8 hash_ino[UBIFS_HASH_ARR_SZ]; 1518 u8 hash_dn[UBIFS_HASH_ARR_SZ]; 1519 1520 dbg_jnl("ino %lu, size %lld -> %lld", 1521 (unsigned long)inum, old_size, new_size); 1522 ubifs_assert(c, !ui->data_len); 1523 ubifs_assert(c, S_ISREG(inode->i_mode)); 1524 ubifs_assert(c, mutex_is_locked(&ui->ui_mutex)); 1525 1526 sz = UBIFS_TRUN_NODE_SZ + UBIFS_INO_NODE_SZ + 1527 UBIFS_MAX_DATA_NODE_SZ * WORST_COMPR_FACTOR; 1528 1529 sz += ubifs_auth_node_sz(c); 1530 1531 ino = kmalloc(sz, GFP_NOFS); 1532 if (!ino) 1533 return -ENOMEM; 1534 1535 trun = (void *)ino + UBIFS_INO_NODE_SZ; 1536 trun->ch.node_type = UBIFS_TRUN_NODE; 1537 trun->inum = cpu_to_le32(inum); 1538 trun->old_size = cpu_to_le64(old_size); 1539 trun->new_size = cpu_to_le64(new_size); 1540 zero_trun_node_unused(trun); 1541 1542 dlen = new_size & (UBIFS_BLOCK_SIZE - 1); 1543 if (dlen) { 1544 /* Get last data block so it can be truncated */ 1545 dn = (void *)trun + UBIFS_TRUN_NODE_SZ; 1546 blk = new_size >> UBIFS_BLOCK_SHIFT; 1547 data_key_init(c, &key, inum, blk); 1548 dbg_jnlk(&key, "last block key "); 1549 err = ubifs_tnc_lookup(c, &key, dn); 1550 if (err == -ENOENT) 1551 dlen = 0; /* Not found (so it is a hole) */ 1552 else if (err) 1553 goto out_free; 1554 else { 1555 int dn_len = le32_to_cpu(dn->size); 1556 1557 if (dn_len <= 0 || dn_len > UBIFS_BLOCK_SIZE) { 1558 ubifs_err(c, "bad data node (block %u, inode %lu)", 1559 blk, inode->i_ino); 1560 ubifs_dump_node(c, dn); 1561 goto out_free; 1562 } 1563 1564 if (dn_len <= dlen) 1565 dlen = 0; /* Nothing to do */ 1566 else { 1567 err = truncate_data_node(c, inode, blk, dn, &dlen); 1568 if (err) 1569 goto out_free; 1570 } 1571 } 1572 } 1573 1574 /* Must make reservation before allocating sequence numbers */ 1575 len = UBIFS_TRUN_NODE_SZ + UBIFS_INO_NODE_SZ; 1576 1577 if (ubifs_authenticated(c)) 1578 len += ALIGN(dlen, 8) + ubifs_auth_node_sz(c); 1579 else 1580 len += dlen; 1581 1582 err = make_reservation(c, BASEHD, len); 1583 if (err) 1584 goto out_free; 1585 1586 pack_inode(c, ino, inode, 0); 1587 err = ubifs_node_calc_hash(c, ino, hash_ino); 1588 if (err) 1589 goto out_release; 1590 1591 ubifs_prep_grp_node(c, trun, UBIFS_TRUN_NODE_SZ, dlen ? 0 : 1); 1592 if (dlen) { 1593 ubifs_prep_grp_node(c, dn, dlen, 1); 1594 err = ubifs_node_calc_hash(c, dn, hash_dn); 1595 if (err) 1596 goto out_release; 1597 } 1598 1599 err = write_head(c, BASEHD, ino, len, &lnum, &offs, sync); 1600 if (err) 1601 goto out_release; 1602 if (!sync) 1603 ubifs_wbuf_add_ino_nolock(&c->jheads[BASEHD].wbuf, inum); 1604 release_head(c, BASEHD); 1605 1606 ubifs_add_auth_dirt(c, lnum); 1607 1608 if (dlen) { 1609 sz = offs + UBIFS_INO_NODE_SZ + UBIFS_TRUN_NODE_SZ; 1610 err = ubifs_tnc_add(c, &key, lnum, sz, dlen, hash_dn); 1611 if (err) 1612 goto out_ro; 1613 } 1614 1615 ino_key_init(c, &key, inum); 1616 err = ubifs_tnc_add(c, &key, lnum, offs, UBIFS_INO_NODE_SZ, hash_ino); 1617 if (err) 1618 goto out_ro; 1619 1620 err = ubifs_add_dirt(c, lnum, UBIFS_TRUN_NODE_SZ); 1621 if (err) 1622 goto out_ro; 1623 1624 bit = new_size & (UBIFS_BLOCK_SIZE - 1); 1625 blk = (new_size >> UBIFS_BLOCK_SHIFT) + (bit ? 1 : 0); 1626 data_key_init(c, &key, inum, blk); 1627 1628 bit = old_size & (UBIFS_BLOCK_SIZE - 1); 1629 blk = (old_size >> UBIFS_BLOCK_SHIFT) - (bit ? 0 : 1); 1630 data_key_init(c, &to_key, inum, blk); 1631 1632 err = ubifs_tnc_remove_range(c, &key, &to_key); 1633 if (err) 1634 goto out_ro; 1635 1636 finish_reservation(c); 1637 spin_lock(&ui->ui_lock); 1638 ui->synced_i_size = ui->ui_size; 1639 spin_unlock(&ui->ui_lock); 1640 mark_inode_clean(c, ui); 1641 kfree(ino); 1642 return 0; 1643 1644 out_release: 1645 release_head(c, BASEHD); 1646 out_ro: 1647 ubifs_ro_mode(c, err); 1648 finish_reservation(c); 1649 out_free: 1650 kfree(ino); 1651 return err; 1652 } 1653 1654 1655 /** 1656 * ubifs_jnl_delete_xattr - delete an extended attribute. 1657 * @c: UBIFS file-system description object 1658 * @host: host inode 1659 * @inode: extended attribute inode 1660 * @nm: extended attribute entry name 1661 * 1662 * This function delete an extended attribute which is very similar to 1663 * un-linking regular files - it writes a deletion xentry, a deletion inode and 1664 * updates the target inode. Returns zero in case of success and a negative 1665 * error code in case of failure. 1666 */ 1667 int ubifs_jnl_delete_xattr(struct ubifs_info *c, const struct inode *host, 1668 const struct inode *inode, 1669 const struct fscrypt_name *nm) 1670 { 1671 int err, xlen, hlen, len, lnum, xent_offs, aligned_xlen, write_len; 1672 struct ubifs_dent_node *xent; 1673 struct ubifs_ino_node *ino; 1674 union ubifs_key xent_key, key1, key2; 1675 int sync = IS_DIRSYNC(host); 1676 struct ubifs_inode *host_ui = ubifs_inode(host); 1677 u8 hash[UBIFS_HASH_ARR_SZ]; 1678 1679 ubifs_assert(c, inode->i_nlink == 0); 1680 ubifs_assert(c, mutex_is_locked(&host_ui->ui_mutex)); 1681 1682 /* 1683 * Since we are deleting the inode, we do not bother to attach any data 1684 * to it and assume its length is %UBIFS_INO_NODE_SZ. 1685 */ 1686 xlen = UBIFS_DENT_NODE_SZ + fname_len(nm) + 1; 1687 aligned_xlen = ALIGN(xlen, 8); 1688 hlen = host_ui->data_len + UBIFS_INO_NODE_SZ; 1689 len = aligned_xlen + UBIFS_INO_NODE_SZ + ALIGN(hlen, 8); 1690 1691 write_len = len + ubifs_auth_node_sz(c); 1692 1693 xent = kzalloc(write_len, GFP_NOFS); 1694 if (!xent) 1695 return -ENOMEM; 1696 1697 /* Make reservation before allocating sequence numbers */ 1698 err = make_reservation(c, BASEHD, write_len); 1699 if (err) { 1700 kfree(xent); 1701 return err; 1702 } 1703 1704 xent->ch.node_type = UBIFS_XENT_NODE; 1705 xent_key_init(c, &xent_key, host->i_ino, nm); 1706 key_write(c, &xent_key, xent->key); 1707 xent->inum = 0; 1708 xent->type = get_dent_type(inode->i_mode); 1709 xent->nlen = cpu_to_le16(fname_len(nm)); 1710 memcpy(xent->name, fname_name(nm), fname_len(nm)); 1711 xent->name[fname_len(nm)] = '\0'; 1712 zero_dent_node_unused(xent); 1713 ubifs_prep_grp_node(c, xent, xlen, 0); 1714 1715 ino = (void *)xent + aligned_xlen; 1716 pack_inode(c, ino, inode, 0); 1717 ino = (void *)ino + UBIFS_INO_NODE_SZ; 1718 pack_inode(c, ino, host, 1); 1719 err = ubifs_node_calc_hash(c, ino, hash); 1720 if (err) 1721 goto out_release; 1722 1723 err = write_head(c, BASEHD, xent, write_len, &lnum, &xent_offs, sync); 1724 if (!sync && !err) 1725 ubifs_wbuf_add_ino_nolock(&c->jheads[BASEHD].wbuf, host->i_ino); 1726 release_head(c, BASEHD); 1727 1728 ubifs_add_auth_dirt(c, lnum); 1729 kfree(xent); 1730 if (err) 1731 goto out_ro; 1732 1733 /* Remove the extended attribute entry from TNC */ 1734 err = ubifs_tnc_remove_nm(c, &xent_key, nm); 1735 if (err) 1736 goto out_ro; 1737 err = ubifs_add_dirt(c, lnum, xlen); 1738 if (err) 1739 goto out_ro; 1740 1741 /* 1742 * Remove all nodes belonging to the extended attribute inode from TNC. 1743 * Well, there actually must be only one node - the inode itself. 1744 */ 1745 lowest_ino_key(c, &key1, inode->i_ino); 1746 highest_ino_key(c, &key2, inode->i_ino); 1747 err = ubifs_tnc_remove_range(c, &key1, &key2); 1748 if (err) 1749 goto out_ro; 1750 err = ubifs_add_dirt(c, lnum, UBIFS_INO_NODE_SZ); 1751 if (err) 1752 goto out_ro; 1753 1754 /* And update TNC with the new host inode position */ 1755 ino_key_init(c, &key1, host->i_ino); 1756 err = ubifs_tnc_add(c, &key1, lnum, xent_offs + len - hlen, hlen, hash); 1757 if (err) 1758 goto out_ro; 1759 1760 finish_reservation(c); 1761 spin_lock(&host_ui->ui_lock); 1762 host_ui->synced_i_size = host_ui->ui_size; 1763 spin_unlock(&host_ui->ui_lock); 1764 mark_inode_clean(c, host_ui); 1765 return 0; 1766 1767 out_release: 1768 kfree(xent); 1769 release_head(c, BASEHD); 1770 out_ro: 1771 ubifs_ro_mode(c, err); 1772 finish_reservation(c); 1773 return err; 1774 } 1775 1776 /** 1777 * ubifs_jnl_change_xattr - change an extended attribute. 1778 * @c: UBIFS file-system description object 1779 * @inode: extended attribute inode 1780 * @host: host inode 1781 * 1782 * This function writes the updated version of an extended attribute inode and 1783 * the host inode to the journal (to the base head). The host inode is written 1784 * after the extended attribute inode in order to guarantee that the extended 1785 * attribute will be flushed when the inode is synchronized by 'fsync()' and 1786 * consequently, the write-buffer is synchronized. This function returns zero 1787 * in case of success and a negative error code in case of failure. 1788 */ 1789 int ubifs_jnl_change_xattr(struct ubifs_info *c, const struct inode *inode, 1790 const struct inode *host) 1791 { 1792 int err, len1, len2, aligned_len, aligned_len1, lnum, offs; 1793 struct ubifs_inode *host_ui = ubifs_inode(host); 1794 struct ubifs_ino_node *ino; 1795 union ubifs_key key; 1796 int sync = IS_DIRSYNC(host); 1797 u8 hash_host[UBIFS_HASH_ARR_SZ]; 1798 u8 hash[UBIFS_HASH_ARR_SZ]; 1799 1800 dbg_jnl("ino %lu, ino %lu", host->i_ino, inode->i_ino); 1801 ubifs_assert(c, host->i_nlink > 0); 1802 ubifs_assert(c, inode->i_nlink > 0); 1803 ubifs_assert(c, mutex_is_locked(&host_ui->ui_mutex)); 1804 1805 len1 = UBIFS_INO_NODE_SZ + host_ui->data_len; 1806 len2 = UBIFS_INO_NODE_SZ + ubifs_inode(inode)->data_len; 1807 aligned_len1 = ALIGN(len1, 8); 1808 aligned_len = aligned_len1 + ALIGN(len2, 8); 1809 1810 aligned_len += ubifs_auth_node_sz(c); 1811 1812 ino = kzalloc(aligned_len, GFP_NOFS); 1813 if (!ino) 1814 return -ENOMEM; 1815 1816 /* Make reservation before allocating sequence numbers */ 1817 err = make_reservation(c, BASEHD, aligned_len); 1818 if (err) 1819 goto out_free; 1820 1821 pack_inode(c, ino, host, 0); 1822 err = ubifs_node_calc_hash(c, ino, hash_host); 1823 if (err) 1824 goto out_release; 1825 pack_inode(c, (void *)ino + aligned_len1, inode, 1); 1826 err = ubifs_node_calc_hash(c, (void *)ino + aligned_len1, hash); 1827 if (err) 1828 goto out_release; 1829 1830 err = write_head(c, BASEHD, ino, aligned_len, &lnum, &offs, 0); 1831 if (!sync && !err) { 1832 struct ubifs_wbuf *wbuf = &c->jheads[BASEHD].wbuf; 1833 1834 ubifs_wbuf_add_ino_nolock(wbuf, host->i_ino); 1835 ubifs_wbuf_add_ino_nolock(wbuf, inode->i_ino); 1836 } 1837 release_head(c, BASEHD); 1838 if (err) 1839 goto out_ro; 1840 1841 ubifs_add_auth_dirt(c, lnum); 1842 1843 ino_key_init(c, &key, host->i_ino); 1844 err = ubifs_tnc_add(c, &key, lnum, offs, len1, hash_host); 1845 if (err) 1846 goto out_ro; 1847 1848 ino_key_init(c, &key, inode->i_ino); 1849 err = ubifs_tnc_add(c, &key, lnum, offs + aligned_len1, len2, hash); 1850 if (err) 1851 goto out_ro; 1852 1853 finish_reservation(c); 1854 spin_lock(&host_ui->ui_lock); 1855 host_ui->synced_i_size = host_ui->ui_size; 1856 spin_unlock(&host_ui->ui_lock); 1857 mark_inode_clean(c, host_ui); 1858 kfree(ino); 1859 return 0; 1860 1861 out_release: 1862 release_head(c, BASEHD); 1863 out_ro: 1864 ubifs_ro_mode(c, err); 1865 finish_reservation(c); 1866 out_free: 1867 kfree(ino); 1868 return err; 1869 } 1870 1871