Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add Troubleshooting section to README #25

Open
wants to merge 1 commit into
base: master
Choose a base branch
from
Open

Add Troubleshooting section to README #25

Changes from all commits
Commits
Show all changes
1 commit
Select commit
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
35 changes: 35 additions & 0 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -64,3 +64,38 @@ point.
```
At this point you should be able to follow the same instructions as described
in https://www.yoctoproject.org/docs/current/yocto-project-qs/yocto-project-qs.html#releases.

Troubleshooting
---------------

### runqemu - ERROR - TUN control device /dev/net/tun is unavailable; you may need to enable TUN (e.g. sudo modprobe tun)

Add the `slirp` argument to your `runqemu` call to use usermode networking instead of TUN. Example:

runqemu qemux86 slirp

### runqemu - ERROR - Failed to run qemu: Could not initialize SDL(No available video device) - exiting

Add the `nographic` argument to your `runqemu` call to avoid using SDL. The text output will go to your console. Example:

runqemu qemux86 nographic

### Accessing core-image-sato GUI via VNC

Since this image has a graphical interface, when SDL is unavailable an alternative to accessing its GUI is via a VNC client. Informing the argument `publicvnc` to `runqemu` will make QEMU setup a VNC server at port 5900.

runqemu qemux86 slirp publicvnc

But to get to the container's internal port 5900, you must map it to an available host port, for example 20000. Add the `-p` option when starting your container:

docker run --rm -it -v myvolume:/workdir -p 20000:5900 crops/poky --workdir=/workdir

After running `runqemu`, point your VNC client to `127.0.0.1:20000`.

> Mac users: You must download a third party VNC client. The builtin client available in Finder (Command-K) does not connect to the local host.

### Access running QEMU image via SSH

If your image has an active SSH server, before connecting to it you must map container's port 22 to an available host port, such as 2222. Note that when using the `slirp` argument to `runqemu`, an internal redirect from 2222 to 22 is already in place. In this case you must map the container's 2222 port, not 22. Example:

docker run --rm -it -v myvolume:/workdir -p 2222:2222 crops/poky --workdir=/workdir