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