// file layer on top of POSIX. // provides streaming support and caching. // // Copyright (c) 2004 Jan Wassenberg // // This file is free software; you can redistribute it and/or // modify it under the terms of the GNU General Public License as // published by the Free Software Foundation; either version 2 of the // License, or (at your option) any later version. // // This file is distributed in the hope that it will be useful, but // WITHOUT ANY WARRANTY; without even the implied warranty of // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU // General Public License for more details. // // Contact info: // Jan.Wassenberg@stud.uni-karlsruhe.de // http://www.stud.uni-karlsruhe.de/~urkt/ #ifndef FILE_H #define FILE_H #include "h_mgr.h" #include "lib.h" struct File { #ifdef PARANOIA u32 magic; #endif // keep offset of flags and size members in sync with struct ZFile! // it is accessed by VFS and must be the same for both (union). // dirty, but necessary because VFile is pushing the HDATA size limit. int flags; off_t size; u32 fn_hash; void* mapping; int fd; }; enum { // open for writing FILE_WRITE = 1, FILE_MEM_READONLY = 2, // do not cache any part of the file // (e.g. if caching on a higher level) FILE_NO_CACHE = 4 }; // keep in sync with zip.cpp and vfs.cpp *_CB_FLAGS! enum FILE_CB_FLAGS { // location LOC_DIR = BIT(0), }; // set current directory to rel_path, relative to the path to the executable, // which is taken from argv0. // // example: executable in "$install_dir/system"; desired root dir is // "$install_dir/data" => rel_path = "../data". // // this is necessary because the current directory is unknown at startup // (e.g. it isn't set when invoked via batch file), and this is the // easiest portable way to find our install directory. // // can only be called once, by design (see source). rel_path is trusted. extern int file_rel_chdir(const char* argv0, const char* rel_path); typedef int(*FileCB)(const char* const name, const uint flags, const ssize_t size, const uintptr_t user); // not recursive - only the files in