Copyright	(c) The University of Glasgow 2002
License	BSD-style (see the file libraries/base/LICENSE)
Maintainer	libraries@haskell.org
Stability	provisional
Portability	non-portable (requires POSIX)
Safe Haskell	Safe
Language	Haskell2010

System.Posix

Description

POSIX.1-2008 support

Synopsis

module System.Posix.Types
module System.Posix.Signals
module System.Posix.Directory
module System.Posix.Files
module System.Posix.Unistd
module System.Posix.IO
module System.Posix.Env
module System.Posix.Process
module System.Posix.Temp
module System.Posix.Terminal
module System.Posix.Time
module System.Posix.User
module System.Posix.Resource
module System.Posix.Semaphore
module System.Posix.SharedMem
data RTLDFlags
- = RTLD_LAZY
- | RTLD_NOW
- | RTLD_GLOBAL
- | RTLD_LOCAL
data DL
- = Null
- | Next
- | DLHandle (Ptr ())
c_dlopen :: CString -> CInt -> IO (Ptr ())
c_dlsym :: Ptr () -> CString -> IO (FunPtr a)
c_dlerror :: IO CString
c_dlclose :: Ptr () -> IO CInt
haveRtldNext :: Bool
haveRtldLocal :: Bool
packRTLDFlags :: [RTLDFlags] -> CInt
packDL :: DL -> Ptr ()
dlopen :: FilePath -> [RTLDFlags] -> IO DL
dlsym :: DL -> String -> IO (FunPtr a)
dlerror :: IO String
dlclose :: DL -> IO ()
withDL :: FilePath -> [RTLDFlags] -> (DL -> IO a) -> IO a
withDL_ :: FilePath -> [RTLDFlags] -> (DL -> IO a) -> IO ()
undl :: DL -> Ptr ()

Documentation

module System.Posix.Types

module System.Posix.Signals

module System.Posix.Directory

module System.Posix.Files

module System.Posix.Unistd

module System.Posix.IO

module System.Posix.Env

module System.Posix.Process

module System.Posix.Temp

module System.Posix.Terminal

module System.Posix.Time

module System.Posix.User

module System.Posix.Resource

module System.Posix.Semaphore

module System.Posix.SharedMem

data RTLDFlags Source #

Flags for dlopen.

Constructors

RTLD_LAZY
RTLD_NOW
RTLD_GLOBAL
RTLD_LOCAL

Instances

Instances details

Read RTLDFlags Source #
Instance details Defined in System.Posix.DynamicLinker.Prim Methods readsPrec :: Int -> ReadS RTLDFlags # readList :: ReadS [RTLDFlags] # readPrec :: ReadPrec RTLDFlags # readListPrec :: ReadPrec [RTLDFlags] #
Show RTLDFlags Source #
Instance details Defined in System.Posix.DynamicLinker.Prim Methods showsPrec :: Int -> RTLDFlags -> ShowS # show :: RTLDFlags -> String # showList :: [RTLDFlags] -> ShowS #

data DL Source #

Flags for dlsym. Notice that Next might not be available on your particular platform! Use haveRtldNext.

If RTLD_DEFAULT is not defined on your platform, packDL Default reduces to nullPtr.

Constructors

Null
Next
DLHandle (Ptr ())

Instances

Instances details

Show DL Source #
Instance details Defined in System.Posix.DynamicLinker.Prim Methods showsPrec :: Int -> DL -> ShowS # show :: DL -> String # showList :: [DL] -> ShowS #

c_dlopen :: CString -> CInt -> IO (Ptr ()) Source #

c_dlsym :: Ptr () -> CString -> IO (FunPtr a) Source #

c_dlerror :: IO CString Source #

c_dlclose :: Ptr () -> IO CInt Source #

haveRtldNext :: Bool Source #

On some hosts (e.g. SuSe and Ubuntu Linux) RTLD_NEXT (and RTLD_DEFAULT) are not visible without setting the macro _GNU_SOURCE. Since we don't want to define this macro, you can use the function haveRtldNext to check whether the flag Next is available. Ideally, this will be optimized by the compiler so that it should be as efficient as an #ifdef.

If you fail to test the flag and use it although it is undefined, packDL will throw an error.

haveRtldLocal :: Bool Source #

Deprecated: defaults to True

packRTLDFlags :: [RTLDFlags] -> CInt Source #

packDL :: DL -> Ptr () Source #

dlopen :: FilePath -> [RTLDFlags] -> IO DL Source #

dlsym :: DL -> String -> IO (FunPtr a) Source #

dlsym returns the address binding of the symbol described in symbol, as it occurs in the shared object identified by source.

dlerror :: IO String Source #

dlclose :: DL -> IO () Source #

withDL :: FilePath -> [RTLDFlags] -> (DL -> IO a) -> IO a Source #

withDL_ :: FilePath -> [RTLDFlags] -> (DL -> IO a) -> IO () Source #

undl :: DL -> Ptr () Source #

undl obtains the raw handle. You mustn't do something like withDL mod flags $ liftM undl >>= p -> use p