fs/fs_context.c

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