Reporting Bugs

All bugs should be reported by email to [email protected].

We endeavour to keep RSAS as bug-free as possible, so please report any bugs you find.

Collecting Core Dumps

If you've found a crash, collecting a core dump file can help us pinpoint the cause. You'll need to enable core dumps on your Linux system by following these instructions:

1) Edit /etc/security/limits.conf, and add these lines:

root       hard        core        unlimited
root       soft        core        unlimited

2) Enable core dumps by running:

sysctl -w kernel.core_pattern=/var/crash/core.%u.%e.%p

If you want to keep core dumps enabled, even after a reboot, add this line to /etc/sysctl.conf:

kernel.core_pattern=/var/crash/core.%u.%e.%p

Verify that the setting stayed with:

cat /proc/sys/kernel/core_pattern

3) To enable core dumps for apps running from the command-line in your current shell session:

ulimit -S -c unlimited

4) If you're running RSAS as a systemd service, you'll need to make some additional changes. Edit /etc/systemd/system/rsas.service and add this line to the [Service] section:

LimitCORE=unlimited

And then run:

systemctl daemon-reload
systemctl daemon-reexec

The next time any application crashes, a core file will be created in /var/crash/ corresponding to the crash.

If you've found a crash, please send us a core dump at [email protected]. and we'd be happy to debug it.

Note that core dumps contain a copy of the application's memory when it crashed and may include sensitive information like stream passwords. They should only be shared with trusted parties and not posted publicly on the internet.