<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>Chapter 26. Debugging a Recipe</title><meta name="generator" content="DocBook XSL Stylesheets V1.71.1"><link rel="start" href="index.html" title="A-A-P Recipe Executive"><link rel="up" href="user.html" title="Part II. User Manual"><link rel="prev" href="user-package.html" title="Chapter 25. Automatic Package Install"><link rel="next" href="user-makedif.html" title="Chapter 27. Differences from make"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><table width="100%" id="navtable"><tbody><tr><td align="left" class="left" width="33%"><b><a href="http://www.a-a-p.org">A-A-P home page</a></b></td><td align="center" class="center" width="34%"><b><a href="index.html">A-A-P Recipe Executive</a></b></td><td align="right" class="right" width="33%"></td></tr><tr><td align="left" class="left"><a accesskey="p" href="user-package.html">Prev</a></td><td align="center" class="center">User Manual</td><td align="right" class="right"><a accesskey="n" href="user-makedif.html">Next</a></td></tr></tbody></table><hr><div class="chapter" lang="en"><div class="titlepage"><div><div><h2 class="title"><a name="user-debug"></a>Chapter 26. Debugging a Recipe</h2></div></div></div><p> The log file shows what happened while A-A-P was executing. Often you can figure out what went wrong by looking at the messages. </p><p> The log file is named "AAPDIR/log". It is located in the directory of the main recipe. If you executed aap again and now want to see the previous log, it is named "AAPDIR/log1". Older logs are "AAPDIR/log2", "AAPDIR/log3", etc. This goes up to "AAPDIR/log9". </p><h2><a name="id2658352"></a>Messages</h2><p> The kind of messages given can be changed with the <a href="ref-variables.html#var-message">MESSAGE</a> variable. It is a comma separated list of message types for which the message is displayed. Other messages are still written in the log file. </p><div class="informaltable"><table border="0"><colgroup><col width="150"><col></colgroup><thead><tr><th>name</th><th>display message for</th></tr></thead><tbody><tr><td>all</td><td>everything</td></tr><tr><td>error</td><td>errors (<span class="application">Aap</span> cannot continue)</td></tr><tr><td>warning</td><td>warnings (things that are wrong but <span class="application">Aap</span> can still continue)</td></tr><tr><td>note</td><td>notes (warnings about things that are probably OK)</td></tr><tr><td>depend</td><td>dependencies, the reasoning about what to build</td></tr><tr><td>info</td><td>general info (file copy/delete, up/downloads)</td></tr><tr><td>extra</td><td>extra info (why something was done)</td></tr><tr><td>system</td><td>system (shell) commands that are executed</td></tr><tr><td>result</td><td>the result of system (shell) commands</td></tr><tr><td>changedir</td><td>changing directories</td></tr></tbody></table></div><p> </p><p> The command line arguments "-v" and "-s" can be used to make the most often used selections: </p><div class="informaltable"><table border="0"><colgroup><col width="150"><col></colgroup><thead><tr><th><span class="application">Aap</span> argument</th><th>$MESSAGE value</th></tr></thead><tbody><tr><td>(nothing)</td><td>error,warning,system,info</td></tr><tr><td><a href="ref-arguments.html#option-verbose">-v</a></td><td>all</td></tr><tr><td><a href="ref-arguments.html#option-verbose">--verbose</a></td><td>all</td></tr><tr><td><a href="ref-arguments.html#option-silent">-s</a></td><td>error</td></tr><tr><td><a href="ref-arguments.html#option-silent">--silent</a></td><td>error</td></tr></tbody></table></div><p> </p><p> Other values can be assigned at the command line. For example, to only see error and dependency messages: </p><div class="literallayout"><p> aap MESSAGE=error,depend (other arguments)<br> </p></div><p> </p><p> Don't forget that excluding "error" means that no error messages are displayed! </p><p> No matter what messages are displayed, all messages are written in the log file. This can be used afterwards to see what actually happened. </p></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="user-package.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="user.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="user-makedif.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Chapter 25. Automatic Package Install </td><td width="20%" align="center"><a accesskey="h" href="index.html"> Contents</a></td><td width="40%" align="right" valign="top"> Chapter 27. Differences from make</td></tr></table></div></body></html>