00001
00002
00003
00004
00005
00006
00007
00008
00009
00010
00011
00012
00013
00014
00015
00016
00017
00018
00019
00020
00021
00022
00023
00024
00025
00026
00027
00028
00029
00030
00031 #ifndef CPL_VSI_H_INCLUDED
00032 #define CPL_VSI_H_INCLUDED
00033
00034 #include "cpl_port.h"
00054
00055
00056
00057
00058
00059 #if !defined(_WIN32) && !defined(_WIN32_WCE)
00060 # include <unistd.h>
00061 #endif
00062
00063
00064 #if !defined(macos_pre10) && !defined(_WIN32_WCE)
00065 # include <sys/stat.h>
00066 #endif
00067
00068
00069 #if defined(_WIN32_WCE)
00070 # include <wce_stat.h>
00071 #endif
00072
00073 CPL_C_START
00074
00075
00076
00077
00078
00079
00080
00081 FILE CPL_DLL * VSIFOpen( const char *, const char * );
00082 int CPL_DLL VSIFClose( FILE * );
00083 int CPL_DLL VSIFSeek( FILE *, long, int );
00084 long CPL_DLL VSIFTell( FILE * );
00085 void CPL_DLL VSIRewind( FILE * );
00086 void CPL_DLL VSIFFlush( FILE * );
00087
00088 size_t CPL_DLL VSIFRead( void *, size_t, size_t, FILE * );
00089 size_t CPL_DLL VSIFWrite( const void *, size_t, size_t, FILE * );
00090 char CPL_DLL *VSIFGets( char *, int, FILE * );
00091 int CPL_DLL VSIFPuts( const char *, FILE * );
00092 int CPL_DLL VSIFPrintf( FILE *, const char *, ... ) CPL_PRINT_FUNC_FORMAT(2, 3);
00093
00094 int CPL_DLL VSIFGetc( FILE * );
00095 int CPL_DLL VSIFPutc( int, FILE * );
00096 int CPL_DLL VSIUngetc( int, FILE * );
00097 int CPL_DLL VSIFEof( FILE * );
00098
00099
00100
00101
00102
00103 typedef struct stat VSIStatBuf;
00104 int CPL_DLL VSIStat( const char *, VSIStatBuf * );
00105
00106 #ifdef _WIN32
00107 # define VSI_ISLNK(x) ( 0 )
00108 # define VSI_ISREG(x) ((x) & S_IFREG)
00109 # define VSI_ISDIR(x) ((x) & S_IFDIR)
00110 # define VSI_ISCHR(x) ((x) & S_IFCHR)
00111 # define VSI_ISBLK(x) ( 0 )
00112 #else
00113 # define VSI_ISLNK(x) S_ISLNK(x)
00114 # define VSI_ISREG(x) S_ISREG(x)
00115 # define VSI_ISDIR(x) S_ISDIR(x)
00116 # define VSI_ISCHR(x) S_ISCHR(x)
00117 # define VSI_ISBLK(x) S_ISBLK(x)
00118 #endif
00119
00120
00121
00122
00123
00124
00125 typedef GUIntBig vsi_l_offset;
00126
00127
00128 #ifdef DEBUG
00129 #define VSIL_STRICT_ENFORCE
00130 #endif
00131
00132 #ifdef VSIL_STRICT_ENFORCE
00133 typedef struct _VSILFILE VSILFILE;
00134 #else
00135 typedef FILE VSILFILE;
00136 #endif
00137
00138 VSILFILE CPL_DLL * VSIFOpenL( const char *, const char * );
00139 int CPL_DLL VSIFCloseL( VSILFILE * );
00140 int CPL_DLL VSIFSeekL( VSILFILE *, vsi_l_offset, int );
00141 vsi_l_offset CPL_DLL VSIFTellL( VSILFILE * );
00142 void CPL_DLL VSIRewindL( VSILFILE * );
00143 size_t CPL_DLL VSIFReadL( void *, size_t, size_t, VSILFILE * );
00144 size_t CPL_DLL VSIFWriteL( const void *, size_t, size_t, VSILFILE * );
00145 int CPL_DLL VSIFEofL( VSILFILE * );
00146 int CPL_DLL VSIFFlushL( VSILFILE * );
00147 int CPL_DLL VSIFPrintfL( VSILFILE *, const char *, ... ) CPL_PRINT_FUNC_FORMAT(2, 3);
00148 int CPL_DLL VSIFPutcL( int, VSILFILE * );
00149
00150 #if defined(VSI_STAT64_T)
00151 typedef struct VSI_STAT64_T VSIStatBufL;
00152 #else
00153 #define VSIStatBufL VSIStatBuf
00154 #endif
00155
00156 int CPL_DLL VSIStatL( const char *, VSIStatBufL * );
00157
00158 #define VSI_STAT_EXISTS_FLAG 0x1
00159 #define VSI_STAT_NATURE_FLAG 0x2
00160 #define VSI_STAT_SIZE_FLAG 0x4
00161
00162 int CPL_DLL VSIStatExL( const char * pszFilename, VSIStatBufL * psStatBuf, int nFlags );
00163
00164 int CPL_DLL VSIIsCaseSensitiveFS( const char * pszFilename );
00165
00166
00167
00168
00169
00170 void CPL_DLL *VSICalloc( size_t, size_t );
00171 void CPL_DLL *VSIMalloc( size_t );
00172 void CPL_DLL VSIFree( void * );
00173 void CPL_DLL *VSIRealloc( void *, size_t );
00174 char CPL_DLL *VSIStrdup( const char * );
00175
00183 void CPL_DLL *VSIMalloc2( size_t nSize1, size_t nSize2 );
00184
00192 void CPL_DLL *VSIMalloc3( size_t nSize1, size_t nSize2, size_t nSize3 );
00193
00194
00195
00196
00197
00198
00199 #define CPLReadDir VSIReadDir
00200 char CPL_DLL **VSIReadDir( const char * );
00201 int CPL_DLL VSIMkdir( const char * pathname, long mode );
00202 int CPL_DLL VSIRmdir( const char * pathname );
00203 int CPL_DLL VSIUnlink( const char * pathname );
00204 int CPL_DLL VSIRename( const char * oldpath, const char * newpath );
00205 char CPL_DLL *VSIStrerror( int );
00206
00207
00208
00209
00210 void CPL_DLL VSIInstallMemFileHandler(void);
00211 void CPL_DLL VSIInstallLargeFileHandler(void);
00212 void CPL_DLL VSIInstallSubFileHandler(void);
00213 void VSIInstallCurlFileHandler(void);
00214 void VSIInstallGZipFileHandler(void);
00215 void VSIInstallZipFileHandler(void);
00216 void VSIInstallStdinHandler(void);
00217 void VSIInstallStdoutHandler(void);
00218 void CPL_DLL VSIInstallSparseFileHandler(void);
00219 void VSIInstallTarFileHandler(void);
00220 void CPL_DLL VSICleanupFileManager(void);
00221
00222 VSILFILE CPL_DLL *VSIFileFromMemBuffer( const char *pszFilename,
00223 GByte *pabyData,
00224 vsi_l_offset nDataLength,
00225 int bTakeOwnership );
00226 GByte CPL_DLL *VSIGetMemFileBuffer( const char *pszFilename,
00227 vsi_l_offset *pnDataLength,
00228 int bUnlinkAndSeize );
00229
00230
00231
00232
00233
00234 unsigned long CPL_DLL VSITime( unsigned long * );
00235 const char CPL_DLL *VSICTime( unsigned long );
00236 struct tm CPL_DLL *VSIGMTime( const time_t *pnTime,
00237 struct tm *poBrokenTime );
00238 struct tm CPL_DLL *VSILocalTime( const time_t *pnTime,
00239 struct tm *poBrokenTime );
00240
00241
00242
00243
00244
00245 #ifdef VSI_DEBUG
00246
00247 #ifndef DEBUG
00248 # define DEBUG
00249 #endif
00250
00251 #include "cpl_error.h"
00252
00253 #define VSIDebug4(f,a1,a2,a3,a4) CPLDebug( "VSI", f, a1, a2, a3, a4 );
00254 #define VSIDebug3( f, a1, a2, a3 ) CPLDebug( "VSI", f, a1, a2, a3 );
00255 #define VSIDebug2( f, a1, a2 ) CPLDebug( "VSI", f, a1, a2 );
00256 #define VSIDebug1( f, a1 ) CPLDebug( "VSI", f, a1 );
00257 #else
00258 #define VSIDebug4( f, a1, a2, a3, a4 ) {}
00259 #define VSIDebug3( f, a1, a2, a3 ) {}
00260 #define VSIDebug2( f, a1, a2 ) {}
00261 #define VSIDebug1( f, a1 ) {}
00262 #endif
00263
00264 CPL_C_END
00265
00266 #endif