README.android
1 MobiCore Daemon in Android
2 ---
3
4 Command line
5 --
6 The MobiCore Daemon supports 4 command line options. It also displays them with the help option:
7
8 # ./mcDriverDaemon -h
9 usage: ./mcDriverDaemon [-mdsbh]
10 Start 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
23 Makes 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
29 Loads 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
39 If 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
45 Custom registry locations
46 --
47 Registry fallback
48
49 In case of a Device wipe in Android the /data/app/mcRegistry folder will be deleted with all it's contents. To overcome
50 this the daemon supports a fallback location(eg /system/app/mcRegistry): it first tries to load the trustlet
51 from /data/app/mcRegistry/[uuid].tlbin and if it fails then it tries to read the trustlet from /system/app/mcRegistry/[uuid].tlb
52
53 Both paths are completely configurable for the Daemon using 2 environment variables:MC_REGISTRY_PATH and MC_REGISTRY_FALLBACK_PATH
54
55 For 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
61 Custom authtoken path
62 --
63
64 The authtoken file is created at provisioning and is by default located in /data/app/mcRegistry/00000.authtoken
65
66 Because a device wipe could delete this file and make MobiCore unusable a new environment variable has been added to change the
67 default behaviour: MC_AUTH_TOKEN_PATH
68
69 $ export MC_AUTH_TOKEN_PATH=/efs
70 $ /data/app/mcDriverDaemon
71
72 This would change the location of the authtoken file to /efs
73