.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.49.3.
.TH LLVM-MC "1" "February 2024" "llvm-mc 15" "User Commands"
.SH NAME
llvm-mc \- manual page for llvm-mc 15
.SH DESCRIPTION
OVERVIEW: llvm machine code playground
.PP
USAGE: llvm\-mc [options]
.PP
OPTIONS:
.PP
Color Options:
.HP
\fB\-\-color\fR \- Use colors in output (default=autodetect)
.PP
Generic Options:
.HP
\fB\-\-help\fR \- Display available options (\fB\-\-help\-hidden\fR for more)
.HP
\fB\-\-help\-list\fR \- Display list of available options (\fB\-\-help\-list\-hidden\fR for more)
.HP
\fB\-\-version\fR \- Display the version of this program
.PP
MC Options:
.HP
\fB\-I\fR \- Directory of include files
.HP
\fB\-M\fR \- Disassembler options
.HP
\fB\-\-arch=\fR \- Target arch to assemble for, see \fB\-version\fR for available targets
.IP
Action to perform:
.HP
\fB\-\-as\-lex\fR \- Lex tokens from a .s file
.HP
\fB\-\-assemble\fR \- Assemble a .s file (default)
.HP
\fB\-\-disassemble\fR \- Disassemble strings of hex bytes
.HP
\fB\-\-mdis\fR \- Marked up disassembly of strings of hex bytes
.HP
\fB\-\-compress\-debug\-sections=\fR \- Choose DWARF debug sections compression:
.TP
=none
\- No compression
.TP
=zlib
\- Use zlib compression
.HP
\fB\-\-defsym=\fR \- Defines a symbol to be an integer constant
.HP
\fB\-\-fdebug\-compilation\-dir=\fR \- Specifies the debug info's compilation dir
.HP
\fB\-\-fdebug\-prefix\-map=\fR<= separated key\-value pairs> \- Map file source paths in debug info
.HP
\fB\-\-filetype=\fR \- Choose an output file type:
.TP
=asm
\- Emit an assembly ('.s') file
.TP
=null
\- Don't emit anything (for timing purposes)
.TP
=obj
\- Emit a native object ('.o') file
.HP
\fB\-g\fR \- Generate dwarf debugging info for assembly source files
.HP
\fB\-\-large\-code\-model\fR \- Create cfi directives that assume the code might be more than 2gb away
.HP
\fB\-\-main\-file\-name=\fR \- Specifies the name we should consider the input file
.HP
\fB\-\-masm\-hexfloats\fR \- Enable MASM\-style hex float initializers (3F800000r)
.HP
\fB\-\-masm\-integers\fR \- Enable binary and hex masm integers (0b110 and 0ABCh)
.HP
\fB\-\-mattr=\fR \- Target specific attributes (\fB\-mattr\fR=\fI\,help\/\fR for details)
.HP
\fB\-\-mcpu=\fR \- Target a specific cpu type (\fB\-mcpu\fR=\fI\,help\/\fR for details)
.HP
\fB\-\-motorola\-integers\fR \- Enable binary and hex Motorola integers (%110 and $ABC)
.HP
\fB\-n\fR \- Don't assume assembly file starts in the text section
.HP
\fB\-\-no\-exec\-stack\fR \- File doesn't need an exec stack
.HP
\fB\-o\fR \- Output filename
.HP
\fB\-\-output\-asm\-variant=\fR \- Syntax variant to use for output printing
.HP
\fB\-\-position\-independent\fR \- Position independent
.HP
\fB\-\-preserve\-comments\fR \- Preserve Comments in outputted assembly
.HP
\fB\-\-print\-imm\-hex\fR \- Prefer hex format for immediate values
.HP
\fB\-\-relax\-relocations\fR \- Emit R_X86_64_GOTPCRELX instead of R_X86_64_GOTPCREL
.HP
\fB\-\-save\-temp\-labels\fR \- Don't discard temporary labels
.HP
\fB\-\-show\-encoding\fR \- Show instruction encodings
.HP
\fB\-\-show\-inst\fR \- Show internal instruction representation
.HP
\fB\-\-show\-inst\-operands\fR \- Show instructions operands as parsed
.HP
\fB\-\-split\-dwarf\-file=\fR \- DWO output filename
.HP
\fB\-\-triple=\fR \- Target triple to assemble for, see \fB\-version\fR for available targets