1 /* ----------------------------------------------------------------------------
2 * $Id: RtsAPI.h,v 1.19 2001/01/11 17:25:56 simonmar Exp $
4 * (c) The GHC Team, 1998-1999
6 * API for invoking Haskell functions via the RTS
8 * --------------------------------------------------------------------------*/
16 * Running the scheduler
19 NoStatus, /* not finished yet */
20 Success, /* completed successfully */
21 Killed, /* uncaught exception */
22 Interrupted, /* stopped in response to a call to interruptStgRts */
23 Deadlock /* no threads to run, but main thread hasn't finished */
26 typedef StgClosure *HaskellObj;
28 /* ----------------------------------------------------------------------------
29 Starting up and shutting down the Haskell RTS.
30 ------------------------------------------------------------------------- */
31 extern void startupHaskell ( int argc, char *argv[], void *init_root );
32 extern void shutdownHaskell ( void );
33 extern void shutdownHaskellAndExit ( int exitCode );
34 extern void setProgArgv ( int argc, char *argv[] );
35 extern void getProgArgv ( int *argc, char **argv[] );
37 /* ----------------------------------------------------------------------------
38 Building Haskell objects from C datatypes.
39 ------------------------------------------------------------------------- */
40 HaskellObj rts_mkChar ( HsChar c );
41 HaskellObj rts_mkInt ( HsInt i );
42 HaskellObj rts_mkInt8 ( HsInt8 i );
43 HaskellObj rts_mkInt16 ( HsInt16 i );
44 HaskellObj rts_mkInt32 ( HsInt32 i );
45 HaskellObj rts_mkInt64 ( HsInt64 i );
46 HaskellObj rts_mkWord ( HsWord w );
47 HaskellObj rts_mkWord8 ( HsWord8 w );
48 HaskellObj rts_mkWord16 ( HsWord16 w );
49 HaskellObj rts_mkWord32 ( HsWord32 w );
50 HaskellObj rts_mkWord64 ( HsWord64 w );
51 HaskellObj rts_mkPtr ( HsPtr a );
52 HaskellObj rts_mkFloat ( HsFloat f );
53 HaskellObj rts_mkDouble ( HsDouble f );
54 HaskellObj rts_mkStablePtr ( HsStablePtr s );
55 HaskellObj rts_mkBool ( HsBool b );
56 HaskellObj rts_mkString ( char *s );
58 HaskellObj rts_apply ( HaskellObj, HaskellObj );
60 /* DEPRECATED (use rts_mkPtr): */
61 HaskellObj rts_mkAddr ( HsAddr a );
63 /* ----------------------------------------------------------------------------
64 Deconstructing Haskell objects
65 ------------------------------------------------------------------------- */
66 HsChar rts_getChar ( HaskellObj );
67 HsInt rts_getInt ( HaskellObj );
68 HsInt32 rts_getInt32 ( HaskellObj );
69 HsWord rts_getWord ( HaskellObj );
70 HsWord32 rts_getWord32 ( HaskellObj );
71 HsPtr rts_getPtr ( HaskellObj );
72 HsFloat rts_getFloat ( HaskellObj );
73 HsDouble rts_getDouble ( HaskellObj );
74 HsStablePtr rts_getStablePtr ( HaskellObj );
75 HsBool rts_getBool ( HaskellObj );
77 /* DEPRECATED (use rts_getPtr): */
78 HsAddr rts_getAddr ( HaskellObj );
80 /* ----------------------------------------------------------------------------
81 Evaluating Haskell expressions
83 The versions ending in '_' allow you to specify an initial stack size.
84 ------------------------------------------------------------------------- */
86 rts_eval ( HaskellObj p, /*out*/HaskellObj *ret );
89 rts_eval_ ( HaskellObj p, unsigned int stack_size, /*out*/HaskellObj *ret );
92 rts_evalIO ( HaskellObj p, /*out*/HaskellObj *ret );
95 rts_evalLazyIO ( HaskellObj p, unsigned int stack_size, /*out*/HaskellObj *ret );
97 #if defined(PAR) || defined(SMP)
99 rts_evalNothing(unsigned int stack_size);
103 rts_checkSchedStatus ( char* site, SchedulerStatus rc);
105 #endif /* RTSAPI_H */