slog2info

Updated: April 19, 2023

Display messages from the system log

Syntax:

slog2info [-acfinSstvWw] [-b bset1,bset2,...] [-d path]
          [-e code1,code2,...] [-l filename] [-r [resetfilename]]

Runs on:

QNX Neutrino

Options:

-a
Highlight logs with ANSI terminal color-codes. Logs of different severity levels are shown with different text/background colors for readability. This might not be formatted correctly on all terminals and emulators.
-b bset1,bset2,...
Parse only the logs of the given buffer set names. You can also specify this as:
-b bset1 -b bset2 -b ...
-c
Clear the live slog2 buffers. You can use this option with -b to clear specific buffer sets.
-d path
(QNX Neutrino 7.0 or later) Specify the directory that contains slogger2 buffer sets. This is only for static snapshots.
-f
(QNX Neutrino 7.0 or later) Format the timestamp as epoch_seconds.milliseconds.
-e code1,code2,...
Parse only the logs that match one of the specified event code numbers.
-i
Display information about a buffer set specified by the -l option.
-l filename
(“el”) The buffer set file to parse. This lets you select a PID-specific buffer set. The filename argument must be the full path of a file under /dev/shmem/slogger2/.
-n
Discard newline ('\n') characters from logs. Display each line in a multiline log as a separate log line in the output.
-r [resetfilename]
Display logs preserved through the most recent reset. Optionally specify a reset file to display logs from another reset.
-S
Show the severity level for each log line as one of: SLOG2_SHUTDOWN, SLOG2_CRITICAL, SLOG2_ERROR, SLOG2_WARNING, SLOG2_NOTICE, SLOG2_INFO, SLOG2_DEBUG1, SLOG2_DEBUG2.
-s
Show the numeric severity level for each log line, where 0 corresponds to SLOG2_SHUTDOWN, and 7 corresponds to SLOG2_DEBUG2.
-t
Display the thread ID.
-v
(QNX Neutrino 7.0 or later) Parse buffers that were registered with the series of SLOG2_HINT_SKIP_BUFFER_* flags for slog2_register().
-W, -w
Wait mode; listen for new prints. Press CtrlC to stop. The -w option prints all available older logs and then starts live streaming; -W ignores all older logs and starts live streaming from the current moment.

Description:

The slog2info utility displays the contents of the system log buffer managed by slogger2, which must be running to record these messages.

If you don't specify any options, slog2info displays all the logs.

Examples:

Dump all logs for a live system:

slog2info

Dump the logs only from a given buffer_set file:

slog2info -l /dev/shmem/slogger2/my_test_buff.86749364

Dump the logs from all buffer_sets with a matching name:

slog2info -b my_test_buff

Dump all logs from the latest reset:

slog2info -r

Dump the logs from all buffer_sets with a matching name from the latest reset:

slog2info -r -b my_test_buff

Dump information pertaining to a given buffer set file:

slog2info -i -l /dev/shmem/slogger2/my_test_buff.86749364

Dump all logs from a live system, and then wait:

slog2info -w