3.1 Command-Line Syntax

The assembler command line may contain options and file names. Options may appear in any order and may be before, after or between file names. The order of file names determines the order of assembly.

xc32-as [options|sourcefiles]...

--’ (two hyphens) by itself names the standard input file explicitly as one of the files for the assembler to translate. Except for ‘--’, any command line argument that begins with a hyphen (‘-’) is an option. Each option changes the behavior of the assembler, but no option changes the way another option works.

Some options require exactly one file name to follow them. The file name may either immediately follow the option’s letter or it may be the next command line argument. For example, to specify an output file named test.o, either of the following options would be acceptable:

  • -o test.o
  • -otest.o
    Note: Command line options are case sensitive.