SDTS_AL
cpl_vsi.h
Go to the documentation of this file.
1 /******************************************************************************
2  * $Id: cpl_vsi.h 1d0fc606e71f2c1ce61f3fd040b187de71d70f9b 2019-04-17 15:01:54 +0200 Even Rouault $
3  *
4  * Project: CPL - Common Portability Library
5  * Author: Frank Warmerdam, warmerdam@pobox.com
6  * Purpose: Include file defining Virtual File System (VSI) functions, a
7  * layer over POSIX file and other system services.
8  *
9  ******************************************************************************
10  * Copyright (c) 1998, Frank Warmerdam
11  * Copyright (c) 2008-2014, Even Rouault <even dot rouault at mines-paris dot org>
12  *
13  * Permission is hereby granted, free of charge, to any person obtaining a
14  * copy of this software and associated documentation files (the "Software"),
15  * to deal in the Software without restriction, including without limitation
16  * the rights to use, copy, modify, merge, publish, distribute, sublicense,
17  * and/or sell copies of the Software, and to permit persons to whom the
18  * Software is furnished to do so, subject to the following conditions:
19  *
20  * The above copyright notice and this permission notice shall be included
21  * in all copies or substantial portions of the Software.
22  *
23  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
24  * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
25  * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
26  * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
27  * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
28  * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
29  * DEALINGS IN THE SOFTWARE.
30  ****************************************************************************/
31 
32 #ifndef CPL_VSI_H_INCLUDED
33 #define CPL_VSI_H_INCLUDED
34 
35 #include "cpl_port.h"
36 #include "cpl_progress.h"
37 
56 /* -------------------------------------------------------------------- */
57 /* We need access to ``struct stat''. */
58 /* -------------------------------------------------------------------- */
59 
60 /* Unix */
61 #if !defined(_WIN32)
62 # include <unistd.h>
63 #endif
64 
65 /* Windows */
66 #include <sys/stat.h>
67 
68 CPL_C_START
69 
71 #ifdef ENABLE_EXPERIMENTAL_CPL_WARN_UNUSED_RESULT
72 #define EXPERIMENTAL_CPL_WARN_UNUSED_RESULT CPL_WARN_UNUSED_RESULT
73 #else
74 #define EXPERIMENTAL_CPL_WARN_UNUSED_RESULT
75 #endif
76 
78 /* ==================================================================== */
79 /* stdio file access functions. These do not support large */
80 /* files, and do not go through the virtualization API. */
81 /* ==================================================================== */
82 
85 FILE CPL_DLL * VSIFOpen( const char *, const char * ) CPL_WARN_UNUSED_RESULT;
86 int CPL_DLL VSIFClose( FILE * );
87 int CPL_DLL VSIFSeek( FILE *, long, int ) EXPERIMENTAL_CPL_WARN_UNUSED_RESULT;
88 long CPL_DLL VSIFTell( FILE * ) CPL_WARN_UNUSED_RESULT;
89 void CPL_DLL VSIRewind( FILE * );
90 void CPL_DLL VSIFFlush( FILE * );
91 
92 size_t CPL_DLL VSIFRead( void *, size_t, size_t, FILE * ) EXPERIMENTAL_CPL_WARN_UNUSED_RESULT;
93 size_t CPL_DLL VSIFWrite( const void *, size_t, size_t, FILE * ) EXPERIMENTAL_CPL_WARN_UNUSED_RESULT;
94 char CPL_DLL *VSIFGets( char *, int, FILE * ) EXPERIMENTAL_CPL_WARN_UNUSED_RESULT;
95 int CPL_DLL VSIFPuts( const char *, FILE * ) EXPERIMENTAL_CPL_WARN_UNUSED_RESULT;
96 int CPL_DLL VSIFPrintf( FILE *, CPL_FORMAT_STRING(const char *), ... ) EXPERIMENTAL_CPL_WARN_UNUSED_RESULT CPL_PRINT_FUNC_FORMAT(2, 3);
97 
98 int CPL_DLL VSIFGetc( FILE * ) EXPERIMENTAL_CPL_WARN_UNUSED_RESULT;
99 int CPL_DLL VSIFPutc( int, FILE * ) EXPERIMENTAL_CPL_WARN_UNUSED_RESULT;
100 int CPL_DLL VSIUngetc( int, FILE * ) EXPERIMENTAL_CPL_WARN_UNUSED_RESULT;
101 int CPL_DLL VSIFEof( FILE * ) EXPERIMENTAL_CPL_WARN_UNUSED_RESULT;
102 
105 /* ==================================================================== */
106 /* VSIStat() related. */
107 /* ==================================================================== */
108 
110 typedef struct stat VSIStatBuf;
111 int CPL_DLL VSIStat( const char *, VSIStatBuf * ) CPL_WARN_UNUSED_RESULT;
114 #ifdef _WIN32
115 # define VSI_ISLNK(x) ( 0 ) /* N/A on Windows */
116 # define VSI_ISREG(x) ((x) & S_IFREG)
117 # define VSI_ISDIR(x) ((x) & S_IFDIR)
118 # define VSI_ISCHR(x) ((x) & S_IFCHR)
119 # define VSI_ISBLK(x) ( 0 ) /* N/A on Windows */
120 #else
121 
122 # define VSI_ISLNK(x) S_ISLNK(x)
123 
124 # define VSI_ISREG(x) S_ISREG(x)
125 
126 # define VSI_ISDIR(x) S_ISDIR(x)
127 
128 # define VSI_ISCHR(x) S_ISCHR(x)
129 # define VSI_ISBLK(x) S_ISBLK(x)
130 
131 #endif
132 
133 /* ==================================================================== */
134 /* 64bit stdio file access functions. If we have a big size */
135 /* defined, then provide prototypes for the large file API, */
136 /* otherwise redefine to use the regular api. */
137 /* ==================================================================== */
138 
142 #define VSI_L_OFFSET_MAX GUINTBIG_MAX
143 
145 /* Make VSIL_STRICT_ENFORCE active in DEBUG builds */
146 #ifdef DEBUG
147 #define VSIL_STRICT_ENFORCE
148 #endif
149 
151 #ifdef VSIL_STRICT_ENFORCE
152 
153 typedef struct _VSILFILE VSILFILE;
154 #else
155 
156 typedef FILE VSILFILE;
157 #endif
158 
159 VSILFILE CPL_DLL * VSIFOpenL( const char *, const char * ) CPL_WARN_UNUSED_RESULT;
160 VSILFILE CPL_DLL * VSIFOpenExL( const char *, const char *, int ) CPL_WARN_UNUSED_RESULT;
161 int CPL_DLL VSIFCloseL( VSILFILE * ) EXPERIMENTAL_CPL_WARN_UNUSED_RESULT;
162 int CPL_DLL VSIFSeekL( VSILFILE *, vsi_l_offset, int ) EXPERIMENTAL_CPL_WARN_UNUSED_RESULT;
164 void CPL_DLL VSIRewindL( VSILFILE * );
165 size_t CPL_DLL VSIFReadL( void *, size_t, size_t, VSILFILE * ) EXPERIMENTAL_CPL_WARN_UNUSED_RESULT;
166 int CPL_DLL VSIFReadMultiRangeL( int nRanges, void ** ppData, const vsi_l_offset* panOffsets, const size_t* panSizes, VSILFILE * ) EXPERIMENTAL_CPL_WARN_UNUSED_RESULT;
167 size_t CPL_DLL VSIFWriteL( const void *, size_t, size_t, VSILFILE * ) EXPERIMENTAL_CPL_WARN_UNUSED_RESULT;
168 int CPL_DLL VSIFEofL( VSILFILE * ) EXPERIMENTAL_CPL_WARN_UNUSED_RESULT;
169 int CPL_DLL VSIFTruncateL( VSILFILE *, vsi_l_offset ) EXPERIMENTAL_CPL_WARN_UNUSED_RESULT;
170 int CPL_DLL VSIFFlushL( VSILFILE * ) EXPERIMENTAL_CPL_WARN_UNUSED_RESULT;
171 int CPL_DLL VSIFPrintfL( VSILFILE *, CPL_FORMAT_STRING(const char *), ... ) EXPERIMENTAL_CPL_WARN_UNUSED_RESULT CPL_PRINT_FUNC_FORMAT(2, 3);
172 int CPL_DLL VSIFPutcL( int, VSILFILE * ) EXPERIMENTAL_CPL_WARN_UNUSED_RESULT;
173 
175 typedef enum
176 {
181 
182 VSIRangeStatus CPL_DLL VSIFGetRangeStatusL( VSILFILE * fp, vsi_l_offset nStart, vsi_l_offset nLength );
183 
184 int CPL_DLL VSIIngestFile( VSILFILE* fp,
185  const char* pszFilename,
186  GByte** ppabyRet,
187  vsi_l_offset* pnSize,
188  GIntBig nMaxSize ) CPL_WARN_UNUSED_RESULT;
189 
190 #if defined(VSI_STAT64_T)
191 
192 typedef struct VSI_STAT64_T VSIStatBufL;
193 #else
194 
195 #define VSIStatBufL VSIStatBuf
196 #endif
197 
198 int CPL_DLL VSIStatL( const char *, VSIStatBufL * ) CPL_WARN_UNUSED_RESULT;
199 
201 #define VSI_STAT_EXISTS_FLAG 0x1
202 
203 #define VSI_STAT_NATURE_FLAG 0x2
204 
205 #define VSI_STAT_SIZE_FLAG 0x4
206 
207 #define VSI_STAT_SET_ERROR_FLAG 0x8
208 
209 int CPL_DLL VSIStatExL( const char * pszFilename, VSIStatBufL * psStatBuf, int nFlags ) CPL_WARN_UNUSED_RESULT;
210 
211 int CPL_DLL VSIIsCaseSensitiveFS( const char * pszFilename );
212 
213 int CPL_DLL VSISupportsSparseFiles( const char* pszPath );
214 
215 int CPL_DLL VSIHasOptimizedReadMultiRange( const char* pszPath );
216 
217 const char CPL_DLL *VSIGetActualURL( const char* pszFilename );
218 
219 char CPL_DLL *VSIGetSignedURL( const char* pszFilename, CSLConstList papszOptions );
220 
221 const char CPL_DLL *VSIGetFileSystemOptions( const char* pszFilename );
222 
223 char CPL_DLL **VSIGetFileSystemsPrefixes( void );
224 
225 void CPL_DLL *VSIFGetNativeFileDescriptorL( VSILFILE* );
226 
227 /* ==================================================================== */
228 /* Memory allocation */
229 /* ==================================================================== */
230 
231 void CPL_DLL *VSICalloc( size_t, size_t ) CPL_WARN_UNUSED_RESULT;
232 void CPL_DLL *VSIMalloc( size_t ) CPL_WARN_UNUSED_RESULT;
233 void CPL_DLL VSIFree( void * );
234 void CPL_DLL *VSIRealloc( void *, size_t ) CPL_WARN_UNUSED_RESULT;
235 char CPL_DLL *VSIStrdup( const char * ) CPL_WARN_UNUSED_RESULT;
236 
237 void CPL_DLL *VSIMallocAligned( size_t nAlignment, size_t nSize ) CPL_WARN_UNUSED_RESULT;
238 void CPL_DLL *VSIMallocAlignedAuto( size_t nSize ) CPL_WARN_UNUSED_RESULT;
239 void CPL_DLL VSIFreeAligned( void* ptr );
240 
241 void CPL_DLL *VSIMallocAlignedAutoVerbose( size_t nSize, const char* pszFile, int nLine ) CPL_WARN_UNUSED_RESULT;
243 #define VSI_MALLOC_ALIGNED_AUTO_VERBOSE( size ) VSIMallocAlignedAutoVerbose(size,__FILE__,__LINE__)
244 
252 void CPL_DLL *VSIMalloc2( size_t nSize1, size_t nSize2 ) CPL_WARN_UNUSED_RESULT;
253 
261 void CPL_DLL *VSIMalloc3( size_t nSize1, size_t nSize2, size_t nSize3 ) CPL_WARN_UNUSED_RESULT;
262 
264 void CPL_DLL *VSIMallocVerbose( size_t nSize, const char* pszFile, int nLine ) CPL_WARN_UNUSED_RESULT;
266 #define VSI_MALLOC_VERBOSE( size ) VSIMallocVerbose(size,__FILE__,__LINE__)
267 
269 void CPL_DLL *VSIMalloc2Verbose( size_t nSize1, size_t nSize2, const char* pszFile, int nLine ) CPL_WARN_UNUSED_RESULT;
271 #define VSI_MALLOC2_VERBOSE( nSize1, nSize2 ) VSIMalloc2Verbose(nSize1,nSize2,__FILE__,__LINE__)
272 
274 void CPL_DLL *VSIMalloc3Verbose( size_t nSize1, size_t nSize2, size_t nSize3, const char* pszFile, int nLine ) CPL_WARN_UNUSED_RESULT;
276 #define VSI_MALLOC3_VERBOSE( nSize1, nSize2, nSize3 ) VSIMalloc3Verbose(nSize1,nSize2,nSize3,__FILE__,__LINE__)
277 
279 void CPL_DLL *VSICallocVerbose( size_t nCount, size_t nSize, const char* pszFile, int nLine ) CPL_WARN_UNUSED_RESULT;
281 #define VSI_CALLOC_VERBOSE( nCount, nSize ) VSICallocVerbose(nCount,nSize,__FILE__,__LINE__)
282 
284 void CPL_DLL *VSIReallocVerbose( void* pOldPtr, size_t nNewSize, const char* pszFile, int nLine ) CPL_WARN_UNUSED_RESULT;
286 #define VSI_REALLOC_VERBOSE( pOldPtr, nNewSize ) VSIReallocVerbose(pOldPtr,nNewSize,__FILE__,__LINE__)
287 
289 char CPL_DLL *VSIStrdupVerbose( const char* pszStr, const char* pszFile, int nLine ) CPL_WARN_UNUSED_RESULT;
291 #define VSI_STRDUP_VERBOSE( pszStr ) VSIStrdupVerbose(pszStr,__FILE__,__LINE__)
292 
293 GIntBig CPL_DLL CPLGetPhysicalRAM(void);
294 GIntBig CPL_DLL CPLGetUsablePhysicalRAM(void);
295 
296 /* ==================================================================== */
297 /* Other... */
298 /* ==================================================================== */
299 
301 #define CPLReadDir VSIReadDir
302 char CPL_DLL **VSIReadDir( const char * );
303 char CPL_DLL **VSIReadDirRecursive( const char *pszPath );
304 char CPL_DLL **VSIReadDirEx( const char *pszPath, int nMaxFiles );
305 
307 typedef struct VSIDIR VSIDIR;
308 
309 VSIDIR CPL_DLL *VSIOpenDir( const char *pszPath,
310  int nRecurseDepth,
311  const char* const *papszOptions);
312 
314 typedef struct VSIDIREntry
315 {
317  char* pszName;
319  int nMode;
331  char** papszExtra;
332 
333 #if defined(__cplusplus) && !defined(CPL_SUPRESS_CPLUSPLUS)
334 
335  VSIDIREntry();
336  ~VSIDIREntry();
337  VSIDIREntry(const VSIDIREntry&) = delete;
338  VSIDIREntry& operator=(VSIDIREntry&) = delete;
340 #endif
341 } VSIDIREntry;
342 
343 const VSIDIREntry CPL_DLL *VSIGetNextDirEntry(VSIDIR* dir);
344 void CPL_DLL VSICloseDir(VSIDIR* dir);
345 
346 int CPL_DLL VSIMkdir( const char * pszPathname, long mode );
347 int CPL_DLL VSIMkdirRecursive( const char * pszPathname, long mode );
348 int CPL_DLL VSIRmdir( const char * pszDirname );
349 int CPL_DLL VSIRmdirRecursive( const char * pszDirname );
350 int CPL_DLL VSIUnlink( const char * pszFilename );
351 int CPL_DLL VSIRename( const char * oldpath, const char * newpath );
352 int CPL_DLL VSISync( const char* pszSource, const char* pszTarget,
353  const char* const * papszOptions,
354  GDALProgressFunc pProgressFunc,
355  void *pProgressData,
356  char*** ppapszOutputs );
357 
358 char CPL_DLL *VSIStrerror( int );
359 GIntBig CPL_DLL VSIGetDiskFreeSpace(const char *pszDirname);
360 
361 /* ==================================================================== */
362 /* Install special file access handlers. */
363 /* ==================================================================== */
364 void CPL_DLL VSIInstallMemFileHandler(void);
366 void CPL_DLL VSIInstallLargeFileHandler(void);
368 void CPL_DLL VSIInstallSubFileHandler(void);
369 void VSIInstallCurlFileHandler(void);
370 void CPL_DLL VSICurlClearCache(void);
371 void CPL_DLL VSICurlPartialClearCache(const char* pszFilenamePrefix);
372 void VSIInstallCurlStreamingFileHandler(void);
373 void VSIInstallS3FileHandler(void);
374 void VSIInstallS3StreamingFileHandler(void);
375 void VSIInstallGSFileHandler(void);
376 void VSIInstallGSStreamingFileHandler(void);
377 void VSIInstallAzureFileHandler(void);
378 void VSIInstallAzureStreamingFileHandler(void);
379 void VSIInstallOSSFileHandler(void);
380 void VSIInstallOSSStreamingFileHandler(void);
381 void VSIInstallSwiftFileHandler(void);
382 void VSIInstallSwiftStreamingFileHandler(void);
383 void VSIInstallGZipFileHandler(void); /* No reason to export that */
384 void VSIInstallZipFileHandler(void); /* No reason to export that */
385 void VSIInstallStdinHandler(void); /* No reason to export that */
386 void VSIInstallHdfsHandler(void); /* No reason to export that */
387 void VSIInstallWebHdfsHandler(void); /* No reason to export that */
388 void VSIInstallStdoutHandler(void); /* No reason to export that */
389 void CPL_DLL VSIInstallSparseFileHandler(void);
390 void VSIInstallTarFileHandler(void); /* No reason to export that */
391 void CPL_DLL VSIInstallCryptFileHandler(void);
392 void CPL_DLL VSISetCryptKey(const GByte* pabyKey, int nKeySize);
394 void CPL_DLL VSICleanupFileManager(void);
397 VSILFILE CPL_DLL *VSIFileFromMemBuffer( const char *pszFilename,
398  GByte *pabyData,
399  vsi_l_offset nDataLength,
400  int bTakeOwnership ) CPL_WARN_UNUSED_RESULT;
401 GByte CPL_DLL *VSIGetMemFileBuffer( const char *pszFilename,
402  vsi_l_offset *pnDataLength,
403  int bUnlinkAndSeize );
404 
406 typedef size_t (*VSIWriteFunction)(const void* ptr, size_t size, size_t nmemb, FILE* stream);
407 void CPL_DLL VSIStdoutSetRedirection( VSIWriteFunction pFct, FILE* stream );
408 
413 typedef int (*VSIFilesystemPluginStatCallback) ( void *pUserData, const char *pszFilename, VSIStatBufL *pStatBuf, int nFlags );
418 typedef int (*VSIFilesystemPluginUnlinkCallback) ( void *pUserData, const char *pszFilename );
423 typedef int (*VSIFilesystemPluginRenameCallback) ( void *pUserData, const char *oldpath, const char *newpath );
428 typedef int (*VSIFilesystemPluginMkdirCallback) ( void *pUserData, const char *pszDirname, long nMode );
433 typedef int (*VSIFilesystemPluginRmdirCallback) ( void *pUserData, const char *pszDirname );
438 typedef char** (*VSIFilesystemPluginReadDirCallback) ( void *pUserData, const char *pszDirname, int nMaxFiles );
444 typedef void* (*VSIFilesystemPluginOpenCallback) ( void *pUserData, const char *pszFilename, const char *pszAccess );
454 typedef int (*VSIFilesystemPluginSeekCallback) ( void *pFile, vsi_l_offset nOffset, int nWhence );
460 typedef size_t (*VSIFilesystemPluginReadCallback) ( void *pFile, void *pBuffer, size_t nSize, size_t nCount );
465 typedef int (*VSIFilesystemPluginReadMultiRangeCallback)( void *pFile, int nRanges, void ** ppData,
466  const vsi_l_offset* panOffsets, const size_t* panSizes );
476 typedef int (*VSIFilesystemPluginEofCallback) ( void *pFile );
481 typedef size_t (*VSIFilesystemPluginWriteCallback) ( void *pFile, const void *pBuffer, size_t nSize,size_t nCount);
486 typedef int (*VSIFilesystemPluginFlushCallback) ( void *pFile );
490 typedef int (*VSIFilesystemPluginTruncateCallback) ( void *pFile, vsi_l_offset nNewSize );
495 typedef int (*VSIFilesystemPluginCloseCallback) ( void *pFile );
496 
504 typedef struct {
508  void *pUserData;
526 /*
527  Callbacks are defined as a struct allocated by a call to VSIAllocFilesystemPluginCallbacksStruct
528  in order to try to maintain ABI stability when eventually adding a new member.
529  Any callbacks added to this struct SHOULD be added to the END of this struct
530 */
532 
538 
544 
551 int CPL_DLL VSIInstallPluginHandler( const char* pszPrefix, const VSIFilesystemPluginCallbacksStruct* poCb);
552 
553 /* ==================================================================== */
554 /* Time querying. */
555 /* ==================================================================== */
556 
558 unsigned long CPL_DLL VSITime( unsigned long * );
559 const char CPL_DLL *VSICTime( unsigned long );
560 struct tm CPL_DLL *VSIGMTime( const time_t *pnTime,
561  struct tm *poBrokenTime );
562 struct tm CPL_DLL *VSILocalTime( const time_t *pnTime,
563  struct tm *poBrokenTime );
567 /* -------------------------------------------------------------------- */
568 /* the following can be turned on for detailed logging of */
569 /* almost all IO calls. */
570 /* -------------------------------------------------------------------- */
571 #ifdef VSI_DEBUG
572 
573 #ifndef DEBUG
574 # define DEBUG
575 #endif
576 
577 #include "cpl_error.h"
578 
579 #define VSIDebug4(f,a1,a2,a3,a4) CPLDebug( "VSI", f, a1, a2, a3, a4 );
580 #define VSIDebug3( f, a1, a2, a3 ) CPLDebug( "VSI", f, a1, a2, a3 );
581 #define VSIDebug2( f, a1, a2 ) CPLDebug( "VSI", f, a1, a2 );
582 #define VSIDebug1( f, a1 ) CPLDebug( "VSI", f, a1 );
583 #else
584 #define VSIDebug4( f, a1, a2, a3, a4 ) {}
585 #define VSIDebug3( f, a1, a2, a3 ) {}
586 #define VSIDebug2( f, a1, a2 ) {}
587 #define VSIDebug1( f, a1 ) {}
588 #endif
589 
591 CPL_C_END
592 
593 #endif /* ndef CPL_VSI_H_INCLUDED */
Definition: cpl_vsi.h:314
VSIRangeStatus
Definition: cpl_vsi.h:175
char CPL_DLL * VSIStrerror(int)
Definition: cpl_vsisimple.cpp:1347
int(* VSIFilesystemPluginFlushCallback)(void *pFile)
Definition: cpl_vsi.h:486
void CPL_DLL * VSIMalloc(size_t) CPL_WARN_UNUSED_RESULT
Definition: cpl_vsisimple.cpp:558
struct VSIDIREntry VSIDIREntry
Definition: cpl_vsil.cpp:1198
char CPL_DLL ** VSIReadDirEx(const char *pszPath, int nMaxFiles)
Read names in a directory.
Definition: cpl_vsil.cpp:117
void CPL_DLL * VSICallocVerbose(size_t nCount, size_t nSize, const char *pszFile, int nLine) CPL_WARN_UNUSED_RESULT
Definition: cpl_vsisimple.cpp:1205
VSIFilesystemPluginCallbacksStruct CPL_DLL * VSIAllocFilesystemPluginCallbacksStruct(void)
Definition: cpl_vsil_plugin.cpp:351
size_t(* VSIFilesystemPluginWriteCallback)(void *pFile, const void *pBuffer, size_t nSize, size_t nCount)
Definition: cpl_vsi.h:481
size_t(* VSIWriteFunction)(const void *ptr, size_t size, size_t nmemb, FILE *stream)
Definition: cpl_vsi.h:406
int CPL_DLL VSIFSeekL(VSILFILE *, vsi_l_offset, int) EXPERIMENTAL_CPL_WARN_UNUSED_RESULT
Seek to requested offset.
Definition: cpl_vsil.cpp:1532
int nMode
Definition: cpl_vsi.h:319
int CPL_DLL VSIUnlink(const char *pszFilename)
Delete a file.
Definition: cpl_vsil.cpp:498
Definition: cpl_vsi.h:179
char CPL_DLL * VSIGetSignedURL(const char *pszFilename, CSLConstList papszOptions)
Returns a signed URL of a supplied filename.
Definition: cpl_vsil.cpp:959
void CPL_DLL VSIInstallSubFileHandler(void)
Definition: cpl_vsil_subfile.cpp:492
void CPL_DLL * VSIFGetNativeFileDescriptorL(VSILFILE *)
Returns the "native" file descriptor for the virtual handle.
Definition: cpl_vsil.cpp:2240
int CPL_DLL VSIFCloseL(VSILFILE *) EXPERIMENTAL_CPL_WARN_UNUSED_RESULT
Close file.
Definition: cpl_vsil.cpp:1472
VSIFilesystemPluginSeekCallback seek
Definition: cpl_vsi.h:517
FILE VSILFILE
Definition: cpl_vsi.h:156
vsi_l_offset CPL_DLL VSIFTellL(VSILFILE *) CPL_WARN_UNUSED_RESULT
Tell current file offset.
Definition: cpl_vsil.cpp:1575
VSIDIR CPL_DLL * VSIOpenDir(const char *pszPath, int nRecurseDepth, const char *const *papszOptions)
Open a directory to read its entries.
Definition: cpl_vsil.cpp:342
vsi_l_offset nSize
Definition: cpl_vsi.h:321
VSIRangeStatus(* VSIFilesystemPluginGetRangeStatusCallback)(void *pFile, vsi_l_offset nOffset, vsi_l_offset nLength)
Definition: cpl_vsi.h:471
size_t CPL_DLL VSIFReadL(void *, size_t, size_t, VSILFILE *) EXPERIMENTAL_CPL_WARN_UNUSED_RESULT
Read bytes from file.
Definition: cpl_vsil.cpp:1690
VSIFilesystemPluginFlushCallback flush
Definition: cpl_vsi.h:523
char CPL_DLL ** VSIGetFileSystemsPrefixes(void)
Return the list of prefixes for virtual file system handlers currently registered.
Definition: cpl_vsil.cpp:2283
int CPL_DLL int CPL_DLL VSIFPutcL(int, VSILFILE *) EXPERIMENTAL_CPL_WARN_UNUSED_RESULT
Write a single byte to the file.
Definition: cpl_vsil.cpp:1955
int CPL_DLL VSIIngestFile(VSILFILE *fp, const char *pszFilename, GByte **ppabyRet, vsi_l_offset *pnSize, GIntBig nMaxSize) CPL_WARN_UNUSED_RESULT
Ingest a file into memory.
Definition: cpl_vsil.cpp:2044
char * pszName
Definition: cpl_vsi.h:317
Definition: cpl_vsi.h:178
unsigned char GByte
Definition: cpl_port.h:215
void CPL_DLL * VSIMalloc3(size_t nSize1, size_t nSize2, size_t nSize3) CPL_WARN_UNUSED_RESULT
Definition: cpl_vsisimple.cpp:1129
int CPL_DLL VSIMkdirRecursive(const char *pszPathname, long mode)
Create a directory and all its ancestors.
Definition: cpl_vsil.cpp:446
int CPL_DLL VSIStatExL(const char *pszFilename, VSIStatBufL *psStatBuf, int nFlags) CPL_WARN_UNUSED_RESULT
Get filesystem object info.
Definition: cpl_vsil.cpp:776
int(* VSIFilesystemPluginEofCallback)(void *pFile)
Definition: cpl_vsi.h:476
int(* VSIFilesystemPluginStatCallback)(void *pUserData, const char *pszFilename, VSIStatBufL *pStatBuf, int nFlags)
Definition: cpl_vsi.h:413
const char CPL_DLL * VSIGetFileSystemOptions(const char *pszFilename)
Return the list of options associated with a virtual file system handler as a serialized XML string.
Definition: cpl_vsil.cpp:2303
char bModeKnown
Definition: cpl_vsi.h:325
VSIFilesystemPluginReadCallback read
Definition: cpl_vsi.h:518
#define CPL_PRINT_FUNC_FORMAT(format_idx, arg_idx)
Definition: cpl_port.h:914
int CPL_DLL VSIFTruncateL(VSILFILE *, vsi_l_offset) EXPERIMENTAL_CPL_WARN_UNUSED_RESULT
Truncate/expand the file to the specified size.
Definition: cpl_vsil.cpp:1892
void CPL_DLL * VSIMalloc2(size_t nSize1, size_t nSize2) CPL_WARN_UNUSED_RESULT
Definition: cpl_vsisimple.cpp:1116
void CPL_DLL * VSIMallocAlignedAutoVerbose(size_t nSize, const char *pszFile, int nLine) CPL_WARN_UNUSED_RESULT
Definition: cpl_vsisimple.cpp:951
int CPL_DLL VSIRename(const char *oldpath, const char *newpath)
Rename a file.
Definition: cpl_vsil.cpp:529
int(* VSIFilesystemPluginUnlinkCallback)(void *pUserData, const char *pszFilename)
Definition: cpl_vsi.h:418
void VSIInstallStdoutHandler(void)
Install /vsistdout/ file system handler.
Definition: cpl_vsil_stdout.cpp:444
char ** papszExtra
Definition: cpl_vsi.h:331
void CPL_DLL * VSIMallocAlignedAuto(size_t nSize) CPL_WARN_UNUSED_RESULT
Definition: cpl_vsisimple.cpp:938
Definition: cpl_vsi.h:504
VSIFilesystemPluginTellCallback tell
Definition: cpl_vsi.h:516
void VSIInstallStdinHandler(void)
Install /vsistdin/ file system handler.
Definition: cpl_vsil_stdin.cpp:421
VSILFILE CPL_DLL * VSIFileFromMemBuffer(const char *pszFilename, GByte *pabyData, vsi_l_offset nDataLength, int bTakeOwnership) CPL_WARN_UNUSED_RESULT
Create memory "file" from a buffer.
Definition: cpl_vsi_mem.cpp:898
int(* VSIFilesystemPluginMkdirCallback)(void *pUserData, const char *pszDirname, long nMode)
Definition: cpl_vsi.h:428
int CPL_DLL VSIRmdirRecursive(const char *pszDirname)
Delete a directory recursively.
Definition: cpl_vsil.cpp:669
void CPL_DLL * VSICalloc(size_t, size_t) CPL_WARN_UNUSED_RESULT
Definition: cpl_vsisimple.cpp:444
VSIRangeStatus CPL_DLL VSIFGetRangeStatusL(VSILFILE *fp, vsi_l_offset nStart, vsi_l_offset nLength)
Return if a given file range contains data or holes filled with zeroes.
Definition: cpl_vsil.cpp:2007
vsi_l_offset(* VSIFilesystemPluginTellCallback)(void *pFile)
Definition: cpl_vsi.h:449
void CPL_DLL * VSIReallocVerbose(void *pOldPtr, size_t nNewSize, const char *pszFile, int nLine) CPL_WARN_UNUSED_RESULT
Definition: cpl_vsisimple.cpp:1224
void CPL_DLL * VSIMallocAligned(size_t nAlignment, size_t nSize) CPL_WARN_UNUSED_RESULT
Definition: cpl_vsisimple.cpp:892
void VSIInstallTarFileHandler(void)
Install /vsitar/ file system handler.
Definition: cpl_vsil_tar.cpp:609
void VSIInstallZipFileHandler(void)
Install ZIP file system handler.
Definition: cpl_vsil_gzip.cpp:3319
VSIFilesystemPluginGetRangeStatusCallback get_range_status
Definition: cpl_vsi.h:520
char **(* VSIFilesystemPluginReadDirCallback)(void *pUserData, const char *pszDirname, int nMaxFiles)
Definition: cpl_vsi.h:438
char CPL_DLL ** VSIReadDirRecursive(const char *pszPath)
Read names in a directory recursively.
Definition: cpl_vsil.cpp:160
struct VSI_STAT64_T VSIStatBufL
Definition: cpl_vsi.h:192
void CPL_DLL VSIInstallSparseFileHandler(void)
Definition: cpl_vsil_sparsefile.cpp:547
VSIFilesystemPluginUnlinkCallback unlink
Definition: cpl_vsi.h:510
int CPL_DLL VSISupportsSparseFiles(const char *pszPath)
Returns if the filesystem supports sparse files.
Definition: cpl_vsil.cpp:856
Definition: cpl_vsi.h:177
int CPL_DLL VSIFEofL(VSILFILE *) EXPERIMENTAL_CPL_WARN_UNUSED_RESULT
Test for end of file.
Definition: cpl_vsil.cpp:1850
VSIFilesystemPluginRenameCallback rename
Definition: cpl_vsi.h:511
int CPL_DLL VSIFReadMultiRangeL(int nRanges, void **ppData, const vsi_l_offset *panOffsets, const size_t *panSizes, VSILFILE *) EXPERIMENTAL_CPL_WARN_UNUSED_RESULT
Read several ranges of bytes from file.
Definition: cpl_vsil.cpp:1750
int(* VSIFilesystemPluginSeekCallback)(void *pFile, vsi_l_offset nOffset, int nWhence)
Definition: cpl_vsi.h:454
void CPL_DLL * VSIMalloc2Verbose(size_t nSize1, size_t nSize2, const char *pszFile, int nLine) CPL_WARN_UNUSED_RESULT
Definition: cpl_vsisimple.cpp:1155
VSILFILE CPL_DLL * VSIFOpenExL(const char *, const char *, int) CPL_WARN_UNUSED_RESULT
Open file.
Definition: cpl_vsil.cpp:1416
char ** CSLConstList
Definition: cpl_port.h:1194
void VSIInstallGZipFileHandler(void)
Install GZip file system handler.
Definition: cpl_vsil_gzip.cpp:2449
void CPL_DLL * VSIMallocVerbose(size_t nSize, const char *pszFile, int nLine) CPL_WARN_UNUSED_RESULT
Definition: cpl_vsisimple.cpp:1138
char CPL_DLL * VSIStrdup(const char *) CPL_WARN_UNUSED_RESULT
Definition: cpl_vsisimple.cpp:995
VSIFilesystemPluginRmdirCallback rmdir
Definition: cpl_vsi.h:513
VSIFilesystemPluginStatCallback stat
Definition: cpl_vsi.h:509
char CPL_DLL ** VSIReadDir(const char *)
Read names in a directory.
Definition: cpl_vsil.cpp:83
int CPL_DLL VSIFFlushL(VSILFILE *) EXPERIMENTAL_CPL_WARN_UNUSED_RESULT
Flush pending writes to disk.
Definition: cpl_vsil.cpp:1638
size_t(* VSIFilesystemPluginReadCallback)(void *pFile, void *pBuffer, size_t nSize, size_t nCount)
Definition: cpl_vsi.h:460
GIntBig CPL_DLL VSIGetDiskFreeSpace(const char *pszDirname)
Return free disk space available on the filesystem.
Definition: cpl_vsil.cpp:2261
const char CPL_DLL * VSIGetActualURL(const char *pszFilename)
Returns the actual URL of a supplied filename.
Definition: cpl_vsil.cpp:912
unsigned long long GUIntBig
Definition: cpl_port.h:251
void VSIInstallHdfsHandler(void)
Install /vsihdfs/ file system handler (non-functional stub)
Definition: cpl_vsil_hdfs.cpp:431
int CPL_DLL VSISync(const char *pszSource, const char *pszTarget, const char *const *papszOptions, GDALProgressFunc pProgressFunc, void *pProgressData, char ***ppapszOutputs)
Synchronize a source file/directory with a target file/directory.
Definition: cpl_vsil.cpp:595
GIntBig nMTime
Definition: cpl_vsi.h:323
char CPL_DLL * VSIStrdupVerbose(const char *pszStr, const char *pszFile, int nLine) CPL_WARN_UNUSED_RESULT
Definition: cpl_vsisimple.cpp:1242
void CPL_DLL VSIFree(void *)
Definition: cpl_vsisimple.cpp:827
VSIFilesystemPluginMkdirCallback mkdir
Definition: cpl_vsi.h:512
int CPL_DLL VSIMkdir(const char *pszPathname, long mode)
Create a directory.
Definition: cpl_vsil.cpp:423
int(* VSIFilesystemPluginRmdirCallback)(void *pUserData, const char *pszDirname)
Definition: cpl_vsi.h:433
VSILFILE CPL_DLL * VSIFOpenL(const char *, const char *) CPL_WARN_UNUSED_RESULT
Open file.
Definition: cpl_vsil.cpp:997
VSIFilesystemPluginEofCallback eof
Definition: cpl_vsi.h:521
int(* VSIFilesystemPluginCloseCallback)(void *pFile)
Definition: cpl_vsi.h:495
int(* VSIFilesystemPluginTruncateCallback)(void *pFile, vsi_l_offset nNewSize)
Definition: cpl_vsi.h:490
int CPL_DLL VSIStatL(const char *, VSIStatBufL *) CPL_WARN_UNUSED_RESULT
Get filesystem object info.
Definition: cpl_vsil.cpp:737
GByte CPL_DLL * VSIGetMemFileBuffer(const char *pszFilename, vsi_l_offset *pnDataLength, int bUnlinkAndSeize)
Fetch buffer underlying memory file.
Definition: cpl_vsi_mem.cpp:959
size_t CPL_DLL VSIFWriteL(const void *, size_t, size_t, VSILFILE *) EXPERIMENTAL_CPL_WARN_UNUSED_RESULT
Write bytes to file.
Definition: cpl_vsil.cpp:1804
int CPL_DLL VSIHasOptimizedReadMultiRange(const char *pszPath)
Returns if the filesystem supports efficient multi-range reading.
Definition: cpl_vsil.cpp:882
#define CPL_FORMAT_STRING(arg)
Definition: cpl_port.h:929
GIntBig CPL_DLL CPLGetPhysicalRAM(void)
Definition: cpl_vsisimple.cpp:1369
GUIntBig vsi_l_offset
Definition: cpl_vsi.h:140
#define CPL_WARN_UNUSED_RESULT
Definition: cpl_port.h:939
VSIFilesystemPluginOpenCallback open
Definition: cpl_vsi.h:515
VSIFilesystemPluginReadDirCallback read_dir
Definition: cpl_vsi.h:514
VSIFilesystemPluginReadMultiRangeCallback read_multi_range
Definition: cpl_vsi.h:519
GIntBig CPL_DLL CPLGetUsablePhysicalRAM(void)
Definition: cpl_vsisimple.cpp:1460
int(* VSIFilesystemPluginReadMultiRangeCallback)(void *pFile, int nRanges, void **ppData, const vsi_l_offset *panOffsets, const size_t *panSizes)
Definition: cpl_vsi.h:465
void CPL_DLL VSIInstallMemFileHandler(void)
Install "memory" file system handler.
Definition: cpl_vsi_mem.cpp:868
void CPL_DLL VSICloseDir(VSIDIR *dir)
Close a directory.
Definition: cpl_vsil.cpp:398
long long GIntBig
Definition: cpl_port.h:248
int(* VSIFilesystemPluginRenameCallback)(void *pUserData, const char *oldpath, const char *newpath)
Definition: cpl_vsi.h:423
Definition: cpl_vsi_virtual.h:242
void * pUserData
Definition: cpl_vsi.h:508
void CPL_DLL VSIRewindL(VSILFILE *)
Rewind the file pointer to the beginning of the file.
Definition: cpl_vsil.cpp:1597
int CPL_DLL VSIInstallPluginHandler(const char *pszPrefix, const VSIFilesystemPluginCallbacksStruct *poCb)
Definition: cpl_vsil_plugin.cpp:344
VSIFilesystemPluginWriteCallback write
Definition: cpl_vsi.h:522
VSIFilesystemPluginTruncateCallback truncate
Definition: cpl_vsi.h:524
char bMTimeKnown
Definition: cpl_vsi.h:329
int CPL_DLL VSIRmdir(const char *pszDirname)
Delete a directory.
Definition: cpl_vsil.cpp:647
const VSIDIREntry CPL_DLL * VSIGetNextDirEntry(VSIDIR *dir)
Return the next entry of the directory.
Definition: cpl_vsil.cpp:379
void *(* VSIFilesystemPluginOpenCallback)(void *pUserData, const char *pszFilename, const char *pszAccess)
Definition: cpl_vsi.h:444
int CPL_DLL VSIIsCaseSensitiveFS(const char *pszFilename)
Returns if the filenames of the filesystem are case sensitive.
Definition: cpl_vsil.cpp:826
char bSizeKnown
Definition: cpl_vsi.h:327
void CPL_DLL VSIStdoutSetRedirection(VSIWriteFunction pFct, FILE *stream)
Definition: cpl_vsil_stdout.cpp:64
void CPL_DLL * VSIRealloc(void *, size_t) CPL_WARN_UNUSED_RESULT
Definition: cpl_vsisimple.cpp:681
void CPL_DLL VSIFreeAligned(void *ptr)
Definition: cpl_vsisimple.cpp:975
VSIFilesystemPluginCloseCallback close
Definition: cpl_vsi.h:525
void CPL_DLL VSIFreeFilesystemPluginCallbacksStruct(VSIFilesystemPluginCallbacksStruct *poCb)
Definition: cpl_vsil_plugin.cpp:354
void CPL_DLL * VSIMalloc3Verbose(size_t nSize1, size_t nSize2, size_t nSize3, const char *pszFile, int nLine) CPL_WARN_UNUSED_RESULT
Definition: cpl_vsisimple.cpp:1180