GDAL
cpl_virtualmem.h
Go to the documentation of this file.
1/**********************************************************************
2 * $Id$
3 *
4 * Name: cpl_virtualmem.h
5 * Project: CPL - Common Portability Library
6 * Purpose: Virtual memory
7 * Author: Even Rouault, <even dot rouault at spatialys.com>
8 *
9 **********************************************************************
10 * Copyright (c) 2014, Even Rouault <even dot rouault at spatialys.com>
11 *
12 * SPDX-License-Identifier: MIT
13 ****************************************************************************/
14
15#ifndef CPL_VIRTUAL_MEM_INCLUDED
16#define CPL_VIRTUAL_MEM_INCLUDED
17
18#include <stddef.h>
19
20#include "cpl_port.h"
21#include "cpl_vsi.h"
22
24
47
59typedef void (*CPLVirtualMemCachePageCbk)(CPLVirtualMem *ctxt, size_t nOffset,
60 void *pPageToFill, size_t nToFill,
61 void *pUserData);
62
74typedef void (*CPLVirtualMemUnCachePageCbk)(CPLVirtualMem *ctxt, size_t nOffset,
75 const void *pPageToBeEvicted,
76 size_t nToBeEvicted,
77 void *pUserData);
78
82typedef void (*CPLVirtualMemFreeUserData)(void *pUserData);
83
85typedef enum
86{
97
104size_t CPL_DLL CPLGetPageSize(void);
105
150CPLVirtualMem CPL_DLL *
151CPLVirtualMemNew(size_t nSize, size_t nCacheSize, size_t nPageSizeHint,
152 int bSingleThreadUsage, CPLVirtualMemAccessMode eAccessMode,
153 CPLVirtualMemCachePageCbk pfnCachePage,
154 CPLVirtualMemUnCachePageCbk pfnUnCachePage,
155 CPLVirtualMemFreeUserData pfnFreeUserData, void *pCbkUserData);
156
162int CPL_DLL CPLIsVirtualMemFileMapAvailable(void);
163
191 VSILFILE *fp, vsi_l_offset nOffset, vsi_l_offset nLength,
192 CPLVirtualMemAccessMode eAccessMode,
193 CPLVirtualMemFreeUserData pfnFreeUserData, void *pCbkUserData);
194
215 CPLVirtualMem *pVMemBase, vsi_l_offset nOffset, vsi_l_offset nSize,
216 CPLVirtualMemFreeUserData pfnFreeUserData, void *pCbkUserData);
217
229void CPL_DLL CPLVirtualMemFree(CPLVirtualMem *ctxt);
230
246void CPL_DLL *CPLVirtualMemGetAddr(CPLVirtualMem *ctxt);
247
255size_t CPL_DLL CPLVirtualMemGetSize(CPLVirtualMem *ctxt);
256
265
274
285size_t CPL_DLL CPLVirtualMemGetPageSize(CPLVirtualMem *ctxt);
286
305
318void CPL_DLL CPLVirtualMemDeclareThread(CPLVirtualMem *ctxt);
319
333
351void CPL_DLL CPLVirtualMemPin(CPLVirtualMem *ctxt, void *pAddr, size_t nSize,
352 int bWriteOp);
353
361void CPL_DLL CPLVirtualMemManagerTerminate(void);
362
364
365#endif /* CPL_VIRTUAL_MEM_INCLUDED */
Core portability definitions for CPL.
#define CPL_C_END
Macro to end a block of C symbols.
Definition: cpl_port.h:283
#define CPL_C_START
Macro to start a block of C symbols.
Definition: cpl_port.h:279
int CPLIsVirtualMemFileMapAvailable(void)
Return if virtual memory mapping of a file is available.
Definition: cpl_virtualmem.cpp:2137
CPLVirtualMem * CPLVirtualMemFileMapNew(VSILFILE *fp, vsi_l_offset nOffset, vsi_l_offset nLength, CPLVirtualMemAccessMode eAccessMode, CPLVirtualMemFreeUserData pfnFreeUserData, void *pCbkUserData)
Create a new virtual memory mapping from a file.
Definition: cpl_virtualmem.cpp:2107
size_t CPLVirtualMemGetSize(CPLVirtualMem *ctxt)
Return the size of the virtual memory mapping.
Definition: cpl_virtualmem.cpp:2219
CPLVirtualMem * CPLVirtualMemNew(size_t nSize, size_t nCacheSize, size_t nPageSizeHint, int bSingleThreadUsage, CPLVirtualMemAccessMode eAccessMode, CPLVirtualMemCachePageCbk pfnCachePage, CPLVirtualMemUnCachePageCbk pfnUnCachePage, CPLVirtualMemFreeUserData pfnFreeUserData, void *pCbkUserData)
Create a new virtual memory mapping.
Definition: cpl_virtualmem.cpp:1948
void(* CPLVirtualMemCachePageCbk)(CPLVirtualMem *ctxt, size_t nOffset, void *pPageToFill, size_t nToFill, void *pUserData)
Callback triggered when a still unmapped page of virtual memory is accessed.
Definition: cpl_virtualmem.h:59
void CPLVirtualMemManagerTerminate(void)
Cleanup any resource and handlers related to virtual memory.
Definition: cpl_virtualmem.cpp:1974
void CPLVirtualMemPin(CPLVirtualMem *ctxt, void *pAddr, size_t nSize, int bWriteOp)
Make sure that a region of virtual memory will be realized.
Definition: cpl_virtualmem.cpp:1969
int CPLVirtualMemIsFileMapping(CPLVirtualMem *ctxt)
Return if the virtual memory mapping is a direct file mapping.
Definition: cpl_virtualmem.cpp:2192
void * CPLVirtualMemGetAddr(CPLVirtualMem *ctxt)
Return the pointer to the start of a virtual memory mapping.
Definition: cpl_virtualmem.cpp:2183
void CPLVirtualMemUnDeclareThread(CPLVirtualMem *ctxt)
Declare that a thread will stop accessing a virtual memory mapping.
Definition: cpl_virtualmem.cpp:1965
void(* CPLVirtualMemUnCachePageCbk)(CPLVirtualMem *ctxt, size_t nOffset, const void *pPageToBeEvicted, size_t nToBeEvicted, void *pUserData)
Callback triggered when a dirty mapped page is going to be freed.
Definition: cpl_virtualmem.h:74
void(* CPLVirtualMemFreeUserData)(void *pUserData)
Callback triggered when a virtual memory mapping is destroyed.
Definition: cpl_virtualmem.h:82
CPLVirtualMem * CPLVirtualMemDerivedNew(CPLVirtualMem *pVMemBase, vsi_l_offset nOffset, vsi_l_offset nSize, CPLVirtualMemFreeUserData pfnFreeUserData, void *pCbkUserData)
Create a new virtual memory mapping derived from an other virtual memory mapping.
Definition: cpl_virtualmem.cpp:2237
CPLVirtualMemAccessMode CPLVirtualMemGetAccessMode(CPLVirtualMem *ctxt)
Return the access mode of the virtual memory mapping.
Definition: cpl_virtualmem.cpp:2201
void CPLVirtualMemDeclareThread(CPLVirtualMem *ctxt)
Declare that a thread will access a virtual memory mapping.
Definition: cpl_virtualmem.cpp:1961
struct CPLVirtualMem CPLVirtualMem
Opaque type that represents a virtual memory mapping.
Definition: cpl_virtualmem.h:46
int CPLVirtualMemIsAccessThreadSafe(CPLVirtualMem *ctxt)
Return TRUE if this memory mapping can be accessed safely from concurrent threads.
Definition: cpl_virtualmem.cpp:2228
void CPLVirtualMemFree(CPLVirtualMem *ctxt)
Free a virtual memory mapping.
Definition: cpl_virtualmem.cpp:2150
CPLVirtualMemAccessMode
Access mode of a virtual memory mapping.
Definition: cpl_virtualmem.h:86
@ VIRTUALMEM_READONLY_ENFORCED
Definition: cpl_virtualmem.h:92
@ VIRTUALMEM_READWRITE
Definition: cpl_virtualmem.h:95
@ VIRTUALMEM_READONLY
Definition: cpl_virtualmem.h:89
size_t CPLVirtualMemGetPageSize(CPLVirtualMem *ctxt)
Return the page size associated to a virtual memory mapping.
Definition: cpl_virtualmem.cpp:2210
size_t CPLGetPageSize(void)
Return the size of a page of virtual memory.
Definition: cpl_virtualmem.cpp:2124
Standard C Covers.
GUIntBig vsi_l_offset
Type for a file offset.
Definition: cpl_vsi.h:130
Virtual file handle.
Definition: cpl_vsi_virtual.h:47