buzz_toolset

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
buzz_toolset [2016/04/17 00:22] – [CMake Support] ilpincybuzz_toolset [2016/09/03 00:28] (current) ilpincy
Line 11: Line 11:
  
 The fourth tool, called ''bzzdeasm'', produces an annotated assembly file from the bytecode and the debug information. The fourth tool, called ''bzzdeasm'', produces an annotated assembly file from the bytecode and the debug information.
 +
 +==== bzzc ====
 +
 +<code bash>
 +$ bzzc [options] <file.bzz>
 +</code>
 +
 +This command combines ''bzzparse'' and ''bzzasm''. It takes as input a script ''file.bzz'' and produces two files: ''file.bo'' (the bytecode file), and ''file.bdb'' (the debugging information file).
 +
 +''bzzc'' honors ''BUZZ_INCLUDE_PATH'' like ''bzzparse''.
 +
 +In addition, it is possible to specify the path of ''bzzparse'' and ''bzzasm'' with the environment variables ''BZZPARSE'' and ''BZZASM'', respectively. This is usually not necessary, as ''bzzc'' looks for these paths automatically. This feature was added to make seamless support of automated build systems like [[https://cmake.org/|CMake]] possible.
 +
 +The ''bzzc'' command accepts the following options:
 +
 +  * ''-I|%%--%%include path1:path2:...:pathN'': specifies a list of include paths to append to ''BUZZ_INCLUDE_PATH''
 +  * ''-b|%%--%%bytecode file.bo'': specifies an explicit name for the bytecode file
 +  * ''-d|%%--%%debug file.bdb'': specifies an explicit name for the debugging information file
 +  * ''-h|%%--%%help'': shows help on the command line
  
 ==== bzzparse ==== ==== bzzparse ====
Line 33: Line 52:
 This command compiles a Buzz [[buzz_assembler|assembly code]] file ''infile.basm'' and produces two output files. The first, ''outfile.bo'', is the bytecode to be executed by the [[buzz_vm|Buzz Virtual Machine]]. The second, ''outfile.bdb'', is a binary file containing debugging information. This command compiles a Buzz [[buzz_assembler|assembly code]] file ''infile.basm'' and produces two output files. The first, ''outfile.bo'', is the bytecode to be executed by the [[buzz_vm|Buzz Virtual Machine]]. The second, ''outfile.bdb'', is a binary file containing debugging information.
  
-==== bzzc ====+==== bzzdeasm ====
  
 <code bash> <code bash>
-bzzc [options] <file.bzz>+bzzdeasm <infile.bo> <infile.bdb> <outfile.basm>
 </code> </code>
  
-This command combines ''bzzparse'' and ''bzzasm''. It takes as input a script ''file.bzz'' and produces two files: ''file.bo'' (the bytecode file), and ''file.bdb'' (the debugging information file). +This tool takes as input a bytecode file ''infile.bo'' and the corresponding debugging information file ''infile.bdb'', and produces an [[buzz_assembler|assembly code]] file ''outfile.basm''
- +==== bzzrun ====
-''bzzc'' honors ''BUZZ_INCLUDE_PATH'' like ''bzzparse''+
- +
-In additionit is possible to specify the path of ''bzzparse'' and ''bzzasm'' with the environment variables ''BZZPARSE'' and ''BZZASM'', respectively. This is usually not necessary, as ''bzzc'' looks for these paths automatically. This feature was added to make seamless support of automated build systems like [[https://cmake.org/|CMake]] possible. +
- +
-The ''bzzc'' command accepts the following options: +
- +
-  * ''-I|%%--%%include path1:path2:...:pathN'': specifies a list of include paths to append to ''BUZZ_INCLUDE_PATH'' +
-  * ''-b|%%--%%bytecode file.bo'': specifies an explicit name for the bytecode file +
-  * ''-d|%%--%%debug file.bdb'': specifies an explicit name for the debugging information file +
-  * ''-h|%%--%%help'': shows help on the command line +
-==== bzzdeasm ====+
  
 <code bash> <code bash>
-bzzdeasm <infile.bo> <infile.bdbg> <outfile.basm>+bzzrun [--trace] file.bo file.bdb
 </code> </code>
  
-This tool takes as input a bytecode file ''infile.bo'' and the corresponding debugging information file ''infile.bdbg''and produces an [[buzz_assembler|assembly code]] file ''outfile.basm''.+This is simple interpreter that executes the given Buzz bytecode file ''file.bo''Its main purpose is to provide a starting point for projects that [[buzz_c_cpp|integrate Buzz as extension language]]. 
 + 
 +As suchthe [[https://github.com/MISTLab/Buzz/blob/master/src/buzz/buzzrun.c|source code of ''bzzrun'']] is more interesting than what the command actually does. ''bzzrun'' can also be used as a simple interpreter for standalone Buzz scripts that do not use any messaging (e.g., neighbors, groups, virtual stigmergy, etc.).
  
 ==== CMake Support ==== ==== CMake Support ====
  • buzz_toolset.1460852562.txt.gz
  • Last modified: 2016/04/17 00:22
  • by ilpincy