busybox/util-linux/umount.c
<<
>>
Prefs
   1/* vi: set sw=4 ts=4: */
   2/*
   3 * Mini umount implementation for busybox
   4 *
   5 * Copyright (C) 1999-2004 by Erik Andersen <andersen@codepoet.org>
   6 * Copyright (C) 2005 by Rob Landley <rob@landley.net>
   7 *
   8 * Licensed under GPLv2, see file LICENSE in this source tree.
   9 */
  10//config:config UMOUNT
  11//config:       bool "umount (5.1 kb)"
  12//config:       default y
  13//config:       help
  14//config:       When you want to remove a mounted filesystem from its current mount
  15//config:       point, for example when you are shutting down the system, the
  16//config:       'umount' utility is the tool to use. If you enabled the 'mount'
  17//config:       utility, you almost certainly also want to enable 'umount'.
  18//config:
  19//config:config FEATURE_UMOUNT_ALL
  20//config:       bool "Support -a (unmount all)"
  21//config:       default y
  22//config:       depends on UMOUNT
  23//config:       help
  24//config:       Support -a option to unmount all currently mounted filesystems.
  25
  26//applet:IF_UMOUNT(APPLET_NOEXEC(umount, umount, BB_DIR_BIN, BB_SUID_DROP, umount))
  27/*
  28 * On one hand, in some weird situations you'd want umount
  29 * to not do anything surprising, to behave as a usual fork+execed executable.
  30 *
  31 * OTOH, there can be situations where execing would not succeed, or even hang
  32 * (say, if executable is on a filesystem which is in trouble and accesses to it
  33 * block in kernel).
  34 * In this case, you might be actually happy if your standalone bbox shell
  35 * does not fork+exec, but only forks and calls umount_main() which it already has!
  36 * Let's go with NOEXEC.
  37 *
  38 * bb_common_bufsiz1 usage here is safe wrt NOEXEC: not expecting it to be zeroed.
  39 */
  40
  41//kbuild:lib-$(CONFIG_UMOUNT) += umount.o
  42
  43//usage:#define umount_trivial_usage
  44//usage:       "[-rlf"IF_FEATURE_MTAB_SUPPORT("m")IF_FEATURE_MOUNT_LOOP("d")IF_FEATURE_UMOUNT_ALL("a")"] [-t FSTYPE] FILESYSTEM|DIRECTORY"
  45//usage:#define umount_full_usage "\n\n"
  46//usage:       "Unmount filesystems\n"
  47//usage:        IF_FEATURE_UMOUNT_ALL(
  48//usage:     "\n        -a      Unmount all filesystems" IF_FEATURE_MTAB_SUPPORT(" in /etc/mtab")
  49//usage:        )
  50//usage:        IF_FEATURE_MTAB_SUPPORT(
  51//usage:     "\n        -n      Don't erase /etc/mtab entries"
  52//usage:        )
  53//usage:     "\n        -r      Remount devices read-only if mount is busy"
  54//usage:     "\n        -l      Lazy umount (detach filesystem)"
  55//usage:     "\n        -f      Force umount (i.e., unreachable NFS server)"
  56//usage:        IF_FEATURE_MOUNT_LOOP(
  57//usage:     "\n        -d      Free loop device if it has been used"
  58//usage:        )
  59//usage:     "\n        -t FSTYPE[,...] Unmount only these filesystem type(s)"
  60//usage:
  61//usage:#define umount_example_usage
  62//usage:       "$ umount /dev/hdc1\n"
  63
  64#include <mntent.h>
  65#include <sys/mount.h>
  66#ifndef MNT_DETACH
  67# define MNT_DETACH 0x00000002
  68#endif
  69#include "libbb.h"
  70#include "common_bufsiz.h"
  71
  72#if defined(__dietlibc__)
  73// TODO: This does not belong here.
  74/* 16.12.2006, Sampo Kellomaki (sampo@iki.fi)
  75 * dietlibc-0.30 does not have implementation of getmntent_r() */
  76static struct mntent *getmntent_r(FILE* stream, struct mntent* result,
  77                char* buffer UNUSED_PARAM, int bufsize UNUSED_PARAM)
  78{
  79        struct mntent* ment = getmntent(stream);
  80        return memcpy(result, ment, sizeof(*ment));
  81}
  82#endif
  83
  84/* ignored: -c -v -i */
  85#define OPTION_STRING           "fldnrat:" "cvi"
  86#define OPT_FORCE               (1 << 0) // Same as MNT_FORCE
  87#define OPT_LAZY                (1 << 1) // Same as MNT_DETACH
  88#define OPT_FREELOOP            (1 << 2)
  89#define OPT_NO_MTAB             (1 << 3)
  90#define OPT_REMOUNT             (1 << 4)
  91#define OPT_ALL                 (ENABLE_FEATURE_UMOUNT_ALL ? (1 << 5) : 0)
  92
  93int umount_main(int argc, char **argv) MAIN_EXTERNALLY_VISIBLE;
  94int umount_main(int argc UNUSED_PARAM, char **argv)
  95{
  96        int doForce;
  97        struct mntent me;
  98        FILE *fp;
  99        char *fstype = NULL;
 100        int status = EXIT_SUCCESS;
 101        unsigned opt;
 102        struct mtab_list {
 103                char *dir;
 104                char *device;
 105                struct mtab_list *next;
 106        } *mtl, *m;
 107
 108        opt = getopt32(argv, OPTION_STRING, &fstype);
 109        //argc -= optind;
 110        argv += optind;
 111
 112        // MNT_FORCE and MNT_DETACH (from linux/fs.h) must match
 113        // OPT_FORCE and OPT_LAZY.
 114        BUILD_BUG_ON(OPT_FORCE != MNT_FORCE || OPT_LAZY != MNT_DETACH);
 115        doForce = opt & (OPT_FORCE|OPT_LAZY);
 116
 117        /* Get a list of mount points from mtab.  We read them all in now mostly
 118         * for umount -a (so we don't have to worry about the list changing while
 119         * we iterate over it, or about getting stuck in a loop on the same failing
 120         * entry.  Notice that this also naturally reverses the list so that -a
 121         * umounts the most recent entries first. */
 122        m = mtl = NULL;
 123
 124        // If we're umounting all, then m points to the start of the list and
 125        // the argument list should be empty (which will match all).
 126        fp = setmntent(bb_path_mtab_file, "r");
 127        if (!fp) {
 128                if (opt & OPT_ALL)
 129                        bb_error_msg_and_die("can't open '%s'", bb_path_mtab_file);
 130        } else {
 131                setup_common_bufsiz();
 132                while (getmntent_r(fp, &me, bb_common_bufsiz1, COMMON_BUFSIZE)) {
 133                        /* Match fstype (fstype==NULL matches always) */
 134                        if (!fstype_matches(me.mnt_type, fstype))
 135                                continue;
 136                        m = xzalloc(sizeof(*m));
 137                        m->next = mtl;
 138                        m->device = xstrdup(me.mnt_fsname);
 139                        m->dir = xstrdup(me.mnt_dir);
 140                        mtl = m;
 141                }
 142                endmntent(fp);
 143        }
 144
 145        // If we're not umounting all, we need at least one argument.
 146        // Note: "-t FSTYPE" does not imply -a.
 147        if (!(opt & OPT_ALL)) {
 148                if (!argv[0])
 149                        bb_show_usage();
 150                m = NULL;
 151        }
 152
 153        // Loop through everything we're supposed to umount, and do so.
 154        for (;;) {
 155                int curstat;
 156                char *zapit = *argv;
 157                char *path;
 158
 159                // Do we already know what to umount this time through the loop?
 160                if (m)
 161                        path = xstrdup(m->dir);
 162                // For umount -a, end of mtab means time to exit.
 163                else if (opt & OPT_ALL)
 164                        break;
 165                // Use command line argument (and look it up in mtab list)
 166                else {
 167                        if (!zapit)
 168                                break;
 169                        argv++;
 170                        path = xmalloc_realpath(zapit);
 171                        if (path) {
 172                                for (m = mtl; m; m = m->next)
 173                                        if (strcmp(path, m->dir) == 0 || strcmp(path, m->device) == 0)
 174                                                break;
 175                        }
 176                }
 177                // If we couldn't find this sucker in /etc/mtab, punt by passing our
 178                // command line argument straight to the umount syscall.  Otherwise,
 179                // umount the directory even if we were given the block device.
 180                if (m) zapit = m->dir;
 181
 182// umount from util-linux 2.22.2 does not do this:
 183// umount -f uses umount2(MNT_FORCE) immediately,
 184// not trying umount() first.
 185// (Strangely, umount -fl ignores -f: it is equivalent to umount -l.
 186// We do pass both flags in this case)
 187#if 0
 188                // Let's ask the thing nicely to unmount.
 189                curstat = umount(zapit);
 190
 191                // Unmount with force and/or lazy flags, if necessary.
 192                if (curstat && doForce)
 193#endif
 194                        curstat = umount2(zapit, doForce);
 195
 196                // If still can't umount, maybe remount read-only?
 197                if (curstat) {
 198                        if ((opt & OPT_REMOUNT) && errno == EBUSY && m) {
 199                                // Note! Even if we succeed here, later we should not
 200                                // free loop device or erase mtab entry!
 201                                const char *msg = "%s busy - remounted read-only";
 202                                curstat = mount(m->device, zapit, NULL, MS_REMOUNT|MS_RDONLY, NULL);
 203                                if (curstat) {
 204                                        msg = "can't remount %s read-only";
 205                                        status = EXIT_FAILURE;
 206                                }
 207                                bb_error_msg(msg, m->device);
 208                        } else {
 209                                status = EXIT_FAILURE;
 210                                bb_perror_msg("can't unmount %s", zapit);
 211                        }
 212                } else {
 213                        // De-allocate the loop device.  This ioctl should be ignored on
 214                        // any non-loop block devices.
 215                        if (ENABLE_FEATURE_MOUNT_LOOP && (opt & OPT_FREELOOP) && m)
 216                                del_loop(m->device);
 217                        if (ENABLE_FEATURE_MTAB_SUPPORT && !(opt & OPT_NO_MTAB) && m)
 218                                erase_mtab(m->dir);
 219                }
 220
 221                // Find next matching mtab entry for -a or umount /dev
 222                // Note this means that "umount /dev/blah" will unmount all instances
 223                // of /dev/blah, not just the most recent.
 224                if (m) {
 225                        while ((m = m->next) != NULL)
 226                                // NB: if m is non-NULL, path is non-NULL as well
 227                                if ((opt & OPT_ALL) || strcmp(path, m->device) == 0)
 228                                        break;
 229                }
 230                free(path);
 231        }
 232
 233        // Free mtab list if necessary
 234        if (ENABLE_FEATURE_CLEAN_UP) {
 235                while (mtl) {
 236                        m = mtl->next;
 237                        free(mtl->device);
 238                        free(mtl->dir);
 239                        free(mtl);
 240                        mtl = m;
 241                }
 242        }
 243
 244        return status;
 245}
 246