// SPDX-License-Identifier: GPL-2.0 /* * linux/fs/apfs/key.c * * Copyright (C) 2018 Ernesto A. Fernández */ #include #include "apfs.h" #include "key.h" #include "super.h" #include "unicode.h" /** * apfs_cat_type - Read the record type of a catalog key * @key: the raw catalog key * * The record type is stored in the last byte of the cnid field; this function * returns that value. */ static inline int apfs_cat_type(struct apfs_key_header *key) { return (le64_to_cpu(key->obj_id_and_type) & APFS_OBJ_TYPE_MASK) >> APFS_OBJ_TYPE_SHIFT; } /** * apfs_cat_cnid - Read the cnid value on a catalog key * @key: the raw catalog key * * The cnid value shares the its field with the record type. This function * masks that part away and returns the result. */ static inline u64 apfs_cat_cnid(struct apfs_key_header *key) { return le64_to_cpu(key->obj_id_and_type) & APFS_OBJ_ID_MASK; } /** * apfs_filename_cmp - Normalize and compare two APFS filenames * @sb: filesystem superblock * @name1, @name2: names to compare * * returns 0 if @name1 and @name2 are equal * < 0 if @name1 comes before @name2 * > 0 if @name1 comes after @name2 */ int apfs_filename_cmp(struct super_block *sb, const char *name1, const char *name2) { struct apfs_unicursor cursor1, cursor2; bool case_fold = apfs_is_case_insensitive(sb); apfs_init_unicursor(&cursor1, name1); apfs_init_unicursor(&cursor2, name2); while (1) { unicode_t uni1, uni2; uni1 = apfs_normalize_next(&cursor1, case_fold); uni2 = apfs_normalize_next(&cursor2, case_fold); if (uni1 != uni2) return uni1 < uni2 ? -1 : 1; if (!uni1) return 0; } } /** * apfs_keycmp - Compare two keys * @sb: filesystem superblock * @k1, @k2: keys to compare * * returns 0 if @k1 and @k2 are equal * < 0 if @k1 comes before @k2 in the btree * > 0 if @k1 comes after @k2 in the btree */ int apfs_keycmp(struct super_block *sb, struct apfs_key *k1, struct apfs_key *k2) { if (k1->id != k2->id) return k1->id < k2->id ? -1 : 1; if (k1->type != k2->type) return k1->type < k2->type ? -1 : 1; if (k1->number != k2->number) return k1->number < k2->number ? -1 : 1; if (!k1->name) return 0; /* Normalization seems to be ignored here, even for directory records */ return strcmp(k1->name, k2->name); } /** * apfs_read_cat_key - Parse an on-disk catalog key * @raw: pointer to the raw key * @size: size of the raw key * @key: apfs_key structure to store the result * * Returns 0 on success, or a negative error code otherwise. */ int apfs_read_cat_key(void *raw, int size, struct apfs_key *key) { if (size < sizeof(struct apfs_key_header)) return -EFSCORRUPTED; key->id = apfs_cat_cnid((struct apfs_key_header *)raw); key->type = apfs_cat_type((struct apfs_key_header *)raw); switch (key->type) { case APFS_TYPE_DIR_REC: if (size < sizeof(struct apfs_drec_hashed_key) + 1 || *((char *)raw + size - 1) != 0) { /* Filename must have NULL-termination */ return -EFSCORRUPTED; } /* Name length is not used in key comparisons, only the hash */ key->number = le32_to_cpu( ((struct apfs_drec_hashed_key *)raw)->name_len_and_hash) & APFS_DREC_HASH_MASK; key->name = ((struct apfs_drec_hashed_key *)raw)->name; break; case APFS_TYPE_XATTR: if (size < sizeof(struct apfs_xattr_key) + 1 || *((char *)raw + size - 1) != 0) { /* xattr name must have NULL-termination */ return -EFSCORRUPTED; } key->number = 0; key->name = ((struct apfs_xattr_key *)raw)->name; break; case APFS_TYPE_FILE_EXTENT: if (size != sizeof(struct apfs_file_extent_key)) return -EFSCORRUPTED; key->number = le64_to_cpu( ((struct apfs_file_extent_key *)raw)->logical_addr); key->name = NULL; break; default: key->number = 0; key->name = NULL; break; } return 0; } /** * apfs_read_omap_key - Parse an on-disk object map key * @raw: pointer to the raw key * @size: size of the raw key * @key: apfs_key structure to store the result * * Returns 0 on success, or a negative error code otherwise. */ int apfs_read_omap_key(void *raw, int size, struct apfs_key *key) { if (size < sizeof(struct apfs_omap_key)) return -EFSCORRUPTED; key->id = le64_to_cpu(((struct apfs_omap_key *)raw)->ok_oid); key->type = 0; key->number = le64_to_cpu(((struct apfs_omap_key *)raw)->ok_xid); key->name = NULL; return 0; } /** * apfs_init_drec_hashed_key - Initialize an in-memory key for a dentry query * @sb: filesystem superblock * @ino: inode number of the parent directory * @name: filename (NULL for a multiple query) * @key: apfs_key structure to initialize */ void apfs_init_drec_hashed_key(struct super_block *sb, u64 ino, const char *name, struct apfs_key *key) { struct apfs_unicursor cursor; bool case_fold = apfs_is_case_insensitive(sb); u32 hash = 0xFFFFFFFF; key->id = ino; key->type = APFS_TYPE_DIR_REC; /* To respect normalization, queries can only consider the hash */ key->name = NULL; if (!name) { key->number = 0; return; } apfs_init_unicursor(&cursor, name); while (1) { unicode_t utf32; utf32 = apfs_normalize_next(&cursor, case_fold); if (!utf32) break; hash = crc32c(hash, &utf32, sizeof(utf32)); } /* The filename length doesn't matter, so it's left as zero */ key->number = hash << APFS_DREC_HASH_SHIFT; }