Confirmed users
313
edits
Auto-tools/Projects/SUTAgent/CommandReference: Difference between revisions
Auto-tools/Projects/SUTAgent/CommandReference (view source)
Revision as of 12:21, 3 January 2014
, 3 January 2014→Optional Commands
| (6 intermediate revisions by 2 users not shown) | |||
| Line 1: | Line 1: | ||
{{note|The agent was originally written for windows mobile and newlines there are \r\n references in code that interacts with the agent. When the Android agent was introduced, we needed to support the code and it would have been a lot of work to retrofit the windows agent, so we made the android agent support \r\n. This is known to be seen in the 'cat' command which is used in some sut_tools scripts. Just keep this in mind as we might have some backwards compatibility issues.}} | |||
== Required Commands == | == Required Commands == | ||
| 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> ''deprecated'' | |||
: 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. | |||
== | == Unsupported Commands == | ||
The original Java SUTAgent implemented these commands. They will be | 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> | ||