1 /* vi: set sw=4 ts=4: */
3 * Mini mount implementation for busybox
5 * Copyright (C) 1995, 1996 by Bruce Perens <bruce@pixar.com>.
6 * Copyright (C) 1999-2004 by Erik Andersen <andersen@codepoet.org>
7 * Copyright (C) 2005-2006 by Rob Landley <rob@landley.net>
9 * Licensed under GPLv2 or later, see file LICENSE in this tarball for details.
12 /* Design notes: There is no spec for mount. Remind me to write one.
14 mount_main() calls singlemount() which calls mount_it_now().
16 mount_main() can loop through /etc/fstab for mount -a
17 singlemount() can loop through /etc/filesystems for fstype detection.
18 mount_it_now() does the actual mount.
25 #if ENABLE_FEATURE_MOUNT_LABEL
26 #include "volume_id.h"
29 /* Needed for nfs support only */
30 #include <sys/utsname.h>
34 #include <rpc/pmap_prot.h>
35 #include <rpc/pmap_clnt.h>
38 #define MS_SILENT (1 << 15)
40 /* Grab more as needed from util-linux's mount/mount_constants.h */
42 #define MS_DIRSYNC 128 /* Directory modifications are synchronous */
46 #if defined(__dietlibc__)
47 /* 16.12.2006, Sampo Kellomaki (sampo@iki.fi)
48 * dietlibc-0.30 does not have implementation of getmntent_r() */
49 static struct mntent *getmntent_r(FILE* stream, struct mntent* result, char* buffer, int bufsize)
51 struct mntent* ment = getmntent(stream);
52 memcpy(result, ment, sizeof(struct mntent));
58 // Not real flags, but we want to be able to check for this.
60 MOUNT_USERS = (1 << 28) * ENABLE_DESKTOP,
61 MOUNT_NOAUTO = (1 << 29),
62 MOUNT_SWAP = (1 << 30),
66 #define OPTION_STR "o:t:rwanfvsi"
80 #if ENABLE_FEATURE_MTAB_SUPPORT
81 #define useMtab (!(option_mask32 & OPT_n))
86 #if ENABLE_FEATURE_MOUNT_FAKE
87 #define fakeIt (option_mask32 & OPT_f)
93 // TODO: more "user" flag compatibility.
94 // "user" option (from mount manpage):
95 // Only the user that mounted a filesystem can unmount it again.
96 // If any user should be able to unmount, then use users instead of user
97 // in the fstab line. The owner option is similar to the user option,
98 // with the restriction that the user must be the owner of the special file.
99 // This may be useful e.g. for /dev/fd if a login script makes
100 // the console user owner of this device.
102 /* Standard mount options (from -o options or --options), with corresponding
105 static const int32_t mount_options[] = {
106 // MS_FLAGS set a bit. ~MS_FLAGS disable that bit. 0 flags are NOPs.
108 USE_FEATURE_MOUNT_LOOP(
112 USE_FEATURE_MOUNT_FSTAB(
114 /* "quiet" 0 - do not filter out, vfat wants to see it */
115 /* "noauto" */ MOUNT_NOAUTO,
116 /* "sw" */ MOUNT_SWAP,
117 /* "swap" */ MOUNT_SWAP,
118 USE_DESKTOP(/* "user" */ MOUNT_USERS,)
119 USE_DESKTOP(/* "users" */ MOUNT_USERS,)
123 USE_FEATURE_MOUNT_FLAGS(
125 /* "nosuid" */ MS_NOSUID,
126 /* "suid" */ ~MS_NOSUID,
127 /* "dev" */ ~MS_NODEV,
128 /* "nodev" */ MS_NODEV,
129 /* "exec" */ ~MS_NOEXEC,
130 /* "noexec" */ MS_NOEXEC,
131 /* "sync" */ MS_SYNCHRONOUS,
132 /* "dirsync" */ MS_DIRSYNC,
133 /* "async" */ ~MS_SYNCHRONOUS,
134 /* "atime" */ ~MS_NOATIME,
135 /* "noatime" */ MS_NOATIME,
136 /* "diratime" */ ~MS_NODIRATIME,
137 /* "nodiratime" */ MS_NODIRATIME,
138 /* "loud" */ ~MS_SILENT,
141 /* "bind" */ MS_BIND,
142 /* "move" */ MS_MOVE,
143 /* "shared" */ MS_SHARED,
144 /* "slave" */ MS_SLAVE,
145 /* "private" */ MS_PRIVATE,
146 /* "unbindable" */ MS_UNBINDABLE,
147 /* "rshared" */ MS_SHARED|MS_RECURSIVE,
148 /* "rslave" */ MS_SLAVE|MS_RECURSIVE,
149 /* "rprivate" */ MS_SLAVE|MS_RECURSIVE,
150 /* "runbindable" */ MS_UNBINDABLE|MS_RECURSIVE,
153 // Always understood.
154 /* "ro" */ MS_RDONLY, // vfs flag
155 /* "rw" */ ~MS_RDONLY, // vfs flag
156 /* "remount" */ MS_REMOUNT // action flag
159 static const char mount_option_str[] =
160 USE_FEATURE_MOUNT_LOOP(
163 USE_FEATURE_MOUNT_FSTAB(
165 /* "quiet" "\0" - do not filter out, vfat wants to see it */
169 USE_DESKTOP("user" "\0")
170 USE_DESKTOP("users" "\0")
173 USE_FEATURE_MOUNT_FLAGS(
203 // Always understood.
204 "ro" "\0" // vfs flag
205 "rw" "\0" // vfs flag
206 "remount" "\0" // action flag
211 #if ENABLE_FEATURE_MOUNT_NFS
212 smalluint nfs_mount_version;
214 #if ENABLE_FEATURE_MOUNT_VERBOSE
218 char getmntent_buf[1];
221 enum { GETMNTENT_BUFSIZE = COMMON_BUFSIZE - offsetof(struct globals, getmntent_buf) };
222 #define G (*(struct globals*)&bb_common_bufsiz1)
223 #define nfs_mount_version (G.nfs_mount_version)
224 #if ENABLE_FEATURE_MOUNT_VERBOSE
225 #define verbose (G.verbose )
229 #define fslist (G.fslist )
230 #define getmntent_buf (G.getmntent_buf )
233 #if ENABLE_FEATURE_MOUNT_VERBOSE
234 static int verbose_mount(const char *source, const char *target,
235 const char *filesystemtype,
236 unsigned long mountflags, const void *data)
241 rc = mount(source, target, filesystemtype, mountflags, data);
243 bb_perror_msg("mount('%s','%s','%s',0x%08lx,'%s'):%d",
244 source, target, filesystemtype,
245 mountflags, (char*)data, rc);
249 #define verbose_mount(...) mount(__VA_ARGS__)
252 static int resolve_mount_spec(char **fsname)
256 #if ENABLE_FEATURE_MOUNT_LABEL
257 if (!strncmp(*fsname, "UUID=", 5))
258 tmp = get_devname_from_uuid(*fsname + 5);
259 else if (!strncmp(*fsname, "LABEL=", 6))
260 tmp = get_devname_from_label(*fsname + 6);
270 /* Append mount options to string */
271 static void append_mount_options(char **oldopts, const char *newopts)
273 if (*oldopts && **oldopts) {
274 /* do not insert options which are already there */
277 int len = strlen(newopts);
278 p = strchr(newopts, ',');
279 if (p) len = p - newopts;
282 if (!strncmp(p, newopts, len)
283 && (p[len] == ',' || p[len] == '\0'))
289 p = xasprintf("%s,%.*s", *oldopts, len, newopts);
294 while (newopts[0] == ',') newopts++;
297 if (ENABLE_FEATURE_CLEAN_UP) free(*oldopts);
298 *oldopts = xstrdup(newopts);
302 /* Use the mount_options list to parse options into flags.
303 * Also return list of unrecognized options if unrecognized!=NULL */
304 static long parse_mount_options(char *options, char **unrecognized)
306 long flags = MS_SILENT;
308 // Loop through options
311 char *comma = strchr(options, ',');
312 const char *option_str = mount_option_str;
314 if (comma) *comma = '\0';
316 // Find this option in mount_options
317 for (i = 0; i < ARRAY_SIZE(mount_options); i++) {
318 if (!strcasecmp(option_str, options)) {
319 long fl = mount_options[i];
320 if (fl < 0) flags &= fl;
324 option_str += strlen(option_str) + 1;
326 // If unrecognized not NULL, append unrecognized mount options */
327 if (unrecognized && i == ARRAY_SIZE(mount_options)) {
328 // Add it to strflags, to pass on to kernel
329 i = *unrecognized ? strlen(*unrecognized) : 0;
330 *unrecognized = xrealloc(*unrecognized, i+strlen(options)+2);
332 // Comma separated if it's not the first one
333 if (i) (*unrecognized)[i++] = ',';
334 strcpy((*unrecognized)+i, options);
339 // Advance to next option
347 // Return a list of all block device backed filesystems
349 static llist_t *get_block_backed_filesystems(void)
351 static const char filesystems[2][sizeof("/proc/filesystems")] = {
360 for (i = 0; i < 2; i++) {
361 f = fopen(filesystems[i], "r");
364 while ((buf = xmalloc_fgetline(f)) != NULL) {
365 if (!strncmp(buf, "nodev", 5) && isspace(buf[5]))
367 fs = skip_whitespace(buf);
368 if (*fs=='#' || *fs=='*' || !*fs) continue;
370 llist_add_to_end(&list, xstrdup(fs));
373 if (ENABLE_FEATURE_CLEAN_UP) fclose(f);
379 #if ENABLE_FEATURE_CLEAN_UP
380 static void delete_block_backed_filesystems(void)
382 llist_free(fslist, free);
385 void delete_block_backed_filesystems(void);
388 // Perform actual mount of specific filesystem at specific location.
389 // NB: mp->xxx fields may be trashed on exit
390 static int mount_it_now(struct mntent *mp, long vfsflags, char *filteropts)
396 bb_error_msg("would do mount('%s','%s','%s',0x%08lx,'%s')",
397 mp->mnt_fsname, mp->mnt_dir, mp->mnt_type,
398 vfsflags, filteropts);
402 // Mount, with fallback to read-only if necessary.
405 rc = verbose_mount(mp->mnt_fsname, mp->mnt_dir, mp->mnt_type,
406 vfsflags, filteropts);
408 // If mount failed, try
409 // helper program <mnt_type>
410 if (ENABLE_FEATURE_MOUNT_HELPERS && rc) {
412 int errno_save = errno;
413 args[0] = xasprintf("mount.%s", mp->mnt_type);
416 args[rc++] = (char *)"-o";
417 args[rc++] = filteropts;
419 args[rc++] = mp->mnt_fsname;
420 args[rc++] = mp->mnt_dir;
422 rc = wait4pid(spawn(args));
429 if (!rc || (vfsflags & MS_RDONLY) || (errno != EACCES && errno != EROFS))
431 if (!(vfsflags & MS_SILENT))
432 bb_error_msg("%s is write-protected, mounting read-only",
434 vfsflags |= MS_RDONLY;
437 // Abort entirely if permission denied.
439 if (rc && errno == EPERM)
440 bb_error_msg_and_die(bb_msg_perm_denied_are_you_root);
442 /* If the mount was successful, and we're maintaining an old-style
443 * mtab file by hand, add the new entry to it now. */
445 if (useMtab && !rc && !(vfsflags & MS_REMOUNT)) {
447 FILE *mountTable = setmntent(bb_path_mtab_file, "a+");
448 const char *option_str = mount_option_str;
452 bb_error_msg("no %s", bb_path_mtab_file);
456 // Add vfs string flags
458 for (i = 0; mount_options[i] != MS_REMOUNT; i++) {
459 if (mount_options[i] > 0 && (mount_options[i] & vfsflags))
460 append_mount_options(&(mp->mnt_opts), option_str);
461 option_str += strlen(option_str) + 1;
464 // Remove trailing / (if any) from directory we mounted on
466 i = strlen(mp->mnt_dir) - 1;
467 if (i > 0 && mp->mnt_dir[i] == '/') mp->mnt_dir[i] = '\0';
469 // Convert to canonical pathnames as needed
471 mp->mnt_dir = bb_simplify_path(mp->mnt_dir);
473 if (!mp->mnt_type || !*mp->mnt_type) { /* bind mount */
474 mp->mnt_fsname = fsname = bb_simplify_path(mp->mnt_fsname);
475 mp->mnt_type = (char*)"bind";
477 mp->mnt_freq = mp->mnt_passno = 0;
481 addmntent(mountTable, mp);
482 endmntent(mountTable);
483 if (ENABLE_FEATURE_CLEAN_UP) {
492 #if ENABLE_FEATURE_MOUNT_NFS
496 * Copyright (C) 1993 Rick Sladkey <jrs@world.std.com>
498 * Licensed under GPLv2, see file LICENSE in this tarball for details.
500 * Wed Feb 8 12:51:48 1995, biro@yggdrasil.com (Ross Biro): allow all port
501 * numbers to be specified on the command line.
503 * Fri, 8 Mar 1996 18:01:39, Swen Thuemmler <swen@uni-paderborn.de>:
504 * Omit the call to connect() for Linux version 1.3.11 or later.
506 * Wed Oct 1 23:55:28 1997: Dick Streefland <dick_streefland@tasking.com>
507 * Implemented the "bg", "fg" and "retry" mount options for NFS.
509 * 1999-02-22 Arkadiusz Mickiewicz <misiek@misiek.eu.org>
510 * - added Native Language Support
512 * Modified by Olaf Kirch and Trond Myklebust for new NFS code,
516 /* This is just a warning of a common mistake. Possibly this should be a
517 * uclibc faq entry rather than in busybox... */
518 #if defined(__UCLIBC__) && ! defined(__UCLIBC_HAS_RPC__)
519 #error "You need to build uClibc with UCLIBC_HAS_RPC for NFS support."
522 #define MOUNTPORT 635
523 #define MNTPATHLEN 1024
524 #define MNTNAMLEN 255
528 typedef char fhandle[FHSIZE];
531 unsigned int fhandle3_len;
543 MNT3ERR_NAMETOOLONG = 63,
544 MNT3ERR_NOTSUPP = 10004,
545 MNT3ERR_SERVERFAULT = 10006,
547 typedef enum mountstat3 mountstat3;
550 unsigned int fhs_status;
555 typedef struct fhstatus fhstatus;
557 struct mountres3_ok {
560 unsigned int auth_flavours_len;
561 char *auth_flavours_val;
564 typedef struct mountres3_ok mountres3_ok;
567 mountstat3 fhs_status;
569 mountres3_ok mountinfo;
572 typedef struct mountres3 mountres3;
574 typedef char *dirpath;
578 typedef struct mountbody *mountlist;
582 dirpath ml_directory;
585 typedef struct mountbody mountbody;
587 typedef struct groupnode *groups;
593 typedef struct groupnode groupnode;
595 typedef struct exportnode *exports;
602 typedef struct exportnode exportnode;
615 typedef struct ppathcnf ppathcnf;
617 #define MOUNTPROG 100005
620 #define MOUNTPROC_NULL 0
621 #define MOUNTPROC_MNT 1
622 #define MOUNTPROC_DUMP 2
623 #define MOUNTPROC_UMNT 3
624 #define MOUNTPROC_UMNTALL 4
625 #define MOUNTPROC_EXPORT 5
626 #define MOUNTPROC_EXPORTALL 6
628 #define MOUNTVERS_POSIX 2
630 #define MOUNTPROC_PATHCONF 7
634 #define MOUNTPROC3_NULL 0
635 #define MOUNTPROC3_MNT 1
636 #define MOUNTPROC3_DUMP 2
637 #define MOUNTPROC3_UMNT 3
638 #define MOUNTPROC3_UMNTALL 4
639 #define MOUNTPROC3_EXPORT 5
651 * We want to be able to compile mount on old kernels in such a way
652 * that the binary will work well on more recent kernels.
653 * Thus, if necessary we teach nfsmount.c the structure of new fields
654 * that will come later.
656 * Moreover, the new kernel includes conflict with glibc includes
657 * so it is easiest to ignore the kernel altogether (at compile time).
665 unsigned char data[64];
668 struct nfs_mount_data {
671 struct nfs2_fh old_root; /* 1 */
677 int acregmin; /* 1 */
678 int acregmax; /* 1 */
679 int acdirmin; /* 1 */
680 int acdirmax; /* 1 */
681 struct sockaddr_in addr; /* 1 */
682 char hostname[256]; /* 1 */
684 unsigned int bsize; /* 3 */
685 struct nfs3_fh root; /* 4 */
688 /* bits in the flags field */
690 NFS_MOUNT_SOFT = 0x0001, /* 1 */
691 NFS_MOUNT_INTR = 0x0002, /* 1 */
692 NFS_MOUNT_SECURE = 0x0004, /* 1 */
693 NFS_MOUNT_POSIX = 0x0008, /* 1 */
694 NFS_MOUNT_NOCTO = 0x0010, /* 1 */
695 NFS_MOUNT_NOAC = 0x0020, /* 1 */
696 NFS_MOUNT_TCP = 0x0040, /* 2 */
697 NFS_MOUNT_VER3 = 0x0080, /* 3 */
698 NFS_MOUNT_KERBEROS = 0x0100, /* 3 */
699 NFS_MOUNT_NONLM = 0x0200 /* 3 */
704 * We need to translate between nfs status return values and
705 * the local errno values which may not be the same.
707 * Andreas Schwab <schwab@LS5.informatik.uni-dortmund.de>: change errno:
708 * "after #include <errno.h> the symbol errno is reserved for any use,
709 * it cannot even be used as a struct tag or field name".
713 #define EDQUOT ENOSPC
716 // Convert each NFSERR_BLAH into EBLAH
718 static const struct {
722 {0,0}, {1,EPERM}, {2,ENOENT}, {5,EIO}, {6,ENXIO}, {13,EACCES}, {17,EEXIST},
723 {19,ENODEV}, {20,ENOTDIR}, {21,EISDIR}, {22,EINVAL}, {27,EFBIG},
724 {28,ENOSPC}, {30,EROFS}, {63,ENAMETOOLONG}, {66,ENOTEMPTY}, {69,EDQUOT},
725 {70,ESTALE}, {71,EREMOTE}, {-1,EIO}
728 static char *nfs_strerror(int status)
732 for (i = 0; nfs_errtbl[i].stat != -1; i++) {
733 if (nfs_errtbl[i].stat == status)
734 return strerror(nfs_errtbl[i].errnum);
736 return xasprintf("unknown nfs status return value: %d", status);
739 static bool_t xdr_fhandle(XDR *xdrs, fhandle objp)
741 if (!xdr_opaque(xdrs, objp, FHSIZE))
746 static bool_t xdr_fhstatus(XDR *xdrs, fhstatus *objp)
748 if (!xdr_u_int(xdrs, &objp->fhs_status))
750 switch (objp->fhs_status) {
752 if (!xdr_fhandle(xdrs, objp->fhstatus_u.fhs_fhandle))
761 static bool_t xdr_dirpath(XDR *xdrs, dirpath *objp)
763 if (!xdr_string(xdrs, objp, MNTPATHLEN))
768 static bool_t xdr_fhandle3(XDR *xdrs, fhandle3 *objp)
770 if (!xdr_bytes(xdrs, (char **)&objp->fhandle3_val, (unsigned int *) &objp->fhandle3_len, FHSIZE3))
775 static bool_t xdr_mountres3_ok(XDR *xdrs, mountres3_ok *objp)
777 if (!xdr_fhandle3(xdrs, &objp->fhandle))
779 if (!xdr_array(xdrs, &(objp->auth_flavours.auth_flavours_val), &(objp->auth_flavours.auth_flavours_len), ~0,
780 sizeof (int), (xdrproc_t) xdr_int))
785 static bool_t xdr_mountstat3(XDR *xdrs, mountstat3 *objp)
787 if (!xdr_enum(xdrs, (enum_t *) objp))
792 static bool_t xdr_mountres3(XDR *xdrs, mountres3 *objp)
794 if (!xdr_mountstat3(xdrs, &objp->fhs_status))
796 switch (objp->fhs_status) {
798 if (!xdr_mountres3_ok(xdrs, &objp->mountres3_u.mountinfo))
807 #define MAX_NFSPROT ((nfs_mount_version >= 4) ? 3 : 2)
810 * Unfortunately, the kernel prints annoying console messages
811 * in case of an unexpected nfs mount version (instead of
812 * just returning some error). Therefore we'll have to try
813 * and figure out what version the kernel expects.
816 * KERNEL_NFS_MOUNT_VERSION: kernel sources at compile time
817 * NFS_MOUNT_VERSION: these nfsmount sources at compile time
818 * nfs_mount_version: version this source and running kernel can handle
821 find_kernel_nfs_mount_version(void)
825 if (nfs_mount_version)
828 nfs_mount_version = 4; /* default */
830 kernel_version = get_linux_version_code();
831 if (kernel_version) {
832 if (kernel_version < KERNEL_VERSION(2,1,32))
833 nfs_mount_version = 1;
834 else if (kernel_version < KERNEL_VERSION(2,2,18) ||
835 (kernel_version >= KERNEL_VERSION(2,3,0) &&
836 kernel_version < KERNEL_VERSION(2,3,99)))
837 nfs_mount_version = 3;
838 /* else v4 since 2.3.99pre4 */
843 get_mountport(struct pmap *pm_mnt,
844 struct sockaddr_in *server_addr,
846 long unsigned version,
850 struct pmaplist *pmap;
852 server_addr->sin_port = PMAPPORT;
853 /* glibc 2.4 (still) has pmap_getmaps(struct sockaddr_in *).
854 * I understand it like "IPv6 for this is not 100% ready" */
855 pmap = pmap_getmaps(server_addr);
857 if (version > MAX_NFSPROT)
858 version = MAX_NFSPROT;
861 pm_mnt->pm_prog = prog;
862 pm_mnt->pm_vers = version;
863 pm_mnt->pm_prot = proto;
864 pm_mnt->pm_port = port;
867 if (pmap->pml_map.pm_prog != prog)
869 if (!version && pm_mnt->pm_vers > pmap->pml_map.pm_vers)
871 if (version > 2 && pmap->pml_map.pm_vers != version)
873 if (version && version <= 2 && pmap->pml_map.pm_vers > 2)
875 if (pmap->pml_map.pm_vers > MAX_NFSPROT ||
876 (proto && pm_mnt->pm_prot && pmap->pml_map.pm_prot != proto) ||
877 (port && pmap->pml_map.pm_port != port))
879 memcpy(pm_mnt, &pmap->pml_map, sizeof(*pm_mnt));
881 pmap = pmap->pml_next;
883 if (!pm_mnt->pm_vers)
884 pm_mnt->pm_vers = MOUNTVERS;
885 if (!pm_mnt->pm_port)
886 pm_mnt->pm_port = MOUNTPORT;
887 if (!pm_mnt->pm_prot)
888 pm_mnt->pm_prot = IPPROTO_TCP;
892 static int daemonize(void)
896 if (pid < 0) /* error */
898 if (pid > 0) /* parent */
901 fd = xopen(bb_dev_null, O_RDWR);
905 while (fd > 2) close(fd--);
907 openlog(applet_name, LOG_PID, LOG_DAEMON);
908 logmode = LOGMODE_SYSLOG;
912 static inline int daemonize(void) { return -ENOSYS; }
916 static inline int we_saw_this_host_before(const char *hostname ATTRIBUTE_UNUSED)
921 /* RPC strerror analogs are terminally idiotic:
922 * *mandatory* prefix and \n at end.
923 * This hopefully helps. Usage:
924 * error_msg_rpc(clnt_*error*(" ")) */
925 static void error_msg_rpc(const char *msg)
928 while (msg[0] == ' ' || msg[0] == ':') msg++;
930 while (len && msg[len-1] == '\n') len--;
931 bb_error_msg("%.*s", len, msg);
934 // NB: mp->xxx fields may be trashed on exit
935 static int nfsmount(struct mntent *mp, long vfsflags, char *filteropts)
941 struct nfs_mount_data data;
944 struct sockaddr_in server_addr;
945 struct sockaddr_in mount_server_addr;
948 struct fhstatus nfsv2;
949 struct mountres3 nfsv3;
975 find_kernel_nfs_mount_version();
983 /* NB: hostname, mounthost, filteropts must be free()d prior to return */
985 filteropts = xstrdup(filteropts); /* going to trash it later... */
987 hostname = xstrdup(mp->mnt_fsname);
988 /* mount_main() guarantees that ':' is there */
989 s = strchr(hostname, ':');
992 /* Ignore all but first hostname in replicated mounts
993 until they can be fully supported. (mack@sgi.com) */
994 s = strchr(hostname, ',');
997 bb_error_msg("warning: multiple hostnames not supported");
1000 server_addr.sin_family = AF_INET;
1001 if (!inet_aton(hostname, &server_addr.sin_addr)) {
1002 hp = gethostbyname(hostname);
1004 bb_herror_msg("%s", hostname);
1007 if ((size_t)hp->h_length > sizeof(struct in_addr)) {
1008 bb_error_msg("got bad hp->h_length");
1009 hp->h_length = sizeof(struct in_addr);
1011 memcpy(&server_addr.sin_addr,
1012 hp->h_addr, hp->h_length);
1015 memcpy(&mount_server_addr, &server_addr, sizeof(mount_server_addr));
1017 /* add IP address to mtab options for use when unmounting */
1019 if (!mp->mnt_opts) { /* TODO: actually mp->mnt_opts is never NULL */
1020 mp->mnt_opts = xasprintf("addr=%s", inet_ntoa(server_addr.sin_addr));
1022 char *tmp = xasprintf("%s%saddr=%s", mp->mnt_opts,
1023 mp->mnt_opts[0] ? "," : "",
1024 inet_ntoa(server_addr.sin_addr));
1029 /* Set default options.
1030 * rsize/wsize (and bsize, for ver >= 3) are left 0 in order to
1031 * let the kernel decide.
1032 * timeo is filled in after we know whether it'll be TCP or UDP. */
1033 memset(&data, 0, sizeof(data));
1039 data.namlen = NAME_MAX;
1047 retry = 10000; /* 10000 minutes ~ 1 week */
1050 mountprog = MOUNTPROG;
1058 if (filteropts) for (opt = strtok(filteropts, ","); opt; opt = strtok(NULL, ",")) {
1059 char *opteq = strchr(opt, '=');
1061 static const char options[] ALIGN1 =
1066 /* 4 */ "acregmin\0"
1067 /* 5 */ "acregmax\0"
1068 /* 6 */ "acdirmin\0"
1069 /* 7 */ "acdirmax\0"
1073 /* 11 */ "mountport\0"
1074 /* 12 */ "mounthost\0"
1075 /* 13 */ "mountprog\0"
1076 /* 14 */ "mountvers\0"
1077 /* 15 */ "nfsprog\0"
1078 /* 16 */ "nfsvers\0"
1083 int val = xatoi_u(opteq + 1);
1085 switch (index_in_strings(options, opt)) {
1095 case 3: // "retrans"
1098 case 4: // "acregmin"
1099 data.acregmin = val;
1101 case 5: // "acregmax"
1102 data.acregmax = val;
1104 case 6: // "acdirmin"
1105 data.acdirmin = val;
1107 case 7: // "acdirmax"
1108 data.acdirmax = val;
1110 case 8: // "actimeo"
1111 data.acregmin = val;
1112 data.acregmax = val;
1113 data.acdirmin = val;
1114 data.acdirmax = val;
1122 case 11: // "mountport"
1125 case 12: // "mounthost"
1126 mounthost = xstrndup(opteq+1,
1127 strcspn(opteq+1," \t\n\r,"));
1129 case 13: // "mountprog"
1132 case 14: // "mountvers"
1135 case 15: // "nfsprog"
1138 case 16: // "nfsvers"
1143 if (!strncmp(opteq+1, "tcp", 3))
1145 else if (!strncmp(opteq+1, "udp", 3))
1148 bb_error_msg("warning: unrecognized proto= option");
1150 case 19: // "namlen"
1151 if (nfs_mount_version >= 2)
1154 bb_error_msg("warning: option namlen is not supported\n");
1156 case 20: // "addr" - ignore
1159 bb_error_msg("unknown nfs mount parameter: %s=%d", opt, val);
1164 static const char options[] ALIGN1 =
1177 if (!strncmp(opt, "no", 2)) {
1181 switch (index_in_strings(options, opt)) {
1217 if (nfs_mount_version >= 3)
1220 bb_error_msg("warning: option nolock is not supported");
1223 bb_error_msg("unknown nfs mount option: %s%s", val ? "" : "no", opt);
1228 proto = (tcp) ? IPPROTO_TCP : IPPROTO_UDP;
1230 data.flags = (soft ? NFS_MOUNT_SOFT : 0)
1231 | (intr ? NFS_MOUNT_INTR : 0)
1232 | (posix ? NFS_MOUNT_POSIX : 0)
1233 | (nocto ? NFS_MOUNT_NOCTO : 0)
1234 | (noac ? NFS_MOUNT_NOAC : 0);
1235 if (nfs_mount_version >= 2)
1236 data.flags |= (tcp ? NFS_MOUNT_TCP : 0);
1237 if (nfs_mount_version >= 3)
1238 data.flags |= (nolock ? NFS_MOUNT_NONLM : 0);
1239 if (nfsvers > MAX_NFSPROT || mountvers > MAX_NFSPROT) {
1240 bb_error_msg("NFSv%d not supported", nfsvers);
1243 if (nfsvers && !mountvers)
1244 mountvers = (nfsvers < 3) ? 1 : nfsvers;
1245 if (nfsvers && nfsvers < mountvers) {
1246 mountvers = nfsvers;
1249 /* Adjust options if none specified */
1251 data.timeo = tcp ? 70 : 7;
1253 data.version = nfs_mount_version;
1255 if (vfsflags & MS_REMOUNT)
1259 * If the previous mount operation on the same host was
1260 * backgrounded, and the "bg" for this mount is also set,
1261 * give up immediately, to avoid the initial timeout.
1263 if (bg && we_saw_this_host_before(hostname)) {
1264 daemonized = daemonize();
1265 if (daemonized <= 0) { /* parent or error */
1266 retval = -daemonized;
1271 /* create mount daemon client */
1272 /* See if the nfs host = mount host. */
1274 if (mounthost[0] >= '0' && mounthost[0] <= '9') {
1275 mount_server_addr.sin_family = AF_INET;
1276 mount_server_addr.sin_addr.s_addr = inet_addr(hostname);
1278 hp = gethostbyname(mounthost);
1280 bb_herror_msg("%s", mounthost);
1283 if ((size_t)hp->h_length > sizeof(struct in_addr)) {
1284 bb_error_msg("got bad hp->h_length");
1285 hp->h_length = sizeof(struct in_addr);
1287 mount_server_addr.sin_family = AF_INET;
1288 memcpy(&mount_server_addr.sin_addr,
1289 hp->h_addr, hp->h_length);
1294 * The following loop implements the mount retries. When the mount
1295 * times out, and the "bg" option is set, we background ourself
1296 * and continue trying.
1298 * The case where the mount point is not present and the "bg"
1299 * option is set, is treated as a timeout. This is done to
1300 * support nested mounts.
1302 * The "retry" count specified by the user is the number of
1303 * minutes to retry before giving up.
1306 struct timeval total_timeout;
1307 struct timeval retry_timeout;
1313 retry_timeout.tv_sec = 3;
1314 retry_timeout.tv_usec = 0;
1315 total_timeout.tv_sec = 20;
1316 total_timeout.tv_usec = 0;
1317 timeout = time(NULL) + 60 * retry;
1321 /* be careful not to use too many CPU cycles */
1325 get_mountport(&pm_mnt, &mount_server_addr,
1330 nfsvers = (pm_mnt.pm_vers < 2) ? 2 : pm_mnt.pm_vers;
1332 /* contact the mount daemon via TCP */
1333 mount_server_addr.sin_port = htons(pm_mnt.pm_port);
1334 msock = RPC_ANYSOCK;
1336 switch (pm_mnt.pm_prot) {
1338 mclient = clntudp_create(&mount_server_addr,
1345 mount_server_addr.sin_port = htons(pm_mnt.pm_port);
1346 msock = RPC_ANYSOCK;
1348 mclient = clnttcp_create(&mount_server_addr,
1357 if (!daemonized && prevt == 0)
1358 error_msg_rpc(clnt_spcreateerror(" "));
1360 enum clnt_stat clnt_stat;
1361 /* try to mount hostname:pathname */
1362 mclient->cl_auth = authunix_create_default();
1364 /* make pointers in xdr_mountres3 NULL so
1365 * that xdr_array allocates memory for us
1367 memset(&status, 0, sizeof(status));
1369 if (pm_mnt.pm_vers == 3)
1370 clnt_stat = clnt_call(mclient, MOUNTPROC3_MNT,
1371 (xdrproc_t) xdr_dirpath,
1372 (caddr_t) &pathname,
1373 (xdrproc_t) xdr_mountres3,
1377 clnt_stat = clnt_call(mclient, MOUNTPROC_MNT,
1378 (xdrproc_t) xdr_dirpath,
1379 (caddr_t) &pathname,
1380 (xdrproc_t) xdr_fhstatus,
1384 if (clnt_stat == RPC_SUCCESS)
1385 goto prepare_kernel_data; /* we're done */
1386 if (errno != ECONNREFUSED) {
1387 error_msg_rpc(clnt_sperror(mclient, " "));
1388 goto fail; /* don't retry */
1390 /* Connection refused */
1391 if (!daemonized && prevt == 0) /* print just once */
1392 error_msg_rpc(clnt_sperror(mclient, " "));
1393 auth_destroy(mclient->cl_auth);
1394 clnt_destroy(mclient);
1400 /* Timeout. We are going to retry... maybe */
1405 daemonized = daemonize();
1406 if (daemonized <= 0) { /* parent or error */
1407 retval = -daemonized;
1414 /* TODO error message */
1420 prepare_kernel_data:
1423 if (status.nfsv2.fhs_status != 0) {
1424 bb_error_msg("%s:%s failed, reason given by server: %s",
1426 nfs_strerror(status.nfsv2.fhs_status));
1429 memcpy(data.root.data,
1430 (char *) status.nfsv2.fhstatus_u.fhs_fhandle,
1432 data.root.size = NFS_FHSIZE;
1433 memcpy(data.old_root.data,
1434 (char *) status.nfsv2.fhstatus_u.fhs_fhandle,
1437 fhandle3 *my_fhandle;
1438 if (status.nfsv3.fhs_status != 0) {
1439 bb_error_msg("%s:%s failed, reason given by server: %s",
1441 nfs_strerror(status.nfsv3.fhs_status));
1444 my_fhandle = &status.nfsv3.mountres3_u.mountinfo.fhandle;
1445 memset(data.old_root.data, 0, NFS_FHSIZE);
1446 memset(&data.root, 0, sizeof(data.root));
1447 data.root.size = my_fhandle->fhandle3_len;
1448 memcpy(data.root.data,
1449 (char *) my_fhandle->fhandle3_val,
1450 my_fhandle->fhandle3_len);
1452 data.flags |= NFS_MOUNT_VER3;
1455 /* create nfs socket for kernel */
1458 if (nfs_mount_version < 3) {
1459 bb_error_msg("NFS over TCP is not supported");
1462 fsock = socket(AF_INET, SOCK_STREAM, IPPROTO_TCP);
1464 fsock = socket(AF_INET, SOCK_DGRAM, IPPROTO_UDP);
1466 bb_perror_msg("nfs socket");
1469 if (bindresvport(fsock, 0) < 0) {
1470 bb_perror_msg("nfs bindresvport");
1474 server_addr.sin_port = PMAPPORT;
1475 port = pmap_getport(&server_addr, nfsprog, nfsvers,
1476 tcp ? IPPROTO_TCP : IPPROTO_UDP);
1480 server_addr.sin_port = htons(port);
1482 /* prepare data structure for kernel */
1485 memcpy((char *) &data.addr, (char *) &server_addr, sizeof(data.addr));
1486 strncpy(data.hostname, hostname, sizeof(data.hostname));
1490 auth_destroy(mclient->cl_auth);
1491 clnt_destroy(mclient);
1496 /* We must wait until mount directory is available */
1497 struct stat statbuf;
1499 while (stat(mp->mnt_dir, &statbuf) == -1) {
1501 daemonized = daemonize();
1502 if (daemonized <= 0) { /* parent or error */
1503 // FIXME: parent doesn't close fsock - ??!
1504 retval = -daemonized;
1508 sleep(delay); /* 1, 2, 4, 8, 16, 30, ... */
1515 do_mount: /* perform actual mount */
1517 mp->mnt_type = (char*)"nfs";
1518 retval = mount_it_now(mp, vfsflags, (char*)&data);
1525 auth_destroy(mclient->cl_auth);
1526 clnt_destroy(mclient);
1540 #else /* !ENABLE_FEATURE_MOUNT_NFS */
1542 /* Never called. Call should be optimized out. */
1543 int nfsmount(struct mntent *mp, long vfsflags, char *filteropts);
1545 #endif /* !ENABLE_FEATURE_MOUNT_NFS */
1547 // Mount one directory. Handles CIFS, NFS, loopback, autobind, and filesystem
1548 // type detection. Returns 0 for success, nonzero for failure.
1549 // NB: mp->xxx fields may be trashed on exit
1550 static int singlemount(struct mntent *mp, int ignore_busy)
1554 char *loopFile = 0, *filteropts = 0;
1558 vfsflags = parse_mount_options(mp->mnt_opts, &filteropts);
1560 // Treat fstype "auto" as unspecified.
1562 if (mp->mnt_type && strcmp(mp->mnt_type, "auto") == 0)
1563 mp->mnt_type = NULL;
1565 // Might this be a virtual filesystem?
1567 if (ENABLE_FEATURE_MOUNT_HELPERS
1568 && (strchr(mp->mnt_fsname, '#'))
1570 char *s, *p, *args[35];
1572 // FIXME: does it allow execution of arbitrary commands?!
1573 // What args[0] can end up with?
1574 for (s = p = mp->mnt_fsname; *s && n < 35-3; ++s) {
1575 if (s[0] == '#' && s[1] != '#') {
1582 args[n++] = mp->mnt_dir;
1584 rc = wait4pid(xspawn(args));
1588 // Might this be an CIFS filesystem?
1590 if (ENABLE_FEATURE_MOUNT_CIFS
1591 && (!mp->mnt_type || strcmp(mp->mnt_type, "cifs") == 0)
1592 && (mp->mnt_fsname[0] == '/' || mp->mnt_fsname[0] == '\\')
1593 && mp->mnt_fsname[0] == mp->mnt_fsname[1]
1595 len_and_sockaddr *lsa;
1600 // Replace '/' with '\' and verify that unc points to "//server/share".
1602 for (s = mp->mnt_fsname; *s; ++s)
1603 if (*s == '/') *s = '\\';
1607 s = strrchr(mp->mnt_fsname, '\\');
1608 if (s <= mp->mnt_fsname+1) goto report_error;
1610 lsa = host2sockaddr(mp->mnt_fsname+2, 0);
1612 if (!lsa) goto report_error;
1614 // insert ip=... option into string flags.
1616 dotted = xmalloc_sockaddr2dotted_noport(&lsa->u.sa);
1617 ip = xasprintf("ip=%s", dotted);
1618 parse_mount_options(ip, &filteropts);
1620 // compose new unc '\\server-ip\share'
1621 // (s => slash after hostname)
1623 mp->mnt_fsname = xasprintf("\\\\%s%s", dotted, s);
1626 vfsflags |= MS_MANDLOCK;
1628 mp->mnt_type = (char*)"cifs";
1629 rc = mount_it_now(mp, vfsflags, filteropts);
1630 if (ENABLE_FEATURE_CLEAN_UP) {
1631 free(mp->mnt_fsname);
1639 // Might this be an NFS filesystem?
1641 if (ENABLE_FEATURE_MOUNT_NFS
1642 && (!mp->mnt_type || !strcmp(mp->mnt_type, "nfs"))
1643 && strchr(mp->mnt_fsname, ':') != NULL
1645 rc = nfsmount(mp, vfsflags, filteropts);
1649 // Look at the file. (Not found isn't a failure for remount, or for
1650 // a synthetic filesystem like proc or sysfs.)
1651 // (We use stat, not lstat, in order to allow
1652 // mount symlink_to_file_or_blkdev dir)
1654 if (!stat(mp->mnt_fsname, &st)
1655 && !(vfsflags & (MS_REMOUNT | MS_BIND | MS_MOVE))
1657 // Do we need to allocate a loopback device for it?
1659 if (ENABLE_FEATURE_MOUNT_LOOP && S_ISREG(st.st_mode)) {
1660 loopFile = bb_simplify_path(mp->mnt_fsname);
1661 mp->mnt_fsname = NULL; /* will receive malloced loop dev name */
1662 if (set_loop(&(mp->mnt_fsname), loopFile, 0) < 0) {
1663 if (errno == EPERM || errno == EACCES)
1664 bb_error_msg(bb_msg_perm_denied_are_you_root);
1666 bb_perror_msg("cannot setup loop device");
1670 // Autodetect bind mounts
1672 } else if (S_ISDIR(st.st_mode) && !mp->mnt_type)
1673 vfsflags |= MS_BIND;
1676 /* If we know the fstype (or don't need to), jump straight
1677 * to the actual mount. */
1679 if (mp->mnt_type || (vfsflags & (MS_REMOUNT | MS_BIND | MS_MOVE)))
1680 rc = mount_it_now(mp, vfsflags, filteropts);
1682 // Loop through filesystem types until mount succeeds
1685 /* Initialize list of block backed filesystems. This has to be
1686 * done here so that during "mount -a", mounts after /proc shows up
1687 * can autodetect. */
1690 fslist = get_block_backed_filesystems();
1691 if (ENABLE_FEATURE_CLEAN_UP && fslist)
1692 atexit(delete_block_backed_filesystems);
1695 for (fl = fslist; fl; fl = fl->link) {
1696 mp->mnt_type = fl->data;
1697 rc = mount_it_now(mp, vfsflags, filteropts);
1702 // If mount failed, clean up loop file (if any).
1704 if (ENABLE_FEATURE_MOUNT_LOOP && rc && loopFile) {
1705 del_loop(mp->mnt_fsname);
1706 if (ENABLE_FEATURE_CLEAN_UP) {
1708 free(mp->mnt_fsname);
1713 if (ENABLE_FEATURE_CLEAN_UP)
1716 if (errno == EBUSY && ignore_busy)
1719 bb_perror_msg("mounting %s on %s failed", mp->mnt_fsname, mp->mnt_dir);
1723 // Parse options, if necessary parse fstab/mtab, and call singlemount for
1724 // each directory to be mounted.
1726 static const char must_be_root[] ALIGN1 = "you must be root";
1728 int mount_main(int argc, char **argv) MAIN_EXTERNALLY_VISIBLE;
1729 int mount_main(int argc, char **argv)
1731 char *cmdopts = xstrdup("");
1732 char *fstype = NULL;
1733 char *storage_path = NULL;
1735 const char *fstabname;
1739 struct mntent mtpair[2], *mtcur = mtpair;
1740 SKIP_DESKTOP(const int nonroot = 0;)
1742 USE_DESKTOP( int nonroot = ) sanitize_env_if_suid();
1744 // Parse long options, like --bind and --move. Note that -o option
1745 // and --option are synonymous. Yes, this means --remount,rw works.
1747 for (i = j = 0; i < argc; i++) {
1748 if (argv[i][0] == '-' && argv[i][1] == '-') {
1749 append_mount_options(&cmdopts, argv[i]+2);
1750 } else argv[j++] = argv[i];
1755 // Parse remaining options
1757 #if ENABLE_FEATURE_MOUNT_VERBOSE
1758 opt_complementary = "vv"; // -v is a counter
1760 opt = getopt32(argv, OPTION_STR, &opt_o, &fstype
1761 USE_FEATURE_MOUNT_VERBOSE(, &verbose));
1762 if (opt & OPT_o) append_mount_options(&cmdopts, opt_o); // -o
1763 if (opt & OPT_r) append_mount_options(&cmdopts, "ro"); // -r
1764 if (opt & OPT_w) append_mount_options(&cmdopts, "rw"); // -w
1768 // Three or more non-option arguments? Die with a usage message.
1770 if (argc > 2) bb_show_usage();
1772 // If we have no arguments, show currently mounted filesystems
1775 if (!(opt & OPT_a)) {
1776 FILE *mountTable = setmntent(bb_path_mtab_file, "r");
1778 if (!mountTable) bb_error_msg_and_die("no %s", bb_path_mtab_file);
1780 while (getmntent_r(mountTable, &mtpair[0], getmntent_buf,
1783 // Don't show rootfs. FIXME: why??
1784 // util-linux 2.12a happily shows rootfs...
1785 //if (!strcmp(mtpair->mnt_fsname, "rootfs")) continue;
1787 if (!fstype || !strcmp(mtpair->mnt_type, fstype))
1788 printf("%s on %s type %s (%s)\n", mtpair->mnt_fsname,
1789 mtpair->mnt_dir, mtpair->mnt_type,
1792 if (ENABLE_FEATURE_CLEAN_UP) endmntent(mountTable);
1793 return EXIT_SUCCESS;
1795 } else storage_path = bb_simplify_path(argv[0]);
1797 // When we have two arguments, the second is the directory and we can
1798 // skip looking at fstab entirely. We can always abspath() the directory
1799 // argument when we get it.
1803 bb_error_msg_and_die(must_be_root);
1804 mtpair->mnt_fsname = argv[0];
1805 mtpair->mnt_dir = argv[1];
1806 mtpair->mnt_type = fstype;
1807 mtpair->mnt_opts = cmdopts;
1808 if (ENABLE_FEATURE_MOUNT_LABEL) {
1809 resolve_mount_spec(&mtpair->mnt_fsname);
1811 rc = singlemount(mtpair, 0);
1815 i = parse_mount_options(cmdopts, 0); // FIXME: should be "long", not "int"
1816 if (nonroot && (i & ~MS_SILENT)) // Non-root users cannot specify flags
1817 bb_error_msg_and_die(must_be_root);
1819 // If we have a shared subtree flag, don't worry about fstab or mtab.
1821 if (ENABLE_FEATURE_MOUNT_FLAGS
1822 && (i & (MS_SHARED | MS_PRIVATE | MS_SLAVE | MS_UNBINDABLE))
1824 rc = verbose_mount("", argv[0], "", i, "");
1825 if (rc) bb_simple_perror_msg_and_die(argv[0]);
1829 // Open either fstab or mtab
1831 fstabname = "/etc/fstab";
1832 if (i & MS_REMOUNT) {
1833 fstabname = bb_path_mtab_file;
1835 fstab = setmntent(fstabname, "r");
1837 bb_perror_msg_and_die("cannot read %s", fstabname);
1839 // Loop through entries until we find what we're looking for.
1841 memset(mtpair, 0, sizeof(mtpair));
1843 struct mntent *mtnext = (mtcur==mtpair ? mtpair+1 : mtpair);
1845 // Get next fstab entry
1847 if (!getmntent_r(fstab, mtcur, getmntent_buf
1848 + (mtcur==mtpair ? GETMNTENT_BUFSIZE/2 : 0),
1849 GETMNTENT_BUFSIZE/2))
1851 // Were we looking for something specific?
1855 // If we didn't find anything, complain.
1857 if (!mtnext->mnt_fsname)
1858 bb_error_msg_and_die("can't find %s in %s",
1859 argv[0], fstabname);
1863 // fstab must have "users" or "user"
1864 if (!(parse_mount_options(mtcur->mnt_opts, 0) & MOUNT_USERS))
1865 bb_error_msg_and_die(must_be_root);
1868 // Mount the last thing we found.
1870 mtcur->mnt_opts = xstrdup(mtcur->mnt_opts);
1871 append_mount_options(&(mtcur->mnt_opts), cmdopts);
1872 if (ENABLE_FEATURE_MOUNT_LABEL) {
1873 resolve_mount_spec(&mtpair->mnt_fsname);
1875 rc = singlemount(mtcur, 0);
1876 free(mtcur->mnt_opts);
1881 /* If we're trying to mount something specific and this isn't it,
1882 * skip it. Note we must match both the exact text in fstab (ala
1883 * "proc") or a full path from root */
1887 // Is this what we're looking for?
1889 if (strcmp(argv[0], mtcur->mnt_fsname) &&
1890 strcmp(storage_path, mtcur->mnt_fsname) &&
1891 strcmp(argv[0], mtcur->mnt_dir) &&
1892 strcmp(storage_path, mtcur->mnt_dir)) continue;
1894 // Remember this entry. Something later may have overmounted
1895 // it, and we want the _last_ match.
1899 // If we're mounting all.
1902 // Do we need to match a filesystem type?
1903 if (fstype && match_fstype(mtcur, fstype))
1906 // Skip noauto and swap anyway.
1908 if (parse_mount_options(mtcur->mnt_opts, 0) & (MOUNT_NOAUTO | MOUNT_SWAP))
1911 // No, mount -a won't mount anything,
1912 // even user mounts, for mere humans.
1915 bb_error_msg_and_die(must_be_root);
1917 // Mount this thing.
1918 if (ENABLE_FEATURE_MOUNT_LABEL)
1919 resolve_mount_spec(&mtpair->mnt_fsname);
1921 // NFS mounts want this to be xrealloc-able
1922 mtcur->mnt_opts = xstrdup(mtcur->mnt_opts);
1923 if (singlemount(mtcur, 1)) {
1924 /* Count number of failed mounts */
1927 free(mtcur->mnt_opts);
1930 if (ENABLE_FEATURE_CLEAN_UP) endmntent(fstab);
1934 if (ENABLE_FEATURE_CLEAN_UP) {