6. Usage

Build tools listed below can be used individually or through a Ferrocene project. File formats are documented in User Manual - File Formats.

6.1. Cleaning the Build Space

In order to prevent the use of out-of-date compilation results, users shall ensure that the build space (object and library directories) is empty before compiling.

If a compilation was performed using rustc directly, then the user shall delete any previous compilation artifacts, as follows:

  • exec - Executables, where exec is the name of an executable.

  • libname.a - Native static libraries, where name is the name of a library.

  • libname.rlib - Rust static libraries, where name is the name of a library.

  • libname.rmeta - Rust metadata file, where name is the name of a library.

  • libname.so - Native dynamic libraries, where name is the name of a library.

6.2. Warnings and Errors

The user shall pass command line option -D warnings to the Ferrocene rustc in order to treat warnings as errors. The user shall not employ command line options -A and -W as those options lower the severity of errors.

6.3. Building a Library

Refer to the User Manual - Building a library.

6.4. Building an Executable

Refer to the User Manual - Building an executable.

6.5. Building Mixed-language Programs

Refer to the User Manual - Building mixed-language programs.

6.6. Performing System Calls

Refer to the User Manual - Performing system calls.