Auto-tools/Projects/SUTAgent/CommandReference: Difference between revisions

(→‎Required Commands: settime command)
 
(4 intermediate revisions by one other user not shown)
Line 7: Line 7:
; cd <dir>
; cd <dir>
: Change the current working directory to <dir>. <dir> can be absolute or relative to the cwd.
: Change the current working directory to <dir>. <dir> can be absolute or relative to the cwd.
; clok : Print system time in milliseconds.
; clok : Print system time in milliseconds since Jan 1, 1970, in UTC.
; cwd
; cwd
: Print the current working directory.
: Print the current working directory.
Line 54: Line 54:
; rmdr <dir>
; rmdr <dir>
: Removes <dir> and all contents (i.e. recursive delete).
: Removes <dir> and all contents (i.e. recursive delete).
; settime <datetime>
; settime <datetime> ''deprecated''
: Sets the system time to <datetime>, which should be in the form "yyyy/mm/dd HH:MM:SS".
: Sets the system time to <datetime> in local time, which should be in the form "yyyy/mm/dd HH:MM:SS".  Note that this command should be avoided, since (a) it may not be clear what timezone the device is in and (b) ambiguity of datetimes in the DST-ST boundary range (times from 01:00:00 to 01:59:59 on the day that DST switches to ST are repeated, once for each time zone).  Use setutime instead.
; setutime <milliseconds>
: Sets the system time to <milliseconds>, which should be a number of milliseconds since Jan 1, 1970, in UTC.
; testroot
; testroot
: Prints the root test directory, that is, a writable location to be used for test support files.
: Prints the root test directory, that is, a writable location to be used for test support files.
; ver
: Prints the product name and version, e.g. SUTAgentAndroid Version 1.13 or SUTAgentNegatus Version 1.1.


== Optional Commands ==
== Optional Commands ==
; kill <name>
: Kill all processes running on the system that match <name>. In the Java implementation, if the process name contains <name> it will be killed (e.g. "kill fire" will kill all firefox processes.) In Negatus, a full match is required.


== Deprecated Commands ==
== Unsupported Commands ==


The original Java SUTAgent implemented these commands. They will be deprecated in the new SUTAgent. Instead, SUTAgent-specific DeviceManager objects will build this functionality out of lower-level commands like 'exec' and 'push'.
The original Java SUTAgent implemented these commands. They will '''not''' be implemented in the new SUTAgent. Instead, SUTAgent-specific DeviceManager objects will build this functionality out of lower-level commands like 'exec' and 'push'.


; inst <path to package file>
; inst <path to package file>
Confirmed users
313

edits