1 /* 2 * File access convenience functions and types. 3 * 4 * Copyright (C) 2021 Paul Boddie <paul@boddie.org.uk> 5 * 6 * This program is free software; you can redistribute it and/or 7 * modify it under the terms of the GNU General Public License as 8 * published by the Free Software Foundation; either version 2 of 9 * the License, or (at your option) any later version. 10 * 11 * This program is distributed in the hope that it will be useful, 12 * but WITHOUT ANY WARRANTY; without even the implied warranty of 13 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the 14 * GNU General Public License for more details. 15 * 16 * You should have received a copy of the GNU General Public License 17 * along with this program; if not, write to the Free Software 18 * Foundation, Inc., 51 Franklin Street, Fifth Floor, 19 * Boston, MA 02110-1301, USA 20 */ 21 22 #include <l4/sys/types.h> 23 24 #include <systypes/base.h> 25 26 27 28 EXTERN_C_BEGIN 29 30 /* File access abstraction. */ 31 32 typedef struct 33 { 34 /* File object reference. */ 35 36 l4_cap_idx_t ref; 37 38 /* Mapped memory accessing a file region. */ 39 40 char *memory; 41 42 /* File region parameters. */ 43 44 offset_t start_pos, end_pos; /* start and end positions of region */ 45 length_t data_end; /* amount/extent of data in the region */ 46 length_t data_current; /* client access offset */ 47 48 /* Total size of file. */ 49 50 offset_t size; 51 52 /* Arbitrary memory mapping support. */ 53 54 int can_mmap; 55 56 } file_t; 57 58 59 60 /* File operations. */ 61 62 void file_close(file_t *file); 63 long file_open(file_t *file, const char *filename, flags_t flags, l4_cap_idx_t server); 64 65 /* File lifecycle operations. */ 66 67 long file_context(file_t *file, l4_cap_idx_t server); 68 long file_context_open(file_t *file, flags_t flags, file_t *context); 69 void file_init(file_t *file); 70 71 /* File and region operations. */ 72 73 long file_flush(file_t *file); 74 long file_mmap(file_t *file, offset_t position, length_t length); 75 long file_resize(file_t *file, offset_t size); 76 77 /* File and region properties. */ 78 79 length_t file_populated_span(file_t *file); 80 length_t file_span(file_t *file); 81 82 /* Convenience functions. */ 83 84 char *file_string_get(file_t *file, length_t offset); 85 int file_string_set(file_t *file, const char *data, length_t offset, length_t *written); 86 87 /* Client data functions. */ 88 89 length_t file_data_available(file_t *file); 90 char *file_data_current(file_t *file); 91 length_t file_data_space(file_t *file); 92 93 /* Client data position functions. */ 94 95 offset_t file_data_current_position(file_t *file); 96 offset_t file_data_end_position(file_t *file); 97 98 /* Client data transfer functions. */ 99 100 void file_data_read(file_t *file, char *buf, size_t to_transfer); 101 void file_data_write(file_t *file, char *buf, size_t to_transfer); 102 103 104 105 /* Pipe operations. */ 106 107 long pipe_open(length_t size, file_t *reader, file_t *writer, l4_cap_idx_t server); 108 109 /* Pipe region operations. */ 110 111 long pipe_current(file_t *pipe); 112 long pipe_next(file_t *pipe); 113 long pipe_written(file_t *pipe, length_t size); 114 115 EXTERN_C_END 116 117 // vim: tabstop=2 expandtab shiftwidth=2