5.24.1. Enabling and Using the Tool

By default, the error reporting tool is disabled. You can enable it by inheriting the report-error class by adding the following statement to the end of your local.conf file in your Build Directory.

     INHERIT += "report-error"
                

By default, the error reporting feature stores information in ${LOG_DIR}/error-report. However, you can specify a directory to use by adding the following to your local.conf file:

     ERR_REPORT_DIR = "path"
                

Enabling error reporting causes the build process to collect the errors and store them in a file as previously described. When the build system encounters an error, it includes a command as part of the console output. You can run the command to send the error file to the server. For example, the following command sends the errors to an upstream server:

     send-error-report /home/brandusa/project/poky/build/tmp/log/error-report/error_report_201403141617.txt [server]
                

In the above example, the server parameter is optional. By default, the errors are sent to a database used by the entire community. If you specify a particular server, you can send them to a different database.

When sending the error file, you receive a link that corresponds to your entry in the database. For example, here is a typical link:

     http://localhost:8000/Errors/Search/1/158
                

Following the link takes you to a web interface where you can browse, query the errors, and view statistics.