1llvm-as - LLVM assembler
2========================
3
4SYNOPSIS
5--------
6
7**llvm-as** [*options*] [*filename*]
8
9DESCRIPTION
10-----------
11
12**llvm-as** is the LLVM assembler.  It reads a file containing human-readable
13LLVM assembly language, translates it to LLVM bitcode, and writes the result
14into a file or to standard output.
15
16If *filename* is omitted or is ``-``, then **llvm-as** reads its input from
17standard input.
18
19If an output file is not specified with the **-o** option, then
20**llvm-as** sends its output to a file or standard output by following
21these rules:
22
23* If the input is standard input, then the output is standard output.
24
25* If the input is a file that ends with ``.ll``, then the output file is of the
26  same name, except that the suffix is changed to ``.bc``.
27
28* If the input is a file that does not end with the ``.ll`` suffix, then the
29  output file has the same name as the input file, except that the ``.bc``
30  suffix is appended.
31
32OPTIONS
33-------
34
35**-f**
36 Enable binary output on terminals.  Normally, **llvm-as** will refuse to
37 write raw bitcode output if the output stream is a terminal. With this option,
38 **llvm-as** will write raw bitcode regardless of the output device.
39
40**-help**
41 Print a summary of command line options.
42
43**-o** *filename*
44 Specify the output file name.  If *filename* is ``-``, then **llvm-as**
45 sends its output to standard output.
46
47EXIT STATUS
48-----------
49
50If **llvm-as** succeeds, it will exit with 0.  Otherwise, if an error occurs, it
51will exit with a non-zero value.
52
53SEE ALSO
54--------
55
56llvm-dis|llvm-dis, gccas|gccas
57