linux/fs/fs_context.c
<<
>>
Prefs
   1// SPDX-License-Identifier: GPL-2.0-or-later
   2/* Provide a way to create a superblock configuration context within the kernel
   3 * that allows a superblock to be set up prior to mounting.
   4 *
   5 * Copyright (C) 2017 Red Hat, Inc. All Rights Reserved.
   6 * Written by David Howells (dhowells@redhat.com)
   7 */
   8
   9#define pr_fmt(fmt) KBUILD_MODNAME ": " fmt
  10#include <linux/module.h>
  11#include <linux/fs_context.h>
  12#include <linux/fs_parser.h>
  13#include <linux/fs.h>
  14#include <linux/mount.h>
  15#include <linux/nsproxy.h>
  16#include <linux/slab.h>
  17#include <linux/magic.h>
  18#include <linux/security.h>
  19#include <linux/mnt_namespace.h>
  20#include <linux/pid_namespace.h>
  21#include <linux/user_namespace.h>
  22#include <net/net_namespace.h>
  23#include <asm/sections.h>
  24#include "mount.h"
  25#include "internal.h"
  26
  27enum legacy_fs_param {
  28        LEGACY_FS_UNSET_PARAMS,
  29        LEGACY_FS_MONOLITHIC_PARAMS,
  30        LEGACY_FS_INDIVIDUAL_PARAMS,
  31};
  32
  33struct legacy_fs_context {
  34        char                    *legacy_data;   /* Data page for legacy filesystems */
  35        size_t                  data_size;
  36        enum legacy_fs_param    param_type;
  37};
  38
  39static int legacy_init_fs_context(struct fs_context *fc);
  40
  41static const struct constant_table common_set_sb_flag[] = {
  42        { "dirsync",    SB_DIRSYNC },
  43        { "lazytime",   SB_LAZYTIME },
  44        { "mand",       SB_MANDLOCK },
  45        { "posixacl",   SB_POSIXACL },
  46        { "ro",         SB_RDONLY },
  47        { "sync",       SB_SYNCHRONOUS },
  48};
  49
  50static const struct constant_table common_clear_sb_flag[] = {
  51        { "async",      SB_SYNCHRONOUS },
  52        { "nolazytime", SB_LAZYTIME },
  53        { "nomand",     SB_MANDLOCK },
  54        { "rw",         SB_RDONLY },
  55        { "silent",     SB_SILENT },
  56};
  57
  58static const char *const forbidden_sb_flag[] = {
  59        "bind",
  60        "dev",
  61        "exec",
  62        "move",
  63        "noatime",
  64        "nodev",
  65        "nodiratime",
  66        "noexec",
  67        "norelatime",
  68        "nostrictatime",
  69        "nosuid",
  70        "private",
  71        "rec",
  72        "relatime",
  73        "remount",
  74        "shared",
  75        "slave",
  76        "strictatime",
  77        "suid",
  78        "unbindable",
  79};
  80
  81/*
  82 * Check for a common mount option that manipulates s_flags.
  83 */
  84static int vfs_parse_sb_flag(struct fs_context *fc, const char *key)
  85{
  86        unsigned int token;
  87        unsigned int i;
  88
  89        for (i = 0; i < ARRAY_SIZE(forbidden_sb_flag); i++)
  90                if (strcmp(key, forbidden_sb_flag[i]) == 0)
  91                        return -EINVAL;
  92
  93        token = lookup_constant(common_set_sb_flag, key, 0);
  94        if (token) {
  95                fc->sb_flags |= token;
  96                fc->sb_flags_mask |= token;
  97                return 0;
  98        }
  99
 100        token = lookup_constant(common_clear_sb_flag, key, 0);
 101        if (token) {
 102                fc->sb_flags &= ~token;
 103                fc->sb_flags_mask |= token;
 104                return 0;
 105        }
 106
 107        return -ENOPARAM;
 108}
 109
 110/**
 111 * vfs_parse_fs_param - Add a single parameter to a superblock config
 112 * @fc: The filesystem context to modify
 113 * @param: The parameter
 114 *
 115 * A single mount option in string form is applied to the filesystem context
 116 * being set up.  Certain standard options (for example "ro") are translated
 117 * into flag bits without going to the filesystem.  The active security module
 118 * is allowed to observe and poach options.  Any other options are passed over
 119 * to the filesystem to parse.
 120 *
 121 * This may be called multiple times for a context.
 122 *
 123 * Returns 0 on success and a negative error code on failure.  In the event of
 124 * failure, supplementary error information may have been set.
 125 */
 126int vfs_parse_fs_param(struct fs_context *fc, struct fs_parameter *param)
 127{
 128        int ret;
 129
 130        if (!param->key)
 131                return invalf(fc, "Unnamed parameter\n");
 132
 133        ret = vfs_parse_sb_flag(fc, param->key);
 134        if (ret != -ENOPARAM)
 135                return ret;
 136
 137        ret = security_fs_context_parse_param(fc, param);
 138        if (ret != -ENOPARAM)
 139                /* Param belongs to the LSM or is disallowed by the LSM; so
 140                 * don't pass to the FS.
 141                 */
 142                return ret;
 143
 144        if (fc->ops->parse_param) {
 145                ret = fc->ops->parse_param(fc, param);
 146                if (ret != -ENOPARAM)
 147                        return ret;
 148        }
 149
 150        /* If the filesystem doesn't take any arguments, give it the
 151         * default handling of source.
 152         */
 153        if (strcmp(param->key, "source") == 0) {
 154                if (param->type != fs_value_is_string)
 155                        return invalf(fc, "VFS: Non-string source");
 156                if (fc->source)
 157                        return invalf(fc, "VFS: Multiple sources");
 158                fc->source = param->string;
 159                param->string = NULL;
 160                return 0;
 161        }
 162
 163        return invalf(fc, "%s: Unknown parameter '%s'",
 164                      fc->fs_type->name, param->key);
 165}
 166EXPORT_SYMBOL(vfs_parse_fs_param);
 167
 168/**
 169 * vfs_parse_fs_string - Convenience function to just parse a string.
 170 */
 171int vfs_parse_fs_string(struct fs_context *fc, const char *key,
 172                        const char *value, size_t v_size)
 173{
 174        int ret;
 175
 176        struct fs_parameter param = {
 177                .key    = key,
 178                .type   = fs_value_is_string,
 179                .size   = v_size,
 180        };
 181
 182        if (v_size > 0) {
 183                param.string = kmemdup_nul(value, v_size, GFP_KERNEL);
 184                if (!param.string)
 185                        return -ENOMEM;
 186        }
 187
 188        ret = vfs_parse_fs_param(fc, &param);
 189        kfree(param.string);
 190        return ret;
 191}
 192EXPORT_SYMBOL(vfs_parse_fs_string);
 193
 194/**
 195 * generic_parse_monolithic - Parse key[=val][,key[=val]]* mount data
 196 * @ctx: The superblock configuration to fill in.
 197 * @data: The data to parse
 198 *
 199 * Parse a blob of data that's in key[=val][,key[=val]]* form.  This can be
 200 * called from the ->monolithic_mount_data() fs_context operation.
 201 *
 202 * Returns 0 on success or the error returned by the ->parse_option() fs_context
 203 * operation on failure.
 204 */
 205int generic_parse_monolithic(struct fs_context *fc, void *data)
 206{
 207        char *options = data, *key;
 208        int ret = 0;
 209
 210        if (!options)
 211                return 0;
 212
 213        ret = security_sb_eat_lsm_opts(options, &fc->security);
 214        if (ret)
 215                return ret;
 216
 217        while ((key = strsep(&options, ",")) != NULL) {
 218                if (*key) {
 219                        size_t v_len = 0;
 220                        char *value = strchr(key, '=');
 221
 222                        if (value) {
 223                                if (value == key)
 224                                        continue;
 225                                *value++ = 0;
 226                                v_len = strlen(value);
 227                        }
 228                        ret = vfs_parse_fs_string(fc, key, value, v_len);
 229                        if (ret < 0)
 230                                break;
 231                }
 232        }
 233
 234        return ret;
 235}
 236EXPORT_SYMBOL(generic_parse_monolithic);
 237
 238/**
 239 * alloc_fs_context - Create a filesystem context.
 240 * @fs_type: The filesystem type.
 241 * @reference: The dentry from which this one derives (or NULL)
 242 * @sb_flags: Filesystem/superblock flags (SB_*)
 243 * @sb_flags_mask: Applicable members of @sb_flags
 244 * @purpose: The purpose that this configuration shall be used for.
 245 *
 246 * Open a filesystem and create a mount context.  The mount context is
 247 * initialised with the supplied flags and, if a submount/automount from
 248 * another superblock (referred to by @reference) is supplied, may have
 249 * parameters such as namespaces copied across from that superblock.
 250 */
 251static struct fs_context *alloc_fs_context(struct file_system_type *fs_type,
 252                                      struct dentry *reference,
 253                                      unsigned int sb_flags,
 254                                      unsigned int sb_flags_mask,
 255                                      enum fs_context_purpose purpose)
 256{
 257        int (*init_fs_context)(struct fs_context *);
 258        struct fs_context *fc;
 259        int ret = -ENOMEM;
 260
 261        fc = kzalloc(sizeof(struct fs_context), GFP_KERNEL);
 262        if (!fc)
 263                return ERR_PTR(-ENOMEM);
 264
 265        fc->purpose     = purpose;
 266        fc->sb_flags    = sb_flags;
 267        fc->sb_flags_mask = sb_flags_mask;
 268        fc->fs_type     = get_filesystem(fs_type);
 269        fc->cred        = get_current_cred();
 270        fc->net_ns      = get_net(current->nsproxy->net_ns);
 271
 272        mutex_init(&fc->uapi_mutex);
 273
 274        switch (purpose) {
 275        case FS_CONTEXT_FOR_MOUNT:
 276                fc->user_ns = get_user_ns(fc->cred->user_ns);
 277                break;
 278        case FS_CONTEXT_FOR_SUBMOUNT:
 279                fc->user_ns = get_user_ns(reference->d_sb->s_user_ns);
 280                break;
 281        case FS_CONTEXT_FOR_RECONFIGURE:
 282                atomic_inc(&reference->d_sb->s_active);
 283                fc->user_ns = get_user_ns(reference->d_sb->s_user_ns);
 284                fc->root = dget(reference);
 285                break;
 286        }
 287
 288        /* TODO: Make all filesystems support this unconditionally */
 289        init_fs_context = fc->fs_type->init_fs_context;
 290        if (!init_fs_context)
 291                init_fs_context = legacy_init_fs_context;
 292
 293        ret = init_fs_context(fc);
 294        if (ret < 0)
 295                goto err_fc;
 296        fc->need_free = true;
 297        return fc;
 298
 299err_fc:
 300        put_fs_context(fc);
 301        return ERR_PTR(ret);
 302}
 303
 304struct fs_context *fs_context_for_mount(struct file_system_type *fs_type,
 305                                        unsigned int sb_flags)
 306{
 307        return alloc_fs_context(fs_type, NULL, sb_flags, 0,
 308                                        FS_CONTEXT_FOR_MOUNT);
 309}
 310EXPORT_SYMBOL(fs_context_for_mount);
 311
 312struct fs_context *fs_context_for_reconfigure(struct dentry *dentry,
 313                                        unsigned int sb_flags,
 314                                        unsigned int sb_flags_mask)
 315{
 316        return alloc_fs_context(dentry->d_sb->s_type, dentry, sb_flags,
 317                                sb_flags_mask, FS_CONTEXT_FOR_RECONFIGURE);
 318}
 319EXPORT_SYMBOL(fs_context_for_reconfigure);
 320
 321struct fs_context *fs_context_for_submount(struct file_system_type *type,
 322                                           struct dentry *reference)
 323{
 324        return alloc_fs_context(type, reference, 0, 0, FS_CONTEXT_FOR_SUBMOUNT);
 325}
 326EXPORT_SYMBOL(fs_context_for_submount);
 327
 328void fc_drop_locked(struct fs_context *fc)
 329{
 330        struct super_block *sb = fc->root->d_sb;
 331        dput(fc->root);
 332        fc->root = NULL;
 333        deactivate_locked_super(sb);
 334}
 335
 336static void legacy_fs_context_free(struct fs_context *fc);
 337
 338/**
 339 * vfs_dup_fc_config: Duplicate a filesystem context.
 340 * @src_fc: The context to copy.
 341 */
 342struct fs_context *vfs_dup_fs_context(struct fs_context *src_fc)
 343{
 344        struct fs_context *fc;
 345        int ret;
 346
 347        if (!src_fc->ops->dup)
 348                return ERR_PTR(-EOPNOTSUPP);
 349
 350        fc = kmemdup(src_fc, sizeof(struct fs_context), GFP_KERNEL);
 351        if (!fc)
 352                return ERR_PTR(-ENOMEM);
 353
 354        mutex_init(&fc->uapi_mutex);
 355
 356        fc->fs_private  = NULL;
 357        fc->s_fs_info   = NULL;
 358        fc->source      = NULL;
 359        fc->security    = NULL;
 360        get_filesystem(fc->fs_type);
 361        get_net(fc->net_ns);
 362        get_user_ns(fc->user_ns);
 363        get_cred(fc->cred);
 364        if (fc->log)
 365                refcount_inc(&fc->log->usage);
 366
 367        /* Can't call put until we've called ->dup */
 368        ret = fc->ops->dup(fc, src_fc);
 369        if (ret < 0)
 370                goto err_fc;
 371
 372        ret = security_fs_context_dup(fc, src_fc);
 373        if (ret < 0)
 374                goto err_fc;
 375        return fc;
 376
 377err_fc:
 378        put_fs_context(fc);
 379        return ERR_PTR(ret);
 380}
 381EXPORT_SYMBOL(vfs_dup_fs_context);
 382
 383/**
 384 * logfc - Log a message to a filesystem context
 385 * @fc: The filesystem context to log to.
 386 * @fmt: The format of the buffer.
 387 */
 388void logfc(struct fs_context *fc, const char *fmt, ...)
 389{
 390        static const char store_failure[] = "OOM: Can't store error string";
 391        struct fc_log *log = fc ? fc->log : NULL;
 392        const char *p;
 393        va_list va;
 394        char *q;
 395        u8 freeable;
 396
 397        va_start(va, fmt);
 398        if (!strchr(fmt, '%')) {
 399                p = fmt;
 400                goto unformatted_string;
 401        }
 402        if (strcmp(fmt, "%s") == 0) {
 403                p = va_arg(va, const char *);
 404                goto unformatted_string;
 405        }
 406
 407        q = kvasprintf(GFP_KERNEL, fmt, va);
 408copied_string:
 409        if (!q)
 410                goto store_failure;
 411        freeable = 1;
 412        goto store_string;
 413
 414unformatted_string:
 415        if ((unsigned long)p >= (unsigned long)__start_rodata &&
 416            (unsigned long)p <  (unsigned long)__end_rodata)
 417                goto const_string;
 418        if (log && within_module_core((unsigned long)p, log->owner))
 419                goto const_string;
 420        q = kstrdup(p, GFP_KERNEL);
 421        goto copied_string;
 422
 423store_failure:
 424        p = store_failure;
 425const_string:
 426        q = (char *)p;
 427        freeable = 0;
 428store_string:
 429        if (!log) {
 430                switch (fmt[0]) {
 431                case 'w':
 432                        printk(KERN_WARNING "%s\n", q + 2);
 433                        break;
 434                case 'e':
 435                        printk(KERN_ERR "%s\n", q + 2);
 436                        break;
 437                default:
 438                        printk(KERN_NOTICE "%s\n", q + 2);
 439                        break;
 440                }
 441                if (freeable)
 442                        kfree(q);
 443        } else {
 444                unsigned int logsize = ARRAY_SIZE(log->buffer);
 445                u8 index;
 446
 447                index = log->head & (logsize - 1);
 448                BUILD_BUG_ON(sizeof(log->head) != sizeof(u8) ||
 449                             sizeof(log->tail) != sizeof(u8));
 450                if ((u8)(log->head - log->tail) == logsize) {
 451                        /* The buffer is full, discard the oldest message */
 452                        if (log->need_free & (1 << index))
 453                                kfree(log->buffer[index]);
 454                        log->tail++;
 455                }
 456
 457                log->buffer[index] = q;
 458                log->need_free &= ~(1 << index);
 459                log->need_free |= freeable << index;
 460                log->head++;
 461        }
 462        va_end(va);
 463}
 464EXPORT_SYMBOL(logfc);
 465
 466/*
 467 * Free a logging structure.
 468 */
 469static void put_fc_log(struct fs_context *fc)
 470{
 471        struct fc_log *log = fc->log;
 472        int i;
 473
 474        if (log) {
 475                if (refcount_dec_and_test(&log->usage)) {
 476                        fc->log = NULL;
 477                        for (i = 0; i <= 7; i++)
 478                                if (log->need_free & (1 << i))
 479                                        kfree(log->buffer[i]);
 480                        kfree(log);
 481                }
 482        }
 483}
 484
 485/**
 486 * put_fs_context - Dispose of a superblock configuration context.
 487 * @fc: The context to dispose of.
 488 */
 489void put_fs_context(struct fs_context *fc)
 490{
 491        struct super_block *sb;
 492
 493        if (fc->root) {
 494                sb = fc->root->d_sb;
 495                dput(fc->root);
 496                fc->root = NULL;
 497                deactivate_super(sb);
 498        }
 499
 500        if (fc->need_free && fc->ops && fc->ops->free)
 501                fc->ops->free(fc);
 502
 503        security_free_mnt_opts(&fc->security);
 504        put_net(fc->net_ns);
 505        put_user_ns(fc->user_ns);
 506        put_cred(fc->cred);
 507        put_fc_log(fc);
 508        put_filesystem(fc->fs_type);
 509        kfree(fc->source);
 510        kfree(fc);
 511}
 512EXPORT_SYMBOL(put_fs_context);
 513
 514/*
 515 * Free the config for a filesystem that doesn't support fs_context.
 516 */
 517static void legacy_fs_context_free(struct fs_context *fc)
 518{
 519        struct legacy_fs_context *ctx = fc->fs_private;
 520
 521        if (ctx) {
 522                if (ctx->param_type == LEGACY_FS_INDIVIDUAL_PARAMS)
 523                        kfree(ctx->legacy_data);
 524                kfree(ctx);
 525        }
 526}
 527
 528/*
 529 * Duplicate a legacy config.
 530 */
 531static int legacy_fs_context_dup(struct fs_context *fc, struct fs_context *src_fc)
 532{
 533        struct legacy_fs_context *ctx;
 534        struct legacy_fs_context *src_ctx = src_fc->fs_private;
 535
 536        ctx = kmemdup(src_ctx, sizeof(*src_ctx), GFP_KERNEL);
 537        if (!ctx)
 538                return -ENOMEM;
 539
 540        if (ctx->param_type == LEGACY_FS_INDIVIDUAL_PARAMS) {
 541                ctx->legacy_data = kmemdup(src_ctx->legacy_data,
 542                                           src_ctx->data_size, GFP_KERNEL);
 543                if (!ctx->legacy_data) {
 544                        kfree(ctx);
 545                        return -ENOMEM;
 546                }
 547        }
 548
 549        fc->fs_private = ctx;
 550        return 0;
 551}
 552
 553/*
 554 * Add a parameter to a legacy config.  We build up a comma-separated list of
 555 * options.
 556 */
 557static int legacy_parse_param(struct fs_context *fc, struct fs_parameter *param)
 558{
 559        struct legacy_fs_context *ctx = fc->fs_private;
 560        unsigned int size = ctx->data_size;
 561        size_t len = 0;
 562
 563        if (strcmp(param->key, "source") == 0) {
 564                if (param->type != fs_value_is_string)
 565                        return invalf(fc, "VFS: Legacy: Non-string source");
 566                if (fc->source)
 567                        return invalf(fc, "VFS: Legacy: Multiple sources");
 568                fc->source = param->string;
 569                param->string = NULL;
 570                return 0;
 571        }
 572
 573        if (ctx->param_type == LEGACY_FS_MONOLITHIC_PARAMS)
 574                return invalf(fc, "VFS: Legacy: Can't mix monolithic and individual options");
 575
 576        switch (param->type) {
 577        case fs_value_is_string:
 578                len = 1 + param->size;
 579                /* Fall through */
 580        case fs_value_is_flag:
 581                len += strlen(param->key);
 582                break;
 583        default:
 584                return invalf(fc, "VFS: Legacy: Parameter type for '%s' not supported",
 585                              param->key);
 586        }
 587
 588        if (len > PAGE_SIZE - 2 - size)
 589                return invalf(fc, "VFS: Legacy: Cumulative options too large");
 590        if (strchr(param->key, ',') ||
 591            (param->type == fs_value_is_string &&
 592             memchr(param->string, ',', param->size)))
 593                return invalf(fc, "VFS: Legacy: Option '%s' contained comma",
 594                              param->key);
 595        if (!ctx->legacy_data) {
 596                ctx->legacy_data = kmalloc(PAGE_SIZE, GFP_KERNEL);
 597                if (!ctx->legacy_data)
 598                        return -ENOMEM;
 599        }
 600
 601        ctx->legacy_data[size++] = ',';
 602        len = strlen(param->key);
 603        memcpy(ctx->legacy_data + size, param->key, len);
 604        size += len;
 605        if (param->type == fs_value_is_string) {
 606                ctx->legacy_data[size++] = '=';
 607                memcpy(ctx->legacy_data + size, param->string, param->size);
 608                size += param->size;
 609        }
 610        ctx->legacy_data[size] = '\0';
 611        ctx->data_size = size;
 612        ctx->param_type = LEGACY_FS_INDIVIDUAL_PARAMS;
 613        return 0;
 614}
 615
 616/*
 617 * Add monolithic mount data.
 618 */
 619static int legacy_parse_monolithic(struct fs_context *fc, void *data)
 620{
 621        struct legacy_fs_context *ctx = fc->fs_private;
 622
 623        if (ctx->param_type != LEGACY_FS_UNSET_PARAMS) {
 624                pr_warn("VFS: Can't mix monolithic and individual options\n");
 625                return -EINVAL;
 626        }
 627
 628        ctx->legacy_data = data;
 629        ctx->param_type = LEGACY_FS_MONOLITHIC_PARAMS;
 630        if (!ctx->legacy_data)
 631                return 0;
 632
 633        if (fc->fs_type->fs_flags & FS_BINARY_MOUNTDATA)
 634                return 0;
 635        return security_sb_eat_lsm_opts(ctx->legacy_data, &fc->security);
 636}
 637
 638/*
 639 * Get a mountable root with the legacy mount command.
 640 */
 641static int legacy_get_tree(struct fs_context *fc)
 642{
 643        struct legacy_fs_context *ctx = fc->fs_private;
 644        struct super_block *sb;
 645        struct dentry *root;
 646
 647        root = fc->fs_type->mount(fc->fs_type, fc->sb_flags,
 648                                      fc->source, ctx->legacy_data);
 649        if (IS_ERR(root))
 650                return PTR_ERR(root);
 651
 652        sb = root->d_sb;
 653        BUG_ON(!sb);
 654
 655        fc->root = root;
 656        return 0;
 657}
 658
 659/*
 660 * Handle remount.
 661 */
 662static int legacy_reconfigure(struct fs_context *fc)
 663{
 664        struct legacy_fs_context *ctx = fc->fs_private;
 665        struct super_block *sb = fc->root->d_sb;
 666
 667        if (!sb->s_op->remount_fs)
 668                return 0;
 669
 670        return sb->s_op->remount_fs(sb, &fc->sb_flags,
 671                                    ctx ? ctx->legacy_data : NULL);
 672}
 673
 674const struct fs_context_operations legacy_fs_context_ops = {
 675        .free                   = legacy_fs_context_free,
 676        .dup                    = legacy_fs_context_dup,
 677        .parse_param            = legacy_parse_param,
 678        .parse_monolithic       = legacy_parse_monolithic,
 679        .get_tree               = legacy_get_tree,
 680        .reconfigure            = legacy_reconfigure,
 681};
 682
 683/*
 684 * Initialise a legacy context for a filesystem that doesn't support
 685 * fs_context.
 686 */
 687static int legacy_init_fs_context(struct fs_context *fc)
 688{
 689        fc->fs_private = kzalloc(sizeof(struct legacy_fs_context), GFP_KERNEL);
 690        if (!fc->fs_private)
 691                return -ENOMEM;
 692        fc->ops = &legacy_fs_context_ops;
 693        return 0;
 694}
 695
 696int parse_monolithic_mount_data(struct fs_context *fc, void *data)
 697{
 698        int (*monolithic_mount_data)(struct fs_context *, void *);
 699
 700        monolithic_mount_data = fc->ops->parse_monolithic;
 701        if (!monolithic_mount_data)
 702                monolithic_mount_data = generic_parse_monolithic;
 703
 704        return monolithic_mount_data(fc, data);
 705}
 706
 707/*
 708 * Clean up a context after performing an action on it and put it into a state
 709 * from where it can be used to reconfigure a superblock.
 710 *
 711 * Note that here we do only the parts that can't fail; the rest is in
 712 * finish_clean_context() below and in between those fs_context is marked
 713 * FS_CONTEXT_AWAITING_RECONF.  The reason for splitup is that after
 714 * successful mount or remount we need to report success to userland.
 715 * Trying to do full reinit (for the sake of possible subsequent remount)
 716 * and failing to allocate memory would've put us into a nasty situation.
 717 * So here we only discard the old state and reinitialization is left
 718 * until we actually try to reconfigure.
 719 */
 720void vfs_clean_context(struct fs_context *fc)
 721{
 722        if (fc->need_free && fc->ops && fc->ops->free)
 723                fc->ops->free(fc);
 724        fc->need_free = false;
 725        fc->fs_private = NULL;
 726        fc->s_fs_info = NULL;
 727        fc->sb_flags = 0;
 728        security_free_mnt_opts(&fc->security);
 729        kfree(fc->source);
 730        fc->source = NULL;
 731
 732        fc->purpose = FS_CONTEXT_FOR_RECONFIGURE;
 733        fc->phase = FS_CONTEXT_AWAITING_RECONF;
 734}
 735
 736int finish_clean_context(struct fs_context *fc)
 737{
 738        int error;
 739
 740        if (fc->phase != FS_CONTEXT_AWAITING_RECONF)
 741                return 0;
 742
 743        if (fc->fs_type->init_fs_context)
 744                error = fc->fs_type->init_fs_context(fc);
 745        else
 746                error = legacy_init_fs_context(fc);
 747        if (unlikely(error)) {
 748                fc->phase = FS_CONTEXT_FAILED;
 749                return error;
 750        }
 751        fc->need_free = true;
 752        fc->phase = FS_CONTEXT_RECONF_PARAMS;
 753        return 0;
 754}
 755