1/* 2 * Copyright 2004-2020, Haiku Inc. All Rights Reserved. 3 * Distributed under the terms of the MIT License. 4 */ 5#ifndef _FS_CACHE_H 6#define _FS_CACHE_H 7 8/*! File System File and Block Caches */ 9 10 11#include <fs_interface.h> 12 13 14/* transaction events */ 15enum { 16 TRANSACTION_WRITTEN = 0x01, 17 TRANSACTION_ABORTED = 0x02, 18 TRANSACTION_ENDED = 0x04, 19 TRANSACTION_IDLE = 0x08 20}; 21 22/* file map modes */ 23enum { 24 FILE_MAP_CACHE_ON_DEMAND = 0x01, /* default mode */ 25 FILE_MAP_CACHE_ALL = 0x02 26}; 27 28typedef void (*transaction_notification_hook)(int32 id, int32 event, 29 void *data); 30 31#ifdef __cplusplus 32extern "C" { 33#endif 34 35/* transactions */ 36extern int32 cache_start_transaction(void *cache); 37extern status_t cache_sync_transaction(void *cache, int32 id); 38extern status_t cache_end_transaction(void *cache, int32 id, 39 transaction_notification_hook hook, void *data); 40extern status_t cache_abort_transaction(void *cache, int32 id); 41extern int32 cache_detach_sub_transaction(void *cache, int32 id, 42 transaction_notification_hook hook, void *data); 43extern status_t cache_abort_sub_transaction(void *cache, int32 id); 44extern status_t cache_start_sub_transaction(void *cache, int32 id); 45extern status_t cache_add_transaction_listener(void *cache, int32 id, 46 int32 events, transaction_notification_hook hook, 47 void *data); 48extern status_t cache_remove_transaction_listener(void *cache, int32 id, 49 transaction_notification_hook hook, void *data); 50extern status_t cache_next_block_in_transaction(void *cache, int32 id, 51 bool mainOnly, long *_cookie, off_t *_blockNumber, 52 void **_data, void **_unchangedData); 53extern int32 cache_blocks_in_transaction(void *cache, int32 id); 54extern int32 cache_blocks_in_main_transaction(void *cache, int32 id); 55extern int32 cache_blocks_in_sub_transaction(void *cache, int32 id); 56extern bool cache_has_block_in_transaction(void* cache, int32 id, off_t blockNumber); 57 58/* block cache */ 59extern void block_cache_delete(void *cache, bool allowWrites); 60extern void *block_cache_create(int fd, off_t numBlocks, size_t blockSize, 61 bool readOnly); 62extern status_t block_cache_sync(void *cache); 63extern status_t block_cache_sync_etc(void *cache, off_t blockNumber, 64 size_t numBlocks); 65extern void block_cache_discard(void *cache, off_t blockNumber, 66 size_t numBlocks); 67extern status_t block_cache_make_writable(void *cache, off_t blockNumber, 68 int32 transaction); 69extern status_t block_cache_get_writable_etc(void *cache, off_t blockNumber, 70 off_t base, off_t length, int32 transaction, void** _block); 71extern void *block_cache_get_writable(void *cache, off_t blockNumber, 72 int32 transaction); 73extern void *block_cache_get_empty(void *cache, off_t blockNumber, 74 int32 transaction); 75extern status_t block_cache_get_etc(void *cache, off_t blockNumber, 76 off_t base, off_t length, const void** _block); 77extern const void *block_cache_get(void *cache, off_t blockNumber); 78extern status_t block_cache_set_dirty(void *cache, off_t blockNumber, 79 bool isDirty, int32 transaction); 80extern void block_cache_put(void *cache, off_t blockNumber); 81 82/* file cache */ 83extern void *file_cache_create(dev_t mountID, ino_t vnodeID, off_t size); 84extern void file_cache_delete(void *cacheRef); 85extern void file_cache_enable(void *cacheRef); 86extern bool file_cache_is_enabled(void *cacheRef); 87extern status_t file_cache_disable(void *cacheRef); 88extern status_t file_cache_set_size(void *cacheRef, off_t size); 89extern status_t file_cache_sync(void *cache); 90 91extern status_t file_cache_read(void *cacheRef, void *cookie, off_t offset, 92 void *bufferBase, size_t *_size); 93extern status_t file_cache_write(void *cacheRef, void *cookie, off_t offset, 94 const void *buffer, size_t *_size); 95 96/* file map */ 97extern void *file_map_create(dev_t mountID, ino_t vnodeID, off_t size); 98extern void file_map_delete(void *map); 99extern void file_map_set_size(void *map, off_t size); 100extern void file_map_invalidate(void *map, off_t offset, off_t size); 101extern status_t file_map_set_mode(void *map, uint32 mode); 102extern status_t file_map_translate(void *map, off_t offset, size_t size, 103 struct file_io_vec *vecs, size_t *_count, size_t align); 104 105/* entry cache */ 106extern status_t entry_cache_add(dev_t mountID, ino_t dirID, const char* name, 107 ino_t nodeID); 108extern status_t entry_cache_add_missing(dev_t mountID, ino_t dirID, 109 const char* name); 110extern status_t entry_cache_remove(dev_t mountID, ino_t dirID, 111 const char* name); 112 113#ifdef __cplusplus 114} 115#endif 116 117#endif /* _FS_CACHE_H */ 118