system/include/fs/fs.h

   1 /*
   2 Copyright (C) 2008  Mathias Gottschlag
   3
   4 Permission is hereby granted, free of charge, to any person obtaining a copy of
   5 this software and associated documentation files (the "Software"), to deal in the
   6 Software without restriction, including without limitation the rights to use,
   7 copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the
   8 Software, and to permit persons to whom the Software is furnished to do so,
   9 subject to the following conditions:
  10
  11 The above copyright notice and this permission notice shall be included in all
  12 copies or substantial portions of the Software.
  13
  14 THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED,
  15 INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A
  16 PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
  17 HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
  18 OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
  19 SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
  20 */
  21 /**
  22  * \file fs.h
  23  * File system access functions.
  24  */
  25
  26 #ifndef FS_FS_H_INCLUDED
  27 #define FS_FS_H_INCLUDED
  28
  29 #include <stdint.h>
  30 #include "mm/memory.h"
  31
  32 /**
  33  * File system driver can only create one file system.
  34  */
  35 #define FS_DRIVER_SINGLE 1
  36 /**
  37  * File system driver can not be mounted manually.
  38  */
  39 #define FS_DRIVER_NOMOUNT 2
  40 /**
  41  * File system does not need any data source (e.g. /dev).
  42  */
  43 #define FS_DRIVER_NODATA 4
  44
  45 struct FsRequest;
  46 struct KeProcess;
  47
  48 /**
  49  * File system information.
  50  */
  51 typedef struct FsFileSystem
  52 {
  53         /**
  54          * Path at which the file system was mounted.
  55          */
  56         char *path;
  57         /**
  58          * Device file which works as the data source for this file system.
  59          */
  60         struct FsFileHandle *device;
  61         /**
  62          * Driver which made this file system.
  63          */
  64         struct FsFileSystemDriver *driver;
  65
  66         /**
  67          * Callback for unmounting the file system.
  68          */
  69         int (*unmount)(struct FsFileSystem *fs);
  70         /**
  71          * Callback for file system requests.
  72          */
  73         int (*query_request)(struct FsFileSystem *fs, struct FsRequest *request);
  74 } FsFileSystem;
  75
  76 /**
  77  * File system driver.
  78  */
  79 typedef struct FsFileSystemDriver
  80 {
  81         /**
  82          * File system driver flags.
  83          */
  84         uint32_t flags;
  85
  86         /**
  87          * Mounts a file system using this driver.
  88          */
  89         FsFileSystem *(*mount)(struct FsFileSystemDriver *driver, const char *path,
  90                 const char *device, uint32_t flags);
  91 } FsFileSystemDriver;
  92
  93 /**
  94  * File information as created by a file system.
  95  */
  96 typedef struct FsFile
  97 {
  98         /**
  99          * Number of file handles referring to this file. The file is not closed
 100          * unless this goes down to 0.
 101          */
 102         uint32_t refcount;
 103         /**
 104          * File system which created this file.
 105          */
 106         FsFileSystem *fs;
 107 } FsFile;
 108
 109 /**
 110  * File handle information
 111  */
 112 typedef struct FsFileHandle
 113 {
 114         /**
 115          * The file which this file handle refers to.
 116          */
 117         FsFile *file;
 118         /**
 119          * Current reading/writing position.
 120          */
 121         uint64_t position;
 122         /**
 123          * File flags as specified at fsOpen().
 124          */
 125         uint32_t flags;
 126 } FsFileHandle;
 127
 128 /**
 129  * Initializes the file system.
 130  */
 131 int fsInit(void);
 132
 133 /**
 134  * Registers a file system driver with the given name.
 135  */
 136 int fsRegisterDriver(FsFileSystemDriver *driver, const char *name);
 137 /**
 138  * Removes a file system driver.
 139  */
 140 int fsUnregisterDriver(FsFileSystemDriver *driver);
 141 /**
 142  * Returns the file system driver with the given name.
 143  */
 144 FsFileSystemDriver *fsGetDriver(const char *name);
 145 /**
 146  * Mounts a file system onto a directory.
 147  * \param driver Driver to be used.
 148  * \param path Path for the file system.
 149  * \param device Device to be used as the data source for the file system.
 150  * \param flags Mounting flags like readonly access.
 151  */
 152 int fsMount(FsFileSystemDriver *driver, const char *path, const char *device,
 153         uint32_t flags);
 154 /**
 155  * Unmounts the file system at the given path.
 156  */
 157 int fsUnmount(const char *path);
 158
 159 #define FS_OPEN_CREATE 1
 160 #define FS_OPEN_READ 2
 161 #define FS_OPEN_WRITE 4
 162 #define FS_OPEN_RW 6
 163
 164 #define FS_MKNOD_FILE 1
 165 #define FS_MKNOD_DIR 2
 166
 167 /**
 168  * Opens a file for use from within the kernel and creates a file handle.
 169  * \param filename Absolute file name.
 170  * \param mode Flags for the open request.
 171  */
 172 FsFileHandle *fsOpen(const char *filename, uint32_t mode);
 173 /**
 174  * Overrides the process variable for the open request.
 175  */
 176 FsFileHandle *fsProcessOpen(struct KeProcess *process, const char *filename, uint32_t mode);
 177 /**
 178  * Closes a file handle.
 179  */
 180 int fsClose(FsFileHandle *file);
 181 /**
 182  * Creates a file system node.
 183  */
 184 int fsMknod(const char *filename, uint32_t mode);
 185
 186 /**
 187  * Writes data to an opened file.
 188  */
 189 int fsWrite(FsFileHandle *file, void *buffer, int size);
 190 /**
 191  * Reads data from an opened file.
 192  */
 193 int fsRead(FsFileHandle *file, void *buffer, int size, int blocking);
 194 /**
 195  * Changes the current position within a file. The position can be different
 196  * within multiple file handles even if they point to one file internally.
 197  * \param file File handle to be used.
 198  * \param offset New offset, relative to whence.
 199  * \param whence Origin for the seek request, can be 0 (from the start of the
 200  * file), 1 (from the current position) or 2 (from the end of the file).
 201  * \return Current absolute file offset.
 202  */
 203 uint64_t fsSeek(FsFileHandle *file, int64_t offset, int whence);
 204 /**
 205  * Issues a file ioctl request.
 206  */
 207 int fsIOCTL(FsFileHandle *file, int request, ...);
 208 /**
 209  * Returns the buffer size for the ioctl parameter or 0 if only one number is
 210  * passed to it directly as an argument.
 211  */
 212 int fsGetIOCTLSize(FsFileHandle *file, int request);
 213
 214 #endif
 215