To get assemble info back from Kick Assembler, use the -asminfo option:

java -jar KickAss.jar mysource.asm -asminfo all

When executing the above statement, output is written to the file "asminfo.txt", but you can specify the file by the -asminfofile option:

java -jar KickAss.jar mysource.asm -asminfo all -asminfofile myAsmInfo.txt

The content of the file will have different sections dependent on what info you have requested. The second parameter describes which info is returned, so in the above example all possible info is returned. The output divided into sections, with different types of information, here is an example:

[libraries]
Math;constant;PI
Math;constant;E
Math;function;abs;1
Math;function;acos;1
...
[directives]
.text;.text "hello";Dumps text bytes to memory.
.by;.by $01,$02,$03;An alias for '.byte'.
...
[files]
0;KickAss.jar:/include/autoinclude.asm
1;mySource.asm
[syntax]
symbolReference;38,8,38,17,0
symbolReference;41,20,41,26,0
functionCall;41,8,41,18,0
symbolReference;56,8,56,17,0
...
[errors]
...

The details of the sections will be explained later.

There are two categories of asmInfo: Predefined info, which contains information about the features that is build into the assembler like directives and libraries. The other main category is source specific informations, like the syntax of the source or errors in the source. You can turn on one or several categories or sections:

This will export all predefined assemble info sections:

java -jar KickAss.jar mysource.asm -asminfo allPredefined

And this will export all predefined assemble info sections and any errors:

java -jar KickAss.jar mysource.asm -asminfo allPredefined|errors

Notice the '|' is used to give several selections - you can add as many as you want. This is the available options:

When the category says 'meta' the option is used to select several of the sections. When the category is not 'meta' the option refers to a specific section. The details of the sections is given in later chapters.