/*

* Internal function/structure declaration. Do NOT include in your

* application.

*

* Please see the file LICENSE in the source's root directory.

*

* This file written by Ryan C. Gordon.

*/

#ifndef _INCLUDE_PHYSFS_INTERNAL_H_

#define _INCLUDE_PHYSFS_INTERNAL_H_

#ifndef __PHYSICSFS_INTERNAL__

#error Do not include this header from your applications.

#endif

#include "physfs.h"

#ifdef HAVE_ASSERT_H

#include <assert.h>

#else

#define assert(x)

#endif

#ifdef __cplusplus

extern "C" {

#endif

/* The LANG section. */

/* please send questions/translations to Ryan: icculus@clutteredmind.org. */

#if (!defined PHYSFS_LANG)

# define PHYSFS_LANG PHYSFS_LANG_ENGLISH

#endif

#define PHYSFS_LANG_ENGLISH 1 /* English by Ryan C. Gordon */

#define PHYSFS_LANG_FRENCH 7 /* French by Stéphane Peter */

#define PHYSFS_LANG_GERMAN 8 /* German by Michael Renner */

#if (PHYSFS_LANG == PHYSFS_LANG_ENGLISH)

#define DIR_ARCHIVE_DESCRIPTION "Non-archive, direct filesystem I/O"

#define GRP_ARCHIVE_DESCRIPTION "Build engine Groupfile format"

#define HOG_ARCHIVE_DESCRIPTION "Descent I/II HOG file format"

#define MVL_ARCHIVE_DESCRIPTION "Descent II Movielib format"

#define QPAK_ARCHIVE_DESCRIPTION "Quake I/II format"

#define ZIP_ARCHIVE_DESCRIPTION "PkZip/WinZip/Info-Zip compatible"

#define ERR_IS_INITIALIZED "Already initialized"

#define ERR_NOT_INITIALIZED "Not initialized"

#define ERR_INVALID_ARGUMENT "Invalid argument"

#define ERR_FILES_STILL_OPEN "Files still open"

#define ERR_NO_DIR_CREATE "Failed to create directories"

#define ERR_OUT_OF_MEMORY "Out of memory"

#define ERR_NOT_IN_SEARCH_PATH "No such entry in search path"

#define ERR_NOT_SUPPORTED "Operation not supported"

#define ERR_UNSUPPORTED_ARCHIVE "Archive type unsupported"

#define ERR_NOT_A_HANDLE "Not a file handle"

#define ERR_INSECURE_FNAME "Insecure filename"

#define ERR_SYMLINK_DISALLOWED "Symbolic links are disabled"

#define ERR_NO_WRITE_DIR "Write directory is not set"

#define ERR_NO_SUCH_FILE "File not found"

#define ERR_NO_SUCH_PATH "Path not found"

#define ERR_NO_SUCH_VOLUME "Volume not found"

#define ERR_PAST_EOF "Past end of file"

#define ERR_ARC_IS_READ_ONLY "Archive is read-only"

#define ERR_IO_ERROR "I/O error"

#define ERR_CANT_SET_WRITE_DIR "Can't set write directory"

#define ERR_SYMLINK_LOOP "Infinite symbolic link loop"

#define ERR_COMPRESSION "(De)compression error"

#define ERR_NOT_IMPLEMENTED "Not implemented"

#define ERR_OS_ERROR "Operating system reported error"

#define ERR_FILE_EXISTS "File already exists"

#define ERR_NOT_A_FILE "Not a file"

#define ERR_NOT_A_DIR "Not a directory"

#define ERR_NOT_AN_ARCHIVE "Not an archive"

#define ERR_CORRUPTED "Corrupted archive"

#define ERR_SEEK_OUT_OF_RANGE "Seek out of range"

#define ERR_BAD_FILENAME "Bad filename"

#define ERR_PHYSFS_BAD_OS_CALL "(BUG) PhysicsFS made a bad system call"

#define ERR_ARGV0_IS_NULL "argv0 is NULL"

#define ERR_ZLIB_NEED_DICT "zlib: need dictionary"

#define ERR_ZLIB_DATA_ERROR "zlib: data error"

#define ERR_ZLIB_MEMORY_ERROR "zlib: memory error"

#define ERR_ZLIB_BUFFER_ERROR "zlib: buffer error"

#define ERR_ZLIB_VERSION_ERROR "zlib: version error"

#define ERR_ZLIB_UNKNOWN_ERROR "zlib: unknown error"

#define ERR_SEARCHPATH_TRUNC "Search path was truncated"

#define ERR_GETMODFN_TRUNC "GetModuleFileName() was truncated"

#define ERR_GETMODFN_NO_DIR "GetModuleFileName() had no dir"

#define ERR_DISK_FULL "Disk is full"

#define ERR_DIRECTORY_FULL "Directory full"

#define ERR_MACOS_GENERIC "MacOS reported error (%d)"

#define ERR_OS2_GENERIC "OS/2 reported error (%d)"

#define ERR_VOL_LOCKED_HW "Volume is locked through hardware"

#define ERR_VOL_LOCKED_SW "Volume is locked through software"

#define ERR_FILE_LOCKED "File is locked"

#define ERR_FILE_OR_DIR_BUSY "File/directory is busy"

#define ERR_FILE_ALREADY_OPEN_W "File already open for writing"

#define ERR_FILE_ALREADY_OPEN_R "File already open for reading"

#define ERR_INVALID_REFNUM "Invalid reference number"

#define ERR_GETTING_FILE_POS "Error getting file position"

#define ERR_VOLUME_OFFLINE "Volume is offline"

#define ERR_PERMISSION_DENIED "Permission denied"

#define ERR_VOL_ALREADY_ONLINE "Volume already online"

#define ERR_NO_SUCH_DRIVE "No such drive"

#define ERR_NOT_MAC_DISK "Not a Macintosh disk"

#define ERR_VOL_EXTERNAL_FS "Volume belongs to an external filesystem"

#define ERR_PROBLEM_RENAME "Problem during rename"

#define ERR_BAD_MASTER_BLOCK "Bad master directory block"

#define ERR_CANT_MOVE_FORBIDDEN "Attempt to move forbidden"

#define ERR_WRONG_VOL_TYPE "Wrong volume type"

#define ERR_SERVER_VOL_LOST "Server volume has been disconnected"

#define ERR_FILE_ID_NOT_FOUND "File ID not found"

#define ERR_FILE_ID_EXISTS "File ID already exists"

#define ERR_SERVER_NO_RESPOND "Server not responding"

#define ERR_USER_AUTH_FAILED "User authentication failed"

#define ERR_PWORD_EXPIRED "Password has expired on server"

#define ERR_ACCESS_DENIED "Access denied"

#define ERR_NOT_A_DOS_DISK "Not a DOS disk"

#define ERR_SHARING_VIOLATION "Sharing violation"

#define ERR_CANNOT_MAKE "Cannot make"

#define ERR_DEV_IN_USE "Device already in use"

#define ERR_OPEN_FAILED "Open failed"

#define ERR_PIPE_BUSY "Pipe is busy"

#define ERR_SHARING_BUF_EXCEEDED "Sharing buffer exceeded"

#define ERR_TOO_MANY_HANDLES "Too many open handles"

#define ERR_SEEK_ERROR "Seek error"

#define ERR_DEL_CWD "Trying to delete current working directory"

#define ERR_WRITE_PROTECT_ERROR "Write protect error"

#define ERR_WRITE_FAULT "Write fault"

#define ERR_LOCK_VIOLATION "Lock violation"

#define ERR_GEN_FAILURE "General failure"

#define ERR_UNCERTAIN_MEDIA "Uncertain media"

#define ERR_PROT_VIOLATION "Protection violation"

#define ERR_BROKEN_PIPE "Broken pipe"

#elif (PHYSFS_LANG == PHYSFS_LANG_GERMAN)

#define DIR_ARCHIVE_DESCRIPTION "Kein Archiv, direkte Ein/Ausgabe in das Dateisystem"

#define GRP_ARCHIVE_DESCRIPTION "Build engine Groupfile format"

#define HOG_ARCHIVE_DESCRIPTION "Descent I/II HOG file format"

#define MVL_ARCHIVE_DESCRIPTION "Descent II Movielib format"

#define QPAK_ARCHIVE_DESCRIPTION "Quake I/II format"

#define ZIP_ARCHIVE_DESCRIPTION "PkZip/WinZip/Info-Zip kompatibel"

#define ERR_IS_INITIALIZED "Bereits initialisiert"

#define ERR_NOT_INITIALIZED "Nicht initialisiert"

#define ERR_INVALID_ARGUMENT "Ungültiges Argument"

#define ERR_FILES_STILL_OPEN "Dateien noch immer geöffnet"

#define ERR_NO_DIR_CREATE "Fehler beim Erzeugen der Verzeichnisse"

#define ERR_OUT_OF_MEMORY "Kein Speicher mehr frei"

#define ERR_NOT_IN_SEARCH_PATH "Eintrag nicht im Suchpfad enthalten"

#define ERR_NOT_SUPPORTED "Befehl nicht unterstützt"

#define ERR_UNSUPPORTED_ARCHIVE "Archiv-Typ nicht unterstützt"

#define ERR_NOT_A_HANDLE "Ist kein Dateideskriptor"

#define ERR_INSECURE_FNAME "Unsicherer Dateiname"

#define ERR_SYMLINK_DISALLOWED "Symbolische Verweise deaktiviert"

#define ERR_NO_WRITE_DIR "Schreibverzeichnis ist nicht gesetzt"

#define ERR_NO_SUCH_FILE "Datei nicht gefunden"

#define ERR_NO_SUCH_PATH "Pfad nicht gefunden"

#define ERR_NO_SUCH_VOLUME "Datencontainer nicht gefunden"

#define ERR_PAST_EOF "Hinter dem Ende der Datei"

#define ERR_ARC_IS_READ_ONLY "Archiv ist schreibgeschützt"

#define ERR_IO_ERROR "Ein/Ausgabe Fehler"

#define ERR_CANT_SET_WRITE_DIR "Kann Schreibverzeichnis nicht setzen"

#define ERR_SYMLINK_LOOP "Endlosschleife durch symbolische Verweise"

#define ERR_COMPRESSION "(De)Kompressionsfehler"

#define ERR_NOT_IMPLEMENTED "Nicht implementiert"

#define ERR_OS_ERROR "Betriebssystem meldete Fehler"

#define ERR_FILE_EXISTS "Datei existiert bereits"

#define ERR_NOT_A_FILE "Ist keine Datei"

#define ERR_NOT_A_DIR "Ist kein Verzeichnis"

#define ERR_NOT_AN_ARCHIVE "Ist kein Archiv"

#define ERR_CORRUPTED "Beschädigtes Archiv"

#define ERR_SEEK_OUT_OF_RANGE "Suche war ausserhalb der Reichweite"

#define ERR_BAD_FILENAME "Unzulässiger Dateiname"

#define ERR_PHYSFS_BAD_OS_CALL "(BUG) PhysicsFS verursachte einen ungültigen Systemaufruf"

#define ERR_ARGV0_IS_NULL "argv0 ist NULL"

#define ERR_ZLIB_NEED_DICT "zlib: brauche Wörterbuch"

#define ERR_ZLIB_DATA_ERROR "zlib: Datenfehler"

#define ERR_ZLIB_MEMORY_ERROR "zlib: Speicherfehler"

#define ERR_ZLIB_BUFFER_ERROR "zlib: Bufferfehler"

#define ERR_ZLIB_VERSION_ERROR "zlib: Versionskonflikt"

#define ERR_ZLIB_UNKNOWN_ERROR "zlib: Unbekannter Fehler"

#define ERR_SEARCHPATH_TRUNC "Suchpfad war abgeschnitten"

#define ERR_GETMODFN_TRUNC "GetModuleFileName() war abgeschnitten"

#define ERR_GETMODFN_NO_DIR "GetModuleFileName() bekam kein Verzeichnis"

#define ERR_DISK_FULL "Laufwerk ist voll"

#define ERR_DIRECTORY_FULL "Verzeichnis ist voll"

#define ERR_MACOS_GENERIC "MacOS meldete Fehler (%d)"

#define ERR_OS2_GENERIC "OS/2 meldete Fehler (%d)"

#define ERR_VOL_LOCKED_HW "Datencontainer ist durch Hardware gesperrt"

#define ERR_VOL_LOCKED_SW "Datencontainer ist durch Software gesperrt"

#define ERR_FILE_LOCKED "Datei ist gesperrt"

#define ERR_FILE_OR_DIR_BUSY "Datei/Verzeichnis ist beschäftigt"

#define ERR_FILE_ALREADY_OPEN_W "Datei schon im Schreibmodus geöffnet"

#define ERR_FILE_ALREADY_OPEN_R "Datei schon im Lesemodus geöffnet"

#define ERR_INVALID_REFNUM "Ungültige Referenznummer"

#define ERR_GETTING_FILE_POS "Fehler beim Finden der Dateiposition"

#define ERR_VOLUME_OFFLINE "Datencontainer ist offline"

#define ERR_PERMISSION_DENIED "Zugriff verweigert"

#define ERR_VOL_ALREADY_ONLINE "Datencontainer ist bereits online"

#define ERR_NO_SUCH_DRIVE "Laufwerk nicht vorhanden"

#define ERR_NOT_MAC_DISK "Ist kein Macintosh Laufwerk"

#define ERR_VOL_EXTERNAL_FS "Datencontainer liegt auf einem externen Dateisystem"

#define ERR_PROBLEM_RENAME "Fehler beim Umbenennen"

#define ERR_BAD_MASTER_BLOCK "Beschädigter Hauptverzeichnisblock"

#define ERR_CANT_MOVE_FORBIDDEN "Verschieben nicht erlaubt"

#define ERR_WRONG_VOL_TYPE "Falscher Datencontainer-Typ"

#define ERR_SERVER_VOL_LOST "Datencontainer am Server wurde getrennt"

#define ERR_FILE_ID_NOT_FOUND "Dateikennung nicht gefunden"

#define ERR_FILE_ID_EXISTS "Dateikennung existiert bereits"

#define ERR_SERVER_NO_RESPOND "Server antwortet nicht"

#define ERR_USER_AUTH_FAILED "Benutzerauthentifizierung fehlgeschlagen"

#define ERR_PWORD_EXPIRED "Passwort am Server ist abgelaufen"

#define ERR_ACCESS_DENIED "Zugriff verweigert"

#define ERR_NOT_A_DOS_DISK "Ist kein DOS-Laufwerk"

#define ERR_SHARING_VIOLATION "Zugriffsverletzung"

#define ERR_CANNOT_MAKE "Kann nicht erzeugen"

#define ERR_DEV_IN_USE "Gerät wird bereits benutzt"

#define ERR_OPEN_FAILED "Öffnen fehlgeschlagen"

#define ERR_PIPE_BUSY "Pipeverbindung ist belegt"

#define ERR_SHARING_BUF_EXCEEDED "Zugriffsbuffer überschritten"

#define ERR_TOO_MANY_HANDLES "Zu viele offene Dateien"

#define ERR_SEEK_ERROR "Fehler beim Suchen"

#define ERR_DEL_CWD "Aktuelles Arbeitsverzeichnis darf nicht gelöscht werden"

#define ERR_WRITE_PROTECT_ERROR "Schreibschutzfehler"

#define ERR_WRITE_FAULT "Schreibfehler"

#define ERR_LOCK_VIOLATION "Sperrverletzung"

#define ERR_GEN_FAILURE "Allgemeiner Fehler"

#define ERR_UNCERTAIN_MEDIA "Unsicheres Medium"

#define ERR_PROT_VIOLATION "Schutzverletzung"

#define ERR_BROKEN_PIPE "Pipeverbindung unterbrochen"

#elif (PHYSFS_LANG == PHYSFS_LANG_FRENCH)

#define DIR_ARCHIVE_DESCRIPTION "Pas d'archive, E/S directes sur système de fichiers"

#define GRP_ARCHIVE_DESCRIPTION "Format Groupfile du moteur Build"

#define HOG_ARCHIVE_DESCRIPTION "Descent I/II HOG file format"

#define MVL_ARCHIVE_DESCRIPTION "Descent II Movielib format"

#define QPAK_ARCHIVE_DESCRIPTION "Quake I/II format"

#define ZIP_ARCHIVE_DESCRIPTION "Compatible PkZip/WinZip/Info-Zip"

#define ERR_IS_INITIALIZED "Déjà initialisé"

#define ERR_NOT_INITIALIZED "Non initialisé"

#define ERR_INVALID_ARGUMENT "Argument invalide"

#define ERR_FILES_STILL_OPEN "Fichiers encore ouverts"

#define ERR_NO_DIR_CREATE "Echec de la création de répertoires"

#define ERR_OUT_OF_MEMORY "A court de mémoire"

#define ERR_NOT_IN_SEARCH_PATH "Aucune entrée dans le chemin de recherche"

#define ERR_NOT_SUPPORTED "Opération non supportée"

#define ERR_UNSUPPORTED_ARCHIVE "Type d'archive non supportée"

#define ERR_NOT_A_HANDLE "Pas un descripteur de fichier"

#define ERR_INSECURE_FNAME "Nom de fichier dangereux"

#define ERR_SYMLINK_DISALLOWED "Les liens symboliques sont désactivés"

#define ERR_NO_WRITE_DIR "Le répertoire d'écriture n'est pas spécifié"

#define ERR_NO_SUCH_FILE "Fichier non trouvé"

#define ERR_NO_SUCH_PATH "Chemin non trouvé"

#define ERR_NO_SUCH_VOLUME "Volume non trouvé"

#define ERR_PAST_EOF "Au-delà de la fin du fichier"

#define ERR_ARC_IS_READ_ONLY "L'archive est en lecture seule"

#define ERR_IO_ERROR "Erreur E/S"

#define ERR_CANT_SET_WRITE_DIR "Ne peut utiliser le répertoire d'écriture"

#define ERR_SYMLINK_LOOP "Boucle infinie dans les liens symboliques"

#define ERR_COMPRESSION "Erreur de (dé)compression"

#define ERR_NOT_IMPLEMENTED "Non implémenté"

#define ERR_OS_ERROR "Erreur rapportée par le système d'exploitation"

#define ERR_FILE_EXISTS "Le fichier existe déjà"

#define ERR_NOT_A_FILE "Pas un fichier"

#define ERR_NOT_A_DIR "Pas un répertoire"

#define ERR_NOT_AN_ARCHIVE "Pas une archive"

#define ERR_CORRUPTED "Archive corrompue"

#define ERR_SEEK_OUT_OF_RANGE "Pointeur de fichier hors de portée"

#define ERR_BAD_FILENAME "Mauvais nom de fichier"

#define ERR_PHYSFS_BAD_OS_CALL "(BOGUE) PhysicsFS a fait un mauvais appel système, le salaud"

#define ERR_ARGV0_IS_NULL "argv0 est NULL"

#define ERR_ZLIB_NEED_DICT "zlib: a besoin du dico"

#define ERR_ZLIB_DATA_ERROR "zlib: erreur de données"

#define ERR_ZLIB_MEMORY_ERROR "zlib: erreur mémoire"

#define ERR_ZLIB_BUFFER_ERROR "zlib: erreur tampon"

#define ERR_ZLIB_VERSION_ERROR "zlib: erreur de version"

#define ERR_ZLIB_UNKNOWN_ERROR "zlib: erreur inconnue"

#define ERR_SEARCHPATH_TRUNC "Le chemin de recherche a été tronqué"

#define ERR_GETMODFN_TRUNC "GetModuleFileName() a été tronqué"

#define ERR_GETMODFN_NO_DIR "GetModuleFileName() n'a pas de répertoire"

#define ERR_DISK_FULL "Disque plein"

#define ERR_DIRECTORY_FULL "Répertoire plein"

#define ERR_MACOS_GENERIC "Erreur rapportée par MacOS (%d)"

#define ERR_OS2_GENERIC "Erreur rapportée par OS/2 (%d)"

#define ERR_VOL_LOCKED_HW "Le volume est verrouillé matériellement"

#define ERR_VOL_LOCKED_SW "Le volume est verrouillé par logiciel"

#define ERR_FILE_LOCKED "Fichier verrouillé"

#define ERR_FILE_OR_DIR_BUSY "Fichier/répertoire occupé"

#define ERR_FILE_ALREADY_OPEN_W "Fichier déjà ouvert en écriture"

#define ERR_FILE_ALREADY_OPEN_R "Fichier déjà ouvert en lecture"

#define ERR_INVALID_REFNUM "Numéro de référence invalide"

#define ERR_GETTING_FILE_POS "Erreur lors de l'obtention de la position du pointeur de fichier"

#define ERR_VOLUME_OFFLINE "Le volume n'est pas en ligne"

#define ERR_PERMISSION_DENIED "Permission refusée"

#define ERR_VOL_ALREADY_ONLINE "Volumé déjà en ligne"

#define ERR_NO_SUCH_DRIVE "Lecteur inexistant"

#define ERR_NOT_MAC_DISK "Pas un disque Macintosh"

#define ERR_VOL_EXTERNAL_FS "Le volume appartient à un système de fichiers externe"

#define ERR_PROBLEM_RENAME "Problème lors du renommage"

#define ERR_BAD_MASTER_BLOCK "Mauvais block maitre de répertoire"

#define ERR_CANT_MOVE_FORBIDDEN "Essai de déplacement interdit"

#define ERR_WRONG_VOL_TYPE "Mauvais type de volume"

#define ERR_SERVER_VOL_LOST "Le volume serveur a été déconnecté"

#define ERR_FILE_ID_NOT_FOUND "Identificateur de fichier non trouvé"

#define ERR_FILE_ID_EXISTS "Identificateur de fichier existe déjà"

#define ERR_SERVER_NO_RESPOND "Le serveur ne répond pas"

#define ERR_USER_AUTH_FAILED "Authentification de l'utilisateur échouée"

#define ERR_PWORD_EXPIRED "Le mot de passe a expiré sur le serveur"

#define ERR_ACCESS_DENIED "Accès refusé"

#define ERR_NOT_A_DOS_DISK "Pas un disque DOS"

#define ERR_SHARING_VIOLATION "Violation de partage"

#define ERR_CANNOT_MAKE "Ne peut faire"

#define ERR_DEV_IN_USE "Périphérique déjà en utilisation"

#define ERR_OPEN_FAILED "Ouverture échouée"

#define ERR_PIPE_BUSY "Le tube est occupé"

#define ERR_SHARING_BUF_EXCEEDED "Tampon de partage dépassé"

#define ERR_TOO_MANY_HANDLES "Trop de descripteurs ouverts"

#define ERR_SEEK_ERROR "Erreur de positionement"

#define ERR_DEL_CWD "Essai de supprimer le répertoire courant"

#define ERR_WRITE_PROTECT_ERROR "Erreur de protection en écriture"

#define ERR_WRITE_FAULT "Erreur d'écriture"

#define ERR_LOCK_VIOLATION "Violation de verrou"

#define ERR_GEN_FAILURE "Echec général"

#define ERR_UNCERTAIN_MEDIA "Média incertain"

#define ERR_PROT_VIOLATION "Violation de protection"

#define ERR_BROKEN_PIPE "Tube cassé"

#else

#error Please define PHYSFS_LANG.

#endif

/* end LANG section. */

struct __PHYSFS_DIRHANDLE__;

struct __PHYSFS_FILEFUNCTIONS__;

typedef struct __PHYSFS_LINKEDSTRINGLIST__

} LinkedStringList;

typedef struct __PHYSFS_FILEHANDLE__

} FileHandle;

typedef struct __PHYSFS_FILEFUNCTIONS__

} FileFunctions;

typedef struct __PHYSFS_DIRHANDLE__

} DirHandle;

/*

* Symlinks should always be followed; PhysicsFS will use

* DirFunctions->isSymLink() and make a judgement on whether to

* continue to call other methods based on that.

*/

typedef struct __PHYSFS_DIRFUNCTIONS__

} DirFunctions;

/*

* Call this to set the message returned by PHYSFS_getLastError().

* Please only use the ERR_* constants above, or add new constants to the

* above group, but I want these all in one place.

*

* Calling this with a NULL argument is a safe no-op.

*/

void __PHYSFS_setError(const char *err);

/*

* Convert (dirName) to platform-dependent notation, then prepend (prepend)

* and append (append) to the converted string.

*

* So, on Win32, calling:

* __PHYSFS_convertToDependent("C:\", "my/files", NULL);

* ...will return the string "C:\my\files".

*

* This is a convenience function; you might want to hack something out that

* is less generic (and therefore more efficient).

*

* Be sure to free() the return value when done with it.

*/

char *__PHYSFS_convertToDependent(const char *prepend,

const char *dirName,

const char *append);

/*

* Verify that (fname) (in platform-independent notation), in relation

* to (h) is secure. That means that each element of fname is checked

* for symlinks (if they aren't permitted). Also, elements such as

* ".", "..", or ":" are flagged.

*

* With some exceptions (like PHYSFS_mkdir(), which builds multiple subdirs

* at a time), you should always pass zero for "allowMissing" for efficiency.

*

* Returns non-zero if string is safe, zero if there's a security issue.

* PHYSFS_getLastError() will specify what was wrong.

*/

int __PHYSFS_verifySecurity(DirHandle *h, const char *fname, int allowMissing);

/*

* Use this to build the list that your enumerate function should return.

* See zip.c for an example of proper use.

*/

LinkedStringList *__PHYSFS_addToLinkedStringList(LinkedStringList *retval,

LinkedStringList **prev,

const char *str,

PHYSFS_sint32 len);

/*

* When sorting the entries in an archive, we use a modified QuickSort.

* When there are less then PHYSFS_QUICKSORT_THRESHOLD entries left to sort,

* we switch over to a BubbleSort for the remainder. Tweak to taste.

*

* You can override this setting by defining PHYSFS_QUICKSORT_THRESHOLD

* before #including "physfs_internal.h".

*/

#ifndef PHYSFS_QUICKSORT_THRESHOLD

#define PHYSFS_QUICKSORT_THRESHOLD 4

#endif

/*

* Sort an array (or whatever) of (max) elements. This uses a mixture of

* a QuickSort and BubbleSort internally.

* (cmpfn) is used to determine ordering, and (swapfn) does the actual

* swapping of elements in the list.

*

* See zip.c for an example.

*/

void __PHYSFS_sort(void *entries, PHYSFS_uint32 max,

int (*cmpfn)(void *, PHYSFS_uint32, PHYSFS_uint32),

void (*swapfn)(void *, PHYSFS_uint32, PHYSFS_uint32));

/* These get used all over for lessening code clutter. */

#define BAIL_MACRO(e, r) { __PHYSFS_setError(e); return r; }

#define BAIL_IF_MACRO(c, e, r) if (c) { __PHYSFS_setError(e); return r; }

#define BAIL_MACRO_MUTEX(e, m, r) { __PHYSFS_setError(e); __PHYSFS_platformReleaseMutex(m); return r; }

#define BAIL_IF_MACRO_MUTEX(c, e, m, r) if (c) { __PHYSFS_setError(e); __PHYSFS_platformReleaseMutex(m); return r; }

/*--------------------------------------------------------------------------*/

/*--------------------------------------------------------------------------*/

/*------------ ----------------*/

/*------------ You MUST implement the following functions ----------------*/

/*------------ if porting to a new platform. ----------------*/

/*------------ (see platform/unix.c for an example) ----------------*/

/*------------ ----------------*/

/*--------------------------------------------------------------------------*/

/*--------------------------------------------------------------------------*/

/*

* The dir separator; "/" on unix, "\\" on win32, ":" on MacOS, etc...

* Obviously, this isn't a function, but it IS a null-terminated string.

*/

extern const char *__PHYSFS_platformDirSeparator;

/*

* Initialize the platform. This is called when PHYSFS_init() is called from

* the application. You can use this to (for example) determine what version

* of Windows you're running.

*

* Return zero if there was a catastrophic failure (which prevents you from

* functioning at all), and non-zero otherwise.

*/

int __PHYSFS_platformInit(void);

/*

* Deinitialize the platform. This is called when PHYSFS_deinit() is called

* from the application. You can use this to clean up anything you've

* allocated in your platform driver.

*

* Return zero if there was a catastrophic failure (which prevents you from

* functioning at all), and non-zero otherwise.

*/

int __PHYSFS_platformDeinit(void);

/*

* Open a file for reading. (filename) is in platform-dependent notation. The

* file pointer should be positioned on the first byte of the file.

*

* The return value will be some platform-specific datatype that is opaque to

* the caller; it could be a (FILE *) under Unix, or a (HANDLE *) under win32.

*

* The same file can be opened for read multiple times, and each should have

* a unique file handle; this is frequently employed to prevent race

* conditions in the archivers.

*

* Call __PHYSFS_setError() and return (NULL) if the file can't be opened.

*/

void *__PHYSFS_platformOpenRead(const char *filename);

/*

* Open a file for writing. (filename) is in platform-dependent notation. If

* the file exists, it should be truncated to zero bytes, and if it doesn't

* exist, it should be created as a zero-byte file. The file pointer should

* be positioned on the first byte of the file.

*

* The return value will be some platform-specific datatype that is opaque to

* the caller; it could be a (FILE *) under Unix, or a (HANDLE *) under win32,

* etc.

*

* Opening a file for write multiple times has undefined results.

*

* Call __PHYSFS_setError() and return (NULL) if the file can't be opened.

*/

void *__PHYSFS_platformOpenWrite(const char *filename);

/*

* Open a file for appending. (filename) is in platform-dependent notation. If

* the file exists, the file pointer should be place just past the end of the

* file, so that the first write will be one byte after the current end of

* the file. If the file doesn't exist, it should be created as a zero-byte

* file. The file pointer should be positioned on the first byte of the file.

*

* The return value will be some platform-specific datatype that is opaque to

* the caller; it could be a (FILE *) under Unix, or a (HANDLE *) under win32,

* etc.

*

* Opening a file for append multiple times has undefined results.

*

* Call __PHYSFS_setError() and return (NULL) if the file can't be opened.

*/

void *__PHYSFS_platformOpenAppend(const char *filename);

/*

* Read more data from a platform-specific file handle. (opaque) should be

* cast to whatever data type your platform uses. Read a maximum of (count)

* objects of (size) 8-bit bytes to the area pointed to by (buffer). If there

* isn't enough data available, return the number of full objects read, and

* position the file pointer at the start of the first incomplete object.

* On success, return (count) and position the file pointer one byte past

* the end of the last read object. Return (-1) if there is a catastrophic

* error, and call __PHYSFS_setError() to describe the problem; the file

* pointer should not move in such a case.

*/

PHYSFS_sint64 __PHYSFS_platformRead(void *opaque, void *buffer,

PHYSFS_uint32 size, PHYSFS_uint32 count);

/*

* Write more data to a platform-specific file handle. (opaque) should be

* cast to whatever data type your platform uses. Write a maximum of (count)

* objects of (size) 8-bit bytes from the area pointed to by (buffer). If

* there isn't enough data available, return the number of full objects

* written, and position the file pointer at the start of the first

* incomplete object. Return (-1) if there is a catastrophic error, and call

* __PHYSFS_setError() to describe the problem; the file pointer should not

* move in such a case.

*/

PHYSFS_sint64 __PHYSFS_platformWrite(void *opaque, const void *buffer,

PHYSFS_uint32 size, PHYSFS_uint32 count);

/*

* Set the file pointer to a new position. (opaque) should be cast to

* whatever data type your platform uses. (pos) specifies the number

* of 8-bit bytes to seek to from the start of the file. Seeking past the

* end of the file is an error condition, and you should check for it.

*

* Not all file types can seek; this is to be expected by the caller.

*

* On error, call __PHYSFS_setError() and return zero. On success, return

* a non-zero value.

*/

int __PHYSFS_platformSeek(void *opaque, PHYSFS_uint64 pos);

/*

* Get the file pointer's position, in an 8-bit byte offset from the start of

* the file. (opaque) should be cast to whatever data type your platform

* uses.

*

* Not all file types can "tell"; this is to be expected by the caller.

*

* On error, call __PHYSFS_setError() and return zero. On success, return

* a non-zero value.

*/

PHYSFS_sint64 __PHYSFS_platformTell(void *opaque);

/*

* Determine the current size of a file, in 8-bit bytes, from an open file.

*

* The caller expects that this information may not be available for all

* file types on all platforms.

*

* Return -1 if you can't do it, and call __PHYSFS_setError(). Otherwise,

* return the file length in 8-bit bytes.

*/

PHYSFS_sint64 __PHYSFS_platformFileLength(void *handle);

/*

* Determine if a file is at EOF. (opaque) should be cast to whatever data

* type your platform uses.

*

* The caller expects that there was a short read before calling this.

*

* Return non-zero if EOF, zero if it is _not_ EOF.

*/

int __PHYSFS_platformEOF(void *opaque);

/*

* Flush any pending writes to disk. (opaque) should be cast to whatever data

* type your platform uses. Be sure to check for errors; the caller expects

* that this function can fail if there was a flushing error, etc.

*

* Return zero on failure, non-zero on success.

*/

int __PHYSFS_platformFlush(void *opaque);

/*

* Flush and close a file. (opaque) should be cast to whatever data type

* your platform uses. Be sure to check for errors when closing; the

* caller expects that this function can fail if there was a flushing

* error, etc.

*

* You should clean up all resources associated with (opaque).

*

* Return zero on failure, non-zero on success.

*/

int __PHYSFS_platformClose(void *opaque);

/*

* Platform implementation of PHYSFS_getCdRomDirs()...

* See physfs.h. The retval should be freeable via PHYSFS_freeList().

*/

char **__PHYSFS_platformDetectAvailableCDs(void);

/*

* Calculate the base dir, if your platform needs special consideration.

* Just return NULL if the standard routines will suffice. (see

* calculateBaseDir() in physfs.c ...)

* Caller will free() the retval if it's not NULL.

*/

char *__PHYSFS_platformCalcBaseDir(const char *argv0);

/*

* Get the platform-specific user name.

* Caller will free() the retval if it's not NULL. If it's NULL, the username

* will default to "default".

*/

char *__PHYSFS_platformGetUserName(void);

/*

* Get the platform-specific user dir.

* Caller will free() the retval if it's not NULL. If it's NULL, the userdir

* will default to basedir/username.

*/

char *__PHYSFS_platformGetUserDir(void);

/*

* Return a number that uniquely identifies the current thread.

* On a platform without threading, (1) will suffice. These numbers are

* arbitrary; the only requirement is that no two threads have the same

* number.

*/

PHYSFS_uint64 __PHYSFS_platformGetThreadID(void);

/*

* This is a pass-through to whatever stricmp() is called on your platform.

*/

int __PHYSFS_platformStricmp(const char *str1, const char *str2);

/*

* Return non-zero if filename (in platform-dependent notation) exists.

* Symlinks should NOT be followed; at this stage, we do not care what the

* symlink points to. Please call __PHYSFS_SetError() with the details of

* why the file does not exist, if it doesn't; you are in a better position

* to know (path not found, bogus filename, file itself is missing, etc).

*/

int __PHYSFS_platformExists(const char *fname);

/*

* Return the last modified time (in seconds since the epoch) of a file.

* Returns -1 on failure. (fname) is in platform-dependent notation.

* Symlinks should be followed; if what the symlink points to is missing,

* then the retval is -1.

*/

PHYSFS_sint64 __PHYSFS_platformGetLastModTime(const char *fname);

/*

* Return non-zero if filename (in platform-dependent notation) is a symlink.

*/

int __PHYSFS_platformIsSymLink(const char *fname);

/*

* Return non-zero if filename (in platform-dependent notation) is a symlink.

* Symlinks should be followed; if what the symlink points to is missing,

* or isn't a directory, then the retval is false.

*/

int __PHYSFS_platformIsDirectory(const char *fname);

/*

* Convert (dirName) to platform-dependent notation, then prepend (prepend)

* and append (append) to the converted string.

*

* So, on Win32, calling:

* __PHYSFS_platformCvtToDependent("C:\", "my/files", NULL);

* ...will return the string "C:\my\files".

*

* This can be implemented in a platform-specific manner, so you can get

* get a speed boost that the default implementation can't, since

* you can make assumptions about the size of strings, etc..

*

* Platforms that choose not to implement this may just call

* __PHYSFS_convertToDependent() as a passthrough, which may fit the bill

* already.

*

* Be sure to free() the return value when done with it.

*/

char *__PHYSFS_platformCvtToDependent(const char *prepend,

const char *dirName,

const char *append);

/*

* Make the current thread give up a timeslice. This is called in a loop

* while waiting for various external forces to get back to us.

*/

void __PHYSFS_platformTimeslice(void);

/*

* Enumerate a directory of files. This follows the rules for the

* DirFunctions->enumerateFiles() method (see above), except that the

* (dirName) that is passed to this function is converted to

* platform-DEPENDENT notation by the caller. The DirFunctions version

* uses platform-independent notation. Note that ".", "..", and other

* metaentries should always be ignored.

*/

LinkedStringList *__PHYSFS_platformEnumerateFiles(const char *dirname,

int omitSymLinks);

/*

* Get the current working directory. The return value should be an