Chapter 26. Debugging a Recipe

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.

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".


The kind of messages given can be changed with the MESSAGE 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.

namedisplay message for
errorerrors (Aap cannot continue)
warningwarnings (things that are wrong but Aap can still continue)
notenotes (warnings about things that are probably OK)
dependdependencies, the reasoning about what to build
infogeneral info (file copy/delete, up/downloads)
extraextra info (why something was done)
systemsystem (shell) commands that are executed
resultthe result of system (shell) commands
changedirchanging directories

The command line arguments "-v" and "-s" can be used to make the most often used selections:

Aap argument$MESSAGE value

Other values can be assigned at the command line. For example, to only see error and dependency messages:

        aap MESSAGE=error,depend  (other arguments)

Don't forget that excluding "error" means that no error messages are displayed!

No matter what messages are displayed, all messages are written in the log file. This can be used afterwards to see what actually happened.