ForeignCall.lhs 7.64 KB
Newer Older
1 2 3 4 5 6
%
% (c) The GRASP/AQUA Project, Glasgow University, 1992-1998
%
\section[Foreign]{Foreign calls}

\begin{code}
7
{-# OPTIONS -w #-}
8 9 10
-- The above warning supression flag is a temporary kludge.
-- While working on this module you are encouraged to remove it and fix
-- any warnings in the module. See
Ian Lynagh's avatar
Ian Lynagh committed
11
--     http://hackage.haskell.org/trac/ghc/wiki/Commentary/CodingStyle#Warnings
12 13
-- for details

14 15
module ForeignCall (
	ForeignCall(..),
16
	Safety(..), playSafe,
17

18
	CExportSpec(..), CLabelString, isCLabelString, pprCLabelString,
19
	CCallSpec(..), 
20
	CCallTarget(..), isDynamicTarget,
21 22 23
	CCallConv(..), defaultCCallConv, ccallConvToInt, ccallConvAttribute,
    ) where

24
import FastString
25
import Binary
26
import Outputable
27
import Module
Ian Lynagh's avatar
Ian Lynagh committed
28 29

import Data.Char
30 31 32 33 34 35 36 37 38 39
\end{code}


%************************************************************************
%*									*
\subsubsection{Data types}
%*									*
%************************************************************************

\begin{code}
40 41
newtype ForeignCall = CCall CCallSpec
  deriving Eq
42
  {-! derive: Binary !-}
43 44 45 46

-- We may need more clues to distinguish foreign calls
-- but this simple printer will do for now
instance Outputable ForeignCall where
chak's avatar
chak committed
47
  ppr (CCall cc)  = ppr cc		
48 49 50 51 52 53 54
\end{code}

  
\begin{code}
data Safety
  = PlaySafe		-- Might invoke Haskell GC, or do a call back, or
			-- switch threads, etc.  So make sure things are
55 56 57 58 59 60 61 62
			-- tidy before the call. Additionally, in the threaded
			-- RTS we arrange for the external call to be executed
			-- by a separate OS thread, i.e., _concurrently_ to the
			-- execution of other Haskell threads.

      Bool              -- Indicates the deprecated "threadsafe" annotation
                        -- which is now an alias for "safe". This information
                        -- is never used except to emit a deprecation warning.
63 64 65

  | PlayRisky		-- None of the above can happen; the call will return
			-- without interacting with the runtime system at all
66
  deriving ( Eq, Show )
67
	-- Show used just for Show Lex.Token, I think
68
  {-! derive: Binary !-}
69 70

instance Outputable Safety where
Ian Lynagh's avatar
Ian Lynagh committed
71 72 73
  ppr (PlaySafe False) = ptext (sLit "safe")
  ppr (PlaySafe True)  = ptext (sLit "threadsafe")
  ppr PlayRisky = ptext (sLit "unsafe")
74

sof's avatar
sof committed
75 76 77
playSafe :: Safety -> Bool
playSafe PlaySafe{} = True
playSafe PlayRisky  = False
78 79 80 81 82 83 84 85 86 87
\end{code}


%************************************************************************
%*									*
\subsubsection{Calling C}
%*									*
%************************************************************************

\begin{code}
88 89 90 91
data CExportSpec
  = CExportStatic		-- foreign export ccall foo :: ty
	CLabelString		-- C Name of exported function
	CCallConv
92
  {-! derive: Binary !-}
93

94 95 96 97 98
data CCallSpec
  =  CCallSpec	CCallTarget	-- What to call
		CCallConv	-- Calling convention to use.
		Safety
  deriving( Eq )
99
  {-! derive: Binary !-}
100 101 102 103 104
\end{code}

The call target:

\begin{code}
105 106

-- | How to call a particular function in C land.
107
data CCallTarget
108 109 110 111 112 113 114 115 116 117
  -- An "unboxed" ccall# to named function
  = StaticTarget  CLabelString  

  -- The first argument of the import is the name of a function pointer (an Addr#).
  --	Used when importing a label as "foreign import ccall "dynamic" ..."
  | DynamicTarget

  -- An "unboxed" ccall# to a named function from a particular package.
  | PackageTarget CLabelString (Maybe PackageId)
  
118
  deriving( Eq )
119
  {-! derive: Binary !-}
120

121
isDynamicTarget :: CCallTarget -> Bool
122
isDynamicTarget DynamicTarget = True
Ian Lynagh's avatar
Ian Lynagh committed
123
isDynamicTarget _             = False
124 125 126
\end{code}


127 128 129 130 131 132 133 134 135 136 137
Stuff to do with calling convention:

ccall:		Caller allocates parameters, *and* deallocates them.

stdcall: 	Caller allocates parameters, callee deallocates.
		Function name has @N after it, where N is number of arg bytes
		e.g.  _Foo@8

ToDo: The stdcall calling convention is x86 (win32) specific,
so perhaps we should emit a warning if it's being used on other
platforms.
138 139
 
See: http://www.programmersheaven.com/2/Calling-conventions
140 141

\begin{code}
142
data CCallConv = CCallConv | StdCallConv | CmmCallConv | PrimCallConv
143 144
  deriving (Eq)
  {-! derive: Binary !-}
145 146

instance Outputable CCallConv where
Ian Lynagh's avatar
Ian Lynagh committed
147 148 149
  ppr StdCallConv = ptext (sLit "stdcall")
  ppr CCallConv   = ptext (sLit "ccall")
  ppr CmmCallConv = ptext (sLit "C--")
150
  ppr PrimCallConv = ptext (sLit "prim")
151 152 153 154 155 156 157 158 159 160 161 162 163 164

defaultCCallConv :: CCallConv
defaultCCallConv = CCallConv

ccallConvToInt :: CCallConv -> Int
ccallConvToInt StdCallConv = 0
ccallConvToInt CCallConv   = 1
\end{code}

Generate the gcc attribute corresponding to the given
calling convention (used by PprAbsC):

\begin{code}
ccallConvAttribute :: CCallConv -> String
165
ccallConvAttribute StdCallConv = "__attribute__((__stdcall__))"
166 167 168
ccallConvAttribute CCallConv   = ""
\end{code}

169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184
\begin{code}
type CLabelString = FastString		-- A C label, completely unencoded

pprCLabelString :: CLabelString -> SDoc
pprCLabelString lbl = ftext lbl

isCLabelString :: CLabelString -> Bool	-- Checks to see if this is a valid C label
isCLabelString lbl 
  = all ok (unpackFS lbl)
  where
    ok c = isAlphaNum c || c == '_' || c == '.'
	-- The '.' appears in e.g. "foo.so" in the 
	-- module part of a ExtName.  Maybe it should be separate
\end{code}


185 186 187
Printing into C files:

\begin{code}
188 189 190
instance Outputable CExportSpec where
  ppr (CExportStatic str _) = pprCLabelString str

191
instance Outputable CCallSpec where
192 193
  ppr (CCallSpec fun cconv safety)
    = hcat [ ifPprDebug callconv, ppr_fun fun ]
194
    where
195 196 197 198 199
      callconv = text "{-" <> ppr cconv <> text "-}"

      gc_suf | playSafe safety = text "_GC"
	     | otherwise       = empty

200 201 202 203 204 205 206 207 208 209 210
      ppr_fun DynamicTarget     
        = text "__dyn_ccall" <> gc_suf <+> text "\"\""

      ppr_fun (PackageTarget fn Nothing)
     	= text "__pkg_ccall" <> gc_suf <+> pprCLabelString fn

      ppr_fun (PackageTarget fn (Just pkgId))
     	= text "__pkg_ccall" <> gc_suf <+> ppr pkgId <+> pprCLabelString fn

      ppr_fun (StaticTarget fn) 
        = text "__ccall"     <> gc_suf <+> pprCLabelString fn
211 212 213
\end{code}


214 215 216 217 218 219
%************************************************************************
%*									*
\subsubsection{Misc}
%*									*
%************************************************************************

220 221 222
\begin{code}
{-* Generated by DrIFT-v1.0 : Look, but Don't Touch. *-}
instance Binary ForeignCall where
223 224
    put_ bh (CCall aa) = put_ bh aa
    get bh = do aa <- get bh; return (CCall aa)
225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264

instance Binary Safety where
    put_ bh (PlaySafe aa) = do
	    putByte bh 0
	    put_ bh aa
    put_ bh PlayRisky = do
	    putByte bh 1
    get bh = do
	    h <- getByte bh
	    case h of
	      0 -> do aa <- get bh
		      return (PlaySafe aa)
	      _ -> do return PlayRisky

instance Binary CExportSpec where
    put_ bh (CExportStatic aa ab) = do
	    put_ bh aa
	    put_ bh ab
    get bh = do
	  aa <- get bh
	  ab <- get bh
	  return (CExportStatic aa ab)

instance Binary CCallSpec where
    put_ bh (CCallSpec aa ab ac) = do
	    put_ bh aa
	    put_ bh ab
	    put_ bh ac
    get bh = do
	  aa <- get bh
	  ab <- get bh
	  ac <- get bh
	  return (CCallSpec aa ab ac)

instance Binary CCallTarget where
    put_ bh (StaticTarget aa) = do
	    putByte bh 0
	    put_ bh aa
    put_ bh DynamicTarget = do
	    putByte bh 1
265 266 267 268
    put_ bh (PackageTarget aa ab) = do
    	    putByte bh 2
	    put_ bh aa
	    put_ bh ab
269 270 271 272 273
    get bh = do
	    h <- getByte bh
	    case h of
	      0 -> do aa <- get bh
		      return (StaticTarget aa)
274 275 276 277
	      1 -> do return DynamicTarget
	      _ -> do aa <- get bh
	      	      ab <- get bh
		      return (PackageTarget aa ab)
278 279 280 281 282 283

instance Binary CCallConv where
    put_ bh CCallConv = do
	    putByte bh 0
    put_ bh StdCallConv = do
	    putByte bh 1
284 285
    put_ bh PrimCallConv = do
	    putByte bh 2
286 287 288 289
    get bh = do
	    h <- getByte bh
	    case h of
	      0 -> do return CCallConv
290 291
	      1 -> do return StdCallConv
	      _ -> do return PrimCallConv
292
\end{code}