Skip to content

Commit 09c3e4c

Browse files
mogasergiuunikraft-bot
authored andcommitted
README.md: Update the way we build the application
Signed-off-by: Sergiu Moga <sergiu.moga@protonmail.com> Reviewed-by: Gabriel Mocanu <gabi.mocanu98@gmail.com> Approved-by: Razvan Deaconescu <razvan.deaconescu@cs.pub.ro> Tested-by: Unikraft CI <monkey@unikraft.io> GitHub-Pull-Request: unikraft#3
1 parent fb343bf commit 09c3e4c

File tree

1 file changed

+43
-4
lines changed

1 file changed

+43
-4
lines changed

README.md

+43-4
Original file line numberDiff line numberDiff line change
@@ -1,10 +1,49 @@
11
# Unikraft "hello world" Application
22

3-
To build and run this application please use the `kraft` script:
3+
This application prints a basic "Hello World!" message.
44

5-
pip3 install git+https://github.com/unikraft/kraft.git
6-
mkdir my-first-unikernel && cd my-first-unikernel
7-
kraft up -p PLATFORM -m ARCHITECTURE helloworld
5+
To configure, build and run the application you need to have [kraft](https://github.com/unikraft/kraft) installed.
6+
7+
To be able to run it, configure the application to run on the desired platform and architecture:
8+
```
9+
$ kraft configure -p PLATFORM -m ARCH
10+
```
11+
12+
Build the application:
13+
```
14+
$ kraft build
15+
```
16+
17+
And, finally, run the application:
18+
```
19+
$ kraft run
20+
Hello World!
21+
```
22+
23+
If you want to have more control you can also configure, build and run the application manually.
24+
25+
To configure it with the desired features:
26+
```
27+
$ make menuconfig
28+
```
29+
30+
Build the application:
31+
```
32+
$ make
33+
```
34+
35+
Run the application:
36+
- If you built the application for `kvm`:
37+
```
38+
sudo qemu-system-x86_64 -kernel "build/app-helloworld_kvm-x86_64" \
39+
-enable-kvm \
40+
-nographic
41+
```
42+
43+
- If you built the application for `linuxu`:
44+
```
45+
./build/app-helloworld_linuxu-x86_64
46+
```
847

948
For more information about `kraft` type ```kraft -h``` or read the
1049
[documentation](http://docs.unikraft.org).

0 commit comments

Comments
 (0)