Added first stab of pnd exec support
[pandora-libraries.git] / include / pnd_apps.h
index 6cf16b4..3f2065a 100644 (file)
@@ -9,8 +9,8 @@ extern "C" {
 #define PND_APPS_SEARCHPATH "/mnt/sd1/pandora/apps:/mnt/sd2/pandora/apps:./testdata/apps"
 #define PND_APPS_KEY "autodiscovery.searchpath"
 
-#define PND_PNDRUN_SEARCHPATH "pnd.searchpath"
-#define PND_PNDRUN_KEY "pnd.default"
+#define PND_PNDRUN_SEARCHPATH_KEY "pnd.searchpath"
+#define PND_PNDRUN_KEY "pnd.runscript"
 #define PND_PNDRUN_FILENAME "pnd_run.sh"
 #define PND_PNDRUN_DEFAULT "./testdata/scripts/pnd_run.sh"
 
@@ -29,12 +29,12 @@ extern "C" {
 /* pnd_apps_exec() is used to blindly launch an app, be it a .pnd file bundle or a plain executable
  * (shell, bin, whatever.) pndrun specifies the full path to the pnd_run sh script, which should be
  * found using searchpaths and locates.. see locatetest.c for a sample
- *   if fullpath ends in PXML_FILENAME (PXML.xml) then pnd_run will be invoked (after extracting goodies
- *     from PXML file as appropriate)
- *   if fullpath ends in .pnd then pnd_run will be invoked (after inspecting embedded PXML or best-guess)
- *   otherwise the fullpath will be executed as-is
+ * NOTE: Use pnd_locate function to locate the pnd_run, for example
+ * NOTE: clock speed will be set prior to invoking the script, and set back on exit
+ * NOTE: No values can be except clockspeed; a 0 clockspeed means 'leave alone'. Set startdoir to "." instead of NULL.
+ * fork() is implied; calling this function does not kill this process :)
  */
-signed char pnd_apps_exec ( char *fullpath, char *pndrun );
+unsigned char pnd_apps_exec ( char *pndrun, char *fullpath, char *unique_id, char *rel_exec, char *rel_startdir, unsigned int clockspeed );
 
 #ifdef __cplusplus
 } /* "C" */