debugd/docs/log_entries.md

# Log Entries

This document describes what the log entries mean. Each entry has a matching
section. Please add a section here for new entries and some brief description of
what it means and how to parse it.

## CLIENT_ID

## DEVICETYPE

## LOGDATE

## amd_pmc_idlemask

Value of the SMU idlemask

## amd_s0ix_stats

Contains the time when the system last entered/exited S0ix and how long it
remained in that state.

## amd_smu_fw_info

Contains additional timing information about the last S0ix suspend including
how long it took to enter and exit that state.

## amd_stb

Base64 encoded contents of the smart trace buffer, contains timestamped POST
codes and logs from various other systems. Requires an AMD specific tool to
decode.

## amdgpu_gem_info

## amdgpu_gtt_mm

## amdgpu_vram_mm

## android_app_storage

## arcvm_console_output

## atmel_tp_deltas

## atmel_tp_refs

## atmel_ts_deltas

## atmel_ts_refs

## atrus_logs

## audit_log

Recent events in audit.log as generated by [auditd(8)].
Only includes audit events of type=SYSCALL and type=AVC (SELinux denials).

## auth_failure

Contains which TPM commands are used and its response when the command failed.

## authpolicy

## bio_crypto_init.LATEST

## bio_crypto_init.PREVIOUS

## bio_fw_updater.LATEST

## bio_fw_updater.PREVIOUS

## biod.LATEST

## biod.PREVIOUS

## bios_info

## bios_log

Log entries stored in console section of coreboot memory region. Contains logs
from things such as coreboot and depthcarge before Linux kernel starts.

## bios_stacked_times

Same as bios_times, but in flame graph compatible stacked format and with enum
names instead of human-readable descriptions.

## bios_times

This entry contains timestamps of events saved by BIOS and its components.
Timestamps are in human-readable form with description and value.

## blkid

## bluetooth.log

This file records the debuggable logs generated by Bluetooth daemons
($syslogseverity < '7'), including logs from bluetoothd, btmanagerd, and
btadapterd.

## bootstat_summary

## borealis_crosvm.log

Logs from the Borealis VM's output (kernel logs to serial, in-VM services).

## borealis_frames

Frame timings from apps running in the Borealis VM. 16 KiB.

## borealis_frames_summary

Summarization of borealis frame timings. 2 KiB.

## borealis_proton_crash_reports

Contains the most recent Proton crash dump containing debug info. ~11 KiB.

## borealis_rootfs_reports

Contains MD5 digests for paths in the Borealis read-only rootfs.
This report may inform if the Borealis rootfs has become corrupted. ~44 KiB.

## borealis_steam_compat_logs

Contains versions of Steam compatibility tools used per game in the last 5 min.
Only one line (less than 100 chars) printed per game.

## borealis_xwindump

If the Borealis VM is running, displays a list of all Borealis windows and
each window's title, size, and other X properties, as seen by the X server.
Expected size is ~20 KiB.

## bt_usb_disconnects

## buddyinfo

Various virtual memory fragmentation details.  See the `/proc/buddyinfo` section
of the [proc(5)] man page for an explanation of each field.

## cbi_info

## cheets_log

## chrome_system_log

## chrome_system_log.PREVIOUS

## chromeos-pgmem

## clobber-state.log

## clobber.log

## console-ramoops

Contains logs from Linux kernel from previous boot, in pstore [ramoops
logger](https://www.kernel.org/doc/html/latest/admin-guide/ramoops.html).

## cpuinfo

Various CPU & system architecture details.  Often shows exact CPU models and
supported hardware flags, as well as how many CPUs and cores that are available.
See the `/proc/cpuinfo` section of the [proc(5)] man page for more details.

## cr50_version

## cros_ec.log

## cros_ec.previous

## cros_ec_panicinfo

## cros_ec_pdinfo

## cros_fp.log

## cros_fp.previous

## cros_fp_panicinfo

[FPMCU] [Panic Data] in human readable form.

## cros_ish.log

## cros_ish.previous

## cros_scp.log

## cros_scp.previous

## cros_tp console

## cros_tp frame

## cros_tp version

## crosid

The output of `crosid -v`, which can be used to understand/debug why a
device matched a certain config identity (or, why a device didn't
match one).

## crostini

## crostini_crosvm.log

Logs from the Termina VM's output (kernel logs to serial, in-VM services).

## display-debug

Logs collected from the 'display_debug' crosh tool, such as annotated drm_trace
logs and snapshots of the output of 'modetest'. The drm_trace logs are as
described below, but with additional categories enabled. See
http://go/cros-displaydebug for more details.

## dmesg

Linux kernel logs from the current run. See [console-ramoops](#console_ramoops)
for previous boot.

## drm_gem_objects

## drm_state

## drm_trace

Logs collected from the kernel's drm module. A subset of
[drm_debug_category messages](https://01.org/linuxgraphics/gfx-docs/drm/gpu/drm-internals.html#c.drm_debug_category)
are enabled and the tail of their output is collected here.

## drm_trace_legacy

Same as above, but for older kernel versions using a legacy drm_trace
implementation.

## ec_info

## edid-decode

## eventlog

## folder_size_dump

The folder_size_dump helper dumps the actual disk usage (in bytes) of various
system folders by calling
`du --human-readable --total --summarize --one-file-system`.
The list of folders and filtering can be found in `folder_size_dump.cc`. Each
entry calls du individually with a sorted list of subfolders.

The output of the `df` command is available separately for comparison.

0 sized entries are filtered out to reduce the size of the report, this does not
provide a complete folder contents listing.

## font_info

## framebuffer

## fwupd_log

Logs printed from [fwupd] daemon execution.

## fwupd_state

Current state of the system as reported by [fwupd] daemon.

## fwupd_version

The [fwupd] client and daemon versions.

## hammerd

## hardware_class

## hardware_verification_report

## hostname

## hypervisor.log

The kernel log from the ManaTEE hypervisor.

## i915_error_state

## i915_gem_gtt

## i915_gem_objects

## ifconfig

## input_devices

## interrupts

Per-CPU interrupt statistics.  See the `/proc/interrupts` section of the
[proc(5)] man page for an explanation of each field.

## iw_list

## kbmcu_info

Information about an MCU controlling an RGB keyboard, including FW version.

## kbmcu_log

Console output of an MCU controlling an RGB keyboard.

## kernel-crashes

## logcat

## lpstat

Information about connected printer and scanner devices produced by `lpstat -l
-r -v -a -p -o`. Produces ~22 lines of output for each device.

## lsblk

## lsmod

## lspci

## lsusb

## lvs

Information about LVM logical volumes.

## mali_memory

## memd clips

## memd.parameters

## meminfo

Various memory usage statistics.  See the `/proc/meminfo` section of the
[proc(5)] man page for an explanation of each field.

## mm-esim-status

## mm-status

## modetest

## mount-encrypted

## mountinfo

File system mount information from the init process's mount namespace. See
https://www.kernel.org/doc/html/latest/filesystems/sharedsubtree.html for what
it means.

## netlog

## netstat

## network-devices

## network-services

## nvmap_iovmm

## oemdata

## pagetypeinfo

## pchg_info

## platform_identity_customization_id

## platform_identity_model

## platform_identity_name

## platform_identity_sku

## platform_identity_whitelabel_tag

## power_supply_info

## power_supply_sysfs

## powerd.LATEST

## powerd.PREVIOUS

## powerd.out

## powerwash_count

## ps

## pvs

Information about LVM physical volumes.

## qcom_fw_info

## secagentd

This file records the debuggable logs generated by the secagentd daemon.

## sensor_info

## slabinfo

Kernel memory allocator/cache statistics.  See the [slabinfo(5)] man page for an
explanation of each field.

## stateful_trim_data

## stateful_trim_state

## storage_info

## swap_info

## syslog

## system_log_stats

## threads

## tlsdate

## top memory

## top thread

## touch_fw_version

## tpm-firmware-updater

## tpm_version

## typec_connector_class

Information about the state of USB Type-C ports, partners and cables from the
USB Type-C connector class.

## typecd

## ui_log

## uname

Short summary of the current system information from the [uname(1)] command.
It will include the [Linux kernel](https://www.kernel.org/) version (including
the git commit), when the kernel was compiled, and some details for the system's
CPU.

## update_engine.log

## upstart

## uptime

The current system [uptime(1)] in seconds, including time spent in suspend.
In other words, how long since the system was booted.

## usb4 devices

## user_folder_size_dump

Dumps the size of all folders inside the primary user's folder and the size of
all daemon stores for all mounted users.

## verified boot

## vmlog.1.LATEST

## vmlog.1.PREVIOUS

## vmlog.LATEST

## vmlog.PREVIOUS

## vmstat

Various virtual memory statistics.  See the `/proc/vmstat` section of the
[proc(5)] man page for an explanation of each field.

## vpd_2.0

## wakeup_sources

Wakeup sources are devices capable of waking the system from a suspend. Contains
various stats about each wakeup source. See `struct wakeup_source` in
`include/linux/pm_wakeup.h` in the kernel for a description of fields in this
file.

Useful for debugging suspend issues.

## wifi_status_no_anonymize

## zram block device stat names

## zram block device stat values

block I/O statistics for zram, space-delimited, documented at
https://www.kernel.org/doc/html/latest/block/stat.html

Useful to know how many I/O happened and how much time was spent using zram
swap.

## zram new stats names

## zram new stats values

Memory management related statistics for zram from /sys/block/zram0/, Documented
at https://www.kernel.org/doc/html/latest/admin-guide/blockdev/zram.html#stats

Useful to know how much memory is being stored compressed in zram.

[auditd(8)]: https://man7.org/linux/man-pages/man8/auditd.8.html
[FPMCU]: https://chromium.googlesource.com/chromiumos/platform/ec/+/HEAD/docs/fingerprint/fingerprint.md
[fwupd]: https://github.com/fwupd/fwupd
[Panic Data]: https://chromium.googlesource.com/chromiumos/platform/ec/+/HEAD/README.md#Panicinfo
[proc(5)]: https://man7.org/linux/man-pages/man5/proc.5.html
[slabinfo(5)]: https://man7.org/linux/man-pages/man5/slabinfo.5.html
[uname(1)]: https://man7.org/linux/man-pages/man1/uname.1.html
[uptime(1)]: https://man7.org/linux/man-pages/man1/uptime.1.html