Safe Haskell | Safe |
---|---|
Language | Haskell98 |
Provides mmap
: mapping files into memory.
Synopsis
- data MmapException = MmapException
- data MunmapException = MunmapException {}
- c_mmap :: Ptr () -> CSize -> ProtOption -> MmapFlags -> Fd -> COff -> IO (Ptr ())
- c_munmap :: Ptr () -> CSize -> IO CInt
- mmap :: Ptr () -> CSize -> ProtOption -> MmapFlags -> Fd -> COff -> IO (Ptr ())
- munmap :: Ptr () -> CSize -> IO ()
- newtype ProtOption = ProtOption {
- unProtOption :: CInt
- protExec :: ProtOption
- protRead :: ProtOption
- protWrite :: ProtOption
- protNone :: ProtOption
- newtype MmapSharedFlag = MmapSharedFlag {}
- mapShared :: MmapSharedFlag
- mapPrivate :: MmapSharedFlag
- newtype MmapOptionalFlag = MmapOptionalFlag {}
- map32Bit :: MmapOptionalFlag
- mapAnonymous :: MmapOptionalFlag
- mapDenywrite :: MmapOptionalFlag
- mapFile :: MmapOptionalFlag
- mapFixed :: MmapOptionalFlag
- mapHugetlb :: MmapOptionalFlag
- mapLocked :: MmapOptionalFlag
- mapNonblock :: MmapOptionalFlag
- mapNoreserve :: MmapOptionalFlag
- mapStack :: MmapOptionalFlag
- newtype MmapFlags = MmapFlags {
- unMmapFlags :: CInt
- mkMmapFlags :: MmapSharedFlag -> MmapOptionalFlag -> MmapFlags
Documentation
data MmapException Source #
Exception thrown when mmap
fails.
Instances
Eq MmapException Source # | |
Defined in MMAP (==) :: MmapException -> MmapException -> Bool # (/=) :: MmapException -> MmapException -> Bool # | |
Ord MmapException Source # | |
Defined in MMAP compare :: MmapException -> MmapException -> Ordering # (<) :: MmapException -> MmapException -> Bool # (<=) :: MmapException -> MmapException -> Bool # (>) :: MmapException -> MmapException -> Bool # (>=) :: MmapException -> MmapException -> Bool # max :: MmapException -> MmapException -> MmapException # min :: MmapException -> MmapException -> MmapException # | |
Show MmapException Source # | |
Defined in MMAP showsPrec :: Int -> MmapException -> ShowS # show :: MmapException -> String # showList :: [MmapException] -> ShowS # | |
Exception MmapException Source # | |
Defined in MMAP |
data MunmapException Source #
Exception thrown when munmap
fails.
Instances
Eq MunmapException Source # | |
Defined in MMAP (==) :: MunmapException -> MunmapException -> Bool # (/=) :: MunmapException -> MunmapException -> Bool # | |
Ord MunmapException Source # | |
Defined in MMAP compare :: MunmapException -> MunmapException -> Ordering # (<) :: MunmapException -> MunmapException -> Bool # (<=) :: MunmapException -> MunmapException -> Bool # (>) :: MunmapException -> MunmapException -> Bool # (>=) :: MunmapException -> MunmapException -> Bool # max :: MunmapException -> MunmapException -> MunmapException # min :: MunmapException -> MunmapException -> MunmapException # | |
Show MunmapException Source # | |
Defined in MMAP showsPrec :: Int -> MunmapException -> ShowS # show :: MunmapException -> String # showList :: [MunmapException] -> ShowS # | |
Exception MunmapException Source # | |
Defined in MMAP |
munmap
- unmap mmap
'ed memory.
This is the raw C function, and its return value must be checked
according to man mmap
.
See munmap
for a variant that turns bad return values into exceptions.
mmap :: Ptr () -> CSize -> ProtOption -> MmapFlags -> Fd -> COff -> IO (Ptr ()) Source #
Convenience around c_mmap
, throwing a MmapException
on a negative return value.
munmap :: Ptr () -> CSize -> IO () Source #
Convenience around c_munmap
, throwing a MunmapException
on a negative return value.
newtype ProtOption Source #
Describes the desired memory protection of the mapping (and must not conflict with the open mode of the file).
Can be combined using the Monoid
instance `(<>)`.
Instances
Eq ProtOption Source # | |
Defined in MMAP (==) :: ProtOption -> ProtOption -> Bool # (/=) :: ProtOption -> ProtOption -> Bool # | |
Ord ProtOption Source # | |
Defined in MMAP compare :: ProtOption -> ProtOption -> Ordering # (<) :: ProtOption -> ProtOption -> Bool # (<=) :: ProtOption -> ProtOption -> Bool # (>) :: ProtOption -> ProtOption -> Bool # (>=) :: ProtOption -> ProtOption -> Bool # max :: ProtOption -> ProtOption -> ProtOption # min :: ProtOption -> ProtOption -> ProtOption # | |
Show ProtOption Source # | |
Defined in MMAP showsPrec :: Int -> ProtOption -> ShowS # show :: ProtOption -> String # showList :: [ProtOption] -> ShowS # | |
Semigroup ProtOption Source # | |
Defined in MMAP (<>) :: ProtOption -> ProtOption -> ProtOption # sconcat :: NonEmpty ProtOption -> ProtOption # stimes :: Integral b => b -> ProtOption -> ProtOption # | |
Monoid ProtOption Source # | |
Defined in MMAP mempty :: ProtOption # mappend :: ProtOption -> ProtOption -> ProtOption # mconcat :: [ProtOption] -> ProtOption # |
protExec :: ProtOption Source #
Pages may be executed.
protRead :: ProtOption Source #
Pages may be read.
protWrite :: ProtOption Source #
Pages may be written.
protNone :: ProtOption Source #
Pages may not be accessed.
newtype MmapSharedFlag Source #
Determines whether updates to the mapping are visible to other processes mapping the same region, and whether updates are carried through to the underlying file.
This behavior is determined by including exactly one of
mapShared
and mapPrivate
.
mapShared :: MmapSharedFlag Source #
Share this mapping. Updates to the mapping are visible to
other processes that map the file, and are carried through to
the underlying file. The file may not actually be updated
until msync(2)
or munmap()
is called..
mapPrivate :: MmapSharedFlag Source #
Create a private copy-on-write mapping. Updates to the mapping
are not visible to other processes mapping the same file, and
are not carried through to the underlying file. It is unspecified
whether changes made to the file after the mmap()
call are
visible in the mapped region.
newtype MmapOptionalFlag Source #
And MmapSharedFlag
with one or more MmapOptionalFlag
s.
Instances
map32Bit :: MmapOptionalFlag Source #
See man mmap
for a description.
mapAnonymous :: MmapOptionalFlag Source #
See man mmap
for a description.
mapDenywrite :: MmapOptionalFlag Source #
See man mmap
for a description.
mapFile :: MmapOptionalFlag Source #
See man mmap
for a description.
mapFixed :: MmapOptionalFlag Source #
See man mmap
for a description.
mapHugetlb :: MmapOptionalFlag Source #
See man mmap
for a description.
mapLocked :: MmapOptionalFlag Source #
See man mmap
for a description.
mapNonblock :: MmapOptionalFlag Source #
See man mmap
for a description.
mapNoreserve :: MmapOptionalFlag Source #
See man mmap
for a description.
mapStack :: MmapOptionalFlag Source #
See man mmap
for a description.
An MmapSharedFlag
with one or more MmapOptionalFlag
s.
mkMmapFlags :: MmapSharedFlag -> MmapOptionalFlag -> MmapFlags Source #
Create MmapFlags
to be passed to c_mmap
from an MmapSharedFlag
and one or more MmapOptionalFlag
s (combine them via `(<>)`,
mempty
for none).