1/* 2 * io.h --- the I/O manager abstraction 3 * 4 * Copyright (C) 1993, 1994, 1995, 1996 Theodore Ts'o. 5 * 6 * %Begin-Header% 7 * This file may be redistributed under the terms of the GNU Library 8 * General Public License, version 2. 9 * %End-Header% 10 */ 11 12#ifndef _EXT2FS_EXT2_IO_H 13#define _EXT2FS_EXT2_IO_H 14 15/* 16 * ext2_loff_t is defined here since unix_io.c needs it. 17 */ 18#if defined(__GNUC__) || defined(HAS_LONG_LONG) 19typedef long long ext2_loff_t; 20#else 21typedef long ext2_loff_t; 22#endif 23 24/* llseek.c */ 25ext2_loff_t ext2fs_llseek (int, ext2_loff_t, int); 26 27typedef struct struct_io_manager *io_manager; 28typedef struct struct_io_channel *io_channel; 29typedef struct struct_io_stats *io_stats; 30 31#define CHANNEL_FLAGS_WRITETHROUGH 0x01 32#define CHANNEL_FLAGS_DISCARD_ZEROES 0x02 33#define CHANNEL_FLAGS_BLOCK_DEVICE 0x04 34 35#define io_channel_discard_zeroes_data(i) (i->flags & CHANNEL_FLAGS_DISCARD_ZEROES) 36 37struct struct_io_channel { 38 errcode_t magic; 39 io_manager manager; 40 char *name; 41 int block_size; 42 errcode_t (*read_error)(io_channel channel, 43 unsigned long block, 44 int count, 45 void *data, 46 size_t size, 47 int actual_bytes_read, 48 errcode_t error); 49 errcode_t (*write_error)(io_channel channel, 50 unsigned long block, 51 int count, 52 const void *data, 53 size_t size, 54 int actual_bytes_written, 55 errcode_t error); 56 int refcount; 57 int flags; 58 long reserved[14]; 59 void *private_data; 60 void *app_data; 61 int align; 62}; 63 64struct struct_io_stats { 65 int num_fields; 66 int reserved; 67 unsigned long long bytes_read; 68 unsigned long long bytes_written; 69}; 70 71struct struct_io_manager { 72 errcode_t magic; 73 const char *name; 74 errcode_t (*open)(const char *name, int flags, io_channel *channel); 75 errcode_t (*close)(io_channel channel); 76 errcode_t (*set_blksize)(io_channel channel, int blksize); 77 errcode_t (*read_blk)(io_channel channel, unsigned long block, 78 int count, void *data); 79 errcode_t (*write_blk)(io_channel channel, unsigned long block, 80 int count, const void *data); 81 errcode_t (*flush)(io_channel channel); 82 errcode_t (*write_byte)(io_channel channel, unsigned long offset, 83 int count, const void *data); 84 errcode_t (*set_option)(io_channel channel, const char *option, 85 const char *arg); 86 errcode_t (*get_stats)(io_channel channel, io_stats *io_stats); 87 errcode_t (*read_blk64)(io_channel channel, unsigned long long block, 88 int count, void *data); 89 errcode_t (*write_blk64)(io_channel channel, unsigned long long block, 90 int count, const void *data); 91 errcode_t (*discard)(io_channel channel, unsigned long long block, 92 unsigned long long count); 93 long reserved[16]; 94}; 95 96#define IO_FLAG_RW 0x0001 97#define IO_FLAG_EXCLUSIVE 0x0002 98#define IO_FLAG_DIRECT_IO 0x0004 99 100/* 101 * Convenience functions.... 102 */ 103#define io_channel_close(c) ((c)->manager->close((c))) 104#define io_channel_set_blksize(c,s) ((c)->manager->set_blksize((c),s)) 105#define io_channel_read_blk(c,b,n,d) ((c)->manager->read_blk((c),b,n,d)) 106#define io_channel_write_blk(c,b,n,d) ((c)->manager->write_blk((c),b,n,d)) 107#define io_channel_flush(c) ((c)->manager->flush((c))) 108#define io_channel_bumpcount(c) ((c)->refcount++) 109 110/* io_manager.c */ 111extern errcode_t io_channel_set_options(io_channel channel, 112 const char *options); 113extern errcode_t io_channel_write_byte(io_channel channel, 114 unsigned long offset, 115 int count, const void *data); 116extern errcode_t io_channel_read_blk64(io_channel channel, 117 unsigned long long block, 118 int count, void *data); 119extern errcode_t io_channel_write_blk64(io_channel channel, 120 unsigned long long block, 121 int count, const void *data); 122extern errcode_t io_channel_discard(io_channel channel, 123 unsigned long long block, 124 unsigned long long count); 125extern errcode_t io_channel_alloc_buf(io_channel channel, 126 int count, void *ptr); 127 128/* unix_io.c */ 129extern io_manager unix_io_manager; 130 131/* undo_io.c */ 132extern io_manager undo_io_manager; 133extern errcode_t set_undo_io_backing_manager(io_manager manager); 134extern errcode_t set_undo_io_backup_file(char *file_name); 135 136/* test_io.c */ 137extern io_manager test_io_manager, test_io_backing_manager; 138extern void (*test_io_cb_read_blk) 139 (unsigned long block, int count, errcode_t err); 140extern void (*test_io_cb_write_blk) 141 (unsigned long block, int count, errcode_t err); 142extern void (*test_io_cb_read_blk64) 143 (unsigned long long block, int count, errcode_t err); 144extern void (*test_io_cb_write_blk64) 145 (unsigned long long block, int count, errcode_t err); 146extern void (*test_io_cb_set_blksize) 147 (int blksize, errcode_t err); 148 149#endif /* _EXT2FS_EXT2_IO_H */ 150 151