Blame - docs/CommandGuide/gccas.html - platform/external/llvm

blob: 67a270c968c30d3e4122294063a8d453a251cc36 [file] [log] [blame]

John Criswell	ecf32e5	2003-09-11 19:58:03 +0000	[diff] [blame]	1	<html>
Chris Lattner	537a02c	2003-10-07 20:01:09 +0000	[diff] [blame]	2	<title>LLVM: gccas tool</title>
John Criswell	ecf32e5	2003-09-11 19:58:03 +0000	[diff] [blame]	3
Chris Lattner	08a04fd	2003-10-07 20:12:05 +0000	[diff] [blame]	4	<body bgcolor=white>
John Criswell	ecf32e5	2003-09-11 19:58:03 +0000	[diff] [blame]	5
				6	<center>
Chris Lattner	537a02c	2003-10-07 20:01:09 +0000	[diff] [blame]	7	<h1>LLVM: <tt>gccas</tt> tool</h1>
John Criswell	ecf32e5	2003-09-11 19:58:03 +0000	[diff] [blame]	8	</center>
				9	<HR>
				10
Chris Lattner	537a02c	2003-10-07 20:01:09 +0000	[diff] [blame]	11	<h3>NAME</h3>
				12	<tt>gccas</tt>
John Criswell	ecf32e5	2003-09-11 19:58:03 +0000	[diff] [blame]	13
Chris Lattner	537a02c	2003-10-07 20:01:09 +0000	[diff] [blame]	14	<h3>SYNOPSIS</h3>
				15	<tt>gccas [options] < filename></tt>
John Criswell	ecf32e5	2003-09-11 19:58:03 +0000	[diff] [blame]	16
Chris Lattner	537a02c	2003-10-07 20:01:09 +0000	[diff] [blame]	17	<h3>DESCRIPTION</h3>
John Criswell	ecf32e5	2003-09-11 19:58:03 +0000	[diff] [blame]	18
Chris Lattner	537a02c	2003-10-07 20:01:09 +0000	[diff] [blame]	19	The <tt>gccas</tt> utility takes an LLVM assembly file generated by the <a
				20	href="llvmgcc.html">C</a> or <a href="llvmgxx.html">C++</a> frontends and
				21	converts it into an LLVM bytecode file. It is primarily used by the GCC front
				22	end, and as such, attempts to mimic the interface provided by the default system
				23	assembler so that it can act as a "drop-in" replacement.<p>
John Criswell	ecf32e5	2003-09-11 19:58:03 +0000	[diff] [blame]	24
Chris Lattner	537a02c	2003-10-07 20:01:09 +0000	[diff] [blame]	25	<tt>gccas</tt> performs a number of optimizations on the input program.<p>
John Criswell	ecf32e5	2003-09-11 19:58:03 +0000	[diff] [blame]	26
				27	<h3>
				28	OPTIONS
				29	</h3>
				30
				31	<ul>
				32	<li> -help
				33	<br>
				34	Print a summary of command line options.
				35	<p>
				36
				37	<li> -o <filename>
				38	<br>
				39	Specify the output filename which will hold the assembled bytecode.
				40	<p>
				41
John Criswell	3beefec	2003-10-16 20:05:48 +0000	[diff] [blame]	42	<li>-disable-inlining
				43	<br>
				44	Disable the inlining pass. By default, it is enabled.
				45	<p>
				46
John Criswell	8417142	2004-03-12 22:45:35 +0000	[diff] [blame]	47	<li> -disable-opt
				48	<br>
				49	Disable all assemble-time optimization passes.
				50	<p>
				51
				52	<li>-enable-correct-eh-support
				53	<br>
				54	Instruct the -lowerinvoke pass to insert code for correct exception handling
				55	support. This is expensive and is by default omitted for efficiency.
				56	<p>
				57
John Criswell	ecf32e5	2003-09-11 19:58:03 +0000	[diff] [blame]	58	<li> -stats
				59	<br>
				60	Print statistics.
				61	<p>
				62
				63	<li> -time-passes
				64	<br>
				65	Record the amount of time needed for each pass and print it to standard
				66	error.
				67	<p>
				68
				69	<li> -verify
				70	<br>
				71	Verify each pass result.
				72	<p>
				73	</ul>
				74
				75	<h3>
				76	EXIT STATUS
				77	</h3>
				78
Chris Lattner	537a02c	2003-10-07 20:01:09 +0000	[diff] [blame]	79	If <tt>gccas</tt> succeeds, it will exit with 0. Otherwise, if an error occurs,
				80	it will exit with a non-zero value.
John Criswell	ecf32e5	2003-09-11 19:58:03 +0000	[diff] [blame]	81
Chris Lattner	537a02c	2003-10-07 20:01:09 +0000	[diff] [blame]	82	<h3>SEE ALSO</h3>
				83	<a href="llvm-as.html"><tt>llvm-as</tt></a>
				84	<a href="gccld.html"><tt>gccld</tt></a>
John Criswell	ecf32e5	2003-09-11 19:58:03 +0000	[diff] [blame]	85
				86	<HR>
Chris Lattner	08a04fd	2003-10-07 20:12:05 +0000	[diff] [blame]	87	Maintained by the <a href="http://llvm.cs.uiuc.edu">LLVM Team</a>.
John Criswell	ecf32e5	2003-09-11 19:58:03 +0000	[diff] [blame]	88	</body>
				89	</html>
				90