1*702f3189SChristoph Hellwig // SPDX-License-Identifier: GPL-2.0-only 2*702f3189SChristoph Hellwig /* 3*702f3189SChristoph Hellwig * Code for looking up block devices in the early boot code before mounting the 4*702f3189SChristoph Hellwig * root file system. Unfortunately currently also abused in a few other places. 5*702f3189SChristoph Hellwig */ 6*702f3189SChristoph Hellwig #include <linux/blkdev.h> 7*702f3189SChristoph Hellwig #include <linux/ctype.h> 8*702f3189SChristoph Hellwig 9*702f3189SChristoph Hellwig struct uuidcmp { 10*702f3189SChristoph Hellwig const char *uuid; 11*702f3189SChristoph Hellwig int len; 12*702f3189SChristoph Hellwig }; 13*702f3189SChristoph Hellwig 14*702f3189SChristoph Hellwig /** 15*702f3189SChristoph Hellwig * match_dev_by_uuid - callback for finding a partition using its uuid 16*702f3189SChristoph Hellwig * @dev: device passed in by the caller 17*702f3189SChristoph Hellwig * @data: opaque pointer to the desired struct uuidcmp to match 18*702f3189SChristoph Hellwig * 19*702f3189SChristoph Hellwig * Returns 1 if the device matches, and 0 otherwise. 20*702f3189SChristoph Hellwig */ 21*702f3189SChristoph Hellwig static int match_dev_by_uuid(struct device *dev, const void *data) 22*702f3189SChristoph Hellwig { 23*702f3189SChristoph Hellwig struct block_device *bdev = dev_to_bdev(dev); 24*702f3189SChristoph Hellwig const struct uuidcmp *cmp = data; 25*702f3189SChristoph Hellwig 26*702f3189SChristoph Hellwig if (!bdev->bd_meta_info || 27*702f3189SChristoph Hellwig strncasecmp(cmp->uuid, bdev->bd_meta_info->uuid, cmp->len)) 28*702f3189SChristoph Hellwig return 0; 29*702f3189SChristoph Hellwig return 1; 30*702f3189SChristoph Hellwig } 31*702f3189SChristoph Hellwig 32*702f3189SChristoph Hellwig /** 33*702f3189SChristoph Hellwig * devt_from_partuuid - looks up the dev_t of a partition by its UUID 34*702f3189SChristoph Hellwig * @uuid_str: char array containing ascii UUID 35*702f3189SChristoph Hellwig * 36*702f3189SChristoph Hellwig * The function will return the first partition which contains a matching 37*702f3189SChristoph Hellwig * UUID value in its partition_meta_info struct. This does not search 38*702f3189SChristoph Hellwig * by filesystem UUIDs. 39*702f3189SChristoph Hellwig * 40*702f3189SChristoph Hellwig * If @uuid_str is followed by a "/PARTNROFF=%d", then the number will be 41*702f3189SChristoph Hellwig * extracted and used as an offset from the partition identified by the UUID. 42*702f3189SChristoph Hellwig * 43*702f3189SChristoph Hellwig * Returns the matching dev_t on success or 0 on failure. 44*702f3189SChristoph Hellwig */ 45*702f3189SChristoph Hellwig static int devt_from_partuuid(const char *uuid_str, dev_t *devt) 46*702f3189SChristoph Hellwig { 47*702f3189SChristoph Hellwig struct uuidcmp cmp; 48*702f3189SChristoph Hellwig struct device *dev = NULL; 49*702f3189SChristoph Hellwig int offset = 0; 50*702f3189SChristoph Hellwig char *slash; 51*702f3189SChristoph Hellwig 52*702f3189SChristoph Hellwig cmp.uuid = uuid_str; 53*702f3189SChristoph Hellwig 54*702f3189SChristoph Hellwig slash = strchr(uuid_str, '/'); 55*702f3189SChristoph Hellwig /* Check for optional partition number offset attributes. */ 56*702f3189SChristoph Hellwig if (slash) { 57*702f3189SChristoph Hellwig char c = 0; 58*702f3189SChristoph Hellwig 59*702f3189SChristoph Hellwig /* Explicitly fail on poor PARTUUID syntax. */ 60*702f3189SChristoph Hellwig if (sscanf(slash + 1, "PARTNROFF=%d%c", &offset, &c) != 1) 61*702f3189SChristoph Hellwig goto out_invalid; 62*702f3189SChristoph Hellwig cmp.len = slash - uuid_str; 63*702f3189SChristoph Hellwig } else { 64*702f3189SChristoph Hellwig cmp.len = strlen(uuid_str); 65*702f3189SChristoph Hellwig } 66*702f3189SChristoph Hellwig 67*702f3189SChristoph Hellwig if (!cmp.len) 68*702f3189SChristoph Hellwig goto out_invalid; 69*702f3189SChristoph Hellwig 70*702f3189SChristoph Hellwig dev = class_find_device(&block_class, NULL, &cmp, &match_dev_by_uuid); 71*702f3189SChristoph Hellwig if (!dev) 72*702f3189SChristoph Hellwig return -ENODEV; 73*702f3189SChristoph Hellwig 74*702f3189SChristoph Hellwig if (offset) { 75*702f3189SChristoph Hellwig /* 76*702f3189SChristoph Hellwig * Attempt to find the requested partition by adding an offset 77*702f3189SChristoph Hellwig * to the partition number found by UUID. 78*702f3189SChristoph Hellwig */ 79*702f3189SChristoph Hellwig *devt = part_devt(dev_to_disk(dev), 80*702f3189SChristoph Hellwig dev_to_bdev(dev)->bd_partno + offset); 81*702f3189SChristoph Hellwig } else { 82*702f3189SChristoph Hellwig *devt = dev->devt; 83*702f3189SChristoph Hellwig } 84*702f3189SChristoph Hellwig 85*702f3189SChristoph Hellwig put_device(dev); 86*702f3189SChristoph Hellwig return 0; 87*702f3189SChristoph Hellwig 88*702f3189SChristoph Hellwig out_invalid: 89*702f3189SChristoph Hellwig pr_err("VFS: PARTUUID= is invalid.\n" 90*702f3189SChristoph Hellwig "Expected PARTUUID=<valid-uuid-id>[/PARTNROFF=%%d]\n"); 91*702f3189SChristoph Hellwig return -EINVAL; 92*702f3189SChristoph Hellwig } 93*702f3189SChristoph Hellwig 94*702f3189SChristoph Hellwig /** 95*702f3189SChristoph Hellwig * match_dev_by_label - callback for finding a partition using its label 96*702f3189SChristoph Hellwig * @dev: device passed in by the caller 97*702f3189SChristoph Hellwig * @data: opaque pointer to the label to match 98*702f3189SChristoph Hellwig * 99*702f3189SChristoph Hellwig * Returns 1 if the device matches, and 0 otherwise. 100*702f3189SChristoph Hellwig */ 101*702f3189SChristoph Hellwig static int match_dev_by_label(struct device *dev, const void *data) 102*702f3189SChristoph Hellwig { 103*702f3189SChristoph Hellwig struct block_device *bdev = dev_to_bdev(dev); 104*702f3189SChristoph Hellwig const char *label = data; 105*702f3189SChristoph Hellwig 106*702f3189SChristoph Hellwig if (!bdev->bd_meta_info || strcmp(label, bdev->bd_meta_info->volname)) 107*702f3189SChristoph Hellwig return 0; 108*702f3189SChristoph Hellwig return 1; 109*702f3189SChristoph Hellwig } 110*702f3189SChristoph Hellwig 111*702f3189SChristoph Hellwig static int devt_from_partlabel(const char *label, dev_t *devt) 112*702f3189SChristoph Hellwig { 113*702f3189SChristoph Hellwig struct device *dev; 114*702f3189SChristoph Hellwig 115*702f3189SChristoph Hellwig dev = class_find_device(&block_class, NULL, label, &match_dev_by_label); 116*702f3189SChristoph Hellwig if (!dev) 117*702f3189SChristoph Hellwig return -ENODEV; 118*702f3189SChristoph Hellwig *devt = dev->devt; 119*702f3189SChristoph Hellwig put_device(dev); 120*702f3189SChristoph Hellwig return 0; 121*702f3189SChristoph Hellwig } 122*702f3189SChristoph Hellwig 123*702f3189SChristoph Hellwig static int devt_from_devname(const char *name, dev_t *devt) 124*702f3189SChristoph Hellwig { 125*702f3189SChristoph Hellwig int part; 126*702f3189SChristoph Hellwig char s[32]; 127*702f3189SChristoph Hellwig char *p; 128*702f3189SChristoph Hellwig 129*702f3189SChristoph Hellwig if (strlen(name) > 31) 130*702f3189SChristoph Hellwig return -EINVAL; 131*702f3189SChristoph Hellwig strcpy(s, name); 132*702f3189SChristoph Hellwig for (p = s; *p; p++) { 133*702f3189SChristoph Hellwig if (*p == '/') 134*702f3189SChristoph Hellwig *p = '!'; 135*702f3189SChristoph Hellwig } 136*702f3189SChristoph Hellwig 137*702f3189SChristoph Hellwig *devt = blk_lookup_devt(s, 0); 138*702f3189SChristoph Hellwig if (*devt) 139*702f3189SChristoph Hellwig return 0; 140*702f3189SChristoph Hellwig 141*702f3189SChristoph Hellwig /* 142*702f3189SChristoph Hellwig * Try non-existent, but valid partition, which may only exist after 143*702f3189SChristoph Hellwig * opening the device, like partitioned md devices. 144*702f3189SChristoph Hellwig */ 145*702f3189SChristoph Hellwig while (p > s && isdigit(p[-1])) 146*702f3189SChristoph Hellwig p--; 147*702f3189SChristoph Hellwig if (p == s || !*p || *p == '0') 148*702f3189SChristoph Hellwig return -EINVAL; 149*702f3189SChristoph Hellwig 150*702f3189SChristoph Hellwig /* try disk name without <part number> */ 151*702f3189SChristoph Hellwig part = simple_strtoul(p, NULL, 10); 152*702f3189SChristoph Hellwig *p = '\0'; 153*702f3189SChristoph Hellwig *devt = blk_lookup_devt(s, part); 154*702f3189SChristoph Hellwig if (*devt) 155*702f3189SChristoph Hellwig return 0; 156*702f3189SChristoph Hellwig 157*702f3189SChristoph Hellwig /* try disk name without p<part number> */ 158*702f3189SChristoph Hellwig if (p < s + 2 || !isdigit(p[-2]) || p[-1] != 'p') 159*702f3189SChristoph Hellwig return -EINVAL; 160*702f3189SChristoph Hellwig p[-1] = '\0'; 161*702f3189SChristoph Hellwig *devt = blk_lookup_devt(s, part); 162*702f3189SChristoph Hellwig if (*devt) 163*702f3189SChristoph Hellwig return 0; 164*702f3189SChristoph Hellwig return -EINVAL; 165*702f3189SChristoph Hellwig } 166*702f3189SChristoph Hellwig 167*702f3189SChristoph Hellwig static int devt_from_devnum(const char *name, dev_t *devt) 168*702f3189SChristoph Hellwig { 169*702f3189SChristoph Hellwig unsigned maj, min, offset; 170*702f3189SChristoph Hellwig char *p, dummy; 171*702f3189SChristoph Hellwig 172*702f3189SChristoph Hellwig if (sscanf(name, "%u:%u%c", &maj, &min, &dummy) == 2 || 173*702f3189SChristoph Hellwig sscanf(name, "%u:%u:%u:%c", &maj, &min, &offset, &dummy) == 3) { 174*702f3189SChristoph Hellwig *devt = MKDEV(maj, min); 175*702f3189SChristoph Hellwig if (maj != MAJOR(*devt) || min != MINOR(*devt)) 176*702f3189SChristoph Hellwig return -EINVAL; 177*702f3189SChristoph Hellwig } else { 178*702f3189SChristoph Hellwig *devt = new_decode_dev(simple_strtoul(name, &p, 16)); 179*702f3189SChristoph Hellwig if (*p) 180*702f3189SChristoph Hellwig return -EINVAL; 181*702f3189SChristoph Hellwig } 182*702f3189SChristoph Hellwig 183*702f3189SChristoph Hellwig return 0; 184*702f3189SChristoph Hellwig } 185*702f3189SChristoph Hellwig 186*702f3189SChristoph Hellwig /* 187*702f3189SChristoph Hellwig * Convert a name into device number. We accept the following variants: 188*702f3189SChristoph Hellwig * 189*702f3189SChristoph Hellwig * 1) <hex_major><hex_minor> device number in hexadecimal represents itself 190*702f3189SChristoph Hellwig * no leading 0x, for example b302. 191*702f3189SChristoph Hellwig * 3) /dev/<disk_name> represents the device number of disk 192*702f3189SChristoph Hellwig * 4) /dev/<disk_name><decimal> represents the device number 193*702f3189SChristoph Hellwig * of partition - device number of disk plus the partition number 194*702f3189SChristoph Hellwig * 5) /dev/<disk_name>p<decimal> - same as the above, that form is 195*702f3189SChristoph Hellwig * used when disk name of partitioned disk ends on a digit. 196*702f3189SChristoph Hellwig * 6) PARTUUID=00112233-4455-6677-8899-AABBCCDDEEFF representing the 197*702f3189SChristoph Hellwig * unique id of a partition if the partition table provides it. 198*702f3189SChristoph Hellwig * The UUID may be either an EFI/GPT UUID, or refer to an MSDOS 199*702f3189SChristoph Hellwig * partition using the format SSSSSSSS-PP, where SSSSSSSS is a zero- 200*702f3189SChristoph Hellwig * filled hex representation of the 32-bit "NT disk signature", and PP 201*702f3189SChristoph Hellwig * is a zero-filled hex representation of the 1-based partition number. 202*702f3189SChristoph Hellwig * 7) PARTUUID=<UUID>/PARTNROFF=<int> to select a partition in relation to 203*702f3189SChristoph Hellwig * a partition with a known unique id. 204*702f3189SChristoph Hellwig * 8) <major>:<minor> major and minor number of the device separated by 205*702f3189SChristoph Hellwig * a colon. 206*702f3189SChristoph Hellwig * 9) PARTLABEL=<name> with name being the GPT partition label. 207*702f3189SChristoph Hellwig * MSDOS partitions do not support labels! 208*702f3189SChristoph Hellwig * 209*702f3189SChristoph Hellwig * If name doesn't have fall into the categories above, we return (0,0). 210*702f3189SChristoph Hellwig * block_class is used to check if something is a disk name. If the disk 211*702f3189SChristoph Hellwig * name contains slashes, the device name has them replaced with 212*702f3189SChristoph Hellwig * bangs. 213*702f3189SChristoph Hellwig */ 214*702f3189SChristoph Hellwig int early_lookup_bdev(const char *name, dev_t *devt) 215*702f3189SChristoph Hellwig { 216*702f3189SChristoph Hellwig if (strncmp(name, "PARTUUID=", 9) == 0) 217*702f3189SChristoph Hellwig return devt_from_partuuid(name + 9, devt); 218*702f3189SChristoph Hellwig if (strncmp(name, "PARTLABEL=", 10) == 0) 219*702f3189SChristoph Hellwig return devt_from_partlabel(name + 10, devt); 220*702f3189SChristoph Hellwig if (strncmp(name, "/dev/", 5) == 0) 221*702f3189SChristoph Hellwig return devt_from_devname(name + 5, devt); 222*702f3189SChristoph Hellwig return devt_from_devnum(name, devt); 223*702f3189SChristoph Hellwig } 224*702f3189SChristoph Hellwig EXPORT_SYMBOL_GPL(early_lookup_bdev); 225