readme: add initial doc
This commit is contained in:
45
README.md
Normal file
45
README.md
Normal file
@@ -0,0 +1,45 @@
|
|||||||
|
`postmarketos-mkinitfs` is a tool for generating an initramfs (and installing
|
||||||
|
it) on postmarketOS.
|
||||||
|
|
||||||
|
## Building
|
||||||
|
|
||||||
|
Building this project requires a Go compiler/toolchain and `make`:
|
||||||
|
|
||||||
|
```
|
||||||
|
$ make
|
||||||
|
```
|
||||||
|
|
||||||
|
To install locally:
|
||||||
|
|
||||||
|
```
|
||||||
|
$ make install
|
||||||
|
```
|
||||||
|
|
||||||
|
Installation prefix can be set in the generally accepted way with setting
|
||||||
|
`PREFIX`:
|
||||||
|
|
||||||
|
```
|
||||||
|
$ make PREFIX=/some/location
|
||||||
|
# make PREFIX=/some/location install
|
||||||
|
```
|
||||||
|
|
||||||
|
Other paths can be modified from the command line as well, see the top section of
|
||||||
|
the `Makefile` for more information.
|
||||||
|
|
||||||
|
Tests (functional and linting) can be executed by using the `test` make target:
|
||||||
|
|
||||||
|
```
|
||||||
|
$ make test
|
||||||
|
```
|
||||||
|
|
||||||
|
## Usage
|
||||||
|
|
||||||
|
The application uses configuration from `/etc/deviceinfo`, and does not support
|
||||||
|
any other options at runtime. It can be run simply by executing:
|
||||||
|
|
||||||
|
```
|
||||||
|
$ postmarketos-mkinitfs
|
||||||
|
```
|
||||||
|
|
||||||
|
For historical reasons, a symlink from `mkinitfs` to `postmarketos-mkinitfs` is
|
||||||
|
also installed by the makefile's `install` target.
|
Reference in New Issue
Block a user