Skip to content

Commit 64556e5

Browse files
committed
updated the readme to provide documentation
1 parent 36c16e8 commit 64556e5

File tree

1 file changed

+20
-0
lines changed

1 file changed

+20
-0
lines changed

README.md

Lines changed: 20 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,20 @@
1+
This is a set of scripts to automate the building and testing of a Linux kernel for the 2012 Wi-Fi Nexus 7, also known as grouper. Currently it will create a build environment, download and build the kernel sources, and boot said kernel on the Nexus. Ideally these scripts will work on any linux system, although so far it's only compatible with x86 and x86_64. It requires git, fastboot, and abootimg to be installed on your system.
2+
3+
Many commands require superuser, this is mostly because of the chroot environment it creates to build the kernel in.
4+
5+
Configuration can be accomplished by editing the `configuration` file. Syntax for the file is basically bash syntax as it's really just a script that gets sourced by the main script. Hopefully I've commented it well enough that one can figure out what all the variables do.
6+
7+
Useage:
8+
`sudo ./builder.sh <command>`
9+
10+
Commands:
11+
* `clean` cleans everything out, so you can start fresh. It does leave the kernel and ramdisk targets alone though.
12+
* `mount` mounts `procfs`, `sysfs`, etc for the chroot environment
13+
* `unmount` unmounts `procfs`, `sysfs`, etc for the chroot environment
14+
* `setup` creates the chroot environment and installs all necessary packages for the cross build into the chroot
15+
* `update` updates the packages in the chroot to current versions
16+
* `kernel <command>` commands that deal with the kernel as follows:
17+
* `get` download the kernel source code
18+
* `update` update the kernel source tree to the most current version
19+
* `build` create the kernel from the source code
20+
* `boot` boot the newly built kernel on the Nexus to try it out. Your nexus needs to be in fastboot/bootloader mode and plugged into your computer for this to work.

0 commit comments

Comments
 (0)