Add some platform notes to the README file

This commit is contained in:
Justine Tunney 2023-11-13 02:26:34 -08:00
parent d1e764b3cf
commit 25a892d6ae
No known key found for this signature in database
GPG key ID: BE714B4575D6E328

View file

@ -196,6 +196,29 @@ You normally run the `.com.dbg` file under gdb. If you need to debug the
gdb foo.com -ex 'add-symbol-file foo.com.dbg 0x401000'
```
## Platform Notes
### Linux
Linux systems with WINE installed might have issues running APE programs
if WINE is registered with `binnfmt_misc`. To work around this, you need
to remove WINE from `binfmt_misc`. You could also disable `binfmt_misc`
entirely.
```
sudo sh -c 'echo 0 > /proc/sys/fs/binfmt_misc/status'
```
### WSL
It's normally unsafe to use APE in a WSL environment, because it tries
to run them as WIN32 binaries within the WSL environment. In order to
make it safe to use Cosmopolitan software on WSL, you have to run:
```sh
sh -c "echo -1 > /proc/sys/fs/binfmt_misc/WSLInterop"
```
## Discord Chatroom
The Cosmopolitan development team collaborates on the Redbean Discord