Anbox kernel modules
Go to file
Alexandru Pirvulescu ee4c25f064 fix creation of all 3 anbox modules symlinks: anbox-binder anbox-hwbinder anbox-vndbinder 2024-05-26 20:10:21 +02:00
ashmem Fix for kernel 6.7+ 2024-01-13 21:57:08 +01:00
binder Fixes for kernel 6.8 2024-02-10 08:49:38 +01:00
debian updated doc to update changelog from git commits 2024-04-02 06:50:21 +02:00
scripts Update Travis configuration 2019-07-04 19:02:11 +09:00
.gitignore Update binder to the latest version 2021-09-26 18:54:51 +02:00
.travis.yml travis: Add kernel v5.4 2020-01-01 20:29:30 +01:00
99-anbox.rules fix creation of all 3 anbox modules symlinks: anbox-binder anbox-hwbinder anbox-vndbinder 2024-05-26 20:10:21 +02:00
INSTALL.sh feat: add script that automates install steps 2020-03-04 10:23:32 +01:00
README.md updated doc to update changelog from git commits 2024-04-02 06:50:21 +02:00
UNINSTALL.sh Create UNINSTALL.sh script and update README.md 2023-02-25 09:00:20 +01:00
anbox.conf Import kernel module source from original Anbox repository 2018-06-08 17:20:21 +02:00

README.md

Build Status

Anbox Kernel Modules

This repository contains the kernel modules necessary to run the Anbox Android container runtime. They're split out of the original Anbox repository to make packaging in various Linux distributions easier.

Install Instruction

You need to have dkms and linux-headers on your system. You can install them by sudo apt install dkms or sudo yum install dkms (dkms is available in epel repo for CentOS).

Package name for linux-headers varies on different distributions, e.g. linux-headers-generic (Ubuntu), linux-headers-amd64 (Debian), kernel-devel (CentOS, Fedora), kernel-default-devel (openSUSE).

You can either run ./INSTALL.sh script to automate the installation steps or follow them manually below:

  • First install the configuration files:

     sudo cp anbox.conf /etc/modules-load.d/
     sudo cp 99-anbox.rules /lib/udev/rules.d/
    
  • Then copy the module sources to /usr/src/:

     sudo cp -rT ashmem /usr/src/anbox-ashmem-1
     sudo cp -rT binder /usr/src/anbox-binder-1
    
  • Finally use dkms to build and install:

     sudo dkms install anbox-ashmem/1
     sudo dkms install anbox-binder/1
    

You can verify by loading these modules and checking the created devices:

 sudo modprobe ashmem_linux
 sudo modprobe binder_linux
 lsmod | grep -e ashmem_linux -e binder_linux
 ls -alh /dev/binder /dev/ashmem

You are expected to see output like:

binder_linux          114688  0
ashmem_linux           16384  0
crw-rw-rw- 1 root root  10, 55 Jun 19 16:30 /dev/ashmem
crw-rw-rw- 1 root root 511,  0 Jun 19 16:30 /dev/binder

Uninstall Instructions

ou can either run ./UNINSTALL.sh script to automate the installation steps or follow them manually below:

  • First use dkms to remove the modules:

     sudo dkms remove anbox-ashmem/1
     sudo dkms remove anbox-binder/1
    
  • Then remove the module sources from /usr/src/:

     sudo rm -rf /usr/src/anbox-ashmem-1
     sudo rm -rf /usr/src/anbox-binder-1
    
  • Finally remove the configuration files:

     sudo rm -f /etc/modules-load.d/anbox.conf
     sudo rm -f /lib/udev/rules.d/99-anbox.rules 
    

You must then restart your device. You can then verify modules were removed by trying to load the modules and checking the created devices:

 sudo modprobe ashmem_linux
 sudo modprobe binder_linux
 lsmod | grep -e ashmem_linux -e binder_linux
 ls -alh /dev/binder /dev/ashmem

You are expected to see output like:

modprobe: FATAL: Module ashmem_linux not found in directory /lib/modules/6.0.2-76060002-generic
modprobe: FATAL: Module binder_linux not found in directory /lib/modules/6.0.2-76060002-generic
ls: cannot access '/dev/binder': No such file or directory
ls: cannot access '/dev/ashmem': No such file or directory

Packaging:

Debian/Ubuntu:

sudo apt-get install devscripts dh-dkms -y 
git log --pretty=" -%an<%ae>:%aI - %s" > ./debian/changelog
debuild -i -us -uc -b 
ls -lrt ../anbox-modules-dkms_*.deb