jrt_plat/java_debug_api/inc/javadebugapi.h
branchRCL_3
changeset 15 a9812d2cae03
parent 1 53c80e845d7c
equal deleted inserted replaced
13:07a17c2b886f 15:a9812d2cae03
    18 
    18 
    19 #ifndef JAVADEBUGAPI_H
    19 #ifndef JAVADEBUGAPI_H
    20 #define JAVADEBUGAPI_H
    20 #define JAVADEBUGAPI_H
    21 
    21 
    22 #include <e32cmn.h>
    22 #include <e32cmn.h>
       
    23 #include <e32std.h>
    23 
    24 
    24 /**
    25 /**
    25  * Java Debug API allows it's users to install, remove, start and
    26  * Java Debug API allows it's users to install, remove, start and
    26  * stop Java applications.
    27  * stop Java applications.
    27  *
    28  *
    57 
    58 
    58 /**
    59 /**
    59  * Starts Java application.
    60  * Starts Java application.
    60  * @param[in] aApplicationUid application uid
    61  * @param[in] aApplicationUid application uid
    61  * @param[in] aUeiParameters includes arguments defined in Unified Emulator Interface (UEI) specification.
    62  * @param[in] aUeiParameters includes arguments defined in Unified Emulator Interface (UEI) specification.
       
    63  * @param[out] aProcessId process id of the launched Java application, valid if application is launched successfully
    62  * If aUeiParameters contains unsupported options then those options are discarded silently.
    64  * If aUeiParameters contains unsupported options then those options are discarded silently.
    63  * Supported arguments:
    65  * Supported arguments:
    64  *   -Xverbose[:options]
    66  *   -Xverbose[:options]
    65  *   -Xdebug -Xrunjdwp:name=value[,name=value[...]]
    67  *   -Xdebug -Xrunjdwp:name=value[,name=value[...]]
    66  * For example, to start Java application in debug mode and set full tracing on
    68  * For example, to start Java application in debug mode and set full tracing on
    67  * following UIE arguments could be given:
    69  * following UIE arguments could be given:
    68  * "-Xdebug -Xrunjdwp:server=y,address=localhost:8000 -Xverbose:all"
    70  * "-Xdebug -Xrunjdwp:server=y,address=localhost:8000 -Xverbose:all"
    69  * @capability NetworkControl
    71  * @capability NetworkControl
    70  * @return true if application is started
    72  * @return true if application is started
    71  */
    73  */
    72 IMPORT_C TBool startApp(TUid aApplicationUid, HBufC& aUeiParameters);
    74 IMPORT_C TBool startApp(TUid aApplicationUid, HBufC& aUeiParameters, TProcessId& aProcessId);
    73 
    75 
    74 /**
    76 /**
    75  * Stops Java application.
    77  * Stops Java application.
    76  * @param[in] aApplicationUid application uid
    78  * @param[in] aApplicationUid application uid
    77  * @capability PowerMgmt
    79  * @capability PowerMgmt