Initial import of the muenevents Linux kernel module
[muen/linux/muenevents.git] / README.md
1 # Muenevents
2
3 ## Introduction
4
5 The *muenevents* Linux kernel module implements a virtual file system that
6 facilitates user-space access to source events (subject-specific hypercalls)
7 provided by the [Muen Separation Kernel][1].
8
9 For each source event a file with the corresponding logical name is shown in
10 the file system. A program can *write(2)* to the files to trigger an event.
11 Using *read(2)* to access the file returns the source event number.
12
13 ## Usage
14
15     $ modprobe muenevents
16     $ mkdir -p /muenevents
17     $ mount -t muenevents none /muenevents
18
19 ## Authentication
20
21 The current authentication model is that the files are created with uid and gid
22 set to 0 and permissions 0600. No further capability checking is done by this
23 module.
24
25 [1]: https://muen.sk