gokrazy / serial-busybox

A bundled statically compiled standalone busybox binary, for debugging on the serial port

Overview

With gokrazy, you can deploy your Go programs as appliances to a Raspberry Pi or PC (→ supported platforms).

For a long time, we were unhappy with having to care about security issues and Linux distribution maintenance on our various Raspberry Pis.

Then, we had a crazy idea: what if we got rid of memory-unsafe languages and all software we don’t strictly need?

Turns out this is feasible. gokrazy is the result.

→ Learn more at gokrazy.org

GitHub Repository structure

• github.com/gokrazy/gokrazy: system code, main issue tracker, documentation
• github.com/gokrazy/tools: SD card image creation code, pulling in:
  • github.com/gokrazy/firmware: Raspberry Pi 3 or 4 firmware files
  • github.com/gokrazy/rpi-eeprom: Raspberry Pi 4 EEPROM files
  • github.com/gokrazy/kernel: pre-built kernel image and bootloader config

Documentation

gokrazy.org uses hugo for creating and generating the website. You can find the hugo install instructions here: Install Hugo. With hugo you can write documentation in Markdown and generate a static website from it.

The website subdirectory is hugo’s root directory. In order to preview the documentation or to re-generate the website, switch the directory to website.

To preview the website, run the hugo webserver:

hugo serve

Generate the website:

hugo

The updated website content will be stored in the ./docs directory. Do not update anything here manually.

serial-busybox's Issues

Include busybox for amd64 arch

For using with qemu etc.

Fix DNS resolution by linking against uclibc to avoid glibc’s NSS system

When I run strace -fvy /perm/sh -c 'nslookup google.ch' on gokrazy, I see:

[…]
[pid 14917] openat(AT_FDCWD, "/etc/nsswitch.conf", O_RDONLY|O_CLOEXEC) = -1 ENOENT (No such file or directory)
[pid 14917] openat(AT_FDCWD, "/etc/ld.so.cache", O_RDONLY|O_CLOEXEC) = -1 ENOENT (No such file or directory)
[pid 14917] openat(AT_FDCWD, "/lib/x86_64-linux-gnu/tls//x86_64/libnss_dns.so.2", O_RDONLY|O_CLOEXEC) = -1 ENOENT (No such file or directory)
[pid 14917] stat("/lib/x86_64-linux-gnu/tls//x86_64", 0x7ffedfbaf910) = -1 ENOENT (No such file or directory)
[pid 14917] openat(AT_FDCWD, "/lib/x86_64-linux-gnu/tls//libnss_dns.so.2", O_RDONLY|O_CLOEXEC) = -1 ENOENT (No such file or directory)
[pid 14917] stat("/lib/x86_64-linux-gnu/tls/", 0x7ffedfbaf910) = -1 ENOENT (No such file or directory)
[pid 14917] openat(AT_FDCWD, "/lib/x86_64-linux-gnu/tls/x86_64/libnss_dns.so.2", O_RDONLY|O_CLOEXEC) = -1 ENOENT (No such file or directory)
[pid 14917] stat("/lib/x86_64-linux-gnu/tls/x86_64", 0x7ffedfbaf910) = -1 ENOENT (No such file or directory)
[pid 14917] openat(AT_FDCWD, "/lib/x86_64-linux-gnu/tls/libnss_dns.so.2", O_RDONLY|O_CLOEXEC) = -1 ENOENT (No such file or directory)
[pid 14917] stat("/lib/x86_64-linux-gnu/tls", 0x7ffedfbaf910) = -1 ENOENT (No such file or directory)
[pid 14917] openat(AT_FDCWD, "/lib/x86_64-linux-gnu//x86_64/libnss_dns.so.2", O_RDONLY|O_CLOEXEC) = -1 ENOENT (No such file or directory)
[pid 14917] stat("/lib/x86_64-linux-gnu//x86_64", 0x7ffedfbaf910) = -1 ENOENT (No such file or directory)
[pid 14917] openat(AT_FDCWD, "/lib/x86_64-linux-gnu//libnss_dns.so.2", O_RDONLY|O_CLOEXEC) = -1 ENOENT (No such file or directory)
[pid 14917] stat("/lib/x86_64-linux-gnu/", 0x7ffedfbaf910) = -1 ENOENT (No such file or directory)
[pid 14917] openat(AT_FDCWD, "/lib/x86_64-linux-gnu/x86_64/libnss_dns.so.2", O_RDONLY|O_CLOEXEC) = -1 ENOENT (No such file or directory)
[pid 14917] stat("/lib/x86_64-linux-gnu/x86_64", 0x7ffedfbaf910) = -1 ENOENT (No such file or directory)
[pid 14917] openat(AT_FDCWD, "/lib/x86_64-linux-gnu/libnss_dns.so.2", O_RDONLY|O_CLOEXEC) = -1 ENOENT (No such file or directory)
[pid 14917] stat("/lib/x86_64-linux-gnu", 0x7ffedfbaf910) = -1 ENOENT (No such file or directory)
[…]
[pid 14917] openat(AT_FDCWD, "/usr/lib//libnss_files.so.2", O_RDONLY|O_CLOEXEC) = -1 ENOENT (No such file or directory)
[pid 14917] openat(AT_FDCWD, "/usr/lib/libnss_files.so.2", O_RDONLY|O_CLOEXEC) = -1 ENOENT (No such file or directory)
[pid 14917] write(1</dev/pts/1>, "Address 1: 10.22.0.1\n", 21Address 1: 10.22.0.1
) = 21
[pid 14917] write(1</dev/pts/1>, "\n", 1
) = 1
[pid 14917] stat("/etc/resolv.conf", {st_dev=makedev(0, 17), st_ino=706, st_mode=S_IFREG|0644, st_nlink=1, st_uid=0, st_gid=0, st_blksize=4096, st_blocks=8, st_size=21, st_atime=1654503033 /* 2022-06-06T10:10:33.205858008+0200 */, st_atime_nsec=205858008, st_mtime=1654502973 /* 2022-06-06T10:09:33.204860481+0200 */, st_mtime_nsec=204860481, st_ctime=1654502973 /* 2022-06-06T10:09:33.205860481+0200 */, st_ctime_nsec=205860481}) = 0
[pid 14917] write(2</dev/pts/1>, "nslookup: can't resolve 'google."..., 36nslookup: can't resolve 'google.ch'
) = 36
[pid 14917] exit_group(1)               = ?
[pid 14917] +++ exited with 1 +++

busybox applets such as nslookup just call getaddrinfo(), so one fix for this issue is to switch from glibc to uclibc.