Getting logs¶

When some component misbehaves or stops working on Replicant, it is recommended to:

1. Get logs showing the issue
2. Open a ticket on our tracker to report the issue (New issue tab)

Buffers¶

The Android logging subsystem uses different log buffers: events, main, radio and system.
Generally speaking, when the issue you encountered concerned telephony, including data (3G), the buffer you want is radio. In any other case, that's the main buffer you want.

In some cases, the information provided by the Android log buffers is not sufficient and the message buffer of the Linux kernel is additionally required for investigating the issue.

There are various ways to obtain the logs:

Using ADB¶

First, you need to install ADB.

Retrieving a buffer from the Android logging subsystem¶

Display a buffer from the Android logging subsystem:

adb logcat -b [BUFFER]

To prepare a new issue report, you need to save the output to a file:

adb logcat -b [BUFFER] -d > path/to/file

Attach the file to the issue report.

Retrieving the kernel message buffer¶

Display the kernel message buffer:

adb shell dmesg

To prepare a new issue report, you need to save the output to a file:

adb shell dmesg > path/to/file

Attach the file to the issue report.

Using aLogcat¶

aLogcat is a (free) Android app that will collect logs and save them to a file, either regularly or when you press the Save button from the app menu.
You can set the desired buffer from the Preferences.

After saving the log, you can get it from a file stored in the alogcat folder on the root of storage.