---
name: "llvm-as-3.1"
section: "1"
platform: "linux"
package: "llvm-3.1"
version: "3.1-1"
release: "Debian 7 (Wheezy)"
platforms: ["linux"]
url: "https://new.carta.tech/llvm-as-3.1"
---

# llvm-as-3.1(1)

LLVM assembler

## NAME

llvm-as - LLVM assembler

## SYNOPSIS

**llvm-as** \[*options*\] \[*filename*\]

## DESCRIPTION

**llvm-as** is the LLVM assembler.  It reads a file containing human-readable LLVM assembly language, translates it to LLVM bitcode, and writes the result into a file or to standard output.

If *filename* is omitted or is `"-"`, then **llvm-as** reads its input from standard input.

If an output file is not specified with the **-o** option, then **llvm-as** sends its output to a file or standard output by following these rules:

- •

  If the input is standard input, then the output is standard output.

- •

  If the input is a file that ends with `".ll"`, then the output file is of the same name, except that the suffix is changed to `".bc"`.

- •

  If the input is a file that does not end with the `".ll"` suffix, then the output file has the same name as the input file, except that the `".bc"` suffix is appended.

## OPTIONS

- **-f**

  Enable binary output on terminals.  Normally, **llvm-as** will refuse to write raw bitcode output if the output stream is a terminal. With this option, **llvm-as** will write raw bitcode regardless of the output device.

- **-help**

  Print a summary of command line options.

- **-o** *filename*

  Specify the output file name.  If *filename* is `"-"`, then **llvm-as** sends its output to standard output.

## EXIT STATUS

If **llvm-as** succeeds, it will exit with 0.  Otherwise, if an error occurs, it will exit with a non-zero value.

## SEE ALSO

llvm-dis, gccas

## AUTHORS

Maintained by the LLVM Team (\<http://llvm.org/\>).