/* * Copyright (C) 2011 Andrea Mazzoleni * * This program is free software: you can redistribute it and/or modify * it under the terms of the GNU General Public License as published by * the Free Software Foundation, either version 3 of the License, or * (at your option) any later version. * * This program is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the * GNU General Public License for more details. * * You should have received a copy of the GNU General Public License * along with this program. If not, see . */ #ifndef __ELEM_H #define __ELEM_H #include "util.h" #include "tommylist.h" #include "tommyhash.h" #include "tommyhashdyn.h" #include "tommyarray.h" /****************************************************************************/ /* snapraid */ /** * Invalid position. */ #define POS_INVALID ((block_off_t)-1) /** * Basic block position type. * With 32 bits and 128k blocks you can address 256 TB. */ typedef uint32_t block_off_t; /** * Basic data position type. * It's signed as file size and offset are usually signed. */ typedef int64_t data_off_t; /** * Content file specification. */ struct snapraid_content { char content[PATH_MAX]; /**< Path of the content file. */ uint64_t device; /**< Device identifier. */ tommy_node node; /**< Next node in the list. */ }; /** * Filter for paths. */ struct snapraid_filter { char pattern[PATH_MAX]; /**< Filter pattern. */ int is_path; /**< If the pattern is only for the complete path. */ int is_dir; /**< If the pattern is only for dir. */ int direction; /**< If it's an inclusion (=1) or an exclusion (=-1). */ tommy_node node; /**< Next node in the list. */ }; struct snapraid_file; #define BLOCK_HAS_HASH 1 /**< If the hash value is valid. */ #define BLOCK_HAS_PARITY 2 /**< If the parity block is valid. */ #define BLOCK_HAS_MASK 3 /**< Mask of all the flags. Used to mix them inside the file pointer. */ /** * Block of a file. */ struct snapraid_block { uintptr_t file_mixed; /**< Back pointer to the file owning this block, mixed with some flags. */ block_off_t parity_pos; /**< Position of the block in the parity. */ unsigned char hash[HASH_SIZE]; /**< Hash of the block. */ }; #define FILE_IS_PRESENT 1 /**< If it's seen as present. */ #define FILE_IS_EXCLUDED 2 /**< If it's an excluded file from the processing. */ #define FILE_IS_LARGER 4 /**< If a larger file was already detected. */ #define FILE_IS_DAMAGED 8 /**< If a fix was attempted but it failed. */ #define FILE_IS_FIXED 16 /**< If a fix was done. */ /** * File. */ struct snapraid_file { int64_t mtime; /**< Modification time. */ uint64_t inode; /**< Inode. */ data_off_t size; /**< Size of the file. */ struct snapraid_block* blockvec; /**< All the blocks of the file. */ block_off_t blockmax; /**< Number of blocks. */ unsigned flag; /**< FILE_IS_* flags. */ char sub[PATH_MAX]; /**< Sub path of the file. Without the disk dir. The disk is implicit. */ /* nodes for data structures */ tommy_node nodelist; tommy_hashdyn_node nodeset; tommy_hashdyn_node pathset; }; /** * Symbolic Link. */ struct snapraid_link { unsigned flag; /**< FILE_IS_* flags. */ char sub[PATH_MAX]; /**< Sub path of the file. Without the disk dir. The disk is implicit. */ char linkto[PATH_MAX]; /**< Link to. */ /* nodes for data structures */ tommy_node nodelist; tommy_hashdyn_node nodeset; }; /** * Disk. */ struct snapraid_disk { char name[PATH_MAX]; /**< Name of the disk. */ char dir[PATH_MAX]; /**< Mount point of the disk. It always terminates with /. */ uint64_t device; /**< Device identifier. */ block_off_t first_free_block; /**< First free searching block. */ tommy_list filelist; /**< List of all the files. */ tommy_hashdyn inodeset; /**< Hashtable by inode of all the files. */ tommy_hashdyn pathset; /**< Hashtable by path of all the files. */ tommy_list linklist; /**< List of all the links. */ tommy_hashdyn linkset; /**< Hashtable by name of all the links. */ tommy_array blockarr; /**< Block array of the disk. */ /* nodes for data structures */ tommy_node node; }; /** * Disk mapping. */ struct snapraid_map { char name[PATH_MAX]; /**< Name of the disk. */ unsigned position; /**< Position of the disk in the parity. */ /* nodes for data structures */ tommy_node node; }; /** * Allocates a content. */ struct snapraid_content* content_alloc(const char* path, uint64_t dev); /** * Deallocates a content. */ void content_free(struct snapraid_content* content); /** * Allocates an exclusion. */ struct snapraid_filter* filter_alloc(int is_include, const char* pattern); /** * Deallocates an exclusion. */ void filter_free(struct snapraid_filter* filter); /** * Filter hidden files. * Return !=0 if it matches and it should be excluded. */ static inline int filter_hidden(int enable, struct dirent* dd, struct stat* st) { if (enable && ishidden(dd, st)) { return 1; /* filter out */ } return 0; } /** * Filters a path using a list of filters. * For each element of the path all the filters are applied, until the first one that matches. * Return !=0 if it matches and it should be excluded. */ int filter_path(tommy_list* filterlist, const char* sub); /** * Filters a dir using a list of filters. * For each element of the path all the filters are applied, until the first one that matches. * Return !=0 if it matches and it should be excluded. */ int filter_dir(tommy_list* filterlist, const char* sub); /** * Filters a path if it's a content file. * Return !=0 if it matches and it should be excluded. */ int filter_content(tommy_list* contentlist, const char* path); /** * Gets the file containing the block. */ static inline struct snapraid_file* block_file_get(struct snapraid_block* block) { return (struct snapraid_file*)(block->file_mixed & ~(uintptr_t)BLOCK_HAS_MASK); } /** * Sets the file containing the block. */ static inline void block_file_set(struct snapraid_block* block, struct snapraid_file* file) { block->file_mixed = (block->file_mixed & ~(uintptr_t)BLOCK_HAS_MASK) | (uintptr_t)file; } static inline int block_flag_has(struct snapraid_block* block, unsigned mask) { return (block->file_mixed & mask) == mask; } static inline void block_flag_set(struct snapraid_block* block, unsigned mask) { block->file_mixed |= mask; } static inline void block_flag_clear(struct snapraid_block* block, unsigned mask) { block->file_mixed &= ~(uintptr_t)mask; } /** * Gets the relative position of a block inside the file. */ block_off_t block_file_pos(struct snapraid_block* block); /** * Checks if the block is the last in the file. */ int block_is_last(struct snapraid_block* block); /** * Gets the size in bytes of the block. * If it's the last block of a file it could be less than block_size. */ unsigned block_file_size(struct snapraid_block* block, unsigned block_size); static inline int file_flag_has(struct snapraid_file* file, unsigned mask) { return (file->flag & mask) == mask; } static inline void file_flag_set(struct snapraid_file* file, unsigned mask) { file->flag |= mask; } static inline void file_flag_clear(struct snapraid_file* file, unsigned mask) { file->flag &= ~mask; } /** * Allocates a file. */ struct snapraid_file* file_alloc(unsigned block_size, const char* sub, uint64_t size, uint64_t mtime, uint64_t inode); /** * Deallocates a file. */ void file_free(struct snapraid_file* file); /** * Returns the name of the file, without the dir. */ const char* file_name(struct snapraid_file* file); /** * Compares a file with an inode. */ int file_inode_compare(const void* void_arg, const void* void_data); /** * Computes the hash of a file inode. */ static inline tommy_uint32_t file_inode_hash(uint64_t inode) { return (tommy_uint32_t)tommy_inthash_u64(inode); } /** * Compares a file with a path. */ int file_path_compare(const void* void_arg, const void* void_data); /** * Computes the hash of a file path. */ static inline tommy_uint32_t file_path_hash(const char* sub) { return tommy_hash_u32(0, sub, strlen(sub)); } static inline int link_flag_has(struct snapraid_link* link, unsigned mask) { return (link->flag & mask) == mask; } static inline void link_flag_set(struct snapraid_link* link, unsigned mask) { link->flag |= mask; } static inline void link_flag_clear(struct snapraid_link* link, unsigned mask) { link->flag &= ~mask; } /** * Allocates a link. */ struct snapraid_link* link_alloc(const char* name, const char* link); /** * Deallocates a link. */ void link_free(struct snapraid_link* link); /** * Compare a link with a name. */ int link_name_compare(const void* void_arg, const void* void_data); /** * Computes the hash of a link name. */ static inline tommy_uint32_t link_name_hash(const char* name) { return tommy_hash_u32(0, name, strlen(name)); } /** * Allocates a disk. */ struct snapraid_disk* disk_alloc(const char* name, const char* dir, uint64_t dev); /** * Deallocates a disk. */ void disk_free(struct snapraid_disk* disk); /** * Gets a specific block of a disk. * Returns 0 if the block is over the end of the disk or not used. */ static inline struct snapraid_block* disk_block_get(struct snapraid_disk* disk, block_off_t pos) { if (pos < tommy_array_size(&disk->blockarr)) return tommy_array_get(&disk->blockarr, pos); else return 0; } /** * Allocates a disk mapping. */ struct snapraid_map* map_alloc(const char* name, unsigned position); /** * Deallocates a disk mapping. */ void map_free(struct snapraid_map* map); #endif