linux/fs/squashfs/super.c
<<
>>
Prefs
   1// SPDX-License-Identifier: GPL-2.0-or-later
   2/*
   3 * Squashfs - a compressed read only filesystem for Linux
   4 *
   5 * Copyright (c) 2002, 2003, 2004, 2005, 2006, 2007, 2008
   6 * Phillip Lougher <phillip@squashfs.org.uk>
   7 *
   8 * super.c
   9 */
  10
  11/*
  12 * This file implements code to read the superblock, read and initialise
  13 * in-memory structures at mount time, and all the VFS glue code to register
  14 * the filesystem.
  15 */
  16
  17#define pr_fmt(fmt) KBUILD_MODNAME ": " fmt
  18
  19#include <linux/fs.h>
  20#include <linux/fs_context.h>
  21#include <linux/fs_parser.h>
  22#include <linux/vfs.h>
  23#include <linux/slab.h>
  24#include <linux/mutex.h>
  25#include <linux/seq_file.h>
  26#include <linux/pagemap.h>
  27#include <linux/init.h>
  28#include <linux/module.h>
  29#include <linux/magic.h>
  30#include <linux/xattr.h>
  31
  32#include "squashfs_fs.h"
  33#include "squashfs_fs_sb.h"
  34#include "squashfs_fs_i.h"
  35#include "squashfs.h"
  36#include "decompressor.h"
  37#include "xattr.h"
  38
  39static struct file_system_type squashfs_fs_type;
  40static const struct super_operations squashfs_super_ops;
  41
  42enum Opt_errors {
  43        Opt_errors_continue,
  44        Opt_errors_panic,
  45};
  46
  47enum squashfs_param {
  48        Opt_errors,
  49};
  50
  51struct squashfs_mount_opts {
  52        enum Opt_errors errors;
  53};
  54
  55static const struct constant_table squashfs_param_errors[] = {
  56        {"continue",   Opt_errors_continue },
  57        {"panic",      Opt_errors_panic },
  58        {}
  59};
  60
  61static const struct fs_parameter_spec squashfs_fs_parameters[] = {
  62        fsparam_enum("errors", Opt_errors, squashfs_param_errors),
  63        {}
  64};
  65
  66static int squashfs_parse_param(struct fs_context *fc, struct fs_parameter *param)
  67{
  68        struct squashfs_mount_opts *opts = fc->fs_private;
  69        struct fs_parse_result result;
  70        int opt;
  71
  72        opt = fs_parse(fc, squashfs_fs_parameters, param, &result);
  73        if (opt < 0)
  74                return opt;
  75
  76        switch (opt) {
  77        case Opt_errors:
  78                opts->errors = result.uint_32;
  79                break;
  80        default:
  81                return -EINVAL;
  82        }
  83
  84        return 0;
  85}
  86
  87static const struct squashfs_decompressor *supported_squashfs_filesystem(
  88        struct fs_context *fc,
  89        short major, short minor, short id)
  90{
  91        const struct squashfs_decompressor *decompressor;
  92
  93        if (major < SQUASHFS_MAJOR) {
  94                errorf(fc, "Major/Minor mismatch, older Squashfs %d.%d "
  95                       "filesystems are unsupported", major, minor);
  96                return NULL;
  97        } else if (major > SQUASHFS_MAJOR || minor > SQUASHFS_MINOR) {
  98                errorf(fc, "Major/Minor mismatch, trying to mount newer "
  99                       "%d.%d filesystem", major, minor);
 100                errorf(fc, "Please update your kernel");
 101                return NULL;
 102        }
 103
 104        decompressor = squashfs_lookup_decompressor(id);
 105        if (!decompressor->supported) {
 106                errorf(fc, "Filesystem uses \"%s\" compression. This is not supported",
 107                       decompressor->name);
 108                return NULL;
 109        }
 110
 111        return decompressor;
 112}
 113
 114
 115static int squashfs_fill_super(struct super_block *sb, struct fs_context *fc)
 116{
 117        struct squashfs_mount_opts *opts = fc->fs_private;
 118        struct squashfs_sb_info *msblk;
 119        struct squashfs_super_block *sblk = NULL;
 120        struct inode *root;
 121        long long root_inode;
 122        unsigned short flags;
 123        unsigned int fragments;
 124        u64 lookup_table_start, xattr_id_table_start, next_table;
 125        int err;
 126
 127        TRACE("Entered squashfs_fill_superblock\n");
 128
 129        sb->s_fs_info = kzalloc(sizeof(*msblk), GFP_KERNEL);
 130        if (sb->s_fs_info == NULL) {
 131                ERROR("Failed to allocate squashfs_sb_info\n");
 132                return -ENOMEM;
 133        }
 134        msblk = sb->s_fs_info;
 135
 136        msblk->panic_on_errors = (opts->errors == Opt_errors_panic);
 137
 138        msblk->devblksize = sb_min_blocksize(sb, SQUASHFS_DEVBLK_SIZE);
 139        msblk->devblksize_log2 = ffz(~msblk->devblksize);
 140
 141        mutex_init(&msblk->meta_index_mutex);
 142
 143        /*
 144         * msblk->bytes_used is checked in squashfs_read_table to ensure reads
 145         * are not beyond filesystem end.  But as we're using
 146         * squashfs_read_table here to read the superblock (including the value
 147         * of bytes_used) we need to set it to an initial sensible dummy value
 148         */
 149        msblk->bytes_used = sizeof(*sblk);
 150        sblk = squashfs_read_table(sb, SQUASHFS_START, sizeof(*sblk));
 151
 152        if (IS_ERR(sblk)) {
 153                errorf(fc, "unable to read squashfs_super_block");
 154                err = PTR_ERR(sblk);
 155                sblk = NULL;
 156                goto failed_mount;
 157        }
 158
 159        err = -EINVAL;
 160
 161        /* Check it is a SQUASHFS superblock */
 162        sb->s_magic = le32_to_cpu(sblk->s_magic);
 163        if (sb->s_magic != SQUASHFS_MAGIC) {
 164                if (!(fc->sb_flags & SB_SILENT))
 165                        errorf(fc, "Can't find a SQUASHFS superblock on %pg",
 166                               sb->s_bdev);
 167                goto failed_mount;
 168        }
 169
 170        /* Check the MAJOR & MINOR versions and lookup compression type */
 171        msblk->decompressor = supported_squashfs_filesystem(
 172                        fc,
 173                        le16_to_cpu(sblk->s_major),
 174                        le16_to_cpu(sblk->s_minor),
 175                        le16_to_cpu(sblk->compression));
 176        if (msblk->decompressor == NULL)
 177                goto failed_mount;
 178
 179        /* Check the filesystem does not extend beyond the end of the
 180           block device */
 181        msblk->bytes_used = le64_to_cpu(sblk->bytes_used);
 182        if (msblk->bytes_used < 0 || msblk->bytes_used >
 183                        i_size_read(sb->s_bdev->bd_inode))
 184                goto failed_mount;
 185
 186        /* Check block size for sanity */
 187        msblk->block_size = le32_to_cpu(sblk->block_size);
 188        if (msblk->block_size > SQUASHFS_FILE_MAX_SIZE)
 189                goto insanity;
 190
 191        /*
 192         * Check the system page size is not larger than the filesystem
 193         * block size (by default 128K).  This is currently not supported.
 194         */
 195        if (PAGE_SIZE > msblk->block_size) {
 196                errorf(fc, "Page size > filesystem block size (%d).  This is "
 197                       "currently not supported!", msblk->block_size);
 198                goto failed_mount;
 199        }
 200
 201        /* Check block log for sanity */
 202        msblk->block_log = le16_to_cpu(sblk->block_log);
 203        if (msblk->block_log > SQUASHFS_FILE_MAX_LOG)
 204                goto failed_mount;
 205
 206        /* Check that block_size and block_log match */
 207        if (msblk->block_size != (1 << msblk->block_log))
 208                goto insanity;
 209
 210        /* Check the root inode for sanity */
 211        root_inode = le64_to_cpu(sblk->root_inode);
 212        if (SQUASHFS_INODE_OFFSET(root_inode) > SQUASHFS_METADATA_SIZE)
 213                goto insanity;
 214
 215        msblk->inode_table = le64_to_cpu(sblk->inode_table_start);
 216        msblk->directory_table = le64_to_cpu(sblk->directory_table_start);
 217        msblk->inodes = le32_to_cpu(sblk->inodes);
 218        msblk->fragments = le32_to_cpu(sblk->fragments);
 219        msblk->ids = le16_to_cpu(sblk->no_ids);
 220        flags = le16_to_cpu(sblk->flags);
 221
 222        TRACE("Found valid superblock on %pg\n", sb->s_bdev);
 223        TRACE("Inodes are %scompressed\n", SQUASHFS_UNCOMPRESSED_INODES(flags)
 224                                ? "un" : "");
 225        TRACE("Data is %scompressed\n", SQUASHFS_UNCOMPRESSED_DATA(flags)
 226                                ? "un" : "");
 227        TRACE("Filesystem size %lld bytes\n", msblk->bytes_used);
 228        TRACE("Block size %d\n", msblk->block_size);
 229        TRACE("Number of inodes %d\n", msblk->inodes);
 230        TRACE("Number of fragments %d\n", msblk->fragments);
 231        TRACE("Number of ids %d\n", msblk->ids);
 232        TRACE("sblk->inode_table_start %llx\n", msblk->inode_table);
 233        TRACE("sblk->directory_table_start %llx\n", msblk->directory_table);
 234        TRACE("sblk->fragment_table_start %llx\n",
 235                (u64) le64_to_cpu(sblk->fragment_table_start));
 236        TRACE("sblk->id_table_start %llx\n",
 237                (u64) le64_to_cpu(sblk->id_table_start));
 238
 239        sb->s_maxbytes = MAX_LFS_FILESIZE;
 240        sb->s_time_min = 0;
 241        sb->s_time_max = U32_MAX;
 242        sb->s_flags |= SB_RDONLY;
 243        sb->s_op = &squashfs_super_ops;
 244
 245        err = -ENOMEM;
 246
 247        msblk->block_cache = squashfs_cache_init("metadata",
 248                        SQUASHFS_CACHED_BLKS, SQUASHFS_METADATA_SIZE);
 249        if (msblk->block_cache == NULL)
 250                goto failed_mount;
 251
 252        /* Allocate read_page block */
 253        msblk->read_page = squashfs_cache_init("data",
 254                squashfs_max_decompressors(), msblk->block_size);
 255        if (msblk->read_page == NULL) {
 256                errorf(fc, "Failed to allocate read_page block");
 257                goto failed_mount;
 258        }
 259
 260        msblk->stream = squashfs_decompressor_setup(sb, flags);
 261        if (IS_ERR(msblk->stream)) {
 262                err = PTR_ERR(msblk->stream);
 263                msblk->stream = NULL;
 264                goto insanity;
 265        }
 266
 267        /* Handle xattrs */
 268        sb->s_xattr = squashfs_xattr_handlers;
 269        xattr_id_table_start = le64_to_cpu(sblk->xattr_id_table_start);
 270        if (xattr_id_table_start == SQUASHFS_INVALID_BLK) {
 271                next_table = msblk->bytes_used;
 272                goto allocate_id_index_table;
 273        }
 274
 275        /* Allocate and read xattr id lookup table */
 276        msblk->xattr_id_table = squashfs_read_xattr_id_table(sb,
 277                xattr_id_table_start, &msblk->xattr_table, &msblk->xattr_ids);
 278        if (IS_ERR(msblk->xattr_id_table)) {
 279                errorf(fc, "unable to read xattr id index table");
 280                err = PTR_ERR(msblk->xattr_id_table);
 281                msblk->xattr_id_table = NULL;
 282                if (err != -ENOTSUPP)
 283                        goto failed_mount;
 284        }
 285        next_table = msblk->xattr_table;
 286
 287allocate_id_index_table:
 288        /* Allocate and read id index table */
 289        msblk->id_table = squashfs_read_id_index_table(sb,
 290                le64_to_cpu(sblk->id_table_start), next_table, msblk->ids);
 291        if (IS_ERR(msblk->id_table)) {
 292                errorf(fc, "unable to read id index table");
 293                err = PTR_ERR(msblk->id_table);
 294                msblk->id_table = NULL;
 295                goto failed_mount;
 296        }
 297        next_table = le64_to_cpu(msblk->id_table[0]);
 298
 299        /* Handle inode lookup table */
 300        lookup_table_start = le64_to_cpu(sblk->lookup_table_start);
 301        if (lookup_table_start == SQUASHFS_INVALID_BLK)
 302                goto handle_fragments;
 303
 304        /* Allocate and read inode lookup table */
 305        msblk->inode_lookup_table = squashfs_read_inode_lookup_table(sb,
 306                lookup_table_start, next_table, msblk->inodes);
 307        if (IS_ERR(msblk->inode_lookup_table)) {
 308                errorf(fc, "unable to read inode lookup table");
 309                err = PTR_ERR(msblk->inode_lookup_table);
 310                msblk->inode_lookup_table = NULL;
 311                goto failed_mount;
 312        }
 313        next_table = le64_to_cpu(msblk->inode_lookup_table[0]);
 314
 315        sb->s_export_op = &squashfs_export_ops;
 316
 317handle_fragments:
 318        fragments = msblk->fragments;
 319        if (fragments == 0)
 320                goto check_directory_table;
 321
 322        msblk->fragment_cache = squashfs_cache_init("fragment",
 323                SQUASHFS_CACHED_FRAGMENTS, msblk->block_size);
 324        if (msblk->fragment_cache == NULL) {
 325                err = -ENOMEM;
 326                goto failed_mount;
 327        }
 328
 329        /* Allocate and read fragment index table */
 330        msblk->fragment_index = squashfs_read_fragment_index_table(sb,
 331                le64_to_cpu(sblk->fragment_table_start), next_table, fragments);
 332        if (IS_ERR(msblk->fragment_index)) {
 333                errorf(fc, "unable to read fragment index table");
 334                err = PTR_ERR(msblk->fragment_index);
 335                msblk->fragment_index = NULL;
 336                goto failed_mount;
 337        }
 338        next_table = le64_to_cpu(msblk->fragment_index[0]);
 339
 340check_directory_table:
 341        /* Sanity check directory_table */
 342        if (msblk->directory_table > next_table) {
 343                err = -EINVAL;
 344                goto insanity;
 345        }
 346
 347        /* Sanity check inode_table */
 348        if (msblk->inode_table >= msblk->directory_table) {
 349                err = -EINVAL;
 350                goto insanity;
 351        }
 352
 353        /* allocate root */
 354        root = new_inode(sb);
 355        if (!root) {
 356                err = -ENOMEM;
 357                goto failed_mount;
 358        }
 359
 360        err = squashfs_read_inode(root, root_inode);
 361        if (err) {
 362                make_bad_inode(root);
 363                iput(root);
 364                goto failed_mount;
 365        }
 366        insert_inode_hash(root);
 367
 368        sb->s_root = d_make_root(root);
 369        if (sb->s_root == NULL) {
 370                ERROR("Root inode create failed\n");
 371                err = -ENOMEM;
 372                goto failed_mount;
 373        }
 374
 375        TRACE("Leaving squashfs_fill_super\n");
 376        kfree(sblk);
 377        return 0;
 378
 379insanity:
 380        errorf(fc, "squashfs image failed sanity check");
 381failed_mount:
 382        squashfs_cache_delete(msblk->block_cache);
 383        squashfs_cache_delete(msblk->fragment_cache);
 384        squashfs_cache_delete(msblk->read_page);
 385        squashfs_decompressor_destroy(msblk);
 386        kfree(msblk->inode_lookup_table);
 387        kfree(msblk->fragment_index);
 388        kfree(msblk->id_table);
 389        kfree(msblk->xattr_id_table);
 390        kfree(sb->s_fs_info);
 391        sb->s_fs_info = NULL;
 392        kfree(sblk);
 393        return err;
 394}
 395
 396static int squashfs_get_tree(struct fs_context *fc)
 397{
 398        return get_tree_bdev(fc, squashfs_fill_super);
 399}
 400
 401static int squashfs_reconfigure(struct fs_context *fc)
 402{
 403        struct super_block *sb = fc->root->d_sb;
 404        struct squashfs_sb_info *msblk = sb->s_fs_info;
 405        struct squashfs_mount_opts *opts = fc->fs_private;
 406
 407        sync_filesystem(fc->root->d_sb);
 408        fc->sb_flags |= SB_RDONLY;
 409
 410        msblk->panic_on_errors = (opts->errors == Opt_errors_panic);
 411
 412        return 0;
 413}
 414
 415static void squashfs_free_fs_context(struct fs_context *fc)
 416{
 417        kfree(fc->fs_private);
 418}
 419
 420static const struct fs_context_operations squashfs_context_ops = {
 421        .get_tree       = squashfs_get_tree,
 422        .free           = squashfs_free_fs_context,
 423        .parse_param    = squashfs_parse_param,
 424        .reconfigure    = squashfs_reconfigure,
 425};
 426
 427static int squashfs_show_options(struct seq_file *s, struct dentry *root)
 428{
 429        struct super_block *sb = root->d_sb;
 430        struct squashfs_sb_info *msblk = sb->s_fs_info;
 431
 432        if (msblk->panic_on_errors)
 433                seq_puts(s, ",errors=panic");
 434        else
 435                seq_puts(s, ",errors=continue");
 436
 437        return 0;
 438}
 439
 440static int squashfs_init_fs_context(struct fs_context *fc)
 441{
 442        struct squashfs_mount_opts *opts;
 443
 444        opts = kzalloc(sizeof(*opts), GFP_KERNEL);
 445        if (!opts)
 446                return -ENOMEM;
 447
 448        fc->fs_private = opts;
 449        fc->ops = &squashfs_context_ops;
 450        return 0;
 451}
 452
 453static int squashfs_statfs(struct dentry *dentry, struct kstatfs *buf)
 454{
 455        struct squashfs_sb_info *msblk = dentry->d_sb->s_fs_info;
 456        u64 id = huge_encode_dev(dentry->d_sb->s_bdev->bd_dev);
 457
 458        TRACE("Entered squashfs_statfs\n");
 459
 460        buf->f_type = SQUASHFS_MAGIC;
 461        buf->f_bsize = msblk->block_size;
 462        buf->f_blocks = ((msblk->bytes_used - 1) >> msblk->block_log) + 1;
 463        buf->f_bfree = buf->f_bavail = 0;
 464        buf->f_files = msblk->inodes;
 465        buf->f_ffree = 0;
 466        buf->f_namelen = SQUASHFS_NAME_LEN;
 467        buf->f_fsid = u64_to_fsid(id);
 468
 469        return 0;
 470}
 471
 472
 473static void squashfs_put_super(struct super_block *sb)
 474{
 475        if (sb->s_fs_info) {
 476                struct squashfs_sb_info *sbi = sb->s_fs_info;
 477                squashfs_cache_delete(sbi->block_cache);
 478                squashfs_cache_delete(sbi->fragment_cache);
 479                squashfs_cache_delete(sbi->read_page);
 480                squashfs_decompressor_destroy(sbi);
 481                kfree(sbi->id_table);
 482                kfree(sbi->fragment_index);
 483                kfree(sbi->meta_index);
 484                kfree(sbi->inode_lookup_table);
 485                kfree(sbi->xattr_id_table);
 486                kfree(sb->s_fs_info);
 487                sb->s_fs_info = NULL;
 488        }
 489}
 490
 491static struct kmem_cache *squashfs_inode_cachep;
 492
 493
 494static void init_once(void *foo)
 495{
 496        struct squashfs_inode_info *ei = foo;
 497
 498        inode_init_once(&ei->vfs_inode);
 499}
 500
 501
 502static int __init init_inodecache(void)
 503{
 504        squashfs_inode_cachep = kmem_cache_create("squashfs_inode_cache",
 505                sizeof(struct squashfs_inode_info), 0,
 506                SLAB_HWCACHE_ALIGN|SLAB_RECLAIM_ACCOUNT|SLAB_ACCOUNT,
 507                init_once);
 508
 509        return squashfs_inode_cachep ? 0 : -ENOMEM;
 510}
 511
 512
 513static void destroy_inodecache(void)
 514{
 515        /*
 516         * Make sure all delayed rcu free inodes are flushed before we
 517         * destroy cache.
 518         */
 519        rcu_barrier();
 520        kmem_cache_destroy(squashfs_inode_cachep);
 521}
 522
 523
 524static int __init init_squashfs_fs(void)
 525{
 526        int err = init_inodecache();
 527
 528        if (err)
 529                return err;
 530
 531        err = register_filesystem(&squashfs_fs_type);
 532        if (err) {
 533                destroy_inodecache();
 534                return err;
 535        }
 536
 537        pr_info("version 4.0 (2009/01/31) Phillip Lougher\n");
 538
 539        return 0;
 540}
 541
 542
 543static void __exit exit_squashfs_fs(void)
 544{
 545        unregister_filesystem(&squashfs_fs_type);
 546        destroy_inodecache();
 547}
 548
 549
 550static struct inode *squashfs_alloc_inode(struct super_block *sb)
 551{
 552        struct squashfs_inode_info *ei =
 553                kmem_cache_alloc(squashfs_inode_cachep, GFP_KERNEL);
 554
 555        return ei ? &ei->vfs_inode : NULL;
 556}
 557
 558
 559static void squashfs_free_inode(struct inode *inode)
 560{
 561        kmem_cache_free(squashfs_inode_cachep, squashfs_i(inode));
 562}
 563
 564static struct file_system_type squashfs_fs_type = {
 565        .owner = THIS_MODULE,
 566        .name = "squashfs",
 567        .init_fs_context = squashfs_init_fs_context,
 568        .parameters = squashfs_fs_parameters,
 569        .kill_sb = kill_block_super,
 570        .fs_flags = FS_REQUIRES_DEV
 571};
 572MODULE_ALIAS_FS("squashfs");
 573
 574static const struct super_operations squashfs_super_ops = {
 575        .alloc_inode = squashfs_alloc_inode,
 576        .free_inode = squashfs_free_inode,
 577        .statfs = squashfs_statfs,
 578        .put_super = squashfs_put_super,
 579        .show_options = squashfs_show_options,
 580};
 581
 582module_init(init_squashfs_fs);
 583module_exit(exit_squashfs_fs);
 584MODULE_DESCRIPTION("squashfs 4.0, a compressed read-only filesystem");
 585MODULE_AUTHOR("Phillip Lougher <phillip@squashfs.org.uk>");
 586MODULE_LICENSE("GPL");
 587