PSI sics-cvs-psi-2008-10-02

initializer.h

@@ -12,7 +12,8 @@ Markus Zolliker, March 2005
 
 typedef void (*Initializer)(void);
 
-void MakeInitializer(const char *type, const char *name, Initializer maker, int startupOnly);
+void MakeInitializer(const char *type, const char *name, Initializer maker, int startupOnly,
+                     const char *desc);
 /*
    install an initializer
 
@@ -32,16 +33,19 @@ Initializer GetInitializer(const char *type, const char *name);
     type. 
 */
 
+/*
 static int MakeObject(SConnection *con, SicsInterp *sics,
                    void *data, int argc, char *argv[]);
-/*
+
    MakeObject has the following syntax:
    
      MakeObject objectName driver [ args ... ]
   
    It executes the initializer with the type "Object" and and the
    driver given as name. The found initalizer should use the given arguments
-   to create a driver.
+   to create a driver. Objects should be dynamic, i.e. there should be
+   a creation command in the status file, except when the creation command
+   was MakeStaticObject instead of MakeObject.
    
 */
 
@@ -51,10 +55,12 @@ typedef int (*CmdInitializer) (SConnection *pCon, int argc, char *argv[], int dy
    - pCon: the sics connection calling this initializer
    - argc: the total number of args
    - argv: the args (argv[0]: "MakeObject", argv[1]: object name, argv[3]: driver ...)
-   - dynamic: the initializer was called _after_ startup
+   - dynamic: 1, if the creation command was MakeObject,
+              0, if the creation command was MakeStaticObject
 */
 
-void MakeDriver(const char *driver, CmdInitializer maker, int startupOnly);
+void MakeDriver(const char *driver, CmdInitializer maker, int startupOnly,
+                const char *desc);
 /*    
    Install a driver of type "Object" with the initializer function maker.
    - startupOnly: the driver creation should only be possible at startup