/* * Copyright 2004-2007, Haiku Inc. All Rights Reserved. * Distributed under the terms of the MIT License. */ #ifndef _FS_INTERFACE_H #define _FS_INTERFACE_H /*! File System Interface Layer Definition */ #include #include #include #include #include struct dirent; struct stat; struct fs_info; struct select_sync; /* the file system's private data structures */ typedef void *fs_volume; typedef void *fs_cookie; typedef void *fs_vnode; /* passed to write_stat() */ enum write_stat_mask { FS_WRITE_STAT_MODE = 0x0001, FS_WRITE_STAT_UID = 0x0002, FS_WRITE_STAT_GID = 0x0004, FS_WRITE_STAT_SIZE = 0x0008, FS_WRITE_STAT_ATIME = 0x0010, FS_WRITE_STAT_MTIME = 0x0020, FS_WRITE_STAT_CRTIME = 0x0040 // NOTE: Changing these constants will break // src/kits/storage/LibBeAdapter.cpp:_kern_write_stat(). }; /* passed to write_fs_info() */ #define FS_WRITE_FSINFO_NAME 0x0001 struct file_io_vec { off_t offset; off_t length; }; #define B_CURRENT_FS_API_VERSION "/v1" #ifdef __cplusplus extern "C" { #endif typedef struct file_system_module_info { struct module_info info; const char* pretty_name; uint32 flags; // DDM flags /* scanning (the device is write locked) */ float (*identify_partition)(int fd, partition_data *partition, void **cookie); status_t (*scan_partition)(int fd, partition_data *partition, void *cookie); void (*free_identify_partition_cookie)(partition_data *partition, void *cookie); void (*free_partition_content_cookie)(partition_data *partition); /* general operations */ status_t (*mount)(dev_t id, const char *device, uint32 flags, const char *args, fs_volume *_fs, ino_t *_rootVnodeID); status_t (*unmount)(fs_volume fs); status_t (*read_fs_info)(fs_volume fs, struct fs_info *info); status_t (*write_fs_info)(fs_volume fs, const struct fs_info *info, uint32 mask); status_t (*sync)(fs_volume fs); /* vnode operations */ status_t (*lookup)(fs_volume fs, fs_vnode dir, const char *name, ino_t *_id, int *_type); status_t (*get_vnode_name)(fs_volume fs, fs_vnode vnode, char *buffer, size_t bufferSize); status_t (*get_vnode)(fs_volume fs, ino_t id, fs_vnode *_vnode, bool reenter); status_t (*put_vnode)(fs_volume fs, fs_vnode vnode, bool reenter); status_t (*remove_vnode)(fs_volume fs, fs_vnode vnode, bool reenter); /* VM file access */ bool (*can_page)(fs_volume fs, fs_vnode vnode, fs_cookie cookie); status_t (*read_pages)(fs_volume fs, fs_vnode vnode, fs_cookie cookie, off_t pos, const iovec *vecs, size_t count, size_t *_numBytes, bool mayBlock, bool reenter); status_t (*write_pages)(fs_volume fs, fs_vnode vnode, fs_cookie cookie, off_t pos, const iovec *vecs, size_t count, size_t *_numBytes, bool mayBlock, bool reenter); /* cache file access */ status_t (*get_file_map)(fs_volume fs, fs_vnode vnode, off_t offset, size_t size, struct file_io_vec *vecs, size_t *_count); /* common operations */ status_t (*ioctl)(fs_volume fs, fs_vnode vnode, fs_cookie cookie, ulong op, void *buffer, size_t length); status_t (*set_flags)(fs_volume fs, fs_vnode vnode, fs_cookie cookie, int flags); status_t (*select)(fs_volume fs, fs_vnode vnode, fs_cookie cookie, uint8 event, uint32 ref, selectsync *sync); status_t (*deselect)(fs_volume fs, fs_vnode vnode, fs_cookie cookie, uint8 event, selectsync *sync); status_t (*fsync)(fs_volume fs, fs_vnode vnode); status_t (*read_symlink)(fs_volume fs, fs_vnode link, char *buffer, size_t *_bufferSize); status_t (*create_symlink)(fs_volume fs, fs_vnode dir, const char *name, const char *path, int mode); status_t (*link)(fs_volume fs, fs_vnode dir, const char *name, fs_vnode vnode); status_t (*unlink)(fs_volume fs, fs_vnode dir, const char *name); status_t (*rename)(fs_volume fs, fs_vnode fromDir, const char *fromName, fs_vnode toDir, const char *toName); status_t (*access)(fs_volume fs, fs_vnode vnode, int mode); status_t (*read_stat)(fs_volume fs, fs_vnode vnode, struct stat *stat); status_t (*write_stat)(fs_volume fs, fs_vnode vnode, const struct stat *stat, uint32 statMask); /* file operations */ status_t (*create)(fs_volume fs, fs_vnode dir, const char *name, int openMode, int perms, fs_cookie *_cookie, ino_t *_newVnodeID); status_t (*open)(fs_volume fs, fs_vnode vnode, int openMode, fs_cookie *_cookie); status_t (*close)(fs_volume fs, fs_vnode vnode, fs_cookie cookie); status_t (*free_cookie)(fs_volume fs, fs_vnode vnode, fs_cookie cookie); status_t (*read)(fs_volume fs, fs_vnode vnode, fs_cookie cookie, off_t pos, void *buffer, size_t *length); status_t (*write)(fs_volume fs, fs_vnode vnode, fs_cookie cookie, off_t pos, const void *buffer, size_t *length); /* directory operations */ status_t (*create_dir)(fs_volume fs, fs_vnode parent, const char *name, int perms, ino_t *_newVnodeID); status_t (*remove_dir)(fs_volume fs, fs_vnode parent, const char *name); status_t (*open_dir)(fs_volume fs, fs_vnode vnode, fs_cookie *_cookie); status_t (*close_dir)(fs_volume fs, fs_vnode vnode, fs_cookie cookie); status_t (*free_dir_cookie)(fs_volume fs, fs_vnode vnode, fs_cookie cookie); status_t (*read_dir)(fs_volume fs, fs_vnode vnode, fs_cookie cookie, struct dirent *buffer, size_t bufferSize, uint32 *_num); status_t (*rewind_dir)(fs_volume fs, fs_vnode vnode, fs_cookie cookie); /* attribute directory operations */ status_t (*open_attr_dir)(fs_volume fs, fs_vnode vnode, fs_cookie *_cookie); status_t (*close_attr_dir)(fs_volume fs, fs_vnode vnode, fs_cookie cookie); status_t (*free_attr_dir_cookie)(fs_volume fs, fs_vnode vnode, fs_cookie cookie); status_t (*read_attr_dir)(fs_volume fs, fs_vnode vnode, fs_cookie cookie, struct dirent *buffer, size_t bufferSize, uint32 *_num); status_t (*rewind_attr_dir)(fs_volume fs, fs_vnode vnode, fs_cookie cookie); /* attribute operations */ status_t (*create_attr)(fs_volume fs, fs_vnode vnode, const char *name, uint32 type, int openMode, fs_cookie *_cookie); status_t (*open_attr)(fs_volume fs, fs_vnode vnode, const char *name, int openMode, fs_cookie *_cookie); status_t (*close_attr)(fs_volume fs, fs_vnode vnode, fs_cookie cookie); status_t (*free_attr_cookie)(fs_volume fs, fs_vnode vnode, fs_cookie cookie); status_t (*read_attr)(fs_volume fs, fs_vnode vnode, fs_cookie cookie, off_t pos, void *buffer, size_t *length); status_t (*write_attr)(fs_volume fs, fs_vnode vnode, fs_cookie cookie, off_t pos, const void *buffer, size_t *length); status_t (*read_attr_stat)(fs_volume fs, fs_vnode vnode, fs_cookie cookie, struct stat *stat); status_t (*write_attr_stat)(fs_volume fs, fs_vnode vnode, fs_cookie cookie, const struct stat *stat, int statMask); status_t (*rename_attr)(fs_volume fs, fs_vnode fromVnode, const char *fromName, fs_vnode toVnode, const char *toName); status_t (*remove_attr)(fs_volume fs, fs_vnode vnode, const char *name); /* index directory & index operations */ status_t (*open_index_dir)(fs_volume fs, fs_cookie *cookie); status_t (*close_index_dir)(fs_volume fs, fs_cookie cookie); status_t (*free_index_dir_cookie)(fs_volume fs, fs_cookie cookie); status_t (*read_index_dir)(fs_volume fs, fs_cookie cookie, struct dirent *buffer, size_t bufferSize, uint32 *_num); status_t (*rewind_index_dir)(fs_volume fs, fs_cookie cookie); status_t (*create_index)(fs_volume fs, const char *name, uint32 type, uint32 flags); status_t (*remove_index)(fs_volume fs, const char *name); status_t (*read_index_stat)(fs_volume fs, const char *name, struct stat *stat); /* query operations */ status_t (*open_query)(fs_volume fs, const char *query, uint32 flags, port_id port, uint32 token, fs_cookie *_cookie); status_t (*close_query)(fs_volume fs, fs_cookie cookie); status_t (*free_query_cookie)(fs_volume fs, fs_cookie cookie); status_t (*read_query)(fs_volume fs, fs_cookie cookie, struct dirent *buffer, size_t bufferSize, uint32 *_num); status_t (*rewind_query)(fs_volume fs, fs_cookie cookie); /* capability querying (the device is read locked) */ uint32 (*get_supported_operations)(partition_data* partition, uint32 mask); bool (*validate_resize)(partition_data *partition, off_t *size); bool (*validate_move)(partition_data *partition, off_t *start); bool (*validate_set_content_name)(partition_data *partition, char *name); bool (*validate_set_content_parameters)(partition_data *partition, const char *parameters); bool (*validate_initialize)(partition_data *partition, char *name, const char *parameters); /* shadow partition modification (device is write locked) */ status_t (*shadow_changed)(partition_data *partition, uint32 operation); /* writing (the device is NOT locked) */ status_t (*defragment)(int fd, partition_id partition, disk_job_id job); status_t (*repair)(int fd, partition_id partition, bool checkOnly, disk_job_id job); status_t (*resize)(int fd, partition_id partition, off_t size, disk_job_id job); status_t (*move)(int fd, partition_id partition, off_t offset, disk_job_id job); status_t (*set_content_name)(int fd, partition_id partition, const char *name, disk_job_id job); status_t (*set_content_parameters)(int fd, partition_id partition, const char *parameters, disk_job_id job); status_t (*initialize)(int fd, partition_id partition, const char *name, const char *parameters, off_t partitionSize, disk_job_id job); } file_system_module_info; /* file system add-ons only prototypes */ extern status_t new_vnode(dev_t mountID, ino_t vnodeID, fs_vnode privateNode); extern status_t publish_vnode(dev_t mountID, ino_t vnodeID, fs_vnode privateNode); extern status_t get_vnode(dev_t mountID, ino_t vnodeID, fs_vnode *_privateNode); extern status_t put_vnode(dev_t mountID, ino_t vnodeID); extern status_t remove_vnode(dev_t mountID, ino_t vnodeID); extern status_t unremove_vnode(dev_t mountID, ino_t vnodeID); extern status_t get_vnode_removed(dev_t mountID, ino_t vnodeID, bool* removed); // Deprecated! Will disappear soon! extern status_t notify_listener(int op, dev_t device, ino_t parentNode, ino_t toParentNode, ino_t node, const char *name); extern status_t notify_entry_created(dev_t device, ino_t directory, const char *name, ino_t node); extern status_t notify_entry_removed(dev_t device, ino_t directory, const char *name, ino_t node); extern status_t notify_entry_moved(dev_t device, ino_t fromDirectory, const char *fromName, ino_t toDirectory, const char *toName, ino_t node); extern status_t notify_stat_changed(dev_t device, ino_t node, uint32 statFields); extern status_t notify_attribute_changed(dev_t device, ino_t node, const char *attribute, int32 cause); extern status_t notify_query_entry_created(port_id port, int32 token, dev_t device, ino_t directory, const char *name, ino_t node); extern status_t notify_query_entry_removed(port_id port, int32 token, dev_t device, ino_t directory, const char *name, ino_t node); #ifdef __cplusplus } #endif #endif /* _FS_INTERFACE_H */