libexfat/mount.c

   1 /*
   2         mount.c (22.10.09)
   3         exFAT file system implementation library.
   4
   5         Free exFAT implementation.
   6         Copyright (C) 2010-2018  Andrew Nayenko
   7
   8         This program is free software; you can redistribute it and/or modify
   9         it under the terms of the GNU General Public License as published by
  10         the Free Software Foundation, either version 2 of the License, or
  11         (at your option) any later version.
  12
  13         This program is distributed in the hope that it will be useful,
  14         but WITHOUT ANY WARRANTY; without even the implied warranty of
  15         MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  16         GNU General Public License for more details.
  17
  18         You should have received a copy of the GNU General Public License along
  19         with this program; if not, write to the Free Software Foundation, Inc.,
  20         51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
  21 */
  22
  23 #include "exfat.h"
  24 #include <string.h>
  25 #include <stdlib.h>
  26 #include <errno.h>
  27 #include <inttypes.h>
  28 #include <unistd.h>
  29 #include <sys/types.h>
  30
  31 static uint64_t rootdir_size(const struct exfat* ef)
  32 {
  33         uint32_t clusters = 0;
  34         uint32_t clusters_max = le32_to_cpu(ef->sb->cluster_count);
  35         cluster_t rootdir_cluster = le32_to_cpu(ef->sb->rootdir_cluster);
  36
  37         /* Iterate all clusters of the root directory to calculate its size.
  38            It can't be contiguous because there is no flag to indicate this. */
  39         do
  40         {
  41                 if (clusters == clusters_max) /* infinite loop detected */
  42                 {
  43                         exfat_error("root directory cannot occupy all %d clusters",
  44                                         clusters);
  45                         return 0;
  46                 }
  47                 if (CLUSTER_INVALID(*ef->sb, rootdir_cluster))
  48                 {
  49                         exfat_error("bad cluster %#x while reading root directory",
  50                                         rootdir_cluster);
  51                         return 0;
  52                 }
  53                 rootdir_cluster = exfat_next_cluster(ef, ef->root, rootdir_cluster);
  54                 clusters++;
  55         }
  56         while (rootdir_cluster != EXFAT_CLUSTER_END);
  57
  58         return (uint64_t) clusters * CLUSTER_SIZE(*ef->sb);
  59 }
  60
  61 static const char* get_option(const char* options, const char* option_name)
  62 {
  63         const char* p;
  64         size_t length = strlen(option_name);
  65
  66         for (p = strstr(options, option_name); p; p = strstr(p + 1, option_name))
  67                 if ((p == options || p[-1] == ',') && p[length] == '=')
  68                         return p + length + 1;
  69         return NULL;
  70 }
  71
  72 static int get_int_option(const char* options, const char* option_name,
  73                 int base, int default_value)
  74 {
  75         const char* p = get_option(options, option_name);
  76
  77         if (p == NULL)
  78                 return default_value;
  79         return strtol(p, NULL, base);
  80 }
  81
  82 static bool match_option(const char* options, const char* option_name)
  83 {
  84         const char* p;
  85         size_t length = strlen(option_name);
  86
  87         for (p = strstr(options, option_name); p; p = strstr(p + 1, option_name))
  88                 if ((p == options || p[-1] == ',') &&
  89                                 (p[length] == ',' || p[length] == '\0'))
  90                         return true;
  91         return false;
  92 }
  93
  94 static void parse_options(struct exfat* ef, const char* options)
  95 {
  96         int opt_umask;
  97
  98         opt_umask = get_int_option(options, "umask", 8, 0);
  99         ef->dmask = get_int_option(options, "dmask", 8, opt_umask);
 100         ef->fmask = get_int_option(options, "fmask", 8, opt_umask);
 101
 102         ef->uid = get_int_option(options, "uid", 10, geteuid());
 103         ef->gid = get_int_option(options, "gid", 10, getegid());
 104
 105         ef->noatime = match_option(options, "noatime");
 106
 107         switch (get_int_option(options, "repair", 10, 0))
 108         {
 109         case 1:
 110                 ef->repair = EXFAT_REPAIR_ASK;
 111                 break;
 112         case 2:
 113                 ef->repair = EXFAT_REPAIR_YES;
 114                 break;
 115         default:
 116                 ef->repair = EXFAT_REPAIR_NO;
 117                 break;
 118         }
 119 }
 120
 121 static bool verify_vbr_checksum(const struct exfat* ef, void* sector)
 122 {
 123         off_t sector_size = SECTOR_SIZE(*ef->sb);
 124         uint32_t vbr_checksum;
 125         int i;
 126
 127         if (exfat_pread(ef->dev, sector, sector_size, 0) < 0)
 128         {
 129                 exfat_error("failed to read boot sector");
 130                 return false;
 131         }
 132         vbr_checksum = exfat_vbr_start_checksum(sector, sector_size);
 133         for (i = 1; i < 11; i++)
 134         {
 135                 if (exfat_pread(ef->dev, sector, sector_size, i * sector_size) < 0)
 136                 {
 137                         exfat_error("failed to read VBR sector");
 138                         return false;
 139                 }
 140                 vbr_checksum = exfat_vbr_add_checksum(sector, sector_size,
 141                                 vbr_checksum);
 142         }
 143         if (exfat_pread(ef->dev, sector, sector_size, i * sector_size) < 0)
 144         {
 145                 exfat_error("failed to read VBR checksum sector");
 146                 return false;
 147         }
 148         for (i = 0; i < sector_size / sizeof(vbr_checksum); i++)
 149                 if (le32_to_cpu(((const le32_t*) sector)[i]) != vbr_checksum)
 150                 {
 151                         exfat_error("invalid VBR checksum 0x%x (expected 0x%x)",
 152                                         le32_to_cpu(((const le32_t*) sector)[i]), vbr_checksum);
 153                         return false;
 154                 }
 155         return true;
 156 }
 157
 158 static int commit_super_block(const struct exfat* ef)
 159 {
 160         if (exfat_pwrite(ef->dev, ef->sb, sizeof(struct exfat_super_block), 0) < 0)
 161         {
 162                 exfat_error("failed to write super block");
 163                 return 1;
 164         }
 165         return exfat_fsync(ef->dev);
 166 }
 167
 168 static int prepare_super_block(const struct exfat* ef)
 169 {
 170         if (le16_to_cpu(ef->sb->volume_state) & EXFAT_STATE_MOUNTED)
 171                 exfat_warn("volume was not unmounted cleanly");
 172
 173         if (ef->ro)
 174                 return 0;
 175
 176         ef->sb->volume_state = cpu_to_le16(
 177                         le16_to_cpu(ef->sb->volume_state) | EXFAT_STATE_MOUNTED);
 178         return commit_super_block(ef);
 179 }
 180
 181 static void exfat_free(struct exfat* ef)
 182 {
 183         exfat_close(ef->dev);   /* first of all, close the descriptor */
 184         ef->dev = NULL;                 /* struct exfat_dev is freed by exfat_close() */
 185         free(ef->root);
 186         ef->root = NULL;
 187         free(ef->zero_cluster);
 188         ef->zero_cluster = NULL;
 189         free(ef->cmap.chunk);
 190         ef->cmap.chunk = NULL;
 191         free(ef->upcase);
 192         ef->upcase = NULL;
 193         free(ef->sb);
 194         ef->sb = NULL;
 195 }
 196
 197 int exfat_mount(struct exfat* ef, const char* spec, const char* options)
 198 {
 199         int rc;
 200         enum exfat_mode mode;
 201
 202         exfat_tzset();
 203         memset(ef, 0, sizeof(struct exfat));
 204
 205         parse_options(ef, options);
 206
 207         if (match_option(options, "ro"))
 208                 mode = EXFAT_MODE_RO;
 209         else if (match_option(options, "ro_fallback"))
 210                 mode = EXFAT_MODE_ANY;
 211         else
 212                 mode = EXFAT_MODE_RW;
 213         ef->dev = exfat_open(spec, mode);
 214         if (ef->dev == NULL)
 215                 return -EIO;
 216         if (exfat_get_mode(ef->dev) == EXFAT_MODE_RO)
 217         {
 218                 if (mode == EXFAT_MODE_ANY)
 219                         ef->ro = -1;
 220                 else
 221                         ef->ro = 1;
 222         }
 223
 224         ef->sb = malloc(sizeof(struct exfat_super_block));
 225         if (ef->sb == NULL)
 226         {
 227                 exfat_error("failed to allocate memory for the super block");
 228                 exfat_free(ef);
 229                 return -ENOMEM;
 230         }
 231         memset(ef->sb, 0, sizeof(struct exfat_super_block));
 232
 233         if (exfat_pread(ef->dev, ef->sb, sizeof(struct exfat_super_block), 0) < 0)
 234         {
 235                 exfat_error("failed to read boot sector");
 236                 exfat_free(ef);
 237                 return -EIO;
 238         }
 239         if (memcmp(ef->sb->oem_name, "EXFAT   ", 8) != 0)
 240         {
 241                 exfat_error("exFAT file system is not found");
 242                 exfat_free(ef);
 243                 return -EIO;
 244         }
 245         /* sector cannot be smaller than 512 bytes */
 246         if (ef->sb->sector_bits < 9)
 247         {
 248                 exfat_error("too small sector size: 2^%hhd", ef->sb->sector_bits);
 249                 exfat_free(ef);
 250                 return -EIO;
 251         }
 252         /* officially exFAT supports cluster size up to 32 MB */
 253         if ((int) ef->sb->sector_bits + (int) ef->sb->spc_bits > 25)
 254         {
 255                 exfat_error("too big cluster size: 2^(%hhd+%hhd)",
 256                                 ef->sb->sector_bits, ef->sb->spc_bits);
 257                 exfat_free(ef);
 258                 return -EIO;
 259         }
 260         ef->zero_cluster = malloc(CLUSTER_SIZE(*ef->sb));
 261         if (ef->zero_cluster == NULL)
 262         {
 263                 exfat_error("failed to allocate zero sector");
 264                 exfat_free(ef);
 265                 return -ENOMEM;
 266         }
 267         /* use zero_cluster as a temporary buffer for VBR checksum verification */
 268         if (!verify_vbr_checksum(ef, ef->zero_cluster))
 269         {
 270                 exfat_free(ef);
 271                 return -EIO;
 272         }
 273         memset(ef->zero_cluster, 0, CLUSTER_SIZE(*ef->sb));
 274         if (ef->sb->version.major != 1 || ef->sb->version.minor != 0)
 275         {
 276                 exfat_error("unsupported exFAT version: %hhu.%hhu",
 277                                 ef->sb->version.major, ef->sb->version.minor);
 278                 exfat_free(ef);
 279                 return -EIO;
 280         }
 281         if (ef->sb->fat_count != 1)
 282         {
 283                 exfat_error("unsupported FAT count: %hhu", ef->sb->fat_count);
 284                 exfat_free(ef);
 285                 return -EIO;
 286         }
 287         if (le64_to_cpu(ef->sb->sector_count) * SECTOR_SIZE(*ef->sb) >
 288                         exfat_get_size(ef->dev))
 289         {
 290                 /* this can cause I/O errors later but we don't fail mounting to let
 291                    user rescue data */
 292                 exfat_warn("file system in sectors is larger than device: "
 293                                 "%"PRIu64" * %d > %"PRIu64,
 294                                 le64_to_cpu(ef->sb->sector_count), SECTOR_SIZE(*ef->sb),
 295                                 exfat_get_size(ef->dev));
 296         }
 297         if ((off_t) le32_to_cpu(ef->sb->cluster_count) * CLUSTER_SIZE(*ef->sb) >
 298                         exfat_get_size(ef->dev))
 299         {
 300                 exfat_error("file system in clusters is larger than device: "
 301                                 "%u * %d > %"PRIu64,
 302                                 le32_to_cpu(ef->sb->cluster_count), CLUSTER_SIZE(*ef->sb),
 303                                 exfat_get_size(ef->dev));
 304                 exfat_free(ef);
 305                 return -EIO;
 306         }
 307
 308         ef->root = malloc(sizeof(struct exfat_node));
 309         if (ef->root == NULL)
 310         {
 311                 exfat_error("failed to allocate root node");
 312                 exfat_free(ef);
 313                 return -ENOMEM;
 314         }
 315         memset(ef->root, 0, sizeof(struct exfat_node));
 316         ef->root->attrib = EXFAT_ATTRIB_DIR;
 317         ef->root->start_cluster = le32_to_cpu(ef->sb->rootdir_cluster);
 318         ef->root->fptr_cluster = ef->root->start_cluster;
 319         ef->root->name[0] = cpu_to_le16('\0');
 320         ef->root->size = rootdir_size(ef);
 321         if (ef->root->size == 0)
 322         {
 323                 exfat_free(ef);
 324                 return -EIO;
 325         }
 326         /* exFAT does not have time attributes for the root directory */
 327         ef->root->mtime = 0;
 328         ef->root->atime = 0;
 329         /* always keep at least 1 reference to the root node */
 330         exfat_get_node(ef->root);
 331
 332         rc = exfat_cache_directory(ef, ef->root);
 333         if (rc != 0)
 334                 goto error;
 335         if (ef->upcase == NULL)
 336         {
 337                 exfat_error("upcase table is not found");
 338                 goto error;
 339         }
 340         if (ef->cmap.chunk == NULL)
 341         {
 342                 exfat_error("clusters bitmap is not found");
 343                 goto error;
 344         }
 345
 346         if (prepare_super_block(ef) != 0)
 347                 goto error;
 348
 349         return 0;
 350
 351 error:
 352         exfat_put_node(ef, ef->root);
 353         exfat_reset_cache(ef);
 354         exfat_free(ef);
 355         return -EIO;
 356 }
 357
 358 static void finalize_super_block(struct exfat* ef)
 359 {
 360         if (ef->ro)
 361                 return;
 362
 363         ef->sb->volume_state = cpu_to_le16(
 364                         le16_to_cpu(ef->sb->volume_state) & ~EXFAT_STATE_MOUNTED);
 365
 366         /* Some implementations set the percentage of allocated space to 0xff
 367            on FS creation and never update it. In this case leave it as is. */
 368         if (ef->sb->allocated_percent != 0xff)
 369         {
 370                 uint32_t free, total;
 371
 372                 free = exfat_count_free_clusters(ef);
 373                 total = le32_to_cpu(ef->sb->cluster_count);
 374                 ef->sb->allocated_percent = ((total - free) * 100 + total / 2) / total;
 375         }
 376
 377         commit_super_block(ef); /* ignore return code */
 378 }
 379
 380 void exfat_unmount(struct exfat* ef)
 381 {
 382         exfat_flush_nodes(ef);  /* ignore return code */
 383         exfat_flush(ef);                /* ignore return code */
 384         exfat_put_node(ef, ef->root);
 385         exfat_reset_cache(ef);
 386         finalize_super_block(ef);
 387         exfat_free(ef);                 /* will close the descriptor */
 388 }