Copyright	(c) Volker Stolz <vs@foldr.org> 2003
License	BSD-style (see the file libraries/base/LICENSE)
Maintainer	vs@foldr.org
Stability	provisional
Portability	non-portable (requires POSIX)
Safe Haskell	Trustworthy
Language	Haskell2010

System.Posix.DynamicLinker.Prim

Contents

low level API

Description

dlopen(3) and friends Derived from GModule.chs by M.Weber & M.Chakravarty which is part of c2hs. I left the API more or less the same, mostly the flags are different.

Synopsis

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
dataRTLDFlags
- = RTLD_LAZY
- | RTLD_NOW
- | RTLD_GLOBAL
- | RTLD_LOCAL
packDL :: DL -> Ptr ()
dataDL
- = Null
- | Next
- | Default
- | DLHandle (Ptr ())

low level API

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 #

dataRTLDFlags Source #

Flags for dlopen.

Constructors

RTLD_LAZY
RTLD_NOW
RTLD_GLOBAL
RTLD_LOCAL

Instances

Instances details

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

packDL :: DL -> Ptr () Source #

dataDL 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, packDLDefault reduces to nullPtr.

Constructors

Null
Next
Default
DLHandle (Ptr ())

Instances

Instances details

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