Project

General

Profile

GettingLogs » History » Revision 2

Revision 1 (Paul Kocialkowski, 09/06/2012 03:45 PM) → Revision 2/15 (Paul Kocialkowski, 09/06/2012 03:45 PM)

h1. Getting Logs 

 When some component misbehaves or stops working on Replicant, it is recommended to: 
 # Get logs showing the issue 
 # Open a ticket on our tracker to report the issue (*New issue* tab) 

 h2. Obtaining logs 

 h3. 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. 

 There are various ways to obtain logs: 

 h3. Using adb 

 Start by installing adb: 
 * Using the (i386) prebuilt binary from the [[ReplicantImages|latest [[ReplicantImages latest image]]. It is located in the *tools/* directory, from the *Base URL*. Download it and make sure it's executable (with @chmod a+x adb@). 
 * Building your own, with the sources from: @git://git.paulk.fr/adb-autotools.git@ 

 Now use adb like: 
 <pre> 
 adb logcat -b [BUFFER] 
 </pre> 
 Save the output to a file and attach it to the new issue report.  

 h3. 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.