Legato comes with a command line tool to set logging variables for Legato components. Executed commands are translated and sent to the Legato log daemon, which forwards it to the correct destination. The Log Control Daemon uses filters to log needed messages, and discards unnecessary messages.

The general format of log commands is:

$ log command commandParameter in destination

Here are some command samples:

$ log level INFO in "processName/componentName"

Set the log level to INFO for a component in a process.

$ log trace "keyword" in "processName/componentName"

Enable a trace.

$ log stoptrace "keyword" in "processName/componentName"

Disable a trace.

All can use "*" in place of processName and componentName for all processes and/or all components. If the "processName/componentName" is omitted, the default destination is set for all processes and all components. In the samples, the 'in' is optional.

The translated command to send to the log daemon has this format:

   | cmd | destination | commandParameter |

where cmd is a command code, one byte long. destination is the processName/componentName followed by a '/' character. commandParameter is the string specific to the command.

Copyright (C) Sierra Wireless, Inc. 2014. Use of this work is subject to license.