Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
43 changes: 40 additions & 3 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,9 +9,14 @@ to the target application.

The key features of `urunit` are:

- Parsing and grouping multi-word arguments from Linux kernel boot parameters
- Launching and waiting for the target application until it terminates
- Reaping all zombie processes
- Parsing and grouping multi-word arguments from Linux kernel boot parameters.
- Launching and waiting for the target application until it terminates.
- Reaping all zombie processes.
- Setting the default route to eth0, if `URUNIT_DEFROUTE` environment variable
is set.
- Reading and setting the environment variables for an application from a file.
- Reading and setting the execution environment configuration for a process from a file.
- Reading and mounting attached block devices defined in the configuration file.

## Building

Expand Down Expand Up @@ -57,6 +62,38 @@ urunit echo `hello world`

will result in `echo` receiving a single argument: `hello world`.

### Urunit configuration file

In order to configure the execution environment for an application, `urunit`
accepts a specific configuration file. The configuration file can contain the
following information:

- The list of the environment variables to set for the application
- The configuration for the process execution environment.
- The list of mounts of block devices. Each block device is defined by its
serial id and it will get mounted in the defined mountpoint.

The file can be specified to `urunit` setting the `URUNIT_CONFIG`
environment variable with the path to the configuration file.

The supported format of the configuration file is the following:

```
UES
/* list of environment variables */
UEE
UCS
UID: <uid_for_the_application>
GID: <gid_for_the_application>
WD: <working_directory>
UCE
UBS
ID: <serial_id>
MP: <mountpoint>
...
UBE
```

## Installation

Using one of the following methods, we can install `urunit` either in a
Expand Down
Loading
Loading