win32-mmap
Release 0.4.2

The win32-mmap library provides an interface for memory mapped IO on MS Windows.

Homepage Rubygems Ruby Documentation Download

License: Artistic-2.0
Install: gem install win32-mmap -v 0.4.2

Documentation

= Description
  This package provides a Ruby interface for memory mapped I/O on MS Windows.
   
= Prerequisites
  * ffi
  * test-unit (Testing only)

= Installation
  gem install win32-mmap
   
= Synopsis
  require 'win32/mmap'
  include Win32
   
  map1 = MMap.new(:file => "C:\\test.map", :size => 1024)
  map1.foo = 'hello'
  map1.bar = 77
  map1.close
   
  map2 = MMap.new(:file => "C:\\test.map")
  p map2.foo # 'hello'
  p map2.bar # 77
  map2.close

= About Memory Mapped Files under Windows
  Under Windows, code and data are both repesented by pages of memory backed
  by files on disk, code by executable image and data by system pagefile
  (i.e. swapfile). These are called memory mapped files. Memory mapped files
  can be used to provide a mechanism for shared memory between processes.
  Different processes are able to share data backed by the same swapfile,
  whether it's the system pagefile or a user-defined swapfile.

  Windows has a tight security system that prevents processes from directly
  sharing information among each other, but mapped memory files provide a
  mechanism that works with the Windows security system by using a name that
  all processes use to open the swapfile.

  A shared section of the swapfile is translated into pages of memory that are
  addressable by more than one process, Windows uses a system resource called a
  prototype page table entry (PPTE) to enable more than one process to address
  the same physical page of memory, thus multiple process can share the same
  data without violating the Windows system security.

  In short, memory mapped files provide shared memory under Windows.

  (This explanation was largely borrowed from Roger Lee's Win32::MMF Perl
  module.)

== Contributions
  Although this library is free, please consider having your company
  setup a gittip if used by your company professionally.

  http://www.gittip.com/djberg96/

= Future Plans
  Suggestions welcome.

= License
  Artistic 2.0
    
= Copyright
  (C) 2003-2013 Daniel J. Berger, All Rights Reserved
    
= Warranty
  This package is provided "as is" and without any express or
  implied warranties, including, without limitation, the implied
  warranties of merchantability and fitness for a particular purpose.
    
= Authors
  Daniel J. Berger
  Park Heesob

Dependencies: 1
Dependent packages: 2
Dependent repositories: 133
Total releases: 10
Latest release: Nov 13, 2015
First release: Jul 25, 2009
Stars: 7
Forks: 3
Watchers: 9
Contributors: 3
Repository size: 56.6 KB
SourceRank: 10