docs and licence
[android-debian.git] / README
1 Introduction
2 ------------
3
4 These scripts are intended to ease the process of bootstrapping a Debian
5 chroot on an Android device. Instructions for installing such a chroot
6 may be found at:
7
8 http://www.steven-mcdonald.id.au/tutorials/debian_on_samsung_galaxy.shtml
9
10
11 Overview
12 --------
13
14 These scripts come in pairs; the ones under android/ are to be executed
15 in an Android environment, and the ones under debian/ get executed in a
16 chroot by the Android scripts.
17
18 These scripts are ready to roll if:
19
20 - your Debian chroot lives in /debian,
21 - you place the scripts under android/ in /data/local/bin/, and
22 - you place the scripts under debian/ in /debian/usr/local/sbin/.
23
24 If this is not the case, then you will need to modify these scripts to
25 work for you.
26
27
28 Starting Debian services at boot time
29 -------------------------------------
30
31 In order to run the debian-init script at boot time, you can add the
32 following to /system/etc/init.local.rc:
33
34 service debian /data/local/bin/debian-init
35     user root
36     group root
37
38 For some reason, Android's init won't start Debian if supplied with the
39 'oneshot' option, so do not use that.