NAME

DESCRIPTION

makeppinfo option file ...

mppi option file ...

Makepp writes detailed information about the files it built and about their dependencies. This information is stored in the .makepp subdirectory along the file it pertains to. It has the form of key-value pairs. In some cases the value will again be a list of associated pairs, typically the signature and the file.

If both "ENV_DEPS" and "ENV_VALS" get displayed, they are merged into a two column table.

If both "DEP_SIGS" and "SORTED_DEPS" get displayed, they are merged into a two column table (in this order which gives a better layout). Each dependency has a "SIGNATURE" which is only "timestamp,size", used only to check if the file must be rescanned. The interesting information is stored in some other key, for the built in signatures as follows:

• "C_MD5_SUM" for "C" or "c_compilation_md5"
• "MD5_SUM" for "md5"
• "SHARED_OBJECT" for "shared_object"
• "V_MD5_SUM" for "verilog_synthesis_md5"
• "XML_MD5_SUM" for "xml"
• "XML_SPACE_MD5_SUM" for "xml_space"

These signature lists are the most frequent reason for rebuilding a file, so you might like to check, whether the signature stored for a dependency matches the current build_signature of that file. If the signatures and everything else matches, that is the basis for getting a file from (one of) your repositories or build cache if it is found there. The details depend on the applicable build check method.

You will encounter two kinds of signatures: simple ones consist of two comma separated numbers, which are the timestamp in file system format (seconds since 1970) and the size. For some files makepp will additionally have the relevant smart signature which is a base64 encoded (letters, digits, slash and plus) MD5 sum of the plain or digested file contents.

This command is partially a makepp debug tool. The list of keys varies depending on which scanner, build check and signature was used. To fully understand the output, you may need to look at the source code. That said, there is also some generally interesting information to be gotten.

Valid options are:

-A filename

--args-file=filename

--arguments-file=filename

Read the file and parse it as possibly quoted whitespace- and/or newline-separated options.

-d

--dates

--decode-dates

In the simple signatures prepend the 1st number, the raw date-time, with its human readable form in parentheses.

-f

--force

Display info even when it is invalid because of inexistent or modified file. In this case the key "SIGNATURE" is replaced by "invalidated_SIGNATURE" and the value indicates in parentheses that the file was deleted or what signature the file now has.

-?

-h

--help

Print out a brief summary of the options.

-k list

--keys=list

--keylist=list

The list specifies one or more space separated Shell style patterns (with [xyz], ?, *, {a,bc,def}). Remember to protect these from your Shell by quoting. These are matched against the keys. Each pattern may be preceded with an exclamation mark ("!") or a caret ("^") to exclude the matched keys from those selected before instead of adding them to the selection. If the first pattern starts with an exclamation mark, it operates on all keys.

    --keys='COMMAND CWD'        # How was this built and where (relative to file).
    

If you want only filenames (useful with "-t|--traverse") select an inexistent key like "none".

-q

--quiet

Don't list file and key names. Repeat to also omit warnings.

-t

--traverse

Also output the same information for each file in SORTED_DEPS (recursively if repeated).

-V

--version

Print out the version number.

EXAMPLES

    makeppinfo --keys='CWD SORTED_DEPS' obj/b.o
    mppi -k'CWD SORTED_DEPS' obj/b.o
    obj/b.o:
    CWD=../src
    SORTED_DEPS=
        b.c
        inc/b.h
        /usr/bin/gcc

    makeppinfo --traverse somefile
    mppi -t somefile

    makeppinfo --traverse --traverse --keys='CWD COMMAND' somefile
    mppi -ttk'CWD SORTED_DEPS' somefile

    makeppinfo --keys='CWD COMMAND' `makeppinfo --traverse --traverse --keys=none somefile|tr -d :|sort`
    mppi -k'CWD SORTED_DEPS' `mppi -ttknone somefile|tr -d :|sort`

ENVIRONMENT

$MAKEPPINFOFLAGS

Any flags in this environment variable are interpreted as command line options before any explicit options. Quotes are interpreted like in makefiles.

AUTHOR