spidey01 / android-linux-chroot-scripts Goto Github PK

This is a set of scripts designed for using a Linux chroot on Android.

## ROAD MAP ##

install.sh
: installs a Linux chroot on your Android device. See INSTALL file.

linuxchroot.sh
: chroot's you 

etc/init.android/rc.enter
: Base system script ran when entering the chroot.

usr/local/etc/init.android/rc.enter
: Local system script ran when entering the chroot.

etc/init.android/rc.leave
: Base system script ran when leaving the chroot.

usr/local/etc/init.android/rc.leave
: Local system script ran when leaving the chroot.

etc/init.android/rc.conf
: Base system configuration file.

usr/local/etc/init.android/rc.conf
: Local system configuration, overrides anything in etc/init.android/rc.conf.

## INIT SYSTEM ##

The init system is simple, look at the end of linuxchroot.sh!

- Scripts with filenames matching E* will be run on order before entering the chroot.
- Scripts with filenames matching L* will be run in order when the chrooted shell exits and returns control back to linuxchroot.sh.

Place scripts for your local system in ${LINUX_CHROOT}/usr/local/etc/init.android.

If it applies to just about every Android device: place it in ${LINUX_CHROOT}/etc/init.android, commit it, push to GitHub, and send me a pull request explaining the changes.


The execution order is as follows:

	linuxchroot.sh ->
		etc/init.android/rc.enter ->
			etc/init.android/E*
		usr/local/etc/init.android/rc.enter ->
			usr/local/etc/init.android/E*
		chroot $LINUX_CHROOT /bin/login -f root ->
			Your initial shell.
		etc/init.android/rc.leave ->
			etc/init.android/L*
		usr/local/etc/init.android/rc.leave ->
			usr/local/etc/init.android/L*


These scripts are executed after changing directory to the LINUX_CHROOT, but not within it.