Skip to content

Commit

Permalink
fixup! add go as depedency for default build target (webg)
Browse files Browse the repository at this point in the history
  • Loading branch information
peppergrayxyz committed Oct 9, 2024
1 parent c684ff5 commit 8970938
Show file tree
Hide file tree
Showing 2 changed files with 83 additions and 3 deletions.
20 changes: 17 additions & 3 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -71,6 +71,7 @@ brew install x86_64-elf-binutils
brew tap nanovms/homebrew-qemu
brew install nanovms/homebrew-qemu/qemu
```
(note: ```go``` is only needed for certain [examples](#examples), but not for building the kernel)

For ARM-based Macs (M1/M2):

Expand Down Expand Up @@ -109,12 +110,12 @@ Note: This is only recommended for those that wish to make code changes to Nanos

Nanos doesn't need too many dependencies on Linux.

To build you need to install nasm, qemu and go (If you don't want to install go, choose a different target, see below):
To build you need to install nasm, qemu and go:

```
sudo apt-get install qemu-system-x86 nasm golang-go
```

(note: ```go``` is only needed for certain [examples](#examples), but not for building the kernel)

For tests you'll also need the following installed:

Expand Down Expand Up @@ -143,7 +144,11 @@ sudo apt-get install libfuse-dev fuse
make kernel
```

#### To run an example program from the test/runtime folder:
#### Examples


To run an example program from the test/runtime folder:

With hardware acceleration:

```
Expand All @@ -155,6 +160,15 @@ Without hardware acceleration:
make run-noaccel
```

Set ```TARGET``` to run a specific example:
```
make TARGET=<example> run
```

Checkout [test/runtime](test/runtime/README.md) for a list of examples. Certain examples requiere ```go``` to be built.

More examples can be found in [docs/examples#examples](https://docs.ops.city/ops/examples#examples).

### Documentation

You can find more documentation on the ops [docs site](https://nanovms.gitbook.io/ops/)
Expand Down
66 changes: 66 additions & 0 deletions test/runtime/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,66 @@
# Examples

Set ```TARGET``` to run a specific example:
```
make TARGET=<example> run
```

Certain examples requiere ```go``` to be built.

More examples can be found in [docs/examples#examples](https://docs.opsity/ops/examples#examples).

Example | Stack | Description
-|-|-
aio | c |
aslr | c |
creat | c |
dup | c |
epoll | c |
eventfd | c |
fadvise | c |
fallocate | c |
fcntl | c |
fst | go |
fs_full | c |
ftrace | c |
futex | c |
futexrobust | c |
getdents | c |
getrandom | c |
hw | c | hello world (dynamic linking)
hws | c | hello world (static linking)
hwg | go | hello world
inotify | c |
io_uring | c |
ktest | c |
mkdir | c |
mmap | c |
netlink | c |
netsock | c |
nullpage | c |
paging | c |
pipe | c |
readv | c |
rename | c |
sandbox | c |
sendfile | c |
shmem | c |
signal | c |
sigoverflow | c |
socketpair | c |
symlink | c |
syslog | c |
thread_test | c |
time | c |
tlbshootdown | c |
tun | c |
udploop | c |
umcg | c |
unixsocket | c |
unlink | c |
vsyscall | c |
web | c | webserver on localhost:8080 (dynamic linking)
webs | c | webserver on localhost:8080 (static linking)
webg | go | webserver on localhost:8080
write | c |
writev | c |

0 comments on commit 8970938

Please sign in to comment.