blob: 1e117c41ea3c0001605e28954b2537eafe955513 [file] [log] [blame]
Jungtae Kim7b143ed2012-09-21 23:23:57 +09001MobiCore Daemon in Android
2---
3
4Command line
5--
6The MobiCore Daemon supports 4 command line options. It also displays them with the help option:
7
8# ./mcDriverDaemon -h
9usage: ./mcDriverDaemon [-mdsbh]
10Start MobiCore Daemon
11
12-h show this help
13-b fork to background
14-m IMAGE load mobicore from IMAGE to DDR
15-s disable daemon scheduler(default enabled)
16-d SIZE donate SIZE bytes to mobicore(disabled on most platforms)
17-r DRIVER load dyamic driver
18
19-b Forks the daemon to background
20
21# ./mcDriverDaemon -b
22
23Makes the daemon run in background and returns immediate control to the shell. No need to use shell forking with &
24
25-m Loads a mobicore image to DDR
26
27# ./mcDriverDaemon -m /data/app/mobicore.img
28
29Loads the mobicore.img to DDR and starts executing it.
30
31-s Disables NQ IRQ scheduler
32
33# ./mcDriverDaemon -s
34
35-d Sets how much RAM is donated to Mobicore in bytes
36
37# ./mcDriverDaemon -d 1048576
38
39If no -d is specified then the daemon donates 1Mb. The Value 0 disables RAM donation.
40
41-r Loads dynamic driver at startup. The full path of the driver binary must be given, eg. /data/app/driver.drbin
42
43# ./mcDriverDaemon -r /data/app/driver.drbin
44
45Custom registry locations
46--
47Registry fallback
48
49In case of a Device wipe in Android the /data/app/mcRegistry folder will be deleted with all it's contents. To overcome
50this the daemon supports a fallback location(eg /system/app/mcRegistry): it first tries to load the trustlet
51from /data/app/mcRegistry/[uuid].tlbin and if it fails then it tries to read the trustlet from /system/app/mcRegistry/[uuid].tlb
52
53Both paths are completely configurable for the Daemon using 2 environment variables:MC_REGISTRY_PATH and MC_REGISTRY_FALLBACK_PATH
54
55For example if you want to use /data/app/mcRegistry as the default path and /system/app/mcRegistry as the fallback path:
56
57$ export MC_REGISTRY_PATH=/data/app/mcRegistry
58$ export MC_REGISTRY_FALLBACK_PATH=/system/app/mcRegistry
59$ /data/app/mcDriverDaemon
60
61Custom authtoken path
62--
63
64The authtoken file is created at provisioning and is by default located in /data/app/mcRegistry/00000.authtoken
65
66Because a device wipe could delete this file and make MobiCore unusable a new environment variable has been added to change the
67default behaviour: MC_AUTH_TOKEN_PATH
68
69$ export MC_AUTH_TOKEN_PATH=/efs
70$ /data/app/mcDriverDaemon
71
72This would change the location of the authtoken file to /efs