.\" 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] <input file>
.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>                                    \- Directory of include files
.HP
\fB\-M\fR <string>                                       \- Disassembler options
.HP
\fB\-\-arch=\fR<string>                                   \- 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<value>                 \- Choose DWARF debug sections compression:
.TP
=none
\-   No compression
.TP
=zlib
\-   Use zlib compression
.HP
\fB\-\-defsym=\fR<string>                                 \- Defines a symbol to be an integer constant
.HP
\fB\-\-fdebug\-compilation\-dir=\fR<string>                 \- 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<value>                                \- 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<string>                         \- 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<a1,+a2,\-a3,...>                          \- Target specific attributes (\fB\-mattr\fR=\fI\,help\/\fR for details)
.HP
\fB\-\-mcpu=\fR<cpu\-name>                                 \- 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 <filename>                                     \- Output filename
.HP
\fB\-\-output\-asm\-variant=\fR<uint>                       \- 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<filename>                     \- DWO output filename
.HP
\fB\-\-triple=\fR<string>                                 \- Target triple to assemble for, see \fB\-version\fR for available targets