Public API Reference

csutil/mmapio.h

Go to the documentation of this file.

/*
    Copyright (C) 2002-2005 by Jorrit Tyberghein
              (C) 2005 by Frank Richter

    This library is free software; you can redistribute it and/or
    modify it under the terms of the GNU Library General Public
    License as published by the Free Software Foundation; either
    version 2 of the License, or (at your option) any later version.

    This library is distributed in the hope that it will be useful,
    but WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
    Library General Public License for more details.

    You should have received a copy of the GNU Library General Public
    License along with this library; if not, write to the Free
    Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
*/

#ifndef __CS_MEMORY_MAPPED_IO__
#define __CS_MEMORY_MAPPED_IO__

#include "csextern.h"
#include "bitarray.h"
#include "ref.h"
#include "refcount.h"

struct iVFS;

/* Note: the "#define csPlatformMemoryMapping ..." is done to appease doxygen,
 * which produces funny results when all the memory mapping base classes
 * would be in unison named "csPlatformMemoryMapping".
 */
#if defined(CS_PLATFORM_WIN32)
  #include "win32/mmap.h"
  #define csPlatformMemoryMapping csPlatformMemoryMappingWin32
#elif defined(CS_HAVE_POSIX_MMAP)
  #include "mmap_posix.h"
  #define csPlatformMemoryMapping csPlatformMemoryMappingPosix
#else
  #include "mmap_dummy.h"
  #define csPlatformMemoryMapping csPlatformMemoryMappingDummy
#endif

class csMemoryMapping : public csRefCount
{
public:
  virtual size_t GetLength() = 0;
  virtual void* GetData() = 0;
};

class CS_CRYSTALSPACE_EXPORT csMemoryMappedIO : public csPlatformMemoryMapping,
                                                public csRefCount
{
private:
  bool valid_mmio_object;

  FILE *hMappedFile;
  
  bool valid_platform;
public:
  csMemoryMappedIO(char const *filename, iVFS* vfs = 0);

  virtual ~csMemoryMappedIO();

  csRef<csMemoryMapping> GetData (size_t offset, size_t length);
  
  bool IsValid();

private:

  struct PlatformMapping : 
    public csPlatformMemoryMapping::PlatformMemoryMapping, 
    public csMemoryMapping
  {
    csRef<csMemoryMappedIO> parent;
    size_t length;
    uint8* data;
    
    PlatformMapping (csMemoryMappedIO* parent) : parent(parent) {}
    virtual ~PlatformMapping() { parent->FreeMapping (this); }
    virtual size_t GetLength() { return length; }
    virtual void* GetData() { return data; }
  };
  friend struct PlatformMapping;
  
  void FreeMapping (PlatformMapping* mapping);
};

#undef csPlatformMemoryMapping 

#endif // __CS_MEMORY_MAPPED_IO__

---