Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/balena-os/kernel-module-build

Example project for building an OOT kernel module in balena
https://github.com/balena-os/kernel-module-build

balena

Last synced: about 1 month ago
JSON representation

Example project for building an OOT kernel module in balena

Awesome Lists containing this project

README

        

# Kernel Module Builder

Provides an example of a multi-container application with a service that builds
an out-of-tree kernel module, loads it and runs it alongside an example service.

* The `load` service builds the kernel module source located in `module/src`
using module headers provided for balena devices using a multi-stage build
and then loads the kernel module.

* The `check` service runs a simple entry script that checks for the output of
the example module and depends on the `load` service above.

## Usage

This project is prepared to build in the balenaCloud builders. To use it
as is [install](https://github.com/balena-io/balena-cli/blob/master/INSTALL.md) the balenaCLI and build with:

```
balena push
```

The device type will be automatically retrieved from the specified fleet.

## Customization

* Replace the `OS_VERSION` argument in the `load` service in the
`docker-compose.yml` file to match the balenaOS version of the target device.

* Replace the contents of the `module/src` directory with the module source to
build.

* Replace the `check` service by your own service.