[llvm-commits] CVS: llvm-www/releases/1.6/docs/CommandGuide/man/man1/analyze.1 bugpoint.1 extract.1 gccas.1 gccld.1 llc.1 lli.1 llvm-as.1 llvm-bcanalyzer.1 llvm-db.1 llvm-dis.1 llvm-link.1 llvm-nm.1 llvm-prof.1 llvmgcc.1 llvmgxx.1 opt.1 stkrc.1
Chris Lattner
lattner at cs.uiuc.edu
Tue Nov 8 12:07:56 PST 2005
Changes in directory llvm-www/releases/1.6/docs/CommandGuide/man/man1:
analyze.1 added (r1.1)
bugpoint.1 added (r1.1)
extract.1 added (r1.1)
gccas.1 added (r1.1)
gccld.1 added (r1.1)
llc.1 added (r1.1)
lli.1 added (r1.1)
llvm-as.1 added (r1.1)
llvm-bcanalyzer.1 added (r1.1)
llvm-db.1 added (r1.1)
llvm-dis.1 added (r1.1)
llvm-link.1 added (r1.1)
llvm-nm.1 added (r1.1)
llvm-prof.1 added (r1.1)
llvmgcc.1 added (r1.1)
llvmgxx.1 added (r1.1)
opt.1 added (r1.1)
stkrc.1 added (r1.1)
---
Log message:
check in 1.6 docs
---
Diffs of the changes: (+3875 -0)
analyze.1 | 197 ++++++++++++++++++++++++++++++
bugpoint.1 | 349 ++++++++++++++++++++++++++++++++++++++++++++++++++++++
extract.1 | 194 ++++++++++++++++++++++++++++++
gccas.1 | 197 ++++++++++++++++++++++++++++++
gccld.1 | 282 +++++++++++++++++++++++++++++++++++++++++++
llc.1 | 286 ++++++++++++++++++++++++++++++++++++++++++++
lli.1 | 198 ++++++++++++++++++++++++++++++
llvm-as.1 | 199 ++++++++++++++++++++++++++++++
llvm-bcanalyzer.1 | 190 +++++++++++++++++++++++++++++
llvm-db.1 | 151 +++++++++++++++++++++++
llvm-dis.1 | 189 +++++++++++++++++++++++++++++
llvm-link.1 | 196 ++++++++++++++++++++++++++++++
llvm-nm.1 | 229 +++++++++++++++++++++++++++++++++++
llvm-prof.1 | 183 ++++++++++++++++++++++++++++
llvmgcc.1 | 206 +++++++++++++++++++++++++++++++
llvmgxx.1 | 206 +++++++++++++++++++++++++++++++
opt.1 | 216 +++++++++++++++++++++++++++++++++
stkrc.1 | 207 ++++++++++++++++++++++++++++++++
18 files changed, 3875 insertions(+)
Index: llvm-www/releases/1.6/docs/CommandGuide/man/man1/analyze.1
diff -c /dev/null llvm-www/releases/1.6/docs/CommandGuide/man/man1/analyze.1:1.1
*** /dev/null Tue Nov 8 14:07:54 2005
--- llvm-www/releases/1.6/docs/CommandGuide/man/man1/analyze.1 Tue Nov 8 14:07:43 2005
***************
*** 0 ****
--- 1,197 ----
+ .\" Automatically generated by Pod::Man version 1.15
+ .\" Sat Jul 10 01:00:16 2004
+ .\"
+ .\" Standard preamble:
+ .\" ======================================================================
+ .de Sh \" Subsection heading
+ .br
+ .if t .Sp
+ .ne 5
+ .PP
+ \fB\\$1\fR
+ .PP
+ ..
+ .de Sp \" Vertical space (when we can't use .PP)
+ .if t .sp .5v
+ .if n .sp
+ ..
+ .de Ip \" List item
+ .br
+ .ie \\n(.$>=3 .ne \\$3
+ .el .ne 3
+ .IP "\\$1" \\$2
+ ..
+ .de Vb \" Begin verbatim text
+ .ft CW
+ .nf
+ .ne \\$1
+ ..
+ .de Ve \" End verbatim text
+ .ft R
+
+ .fi
+ ..
+ .\" Set up some character translations and predefined strings. \*(-- will
+ .\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
+ .\" double quote, and \*(R" will give a right double quote. | will give a
+ .\" real vertical bar. \*(C+ will give a nicer C++. Capital omega is used
+ .\" to do unbreakable dashes and therefore won't be available. \*(C` and
+ .\" \*(C' expand to `' in nroff, nothing in troff, for use with C<>
+ .tr \(*W-|\(bv\*(Tr
+ .ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
+ .ie n \{\
+ . ds -- \(*W-
+ . ds PI pi
+ . if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
+ . if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch
+ . ds L" ""
+ . ds R" ""
+ . ds C` ""
+ . ds C' ""
+ 'br\}
+ .el\{\
+ . ds -- \|\(em\|
+ . ds PI \(*p
+ . ds L" ``
+ . ds R" ''
+ 'br\}
+ .\"
+ .\" If the F register is turned on, we'll generate index entries on stderr
+ .\" for titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and
+ .\" index entries marked with X<> in POD. Of course, you'll have to process
+ .\" the output yourself in some meaningful fashion.
+ .if \nF \{\
+ . de IX
+ . tm Index:\\$1\t\\n%\t"\\$2"
+ ..
+ . nr % 0
+ . rr F
+ .\}
+ .\"
+ .\" For nroff, turn off justification. Always turn off hyphenation; it
+ .\" makes way too many mistakes in technical documents.
+ .hy 0
+ .if n .na
+ .\"
+ .\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
+ .\" Fear. Run. Save yourself. No user-serviceable parts.
+ .bd B 3
+ . \" fudge factors for nroff and troff
+ .if n \{\
+ . ds #H 0
+ . ds #V .8m
+ . ds #F .3m
+ . ds #[ \f1
+ . ds #] \fP
+ .\}
+ .if t \{\
+ . ds #H ((1u-(\\\\n(.fu%2u))*.13m)
+ . ds #V .6m
+ . ds #F 0
+ . ds #[ \&
+ . ds #] \&
+ .\}
+ . \" simple accents for nroff and troff
+ .if n \{\
+ . ds ' \&
+ . ds ` \&
+ . ds ^ \&
+ . ds , \&
+ . ds ~ ~
+ . ds /
+ .\}
+ .if t \{\
+ . ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
+ . ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
+ . ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
+ . ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
+ . ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
+ . ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
+ .\}
+ . \" troff and (daisy-wheel) nroff accents
+ .ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
+ .ds 8 \h'\*(#H'\(*b\h'-\*(#H'
+ .ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
+ .ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
+ .ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
+ .ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
+ .ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
+ .ds ae a\h'-(\w'a'u*4/10)'e
+ .ds Ae A\h'-(\w'A'u*4/10)'E
+ . \" corrections for vroff
+ .if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
+ .if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
+ . \" for low resolution devices (crt and lpr)
+ .if \n(.H>23 .if \n(.V>19 \
+ \{\
+ . ds : e
+ . ds 8 ss
+ . ds o a
+ . ds d- d\h'-1'\(ga
+ . ds D- D\h'-1'\(hy
+ . ds th \o'bp'
+ . ds Th \o'LP'
+ . ds ae ae
+ . ds Ae AE
+ .\}
+ .rm #[ #] #H #V #F C
+ .\" ======================================================================
+ .\"
+ .IX Title "ANALYZE 1"
+ .TH ANALYZE 1 "1.3" "2004-07-04" "LLVM Command Guide"
+ .UC
+ .SH "NAME"
+ analyze \- \s-1LLVM\s0 program analyzer
+ .SH "SYNOPSIS"
+ .IX Header "SYNOPSIS"
+ \&\fBanalyze\fR [\fIoptions\fR] [\fIfilename\fR]
+ .SH "DESCRIPTION"
+ .IX Header "DESCRIPTION"
+ The \fBanalyze\fR command performs various analysis of \s-1LLVM\s0 assembly
+ code or bytecode. It will usually print the results on standard
+ output, but in a few cases, it will print output to standard error
+ or generate a file with the analysis output, which is usually done
+ when the output is meant for another program.
+ .PP
+ If filename is omitted or is \fI-\fR, \fBanalyze\fR reads its input from
+ standard input. It first attempts to interpret its input as \s-1LLVM\s0
+ bytecode. If it encounters an error, it then attempts to parse the
+ input as \s-1LLVM\s0 assembly language.
+ .SH "OPTIONS"
+ .IX Header "OPTIONS"
+ .Ip "\fB\-help\fR" 4
+ .IX Item "-help"
+ Print a summary of command line options.
+ .Ip "\fB\-q\fR" 4
+ .IX Item "-q"
+ Quiet mode. With this option, analysis pass names are not printed.
+ .Ip "\fB\-load\fR \fIplugin\fR" 4
+ .IX Item "-load plugin"
+ Load the specified dynamic object with name \fIplugin\fR. This file
+ should contain additional analysis passes that register themselves
+ with the \fBanalyze\fR program after being loaded.
+ .Sp
+ After being loaded, additional command line options are made
+ available for running the passes made available by \fIplugin\fR. Use
+ \&\fBanalyze \-load\fR \fIplugin\fR \fB\-help\fR to see the new list of available
+ analysis passes.
+ .Ip "\fB\-profile-info-file\fR \fIfilename\fR" 4
+ .IX Item "-profile-info-file filename"
+ Specify the name of the file loaded by the \-profile-loader option.
+ .Ip "\fB\-stats\fR" 4
+ .IX Item "-stats"
+ Print statistics.
+ .Ip "\fB\-time-passes\fR" 4
+ .IX Item "-time-passes"
+ Record the amount of time needed for each pass and print it to standard
+ error.
+ .SH "EXIT STATUS"
+ .IX Header "EXIT STATUS"
+ If \fBanalyze\fR succeeds, it will exit with 0. Otherwise, if an error
+ occurs, it will exit with a non-zero value.
+ .SH "SEE ALSO"
+ .IX Header "SEE ALSO"
+ opt
+ .SH "AUTHORS"
+ .IX Header "AUTHORS"
+ Maintained by the \s-1LLVM\s0 Team (http://llvm.cs.uiuc.edu).
Index: llvm-www/releases/1.6/docs/CommandGuide/man/man1/bugpoint.1
diff -c /dev/null llvm-www/releases/1.6/docs/CommandGuide/man/man1/bugpoint.1:1.1
*** /dev/null Tue Nov 8 14:07:55 2005
--- llvm-www/releases/1.6/docs/CommandGuide/man/man1/bugpoint.1 Tue Nov 8 14:07:44 2005
***************
*** 0 ****
--- 1,349 ----
+ .\" Automatically generated by Pod::Man version 1.15
+ .\" Sat Jul 10 01:00:16 2004
+ .\"
+ .\" Standard preamble:
+ .\" ======================================================================
+ .de Sh \" Subsection heading
+ .br
+ .if t .Sp
+ .ne 5
+ .PP
+ \fB\\$1\fR
+ .PP
+ ..
+ .de Sp \" Vertical space (when we can't use .PP)
+ .if t .sp .5v
+ .if n .sp
+ ..
+ .de Ip \" List item
+ .br
+ .ie \\n(.$>=3 .ne \\$3
+ .el .ne 3
+ .IP "\\$1" \\$2
+ ..
+ .de Vb \" Begin verbatim text
+ .ft CW
+ .nf
+ .ne \\$1
+ ..
+ .de Ve \" End verbatim text
+ .ft R
+
+ .fi
+ ..
+ .\" Set up some character translations and predefined strings. \*(-- will
+ .\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
+ .\" double quote, and \*(R" will give a right double quote. | will give a
+ .\" real vertical bar. \*(C+ will give a nicer C++. Capital omega is used
+ .\" to do unbreakable dashes and therefore won't be available. \*(C` and
+ .\" \*(C' expand to `' in nroff, nothing in troff, for use with C<>
+ .tr \(*W-|\(bv\*(Tr
+ .ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
+ .ie n \{\
+ . ds -- \(*W-
+ . ds PI pi
+ . if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
+ . if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch
+ . ds L" ""
+ . ds R" ""
+ . ds C` ""
+ . ds C' ""
+ 'br\}
+ .el\{\
+ . ds -- \|\(em\|
+ . ds PI \(*p
+ . ds L" ``
+ . ds R" ''
+ 'br\}
+ .\"
+ .\" If the F register is turned on, we'll generate index entries on stderr
+ .\" for titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and
+ .\" index entries marked with X<> in POD. Of course, you'll have to process
+ .\" the output yourself in some meaningful fashion.
+ .if \nF \{\
+ . de IX
+ . tm Index:\\$1\t\\n%\t"\\$2"
+ ..
+ . nr % 0
+ . rr F
+ .\}
+ .\"
+ .\" For nroff, turn off justification. Always turn off hyphenation; it
+ .\" makes way too many mistakes in technical documents.
+ .hy 0
+ .if n .na
+ .\"
+ .\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
+ .\" Fear. Run. Save yourself. No user-serviceable parts.
+ .bd B 3
+ . \" fudge factors for nroff and troff
+ .if n \{\
+ . ds #H 0
+ . ds #V .8m
+ . ds #F .3m
+ . ds #[ \f1
+ . ds #] \fP
+ .\}
+ .if t \{\
+ . ds #H ((1u-(\\\\n(.fu%2u))*.13m)
+ . ds #V .6m
+ . ds #F 0
+ . ds #[ \&
+ . ds #] \&
+ .\}
+ . \" simple accents for nroff and troff
+ .if n \{\
+ . ds ' \&
+ . ds ` \&
+ . ds ^ \&
+ . ds , \&
+ . ds ~ ~
+ . ds /
+ .\}
+ .if t \{\
+ . ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
+ . ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
+ . ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
+ . ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
+ . ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
+ . ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
+ .\}
+ . \" troff and (daisy-wheel) nroff accents
+ .ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
+ .ds 8 \h'\*(#H'\(*b\h'-\*(#H'
+ .ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
+ .ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
+ .ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
+ .ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
+ .ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
+ .ds ae a\h'-(\w'a'u*4/10)'e
+ .ds Ae A\h'-(\w'A'u*4/10)'E
+ . \" corrections for vroff
+ .if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
+ .if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
+ . \" for low resolution devices (crt and lpr)
+ .if \n(.H>23 .if \n(.V>19 \
+ \{\
+ . ds : e
+ . ds 8 ss
+ . ds o a
+ . ds d- d\h'-1'\(ga
+ . ds D- D\h'-1'\(hy
+ . ds th \o'bp'
+ . ds Th \o'LP'
+ . ds ae ae
+ . ds Ae AE
+ .\}
+ .rm #[ #] #H #V #F C
+ .\" ======================================================================
+ .\"
+ .IX Title "BUGPOINT 1"
+ .TH BUGPOINT 1 "1.3" "2004-07-04" "LLVM Command Guide"
+ .UC
+ .SH "NAME"
+ bugpoint \- automatic test case reduction tool
+ .SH "SYNOPSIS"
+ .IX Header "SYNOPSIS"
+ \&\fBbugpoint\fR [\fIoptions\fR] [\fIinput \s-1LLVM\s0 ll/bc files\fR] [\fI\s-1LLVM\s0 passes\fR] \fB\*(--args\fR
+ \&\fIprogram arguments\fR
+ .SH "DESCRIPTION"
+ .IX Header "DESCRIPTION"
+ \&\fBbugpoint\fR narrows down the source of problems in \s-1LLVM\s0 tools and passes. It
+ can be used to debug three types of failures: optimizer crashes, miscompilations
+ by optimizers, or bad native code generation (including problems in the static
+ and \s-1JIT\s0 compilers). It aims to reduce large test cases to small, useful ones.
+ For example, if \fBgccas\fR crashes while optimizing a file, it will identify the
+ optimization (or combination of optimizations) that causes the crash, and reduce
+ the file down to a small example which triggers the crash.
+ .Sh "Design Philosophy"
+ .IX Subsection "Design Philosophy"
+ \&\fBbugpoint\fR is designed to be a useful tool without requiring any hooks into the
+ \&\s-1LLVM\s0 infrastructure at all. It works with any and all \s-1LLVM\s0 passes and code
+ generators, and does not need to \*(L"know\*(R" how they work. Because of this, it may
+ appear to do stupid things or miss obvious simplifications. \fBbugpoint\fR is also
+ designed to trade off programmer time for computer time in the
+ compiler-debugging process; consequently, it may take a long period of
+ (unattended) time to reduce a test case, but we feel it is still worth it. Note
+ that \fBbugpoint\fR is generally very quick unless debugging a miscompilation where
+ each test of the program (which requires executing it) takes a long time.
+ .Sh "Automatic Debugger Selection"
+ .IX Subsection "Automatic Debugger Selection"
+ \&\fBbugpoint\fR reads each \fI.bc\fR or \fI.ll\fR file specified on the command line and
+ links them together into a single module, called the test program. If any \s-1LLVM\s0
+ passes are specified on the command line, it runs these passes on the test
+ program. If any of the passes crash, or if they produce malformed output (which
+ causes the verifier to abort), \fBbugpoint\fR starts the crash debugger.
+ .PP
+ Otherwise, if the \fB\-output\fR option was not specified, \fBbugpoint\fR runs the test
+ program with the C backend (which is assumed to generate good code) to generate
+ a reference output. Once \fBbugpoint\fR has a reference output for the test
+ program, it tries executing it with the selected code generator. If the
+ selected code generator crashes, \fBbugpoint\fR starts the the Crash debugger entry elsewhere in this document on
+ the code generator. Otherwise, if the resulting output differs from the
+ reference output, it assumes the difference resulted from a code generator
+ failure, and starts the the Code generator debugger entry elsewhere in this document.
+ .PP
+ Finally, if the output of the selected code generator matches the reference
+ output, \fBbugpoint\fR runs the test program after all of the \s-1LLVM\s0 passes have been
+ applied to it. If its output differs from the reference output, it assumes the
+ difference resulted from a failure in one of the \s-1LLVM\s0 passes, and enters the
+ miscompilation debugger. Otherwise, there is no problem \fBbugpoint\fR can debug.
+ .Sh "Crash debugger"
+ .IX Subsection "Crash debugger"
+ If an optimizer or code generator crashes, \fBbugpoint\fR will try as hard as it
+ can to reduce the list of passes (for optimizer crashes) and the size of the
+ test program. First, \fBbugpoint\fR figures out which combination of optimizer
+ passes triggers the bug. This is useful when debugging a problem exposed by
+ \&\fBgccas\fR, for example, because it runs over 38 passes.
+ .PP
+ Next, \fBbugpoint\fR tries removing functions from the test program, to reduce its
+ size. Usually it is able to reduce a test program to a single function, when
+ debugging intraprocedural optimizations. Once the number of functions has been
+ reduced, it attempts to delete various edges in the control flow graph, to
+ reduce the size of the function as much as possible. Finally, \fBbugpoint\fR
+ deletes any individual \s-1LLVM\s0 instructions whose absence does not eliminate the
+ failure. At the end, \fBbugpoint\fR should tell you what passes crash, give you a
+ bytecode file, and give you instructions on how to reproduce the failure with
+ \&\fBopt\fR, \fBanalyze\fR, or \fBllc\fR.
+ .Sh "Code generator debugger"
+ .IX Subsection "Code generator debugger"
+ The code generator debugger attempts to narrow down the amount of code that is
+ being miscompiled by the selected code generator. To do this, it takes the test
+ program and partitions it into two pieces: one piece which it compiles with the
+ C backend (into a shared object), and one piece which it runs with either the
+ \&\s-1JIT\s0 or the static compiler (\fBllc\fR). It uses several techniques to reduce the
+ amount of code pushed through the \s-1LLVM\s0 code generator, to reduce the potential
+ scope of the problem. After it is finished, it emits two bytecode files (called
+ \&\*(L"test\*(R" [to be compiled with the code generator] and \*(L"safe\*(R" [to be compiled with
+ the C backend], respectively), and instructions for reproducing the problem.
+ The code generator debugger assumes that the C backend produces good code.
+ .Sh "Miscompilation debugger"
+ .IX Subsection "Miscompilation debugger"
+ The miscompilation debugger works similarly to the code generator debugger. It
+ works by splitting the test program into two pieces, running the optimizations
+ specified on one piece, linking the two pieces back together, and then executing
+ the result. It attempts to narrow down the list of passes to the one (or few)
+ which are causing the miscompilation, then reduce the portion of the test
+ program which is being miscompiled. The miscompilation debugger assumes that
+ the selected code generator is working properly.
+ .Sh "Advice for using bugpoint"
+ .IX Subsection "Advice for using bugpoint"
+ \&\fBbugpoint\fR can be a remarkably useful tool, but it sometimes works in
+ non-obvious ways. Here are some hints and tips:
+ .Ip "\(bu" 4
+ In the code generator and miscompilation debuggers, \fBbugpoint\fR only
+ works with programs that have deterministic output. Thus, if the program
+ outputs \f(CW\*(C`argv[0]\*(C'\fR, the date, time, or any other \*(L"random\*(R" data, \fBbugpoint\fR may
+ misinterpret differences in these data, when output, as the result of a
+ miscompilation. Programs should be temporarily modified to disable outputs that
+ are likely to vary from run to run.
+ .Ip "\(bu" 4
+ In the code generator and miscompilation debuggers, debugging will go faster if
+ you manually modify the program or its inputs to reduce the runtime, but still
+ exhibit the problem.
+ .Ip "\(bu" 4
+ \&\fBbugpoint\fR is extremely useful when working on a new optimization: it helps
+ track down regressions quickly. To avoid having to relink \fBbugpoint\fR every
+ time you change your optimization, make \fBbugpoint\fR dynamically load
+ your optimization by using the \fB\-load\fR option.
+ .Ip "\(bu" 4
+ \&\fBbugpoint\fR can generate a lot of output and run for a long period of time. It
+ is often useful to capture the output of the program to file. For example, in
+ the C shell, you can type:
+ .Sp
+ .Vb 1
+ \& bugpoint ... |& tee bugpoint.log
+ .Ve
+ to get a copy of \fBbugpoint\fR's output in the file \fIbugpoint.log\fR, as well as on
+ your terminal.
+ .Ip "\(bu" 4
+ \&\fBbugpoint\fR cannot debug problems with the \s-1LLVM\s0 linker. If \fBbugpoint\fR crashes
+ before you see its \f(CW\*(C`All input ok\*(C'\fR message, you might try running \f(CW\*(C`llvm\-link
+ \&\-v\*(C'\fR on the same set of input files. If that also crashes, you may be
+ experiencing a linker bug.
+ .Ip "\(bu" 4
+ If your program is supposed to crash, \fBbugpoint\fR will be confused. One way to
+ deal with this is to cause \fBbugpoint\fR to ignore the exit code from your
+ program, by giving it the \fB\-check-exit-code=false\fR option.
+ .SH "OPTIONS"
+ .IX Header "OPTIONS"
+ .Ip "\fB\*(--additional-so\fR \fIlibrary\fR" 4
+ .IX Item "additional-so library"
+ Load the dynamic shared object \fIlibrary\fR into the test program whenever it is
+ run. This is useful if you are debugging programs which depend on non-LLVM
+ libraries (such as the X or curses libraries) to run.
+ .Ip "\fB\*(--args\fR \fIprogram args\fR" 4
+ .IX Item "args program args"
+ Pass all arguments specified after \-args to the test program whenever it runs.
+ Note that if any of the \fIprogram args\fR start with a '\-', you should use:
+ .Sp
+ .Vb 1
+ \& bugpoint [bugpoint args] --args -- [program args]
+ .Ve
+ The \*(L"\-\-\*(R" right after the \fB\*(--args\fR option tells \fBbugpoint\fR to consider any
+ options starting with \f(CW\*(C`\-\*(C'\fR to be part of the \fB\*(--args\fR option, not as options to
+ \&\fBbugpoint\fR itself.
+ .Ip "\fB\*(--tool-args\fR \fItool args\fR" 4
+ .IX Item "tool-args tool args"
+ Pass all arguments specified after \-\-tool-args to the \s-1LLVM\s0 tool under test
+ (\fBllc\fR, \fBlli\fR, etc.) whenever it runs. You should use this option in the
+ following way:
+ .Sp
+ .Vb 1
+ \& bugpoint [bugpoint args] --tool-args -- [tool args]
+ .Ve
+ The \*(L"\-\-\*(R" right after the \fB\*(--tool-args\fR option tells \fBbugpoint\fR to consider any
+ options starting with \f(CW\*(C`\-\*(C'\fR to be part of the \fB\*(--tool-args\fR option, not as
+ options to \fBbugpoint\fR itself. (See \fB\*(--args\fR, above.)
+ .Ip "\fB\*(--check-exit-code\fR=\fI{true,false}\fR" 4
+ .IX Item "check-exit-code={true,false}"
+ Assume a non-zero exit code or core dump from the test program is a failure.
+ Defaults to true.
+ .Ip "\fB\*(--disable-{dce,simplifycfg}\fR" 4
+ .IX Item "disable-{dce,simplifycfg}"
+ Do not run the specified passes to clean up and reduce the size of the test
+ program. By default, \fBbugpoint\fR uses these passes internally when attempting to
+ reduce test programs. If you're trying to find a bug in one of these passes,
+ \&\fBbugpoint\fR may crash.
+ .Ip "\fB\*(--help\fR" 4
+ .IX Item "help"
+ Print a summary of command line options.
+ .Ip "\fB\*(--input\fR \fIfilename\fR" 4
+ .IX Item "input filename"
+ Open \fIfilename\fR and redirect the standard input of the test program, whenever
+ it runs, to come from that file.
+ .Ip "\fB\*(--load\fR \fIplugin\fR" 4
+ .IX Item "load plugin"
+ Load the dynamic object \fIplugin\fR into \fBbugpoint\fR itself. This object should
+ register new optimization passes. Once loaded, the object will add new command
+ line options to enable various optimizations. To see the new complete list of
+ optimizations, use the \fB\*(--help\fR and \fB\*(--load\fR options together; for example:
+ .Sp
+ .Vb 1
+ \& bugpoint --load myNewPass.so --help
+ .Ve
+ .Ip "\fB\*(--output\fR \fIfilename\fR" 4
+ .IX Item "output filename"
+ Whenever the test program produces output on its standard output stream, it
+ should match the contents of \fIfilename\fR (the \*(L"reference output\*(R"). If you
+ do not use this option, \fBbugpoint\fR will attempt to generate a reference output
+ by compiling the program with the C backend and running it.
+ .Ip "\fB\*(--profile-info-file\fR \fIfilename\fR" 4
+ .IX Item "profile-info-file filename"
+ Profile file loaded by \fB\*(--profile-loader\fR.
+ .Ip "\fB\*(--run-{int,jit,llc,cbe}\fR" 4
+ .IX Item "run-{int,jit,llc,cbe}"
+ Whenever the test program is compiled, \fBbugpoint\fR should generate code for it
+ using the specified code generator. These options allow you to choose the
+ interpreter, the \s-1JIT\s0 compiler, the static native code compiler, or the C
+ backend, respectively.
+ .SH "EXIT STATUS"
+ .IX Header "EXIT STATUS"
+ If \fBbugpoint\fR succeeds in finding a problem, it will exit with 0. Otherwise,
+ if an error occurs, it will exit with a non-zero value.
+ .SH "SEE ALSO"
+ .IX Header "SEE ALSO"
+ opt, analyze
+ .SH "AUTHOR"
+ .IX Header "AUTHOR"
+ Maintained by the \s-1LLVM\s0 Team (http://llvm.cs.uiuc.edu).
Index: llvm-www/releases/1.6/docs/CommandGuide/man/man1/extract.1
diff -c /dev/null llvm-www/releases/1.6/docs/CommandGuide/man/man1/extract.1:1.1
*** /dev/null Tue Nov 8 14:07:55 2005
--- llvm-www/releases/1.6/docs/CommandGuide/man/man1/extract.1 Tue Nov 8 14:07:44 2005
***************
*** 0 ****
--- 1,194 ----
+ .\" Automatically generated by Pod::Man version 1.15
+ .\" Sat Jul 10 01:00:16 2004
+ .\"
+ .\" Standard preamble:
+ .\" ======================================================================
+ .de Sh \" Subsection heading
+ .br
+ .if t .Sp
+ .ne 5
+ .PP
+ \fB\\$1\fR
+ .PP
+ ..
+ .de Sp \" Vertical space (when we can't use .PP)
+ .if t .sp .5v
+ .if n .sp
+ ..
+ .de Ip \" List item
+ .br
+ .ie \\n(.$>=3 .ne \\$3
+ .el .ne 3
+ .IP "\\$1" \\$2
+ ..
+ .de Vb \" Begin verbatim text
+ .ft CW
+ .nf
+ .ne \\$1
+ ..
+ .de Ve \" End verbatim text
+ .ft R
+
+ .fi
+ ..
+ .\" Set up some character translations and predefined strings. \*(-- will
+ .\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
+ .\" double quote, and \*(R" will give a right double quote. | will give a
+ .\" real vertical bar. \*(C+ will give a nicer C++. Capital omega is used
+ .\" to do unbreakable dashes and therefore won't be available. \*(C` and
+ .\" \*(C' expand to `' in nroff, nothing in troff, for use with C<>
+ .tr \(*W-|\(bv\*(Tr
+ .ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
+ .ie n \{\
+ . ds -- \(*W-
+ . ds PI pi
+ . if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
+ . if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch
+ . ds L" ""
+ . ds R" ""
+ . ds C` ""
+ . ds C' ""
+ 'br\}
+ .el\{\
+ . ds -- \|\(em\|
+ . ds PI \(*p
+ . ds L" ``
+ . ds R" ''
+ 'br\}
+ .\"
+ .\" If the F register is turned on, we'll generate index entries on stderr
+ .\" for titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and
+ .\" index entries marked with X<> in POD. Of course, you'll have to process
+ .\" the output yourself in some meaningful fashion.
+ .if \nF \{\
+ . de IX
+ . tm Index:\\$1\t\\n%\t"\\$2"
+ ..
+ . nr % 0
+ . rr F
+ .\}
+ .\"
+ .\" For nroff, turn off justification. Always turn off hyphenation; it
+ .\" makes way too many mistakes in technical documents.
+ .hy 0
+ .if n .na
+ .\"
+ .\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
+ .\" Fear. Run. Save yourself. No user-serviceable parts.
+ .bd B 3
+ . \" fudge factors for nroff and troff
+ .if n \{\
+ . ds #H 0
+ . ds #V .8m
+ . ds #F .3m
+ . ds #[ \f1
+ . ds #] \fP
+ .\}
+ .if t \{\
+ . ds #H ((1u-(\\\\n(.fu%2u))*.13m)
+ . ds #V .6m
+ . ds #F 0
+ . ds #[ \&
+ . ds #] \&
+ .\}
+ . \" simple accents for nroff and troff
+ .if n \{\
+ . ds ' \&
+ . ds ` \&
+ . ds ^ \&
+ . ds , \&
+ . ds ~ ~
+ . ds /
+ .\}
+ .if t \{\
+ . ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
+ . ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
+ . ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
+ . ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
+ . ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
+ . ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
+ .\}
+ . \" troff and (daisy-wheel) nroff accents
+ .ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
+ .ds 8 \h'\*(#H'\(*b\h'-\*(#H'
+ .ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
+ .ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
+ .ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
+ .ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
+ .ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
+ .ds ae a\h'-(\w'a'u*4/10)'e
+ .ds Ae A\h'-(\w'A'u*4/10)'E
+ . \" corrections for vroff
+ .if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
+ .if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
+ . \" for low resolution devices (crt and lpr)
+ .if \n(.H>23 .if \n(.V>19 \
+ \{\
+ . ds : e
+ . ds 8 ss
+ . ds o a
+ . ds d- d\h'-1'\(ga
+ . ds D- D\h'-1'\(hy
+ . ds th \o'bp'
+ . ds Th \o'LP'
+ . ds ae ae
+ . ds Ae AE
+ .\}
+ .rm #[ #] #H #V #F C
+ .\" ======================================================================
+ .\"
+ .IX Title "EXTRACT 1"
+ .TH EXTRACT 1 "1.3" "2004-07-04" "LLVM Command Guide"
+ .UC
+ .SH "NAME"
+ extract \- extract a function from an \s-1LLVM\s0 module
+ .SH "SYNOPSIS"
+ .IX Header "SYNOPSIS"
+ \&\fBextract\fR [\fIoptions\fR] \fB\*(--func\fR \fIfunction-name\fR [\fIfilename\fR]
+ .SH "DESCRIPTION"
+ .IX Header "DESCRIPTION"
+ The \fBextract\fR command takes the name of a function and extracts it from
+ the specified \s-1LLVM\s0 bytecode file. It is primarily used as a debugging tool to
+ reduce test cases from larger programs that are triggering a bug.
+ .PP
+ In addition to extracting the bytecode of the specified function,
+ \&\fBextract\fR will also remove unreachable global variables, prototypes, and
+ unused types.
+ .PP
+ The \fBextract\fR command reads its input from standard input if filename is
+ omitted or if filename is \-. The output is always written to standard output,
+ unless the \fB\-o\fR option is specified (see below).
+ .SH "OPTIONS"
+ .IX Header "OPTIONS"
+ .Ip "\fB\-f\fR" 4
+ .IX Item "-f"
+ Force overwrite. Normally, \fBextract\fR will refuse to overwrite an
+ output file that already exists. With this option, \fBextract\fR
+ will overwrite the output file and replace it with new bytecode.
+ .Ip "\fB\*(--func\fR \fIfunction-name\fR" 4
+ .IX Item "func function-name"
+ Extract the function named \fIfunction-name\fR from the \s-1LLVM\s0 bytecode.
+ .Ip "\fB\*(--help\fR" 4
+ .IX Item "help"
+ Print a summary of command line options.
+ .Ip "\fB\-o\fR \fIfilename\fR" 4
+ .IX Item "-o filename"
+ Specify the output filename. If filename is \*(L"\-\*(R" (the default), then
+ \&\fBextract\fR sends its output to standard output.
+ .Ip "\fB\*(--stats\fR" 4
+ .IX Item "stats"
+ Print statistics.
+ .Ip "\fB\*(--time-passes\fR" 4
+ .IX Item "time-passes"
+ Record the amount of time needed for each pass and print it to standard
+ error.
+ .SH "EXIT STATUS"
+ .IX Header "EXIT STATUS"
+ If \fBextract\fR succeeds, it will exit with 0. Otherwise, if an error
+ occurs, it will exit with a non-zero value.
+ .SH "SEE ALSO"
+ .IX Header "SEE ALSO"
+ bugpoint
+ .SH "AUTHORS"
+ .IX Header "AUTHORS"
+ Maintained by the \s-1LLVM\s0 Team (http://llvm.cs.uiuc.edu).
Index: llvm-www/releases/1.6/docs/CommandGuide/man/man1/gccas.1
diff -c /dev/null llvm-www/releases/1.6/docs/CommandGuide/man/man1/gccas.1:1.1
*** /dev/null Tue Nov 8 14:07:55 2005
--- llvm-www/releases/1.6/docs/CommandGuide/man/man1/gccas.1 Tue Nov 8 14:07:44 2005
***************
*** 0 ****
--- 1,197 ----
+ .\" Automatically generated by Pod::Man version 1.15
+ .\" Sat Jul 10 01:00:16 2004
+ .\"
+ .\" Standard preamble:
+ .\" ======================================================================
+ .de Sh \" Subsection heading
+ .br
+ .if t .Sp
+ .ne 5
+ .PP
+ \fB\\$1\fR
+ .PP
+ ..
+ .de Sp \" Vertical space (when we can't use .PP)
+ .if t .sp .5v
+ .if n .sp
+ ..
+ .de Ip \" List item
+ .br
+ .ie \\n(.$>=3 .ne \\$3
+ .el .ne 3
+ .IP "\\$1" \\$2
+ ..
+ .de Vb \" Begin verbatim text
+ .ft CW
+ .nf
+ .ne \\$1
+ ..
+ .de Ve \" End verbatim text
+ .ft R
+
+ .fi
+ ..
+ .\" Set up some character translations and predefined strings. \*(-- will
+ .\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
+ .\" double quote, and \*(R" will give a right double quote. | will give a
+ .\" real vertical bar. \*(C+ will give a nicer C++. Capital omega is used
+ .\" to do unbreakable dashes and therefore won't be available. \*(C` and
+ .\" \*(C' expand to `' in nroff, nothing in troff, for use with C<>
+ .tr \(*W-|\(bv\*(Tr
+ .ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
+ .ie n \{\
+ . ds -- \(*W-
+ . ds PI pi
+ . if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
+ . if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch
+ . ds L" ""
+ . ds R" ""
+ . ds C` ""
+ . ds C' ""
+ 'br\}
+ .el\{\
+ . ds -- \|\(em\|
+ . ds PI \(*p
+ . ds L" ``
+ . ds R" ''
+ 'br\}
+ .\"
+ .\" If the F register is turned on, we'll generate index entries on stderr
+ .\" for titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and
+ .\" index entries marked with X<> in POD. Of course, you'll have to process
+ .\" the output yourself in some meaningful fashion.
+ .if \nF \{\
+ . de IX
+ . tm Index:\\$1\t\\n%\t"\\$2"
+ ..
+ . nr % 0
+ . rr F
+ .\}
+ .\"
+ .\" For nroff, turn off justification. Always turn off hyphenation; it
+ .\" makes way too many mistakes in technical documents.
+ .hy 0
+ .if n .na
+ .\"
+ .\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
+ .\" Fear. Run. Save yourself. No user-serviceable parts.
+ .bd B 3
+ . \" fudge factors for nroff and troff
+ .if n \{\
+ . ds #H 0
+ . ds #V .8m
+ . ds #F .3m
+ . ds #[ \f1
+ . ds #] \fP
+ .\}
+ .if t \{\
+ . ds #H ((1u-(\\\\n(.fu%2u))*.13m)
+ . ds #V .6m
+ . ds #F 0
+ . ds #[ \&
+ . ds #] \&
+ .\}
+ . \" simple accents for nroff and troff
+ .if n \{\
+ . ds ' \&
+ . ds ` \&
+ . ds ^ \&
+ . ds , \&
+ . ds ~ ~
+ . ds /
+ .\}
+ .if t \{\
+ . ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
+ . ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
+ . ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
+ . ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
+ . ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
+ . ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
+ .\}
+ . \" troff and (daisy-wheel) nroff accents
+ .ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
+ .ds 8 \h'\*(#H'\(*b\h'-\*(#H'
+ .ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
+ .ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
+ .ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
+ .ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
+ .ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
+ .ds ae a\h'-(\w'a'u*4/10)'e
+ .ds Ae A\h'-(\w'A'u*4/10)'E
+ . \" corrections for vroff
+ .if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
+ .if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
+ . \" for low resolution devices (crt and lpr)
+ .if \n(.H>23 .if \n(.V>19 \
+ \{\
+ . ds : e
+ . ds 8 ss
+ . ds o a
+ . ds d- d\h'-1'\(ga
+ . ds D- D\h'-1'\(hy
+ . ds th \o'bp'
+ . ds Th \o'LP'
+ . ds ae ae
+ . ds Ae AE
+ .\}
+ .rm #[ #] #H #V #F C
+ .\" ======================================================================
+ .\"
+ .IX Title "GCCAS 1"
+ .TH GCCAS 1 "1.3" "2004-07-04" "LLVM Command Guide"
+ .UC
+ .SH "NAME"
+ gccas \- optimizing \s-1LLVM\s0 assembler
+ .SH "SYNOPSIS"
+ .IX Header "SYNOPSIS"
+ \&\fBgccas\fR [\fIoptions\fR] \fIfilename\fR
+ .SH "DESCRIPTION"
+ .IX Header "DESCRIPTION"
+ The \fBgccas\fR utility takes an \s-1LLVM\s0 assembly file generated by the
+ llvmgcc or llvmg++ front-ends and converts
+ it into an \s-1LLVM\s0 bytecode file. It is primarily used by the \s-1GCC\s0
+ front end, and as such, attempts to mimic the interface provided
+ by the default system assembler so that it can act as a \*(L"drop-in\*(R"
+ replacement.
+ .PP
+ \&\fBgccas\fR performs a number of optimizations on the input program,
+ including but not limited to: promotion of stack values to \s-1SSA\s0
+ registers; elimination of dead globals, function arguments, code,
+ and types; tail-call elimination; loop-invariant code motion; global
+ common-subexpression elimination; and sparse conditional constant
+ propagation.
+ .SH "OPTIONS"
+ .IX Header "OPTIONS"
+ .Ip "\fB\*(--help\fR" 4
+ .IX Item "help"
+ Print a summary of command line options.
+ .Ip "\fB\-o\fR \fIfilename\fR" 4
+ .IX Item "-o filename"
+ Specify the name of the output file which will hold the assembled bytecode.
+ .Ip "\fB\*(--disable-inlining\fR" 4
+ .IX Item "disable-inlining"
+ Disable the inlining pass. By default, it is enabled.
+ .Ip "\fB\*(--disable-opt\fR" 4
+ .IX Item "disable-opt"
+ Disable all assembler-time optimization passes.
+ .Ip "\fB\*(--stats\fR" 4
+ .IX Item "stats"
+ Print statistics.
+ .Ip "\fB\*(--time-passes\fR" 4
+ .IX Item "time-passes"
+ Record the amount of time needed for each pass and print it to standard
+ error.
+ .Ip "\fB\*(--verify\fR" 4
+ .IX Item "verify"
+ Verify each pass result.
+ .SH "EXIT STATUS"
+ .IX Header "EXIT STATUS"
+ If \fBgccas\fR succeeds, it will exit with an exit status of 0.
+ Otherwise, if an error occurs, it will exit with a non-zero exit
+ status.
+ .SH "SEE ALSO"
+ .IX Header "SEE ALSO"
+ llvm-as, gccld
+ .SH "AUTHORS"
+ .IX Header "AUTHORS"
+ Maintained by the \s-1LLVM\s0 Team (http://llvm.cs.uiuc.edu).
Index: llvm-www/releases/1.6/docs/CommandGuide/man/man1/gccld.1
diff -c /dev/null llvm-www/releases/1.6/docs/CommandGuide/man/man1/gccld.1:1.1
*** /dev/null Tue Nov 8 14:07:55 2005
--- llvm-www/releases/1.6/docs/CommandGuide/man/man1/gccld.1 Tue Nov 8 14:07:44 2005
***************
*** 0 ****
--- 1,282 ----
+ .\" Automatically generated by Pod::Man version 1.15
+ .\" Sat Jul 10 01:00:16 2004
+ .\"
+ .\" Standard preamble:
+ .\" ======================================================================
+ .de Sh \" Subsection heading
+ .br
+ .if t .Sp
+ .ne 5
+ .PP
+ \fB\\$1\fR
+ .PP
+ ..
+ .de Sp \" Vertical space (when we can't use .PP)
+ .if t .sp .5v
+ .if n .sp
+ ..
+ .de Ip \" List item
+ .br
+ .ie \\n(.$>=3 .ne \\$3
+ .el .ne 3
+ .IP "\\$1" \\$2
+ ..
+ .de Vb \" Begin verbatim text
+ .ft CW
+ .nf
+ .ne \\$1
+ ..
+ .de Ve \" End verbatim text
+ .ft R
+
+ .fi
+ ..
+ .\" Set up some character translations and predefined strings. \*(-- will
+ .\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
+ .\" double quote, and \*(R" will give a right double quote. | will give a
+ .\" real vertical bar. \*(C+ will give a nicer C++. Capital omega is used
+ .\" to do unbreakable dashes and therefore won't be available. \*(C` and
+ .\" \*(C' expand to `' in nroff, nothing in troff, for use with C<>
+ .tr \(*W-|\(bv\*(Tr
+ .ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
+ .ie n \{\
+ . ds -- \(*W-
+ . ds PI pi
+ . if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
+ . if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch
+ . ds L" ""
+ . ds R" ""
+ . ds C` ""
+ . ds C' ""
+ 'br\}
+ .el\{\
+ . ds -- \|\(em\|
+ . ds PI \(*p
+ . ds L" ``
+ . ds R" ''
+ 'br\}
+ .\"
+ .\" If the F register is turned on, we'll generate index entries on stderr
+ .\" for titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and
+ .\" index entries marked with X<> in POD. Of course, you'll have to process
+ .\" the output yourself in some meaningful fashion.
+ .if \nF \{\
+ . de IX
+ . tm Index:\\$1\t\\n%\t"\\$2"
+ ..
+ . nr % 0
+ . rr F
+ .\}
+ .\"
+ .\" For nroff, turn off justification. Always turn off hyphenation; it
+ .\" makes way too many mistakes in technical documents.
+ .hy 0
+ .if n .na
+ .\"
+ .\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
+ .\" Fear. Run. Save yourself. No user-serviceable parts.
+ .bd B 3
+ . \" fudge factors for nroff and troff
+ .if n \{\
+ . ds #H 0
+ . ds #V .8m
+ . ds #F .3m
+ . ds #[ \f1
+ . ds #] \fP
+ .\}
+ .if t \{\
+ . ds #H ((1u-(\\\\n(.fu%2u))*.13m)
+ . ds #V .6m
+ . ds #F 0
+ . ds #[ \&
+ . ds #] \&
+ .\}
+ . \" simple accents for nroff and troff
+ .if n \{\
+ . ds ' \&
+ . ds ` \&
+ . ds ^ \&
+ . ds , \&
+ . ds ~ ~
+ . ds /
+ .\}
+ .if t \{\
+ . ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
+ . ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
+ . ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
+ . ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
+ . ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
+ . ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
+ .\}
+ . \" troff and (daisy-wheel) nroff accents
+ .ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
+ .ds 8 \h'\*(#H'\(*b\h'-\*(#H'
+ .ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
+ .ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
+ .ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
+ .ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
+ .ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
+ .ds ae a\h'-(\w'a'u*4/10)'e
+ .ds Ae A\h'-(\w'A'u*4/10)'E
+ . \" corrections for vroff
+ .if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
+ .if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
+ . \" for low resolution devices (crt and lpr)
+ .if \n(.H>23 .if \n(.V>19 \
+ \{\
+ . ds : e
+ . ds 8 ss
+ . ds o a
+ . ds d- d\h'-1'\(ga
+ . ds D- D\h'-1'\(hy
+ . ds th \o'bp'
+ . ds Th \o'LP'
+ . ds ae ae
+ . ds Ae AE
+ .\}
+ .rm #[ #] #H #V #F C
+ .\" ======================================================================
+ .\"
+ .IX Title "GCCLD 1"
+ .TH GCCLD 1 "1.3" "2004-07-04" "LLVM Command Guide"
+ .UC
+ .SH "NAME"
+ gccld \- optimizing \s-1LLVM\s0 linker
+ .SH "SYNOPSIS"
+ .IX Header "SYNOPSIS"
+ \&\fBgccld\fR [\fIoptions\fR] \fIfilename ...\fR
+ .SH "DESCRIPTION"
+ .IX Header "DESCRIPTION"
+ The \fBgccld\fR utility takes a set of \s-1LLVM\s0 bytecode files and links them
+ together into a single \s-1LLVM\s0 bytecode file. The output bytecode file can be
+ another bytecode library or an executable bytecode program. Using additional
+ options, \fBgccld\fR is able to produce native code executables.
+ .PP
+ The \fBgccld\fR utility is primarily used by the the llvmgcc manpage and
+ llvmg++ front-ends, and as such, attempts to mimic the interface
+ provided by the default system linker so that it can act as a ``drop-in''
+ replacement.
+ .PP
+ The \fBgccld\fR tool performs a small set of interprocedural, post-link
+ optimizations on the program.
+ .Sh "Search Order"
+ .IX Subsection "Search Order"
+ When looking for objects specified on the command line, \fBgccld\fR will search for
+ the object first in the current directory and then in the directory specified by
+ the \fB\s-1LLVM_LIB_SEARCH_PATH\s0\fR environment variable. If it cannot find the object,
+ it fails.
+ .PP
+ When looking for a library specified with the \fB\-l\fR option, \fBgccld\fR first
+ attempts to load a file with that name from the current directory. If that
+ fails, it looks for lib\fIlibrary\fR.bc, lib\fIlibrary\fR.a, or lib\fIlibrary\fR.\fIshared
+ library extension\fR, in that order, in each directory added to the library search
+ path with the \fB\-L\fR option. These directories are searched in the order they
+ were specified. If the library cannot be located, then \fBgccld\fR looks in the
+ directory specified by the \fB\s-1LLVM_LIB_SEARCH_PATH\s0\fR environment variable. If it
+ does not find a library there, it fails.
+ .PP
+ The shared library extension may be \fI.so\fR, \fI.dyld\fR, \fI.dll\fR, or something
+ different, depending upon the system.
+ .PP
+ The \fB\-L\fR option is global. It does not matter where it is specified in the
+ list of command line arguments; the directory is simply added to the search path
+ and is applied to all libraries, preceding or succeeding, in the command line.
+ .Sh "Link order"
+ .IX Subsection "Link order"
+ All object files are linked first in the order they were specified on the
+ command line. All library files are linked next. Some libraries may not be
+ linked into the object program; see below.
+ .Sh "Library Linkage"
+ .IX Subsection "Library Linkage"
+ Object files and static bytecode objects are always linked into the output
+ file. Library archives (.a files) load only the objects within the archive
+ that define symbols needed by the output file. Hence, libraries should be
+ listed after the object files and libraries which need them; otherwise, the
+ library may not be linked in, and the dependent library will not have its
+ undefined symbols defined.
+ .Sh "Native code generation"
+ .IX Subsection "Native code generation"
+ The \fBgccld\fR program has limited support for native code generation, when
+ using the \fB\-native\fR or \fB\-native-cbe\fR options.
+ .SH "OPTIONS"
+ .IX Header "OPTIONS"
+ .Ip "\fB\-help\fR" 4
+ .IX Item "-help"
+ Print a summary of command line options.
+ .Ip "\fB\-o\fR \fIfilename\fR" 4
+ .IX Item "-o filename"
+ Specify the output filename which will hold the linked bytecode.
+ .Ip "\fB\-stats\fR" 4
+ .IX Item "-stats"
+ Print statistics.
+ .Ip "\fB\-time-passes\fR" 4
+ .IX Item "-time-passes"
+ Record the amount of time needed for each pass and print it to standard
+ error.
+ .Ip "\fB\-verify\fR" 4
+ .IX Item "-verify"
+ Verify each pass result.
+ .Ip "\fB\-disable-opt\fR" 4
+ .IX Item "-disable-opt"
+ Disable all link-time optimization passes.
+ .Ip "\fB\-disable-inlining\fR" 4
+ .IX Item "-disable-inlining"
+ Do not run the inliner pass.
+ .Ip "\fB\-L\fR\fIdirectory\fR" 4
+ .IX Item "-Ldirectory"
+ Add directory to the list of directories to search when looking for
+ libraries.
+ .Ip "\fB\-disable-internalize\fR" 4
+ .IX Item "-disable-internalize"
+ Do not mark all symbols as internal.
+ .Ip "\fB\-internalize-public-api-file\fR \fIfilename\fR" 4
+ .IX Item "-internalize-public-api-file filename"
+ Preserve the list of symbol names in the file filename.
+ .Ip "\fB\-internalize-public-api-list <list>\fR" 4
+ .IX Item "-internalize-public-api-list <list>"
+ Preserve the symbol names in list.
+ .Ip "\fB\-l\fR\fIlibrary\fR" 4
+ .IX Item "-llibrary"
+ Specify libraries to include when linking the output file. When linking,
+ \&\fBgccld\fR will first attempt to load a file with the pathname \fBlibrary\fR. If
+ that fails, it will then attempt to load lib\fIlibrary\fR.bc, lib\fIlibrary\fR.a, and
+ lib\fIlibrary\fR.\fIshared library extension\fR, in that order.
+ .Ip "\fB\-link-as-library\fR" 4
+ .IX Item "-link-as-library"
+ Link the .bc files together as a library, not an executable.
+ .Ip "\fB\-native\fR" 4
+ .IX Item "-native"
+ Generate a native machine code executable.
+ .Sp
+ When generating native executables, \fBgccld\fR first checks for a bytecode
+ version of the library and links it in, if necessary. If the library is
+ missing, \fBgccld\fR skips it. Then, \fBgccld\fR links in the same
+ libraries as native code.
+ .Sp
+ In this way, \fBgccld\fR should be able to link in optimized bytecode
+ subsets of common libraries and then link in any part of the library that
+ hasn't been converted to bytecode.
+ .Ip "\fB\-native-cbe\fR" 4
+ .IX Item "-native-cbe"
+ Generate a native machine code executable with the \s-1LLVM\s0 C backend.
+ .Sp
+ This option is identical to the \fB\-native\fR option, but uses the
+ C backend to generate code for the program instead of an \s-1LLVM\s0 native
+ code generator.
+ .Ip "\fB\-s\fR" 4
+ .IX Item "-s"
+ Strip symbol information from the generated executable.
+ .Ip "\fB\-v\fR" 4
+ .IX Item "-v"
+ Print information about actions taken.
+ .SH "EXIT STATUS"
+ .IX Header "EXIT STATUS"
+ If \fBgccld\fR succeeds, it will exit with an exit status of 0.
+ Otherwise, if an error occurs, it will exit with a non-zero exit
+ status.
+ .SH "SEE ALSO"
+ .IX Header "SEE ALSO"
+ llvm-link, gccas
+ .SH "AUTHORS"
+ .IX Header "AUTHORS"
+ Maintained by the \s-1LLVM\s0 Team (http://llvm.cs.uiuc.edu).
Index: llvm-www/releases/1.6/docs/CommandGuide/man/man1/llc.1
diff -c /dev/null llvm-www/releases/1.6/docs/CommandGuide/man/man1/llc.1:1.1
*** /dev/null Tue Nov 8 14:07:55 2005
--- llvm-www/releases/1.6/docs/CommandGuide/man/man1/llc.1 Tue Nov 8 14:07:44 2005
***************
*** 0 ****
--- 1,286 ----
+ .\" Automatically generated by Pod::Man version 1.15
+ .\" Sat Jul 10 01:00:17 2004
+ .\"
+ .\" Standard preamble:
+ .\" ======================================================================
+ .de Sh \" Subsection heading
+ .br
+ .if t .Sp
+ .ne 5
+ .PP
+ \fB\\$1\fR
+ .PP
+ ..
+ .de Sp \" Vertical space (when we can't use .PP)
+ .if t .sp .5v
+ .if n .sp
+ ..
+ .de Ip \" List item
+ .br
+ .ie \\n(.$>=3 .ne \\$3
+ .el .ne 3
+ .IP "\\$1" \\$2
+ ..
+ .de Vb \" Begin verbatim text
+ .ft CW
+ .nf
+ .ne \\$1
+ ..
+ .de Ve \" End verbatim text
+ .ft R
+
+ .fi
+ ..
+ .\" Set up some character translations and predefined strings. \*(-- will
+ .\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
+ .\" double quote, and \*(R" will give a right double quote. | will give a
+ .\" real vertical bar. \*(C+ will give a nicer C++. Capital omega is used
+ .\" to do unbreakable dashes and therefore won't be available. \*(C` and
+ .\" \*(C' expand to `' in nroff, nothing in troff, for use with C<>
+ .tr \(*W-|\(bv\*(Tr
+ .ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
+ .ie n \{\
+ . ds -- \(*W-
+ . ds PI pi
+ . if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
+ . if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch
+ . ds L" ""
+ . ds R" ""
+ . ds C` ""
+ . ds C' ""
+ 'br\}
+ .el\{\
+ . ds -- \|\(em\|
+ . ds PI \(*p
+ . ds L" ``
+ . ds R" ''
+ 'br\}
+ .\"
+ .\" If the F register is turned on, we'll generate index entries on stderr
+ .\" for titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and
+ .\" index entries marked with X<> in POD. Of course, you'll have to process
+ .\" the output yourself in some meaningful fashion.
+ .if \nF \{\
+ . de IX
+ . tm Index:\\$1\t\\n%\t"\\$2"
+ ..
+ . nr % 0
+ . rr F
+ .\}
+ .\"
+ .\" For nroff, turn off justification. Always turn off hyphenation; it
+ .\" makes way too many mistakes in technical documents.
+ .hy 0
+ .if n .na
+ .\"
+ .\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
+ .\" Fear. Run. Save yourself. No user-serviceable parts.
+ .bd B 3
+ . \" fudge factors for nroff and troff
+ .if n \{\
+ . ds #H 0
+ . ds #V .8m
+ . ds #F .3m
+ . ds #[ \f1
+ . ds #] \fP
+ .\}
+ .if t \{\
+ . ds #H ((1u-(\\\\n(.fu%2u))*.13m)
+ . ds #V .6m
+ . ds #F 0
+ . ds #[ \&
+ . ds #] \&
+ .\}
+ . \" simple accents for nroff and troff
+ .if n \{\
+ . ds ' \&
+ . ds ` \&
+ . ds ^ \&
+ . ds , \&
+ . ds ~ ~
+ . ds /
+ .\}
+ .if t \{\
+ . ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
+ . ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
+ . ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
+ . ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
+ . ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
+ . ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
+ .\}
+ . \" troff and (daisy-wheel) nroff accents
+ .ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
+ .ds 8 \h'\*(#H'\(*b\h'-\*(#H'
+ .ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
+ .ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
+ .ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
+ .ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
+ .ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
+ .ds ae a\h'-(\w'a'u*4/10)'e
+ .ds Ae A\h'-(\w'A'u*4/10)'E
+ . \" corrections for vroff
+ .if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
+ .if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
+ . \" for low resolution devices (crt and lpr)
+ .if \n(.H>23 .if \n(.V>19 \
+ \{\
+ . ds : e
+ . ds 8 ss
+ . ds o a
+ . ds d- d\h'-1'\(ga
+ . ds D- D\h'-1'\(hy
+ . ds th \o'bp'
+ . ds Th \o'LP'
+ . ds ae ae
+ . ds Ae AE
+ .\}
+ .rm #[ #] #H #V #F C
+ .\" ======================================================================
+ .\"
+ .IX Title "LLC 1"
+ .TH LLC 1 "1.3" "2004-07-04" "LLVM Command Guide"
+ .UC
+ .SH "NAME"
+ llc \- \s-1LLVM\s0 static compiler
+ .SH "SYNOPSIS"
+ .IX Header "SYNOPSIS"
+ \&\fBllc\fR [\fIoptions\fR] [\fIfilename\fR]
+ .SH "DESCRIPTION"
+ .IX Header "DESCRIPTION"
+ The \fBllc\fR command compiles \s-1LLVM\s0 bytecode into assembly language for a
+ specified architecture. The assembly language output can then be passed through
+ a native assembler and linker to generate native code.
+ .PP
+ The choice of architecture for the output assembly code is determined as
+ follows, by attempting to satisfy each of the following rules in turn (first
+ one wins):
+ .Ip "\(bu" 4
+ If the user has specified an architecture with the \-m option, use that
+ architecture.
+ .Ip "\(bu" 4
+ Examine the input \s-1LLVM\s0 bytecode file: if it is little endian and has a
+ pointer size of 32 bits, select the Intel \s-1IA-32\s0 architecture. If it is big
+ endian and has a pointer size of 64 bits, select the SparcV9 architecture.
+ .Ip "\(bu" 4
+ If \fBllc\fR was compiled on an architecture for which it can generate code, select
+ the architecture upon which \fBllc\fR was compiled.
+ .Ip "\(bu" 4
+ Exit with an error message telling the user to specify the output
+ architecture explicitly.
+ .SH "OPTIONS"
+ .IX Header "OPTIONS"
+ If \fIfilename\fR is \- or omitted, \fBllc\fR reads \s-1LLVM\s0 bytecode from standard input.
+ Otherwise, it will read \s-1LLVM\s0 bytecode from \fIfilename\fR.
+ .PP
+ If the \fB\-o\fR option is omitted, then \fBllc\fR will send its output to standard
+ output if the input is from standard input. If the \fB\-o\fR option specifies \-,
+ then the output will also be sent to standard output.
+ .PP
+ If no \fB\-o\fR option is specified and an input file other than \- is specified,
+ then \fBllc\fR creates the output filename by taking the input filename,
+ removing any existing \fI.bc\fR extension, and adding a \fI.s\fR suffix.
+ .PP
+ Other \fBllc\fR options are as follows:
+ .Ip "\fB\-f\fR" 4
+ .IX Item "-f"
+ Overwrite output files. By default, \fBllc\fR will refuse to overwrite
+ an output file which already exists.
+ .Ip "\fB\-march\fR=\fIarch\fR" 4
+ .IX Item "-march=arch"
+ Specify the architecture for which to generate assembly. Valid
+ architectures are:
+ .RS 4
+ .Ip "\fIx86\fR" 4
+ .IX Item "x86"
+ Intel \s-1IA-32\s0 (Pentium and above)
+ .Ip "\fIsparcv9\fR" 4
+ .IX Item "sparcv9"
+ 64\-bit \s-1SPARC\s0 V9
+ .Ip "\fIc\fR" 4
+ .IX Item "c"
+ Emit C code, not assembly
+ .RE
+ .RS 4
+ .RE
+ .Ip "\fB\-enable-correct-eh-support\fR" 4
+ .IX Item "-enable-correct-eh-support"
+ Instruct the \fB\-lowerinvoke\fR pass to insert code for correct exception handling
+ support. This is expensive and is by default omitted for efficiency.
+ .Ip "\fB\-help\fR" 4
+ .IX Item "-help"
+ Print a summary of command line options.
+ .Ip "\fB\-stats\fR" 4
+ .IX Item "-stats"
+ Print statistics recorded by code-generation passes.
+ .Ip "\fB\-time-passes\fR" 4
+ .IX Item "-time-passes"
+ Record the amount of time needed for each pass and print a report to standard
+ error.
+ .Sh "Intel IA-32\-specific Options"
+ .IX Subsection "Intel IA-32-specific Options"
+ .Ip "\fB\*(--disable-fp-elim\fR" 4
+ .IX Item "disable-fp-elim"
+ Disable frame pointer elimination optimization.
+ .Ip "\fB\*(--disable-pattern-isel\fR" 4
+ .IX Item "disable-pattern-isel"
+ Use the 'simple' X86 instruction selector (the default).
+ .Ip "\fB\*(--print-machineinstrs\fR" 4
+ .IX Item "print-machineinstrs"
+ Print generated machine code.
+ .Ip "\fB\*(--regalloc\fR=\fIallocator\fR" 4
+ .IX Item "regalloc=allocator"
+ Specify the register allocator to use. The default \fIallocator\fR is \fIlocal\fR.
+ Valid register allocators are:
+ .RS 4
+ .Ip "\fIsimple\fR" 4
+ .IX Item "simple"
+ Very simple \*(L"always spill\*(R" register allocator
+ .Ip "\fIlocal\fR" 4
+ .IX Item "local"
+ Local register allocator
+ .Ip "\fIlinearscan\fR" 4
+ .IX Item "linearscan"
+ Linear scan global register allocator (experimental)
+ .RE
+ .RS 4
+ .RE
+ .Ip "\fB\*(--spiller\fR=\fIspiller\fR" 4
+ .IX Item "spiller=spiller"
+ Specify the spiller to use for register allocators that support it. Currently
+ this option is used only by the linear scan register allocator. The default
+ \&\fIspiller\fR is \fIlocal\fR. Valid spillers are:
+ .RS 4
+ .Ip "\fIsimple\fR" 4
+ .IX Item "simple"
+ Simple spiller
+ .Ip "\fIlocal\fR" 4
+ .IX Item "local"
+ Local spiller
+ .RE
+ .RS 4
+ .RE
+ .Sh "SPARCV9\-specific Options"
+ .IX Subsection "SPARCV9-specific Options"
+ .Ip "\fB\*(--disable-peephole\fR" 4
+ .IX Item "disable-peephole"
+ Disable peephole optimization pass.
+ .Ip "\fB\*(--disable-sched\fR" 4
+ .IX Item "disable-sched"
+ Disable local scheduling pass.
+ .Ip "\fB\*(--disable-strip\fR" 4
+ .IX Item "disable-strip"
+ The Sparc backend embeds the \s-1LLVM\s0 bytecode into the assembly output. This
+ option requests that symbol names be retained; by default, they are stripped out.
+ .Ip "\fB\*(--enable-maps\fR" 4
+ .IX Item "enable-maps"
+ Emit LLVM-to-machine code mapping information into the assembly output.
+ .SH "EXIT STATUS"
+ .IX Header "EXIT STATUS"
+ If \fBllc\fR succeeds, it will exit with 0. Otherwise, if an error occurs,
+ it will exit with a non-zero value.
+ .SH "SEE ALSO"
+ .IX Header "SEE ALSO"
+ lli
+ .SH "AUTHORS"
+ .IX Header "AUTHORS"
+ Maintained by the \s-1LLVM\s0 Team (http://llvm.cs.uiuc.edu).
Index: llvm-www/releases/1.6/docs/CommandGuide/man/man1/lli.1
diff -c /dev/null llvm-www/releases/1.6/docs/CommandGuide/man/man1/lli.1:1.1
*** /dev/null Tue Nov 8 14:07:55 2005
--- llvm-www/releases/1.6/docs/CommandGuide/man/man1/lli.1 Tue Nov 8 14:07:44 2005
***************
*** 0 ****
--- 1,198 ----
+ .\" Automatically generated by Pod::Man version 1.15
+ .\" Sat Jul 10 01:00:17 2004
+ .\"
+ .\" Standard preamble:
+ .\" ======================================================================
+ .de Sh \" Subsection heading
+ .br
+ .if t .Sp
+ .ne 5
+ .PP
+ \fB\\$1\fR
+ .PP
+ ..
+ .de Sp \" Vertical space (when we can't use .PP)
+ .if t .sp .5v
+ .if n .sp
+ ..
+ .de Ip \" List item
+ .br
+ .ie \\n(.$>=3 .ne \\$3
+ .el .ne 3
+ .IP "\\$1" \\$2
+ ..
+ .de Vb \" Begin verbatim text
+ .ft CW
+ .nf
+ .ne \\$1
+ ..
+ .de Ve \" End verbatim text
+ .ft R
+
+ .fi
+ ..
+ .\" Set up some character translations and predefined strings. \*(-- will
+ .\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
+ .\" double quote, and \*(R" will give a right double quote. | will give a
+ .\" real vertical bar. \*(C+ will give a nicer C++. Capital omega is used
+ .\" to do unbreakable dashes and therefore won't be available. \*(C` and
+ .\" \*(C' expand to `' in nroff, nothing in troff, for use with C<>
+ .tr \(*W-|\(bv\*(Tr
+ .ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
+ .ie n \{\
+ . ds -- \(*W-
+ . ds PI pi
+ . if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
+ . if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch
+ . ds L" ""
+ . ds R" ""
+ . ds C` ""
+ . ds C' ""
+ 'br\}
+ .el\{\
+ . ds -- \|\(em\|
+ . ds PI \(*p
+ . ds L" ``
+ . ds R" ''
+ 'br\}
+ .\"
+ .\" If the F register is turned on, we'll generate index entries on stderr
+ .\" for titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and
+ .\" index entries marked with X<> in POD. Of course, you'll have to process
+ .\" the output yourself in some meaningful fashion.
+ .if \nF \{\
+ . de IX
+ . tm Index:\\$1\t\\n%\t"\\$2"
+ ..
+ . nr % 0
+ . rr F
+ .\}
+ .\"
+ .\" For nroff, turn off justification. Always turn off hyphenation; it
+ .\" makes way too many mistakes in technical documents.
+ .hy 0
+ .if n .na
+ .\"
+ .\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
+ .\" Fear. Run. Save yourself. No user-serviceable parts.
+ .bd B 3
+ . \" fudge factors for nroff and troff
+ .if n \{\
+ . ds #H 0
+ . ds #V .8m
+ . ds #F .3m
+ . ds #[ \f1
+ . ds #] \fP
+ .\}
+ .if t \{\
+ . ds #H ((1u-(\\\\n(.fu%2u))*.13m)
+ . ds #V .6m
+ . ds #F 0
+ . ds #[ \&
+ . ds #] \&
+ .\}
+ . \" simple accents for nroff and troff
+ .if n \{\
+ . ds ' \&
+ . ds ` \&
+ . ds ^ \&
+ . ds , \&
+ . ds ~ ~
+ . ds /
+ .\}
+ .if t \{\
+ . ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
+ . ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
+ . ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
+ . ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
+ . ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
+ . ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
+ .\}
+ . \" troff and (daisy-wheel) nroff accents
+ .ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
+ .ds 8 \h'\*(#H'\(*b\h'-\*(#H'
+ .ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
+ .ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
+ .ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
+ .ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
+ .ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
+ .ds ae a\h'-(\w'a'u*4/10)'e
+ .ds Ae A\h'-(\w'A'u*4/10)'E
+ . \" corrections for vroff
+ .if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
+ .if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
+ . \" for low resolution devices (crt and lpr)
+ .if \n(.H>23 .if \n(.V>19 \
+ \{\
+ . ds : e
+ . ds 8 ss
+ . ds o a
+ . ds d- d\h'-1'\(ga
+ . ds D- D\h'-1'\(hy
+ . ds th \o'bp'
+ . ds Th \o'LP'
+ . ds ae ae
+ . ds Ae AE
+ .\}
+ .rm #[ #] #H #V #F C
+ .\" ======================================================================
+ .\"
+ .IX Title "LLI 1"
+ .TH LLI 1 "1.3" "2004-07-04" "LLVM Command Guide"
+ .UC
+ .SH "NAME"
+ lli \- directly execute programs from \s-1LLVM\s0 bytecode
+ .SH "SYNOPSIS"
+ .IX Header "SYNOPSIS"
+ \&\fBlli\fR [\fIoptions\fR] [\fIfilename\fR] [\fIprogram args\fR]
+ .SH "DESCRIPTION"
+ .IX Header "DESCRIPTION"
+ \&\fBlli\fR directly executes programs in \s-1LLVM\s0 bytecode format. It takes a program
+ in \s-1LLVM\s0 bytecode format and executes it using a just-in-time compiler, if one is
+ available for the current architecture, or an interpreter. \fBlli\fR takes all of
+ the same code generator options as llc, but they are only effective when
+ \&\fBlli\fR is using the just-in-time compiler.
+ .PP
+ If \fIfilename\fR is not specified, then \fBlli\fR reads the \s-1LLVM\s0 bytecode for the
+ program from standard input.
+ .PP
+ The optional \fIargs\fR specified on the command line are passed to the program as
+ arguments.
+ .SH "OPTIONS"
+ .IX Header "OPTIONS"
+ .Ip "\fB\-help\fR" 4
+ .IX Item "-help"
+ Print a summary of command line options.
+ .Ip "\fB\-stats\fR" 4
+ .IX Item "-stats"
+ Print statistics from the code-generation passes. This is only meaningful for
+ the just-in-time compiler, at present.
+ .Ip "\fB\-time-passes\fR" 4
+ .IX Item "-time-passes"
+ Record the amount of time needed for each code-generation pass and print it to
+ standard error.
+ .Ip "\fB\-march\fR=\fIarch\fR" 4
+ .IX Item "-march=arch"
+ Use the specified non-default architecture arch when selecting a code generator
+ for the just-in-time compiler. This may result in a crash if you pick an
+ architecture which is not compatible with the hardware you are running \fBlli\fR on.
+ .Ip "\fB\-force-interpreter\fR=\fI{false,true}\fR" 4
+ .IX Item "-force-interpreter={false,true}"
+ If set to true, use the interpreter even if a just-in-time compiler is available
+ for this architecture. Defaults to false.
+ .Ip "\fB\-f\fR=\fIname\fR" 4
+ .IX Item "-f=name"
+ Call the function named \fIname\fR to start the program. Note: The
+ function is assumed to have the C signature \f(CW\*(C`int\*(C'\fR \fIname\fR \f(CW\*(C`(int,
+ char **, char **)\*(C'\fR. If you try to use this option to call a function of
+ incompatible type, undefined behavior may result. Defaults to \f(CW\*(C`main\*(C'\fR.
+ .SH "EXIT STATUS"
+ .IX Header "EXIT STATUS"
+ If \fBlli\fR fails to load the program, it will exit with an exit code of 1.
+ Otherwise, it will return the exit code of the program it executes.
+ .SH "SEE ALSO"
+ .IX Header "SEE ALSO"
+ llc
+ .SH "AUTHOR"
+ .IX Header "AUTHOR"
+ Maintained by the \s-1LLVM\s0 Team (http://llvm.cs.uiuc.edu).
Index: llvm-www/releases/1.6/docs/CommandGuide/man/man1/llvm-as.1
diff -c /dev/null llvm-www/releases/1.6/docs/CommandGuide/man/man1/llvm-as.1:1.1
*** /dev/null Tue Nov 8 14:07:55 2005
--- llvm-www/releases/1.6/docs/CommandGuide/man/man1/llvm-as.1 Tue Nov 8 14:07:44 2005
***************
*** 0 ****
--- 1,199 ----
+ .\" Automatically generated by Pod::Man version 1.15
+ .\" Sat Jul 10 01:00:17 2004
+ .\"
+ .\" Standard preamble:
+ .\" ======================================================================
+ .de Sh \" Subsection heading
+ .br
+ .if t .Sp
+ .ne 5
+ .PP
+ \fB\\$1\fR
+ .PP
+ ..
+ .de Sp \" Vertical space (when we can't use .PP)
+ .if t .sp .5v
+ .if n .sp
+ ..
+ .de Ip \" List item
+ .br
+ .ie \\n(.$>=3 .ne \\$3
+ .el .ne 3
+ .IP "\\$1" \\$2
+ ..
+ .de Vb \" Begin verbatim text
+ .ft CW
+ .nf
+ .ne \\$1
+ ..
+ .de Ve \" End verbatim text
+ .ft R
+
+ .fi
+ ..
+ .\" Set up some character translations and predefined strings. \*(-- will
+ .\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
+ .\" double quote, and \*(R" will give a right double quote. | will give a
+ .\" real vertical bar. \*(C+ will give a nicer C++. Capital omega is used
+ .\" to do unbreakable dashes and therefore won't be available. \*(C` and
+ .\" \*(C' expand to `' in nroff, nothing in troff, for use with C<>
+ .tr \(*W-|\(bv\*(Tr
+ .ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
+ .ie n \{\
+ . ds -- \(*W-
+ . ds PI pi
+ . if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
+ . if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch
+ . ds L" ""
+ . ds R" ""
+ . ds C` ""
+ . ds C' ""
+ 'br\}
+ .el\{\
+ . ds -- \|\(em\|
+ . ds PI \(*p
+ . ds L" ``
+ . ds R" ''
+ 'br\}
+ .\"
+ .\" If the F register is turned on, we'll generate index entries on stderr
+ .\" for titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and
+ .\" index entries marked with X<> in POD. Of course, you'll have to process
+ .\" the output yourself in some meaningful fashion.
+ .if \nF \{\
+ . de IX
+ . tm Index:\\$1\t\\n%\t"\\$2"
+ ..
+ . nr % 0
+ . rr F
+ .\}
+ .\"
+ .\" For nroff, turn off justification. Always turn off hyphenation; it
+ .\" makes way too many mistakes in technical documents.
+ .hy 0
+ .if n .na
+ .\"
+ .\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
+ .\" Fear. Run. Save yourself. No user-serviceable parts.
+ .bd B 3
+ . \" fudge factors for nroff and troff
+ .if n \{\
+ . ds #H 0
+ . ds #V .8m
+ . ds #F .3m
+ . ds #[ \f1
+ . ds #] \fP
+ .\}
+ .if t \{\
+ . ds #H ((1u-(\\\\n(.fu%2u))*.13m)
+ . ds #V .6m
+ . ds #F 0
+ . ds #[ \&
+ . ds #] \&
+ .\}
+ . \" simple accents for nroff and troff
+ .if n \{\
+ . ds ' \&
+ . ds ` \&
+ . ds ^ \&
+ . ds , \&
+ . ds ~ ~
+ . ds /
+ .\}
+ .if t \{\
+ . ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
+ . ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
+ . ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
+ . ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
+ . ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
+ . ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
+ .\}
+ . \" troff and (daisy-wheel) nroff accents
+ .ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
+ .ds 8 \h'\*(#H'\(*b\h'-\*(#H'
+ .ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
+ .ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
+ .ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
+ .ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
+ .ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
+ .ds ae a\h'-(\w'a'u*4/10)'e
+ .ds Ae A\h'-(\w'A'u*4/10)'E
+ . \" corrections for vroff
+ .if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
+ .if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
+ . \" for low resolution devices (crt and lpr)
+ .if \n(.H>23 .if \n(.V>19 \
+ \{\
+ . ds : e
+ . ds 8 ss
+ . ds o a
+ . ds d- d\h'-1'\(ga
+ . ds D- D\h'-1'\(hy
+ . ds th \o'bp'
+ . ds Th \o'LP'
+ . ds ae ae
+ . ds Ae AE
+ .\}
+ .rm #[ #] #H #V #F C
+ .\" ======================================================================
+ .\"
+ .IX Title "LLVM-AS 1"
+ .TH LLVM-AS 1 "1.3" "2004-07-04" "LLVM Command Guide"
+ .UC
+ .SH "NAME"
+ llvm-as \- \s-1LLVM\s0 assembler
+ .SH "SYNOPSIS"
+ .IX Header "SYNOPSIS"
+ \&\fBllvm-as\fR [\fIoptions\fR] [\fIfilename\fR]
+ .SH "DESCRIPTION"
+ .IX Header "DESCRIPTION"
+ The \fBllvm-as\fR command invokes the \s-1LLVM\s0 assembler. It reads a file containing
+ human-readable \s-1LLVM\s0 assembly language, translates it to \s-1LLVM\s0 bytecode, and
+ writes the result into a file or to standard output.
+ .PP
+ If \fIfilename\fR is omitted or is \f(CW\*(C`\-\*(C'\fR, then \fBllvm-as\fR reads its input from
+ standard input.
+ .PP
+ If an output file is not specified with the \fB\-o\fR option, then
+ \&\fBllvm-as\fR sends its output to a file or standard output by following
+ these rules:
+ .Ip "\(bu" 4
+ If the input is standard input, then the output is standard output.
+ .Ip "\(bu" 4
+ If the input is a file that ends with \f(CW\*(C`.ll\*(C'\fR, then the output file is of
+ the same name, except that the suffix is changed to \f(CW\*(C`.bc\*(C'\fR.
+ .Ip "\(bu" 4
+ If the input is a file that does not end with the \f(CW\*(C`.ll\*(C'\fR suffix, then the
+ output file has the same name as the input file, except that the \f(CW\*(C`.bc\*(C'\fR
+ suffix is appended.
+ .SH "OPTIONS"
+ .IX Header "OPTIONS"
+ .Ip "\fB\-f\fR" 4
+ .IX Item "-f"
+ Force overwrite. Normally, \fBllvm-as\fR will refuse to overwrite an
+ output file that already exists. With this option, \fBllvm-as\fR
+ will overwrite the output file and replace it with new bytecode.
+ .Ip "\fB\*(--help\fR" 4
+ .IX Item "help"
+ Print a summary of command line options.
+ .Ip "\fB\-o\fR \fIfilename\fR" 4
+ .IX Item "-o filename"
+ Specify the output file name. If \fIfilename\fR is \f(CW\*(C`\-\*(C'\fR, then \fBllvm-as\fR
+ sends its output to standard output.
+ .Ip "\fB\*(--stats\fR" 4
+ .IX Item "stats"
+ Print statistics.
+ .Ip "\fB\*(--time-passes\fR" 4
+ .IX Item "time-passes"
+ Record the amount of time needed for each pass and print it to standard
+ error.
+ .SH "EXIT STATUS"
+ .IX Header "EXIT STATUS"
+ If \fBllvm-as\fR succeeds, it will exit with 0. Otherwise, if an error
+ occurs, it will exit with a non-zero value.
+ .SH "SEE ALSO"
+ .IX Header "SEE ALSO"
+ llvm-dis, gccas
+ .SH "AUTHORS"
+ .IX Header "AUTHORS"
+ Maintained by the \s-1LLVM\s0 Team (http://llvm.cs.uiuc.edu).
Index: llvm-www/releases/1.6/docs/CommandGuide/man/man1/llvm-bcanalyzer.1
diff -c /dev/null llvm-www/releases/1.6/docs/CommandGuide/man/man1/llvm-bcanalyzer.1:1.1
*** /dev/null Tue Nov 8 14:07:55 2005
--- llvm-www/releases/1.6/docs/CommandGuide/man/man1/llvm-bcanalyzer.1 Tue Nov 8 14:07:44 2005
***************
*** 0 ****
--- 1,190 ----
+ .\" Automatically generated by Pod::Man version 1.15
+ .\" Sat Jul 10 01:00:17 2004
+ .\"
+ .\" Standard preamble:
+ .\" ======================================================================
+ .de Sh \" Subsection heading
+ .br
+ .if t .Sp
+ .ne 5
+ .PP
+ \fB\\$1\fR
+ .PP
+ ..
+ .de Sp \" Vertical space (when we can't use .PP)
+ .if t .sp .5v
+ .if n .sp
+ ..
+ .de Ip \" List item
+ .br
+ .ie \\n(.$>=3 .ne \\$3
+ .el .ne 3
+ .IP "\\$1" \\$2
+ ..
+ .de Vb \" Begin verbatim text
+ .ft CW
+ .nf
+ .ne \\$1
+ ..
+ .de Ve \" End verbatim text
+ .ft R
+
+ .fi
+ ..
+ .\" Set up some character translations and predefined strings. \*(-- will
+ .\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
+ .\" double quote, and \*(R" will give a right double quote. | will give a
+ .\" real vertical bar. \*(C+ will give a nicer C++. Capital omega is used
+ .\" to do unbreakable dashes and therefore won't be available. \*(C` and
+ .\" \*(C' expand to `' in nroff, nothing in troff, for use with C<>
+ .tr \(*W-|\(bv\*(Tr
+ .ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
+ .ie n \{\
+ . ds -- \(*W-
+ . ds PI pi
+ . if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
+ . if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch
+ . ds L" ""
+ . ds R" ""
+ . ds C` ""
+ . ds C' ""
+ 'br\}
+ .el\{\
+ . ds -- \|\(em\|
+ . ds PI \(*p
+ . ds L" ``
+ . ds R" ''
+ 'br\}
+ .\"
+ .\" If the F register is turned on, we'll generate index entries on stderr
+ .\" for titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and
+ .\" index entries marked with X<> in POD. Of course, you'll have to process
+ .\" the output yourself in some meaningful fashion.
+ .if \nF \{\
+ . de IX
+ . tm Index:\\$1\t\\n%\t"\\$2"
+ ..
+ . nr % 0
+ . rr F
+ .\}
+ .\"
+ .\" For nroff, turn off justification. Always turn off hyphenation; it
+ .\" makes way too many mistakes in technical documents.
+ .hy 0
+ .if n .na
+ .\"
+ .\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
+ .\" Fear. Run. Save yourself. No user-serviceable parts.
+ .bd B 3
+ . \" fudge factors for nroff and troff
+ .if n \{\
+ . ds #H 0
+ . ds #V .8m
+ . ds #F .3m
+ . ds #[ \f1
+ . ds #] \fP
+ .\}
+ .if t \{\
+ . ds #H ((1u-(\\\\n(.fu%2u))*.13m)
+ . ds #V .6m
+ . ds #F 0
+ . ds #[ \&
+ . ds #] \&
+ .\}
+ . \" simple accents for nroff and troff
+ .if n \{\
+ . ds ' \&
+ . ds ` \&
+ . ds ^ \&
+ . ds , \&
+ . ds ~ ~
+ . ds /
+ .\}
+ .if t \{\
+ . ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
+ . ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
+ . ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
+ . ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
+ . ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
+ . ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
+ .\}
+ . \" troff and (daisy-wheel) nroff accents
+ .ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
+ .ds 8 \h'\*(#H'\(*b\h'-\*(#H'
+ .ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
+ .ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
+ .ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
+ .ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
+ .ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
+ .ds ae a\h'-(\w'a'u*4/10)'e
+ .ds Ae A\h'-(\w'A'u*4/10)'E
+ . \" corrections for vroff
+ .if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
+ .if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
+ . \" for low resolution devices (crt and lpr)
+ .if \n(.H>23 .if \n(.V>19 \
+ \{\
+ . ds : e
+ . ds 8 ss
+ . ds o a
+ . ds d- d\h'-1'\(ga
+ . ds D- D\h'-1'\(hy
+ . ds th \o'bp'
+ . ds Th \o'LP'
+ . ds ae ae
+ . ds Ae AE
+ .\}
+ .rm #[ #] #H #V #F C
+ .\" ======================================================================
+ .\"
+ .IX Title "LLVM-BCANALYZER 1"
+ .TH LLVM-BCANALYZER 1 "1.3" "2004-07-02" "LLVM Command Guide"
+ .UC
+ .SH "NAME"
+ llvm-bcanalyzer \- \s-1LLVM\s0 bytecode analyzer
+ .SH "SYNOPSIS"
+ .IX Header "SYNOPSIS"
+ \&\fBllvm-bcanalyzer\fR [\fIoptions\fR] [\fIfilename\fR]
+ .SH "DESCRIPTION"
+ .IX Header "DESCRIPTION"
+ The \fBllvm-bcanalyzer\fR command is a small utility for analyzing bytecode files.
+ The tool reads a bytecode file (such as generated with the \fBllvm-as\fR tool) and
+ produces a statistical report on the contents of the byteocde file. The tool
+ will also dump a low level but human readable version of the bytecode file.
+ This tool is probably not of much interest or utility except for those working
+ directly with the bytecode file format. Most \s-1LLVM\s0 users can just ignore
+ this tool.
+ .PP
+ If \fIfilename\fR is omitted or is \f(CW\*(C`\-\*(C'\fR, then \fBllvm-bcanalyzer\fR reads its input
+ from standard input. This is useful for combining the tool into a pipeline.
+ .PP
+ Output is written to the standard output.
+ .SH "OPTIONS"
+ .IX Header "OPTIONS"
+ .Ip "\fB\-nodetails\fR" 4
+ .IX Item "-nodetails"
+ Causes \fBllvm-bcanalyzer\fR to abbreviate its output by writing out only a module
+ level summary. The details for individual functions are not displayed.
+ .Ip "\fB\-dump\fR" 4
+ .IX Item "-dump"
+ Causes \fBllvm-bcanalyzer\fR to dump the bytecode in a human readable format. This
+ format is significantly different from \s-1LLVM\s0 assembly and provides details about
+ the encoding of the bytecode file.
+ .Ip "\fB\-verify\fR" 4
+ .IX Item "-verify"
+ Causes \fBllvm-bcanalyzer\fR to verify the module produced by by reading the
+ bytecode. This ensures that the statistics generated are based on a consistent
+ module.
+ .Ip "\fB\*(--help\fR" 4
+ .IX Item "help"
+ Print a summary of command line options.
+ .SH "EXIT STATUS"
+ .IX Header "EXIT STATUS"
+ If \fBllvm-bcanalyzer\fR succeeds, it will exit with 0. Otherwise, if an error
+ occurs, it will exit with a non-zero value, usually 1.
+ .SH "SEE ALSO"
+ .IX Header "SEE ALSO"
+ llvm-dis, http://llvm.cs.uiuc.edu/docs/BytecodeFormat.html
+ .SH "AUTHORS"
+ .IX Header "AUTHORS"
+ Maintained by the \s-1LLVM\s0 Team (http://llvm.cs.uiuc.edu).
Index: llvm-www/releases/1.6/docs/CommandGuide/man/man1/llvm-db.1
diff -c /dev/null llvm-www/releases/1.6/docs/CommandGuide/man/man1/llvm-db.1:1.1
*** /dev/null Tue Nov 8 14:07:55 2005
--- llvm-www/releases/1.6/docs/CommandGuide/man/man1/llvm-db.1 Tue Nov 8 14:07:44 2005
***************
*** 0 ****
--- 1,151 ----
+ .\" Automatically generated by Pod::Man version 1.15
+ .\" Sat Jul 10 01:00:17 2004
+ .\"
+ .\" Standard preamble:
+ .\" ======================================================================
+ .de Sh \" Subsection heading
+ .br
+ .if t .Sp
+ .ne 5
+ .PP
+ \fB\\$1\fR
+ .PP
+ ..
+ .de Sp \" Vertical space (when we can't use .PP)
+ .if t .sp .5v
+ .if n .sp
+ ..
+ .de Ip \" List item
+ .br
+ .ie \\n(.$>=3 .ne \\$3
+ .el .ne 3
+ .IP "\\$1" \\$2
+ ..
+ .de Vb \" Begin verbatim text
+ .ft CW
+ .nf
+ .ne \\$1
+ ..
+ .de Ve \" End verbatim text
+ .ft R
+
+ .fi
+ ..
+ .\" Set up some character translations and predefined strings. \*(-- will
+ .\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
+ .\" double quote, and \*(R" will give a right double quote. | will give a
+ .\" real vertical bar. \*(C+ will give a nicer C++. Capital omega is used
+ .\" to do unbreakable dashes and therefore won't be available. \*(C` and
+ .\" \*(C' expand to `' in nroff, nothing in troff, for use with C<>
+ .tr \(*W-|\(bv\*(Tr
+ .ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
+ .ie n \{\
+ . ds -- \(*W-
+ . ds PI pi
+ . if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
+ . if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch
+ . ds L" ""
+ . ds R" ""
+ . ds C` ""
+ . ds C' ""
+ 'br\}
+ .el\{\
+ . ds -- \|\(em\|
+ . ds PI \(*p
+ . ds L" ``
+ . ds R" ''
+ 'br\}
+ .\"
+ .\" If the F register is turned on, we'll generate index entries on stderr
+ .\" for titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and
+ .\" index entries marked with X<> in POD. Of course, you'll have to process
+ .\" the output yourself in some meaningful fashion.
+ .if \nF \{\
+ . de IX
+ . tm Index:\\$1\t\\n%\t"\\$2"
+ ..
+ . nr % 0
+ . rr F
+ .\}
+ .\"
+ .\" For nroff, turn off justification. Always turn off hyphenation; it
+ .\" makes way too many mistakes in technical documents.
+ .hy 0
+ .if n .na
+ .\"
+ .\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
+ .\" Fear. Run. Save yourself. No user-serviceable parts.
+ .bd B 3
+ . \" fudge factors for nroff and troff
+ .if n \{\
+ . ds #H 0
+ . ds #V .8m
+ . ds #F .3m
+ . ds #[ \f1
+ . ds #] \fP
+ .\}
+ .if t \{\
+ . ds #H ((1u-(\\\\n(.fu%2u))*.13m)
+ . ds #V .6m
+ . ds #F 0
+ . ds #[ \&
+ . ds #] \&
+ .\}
+ . \" simple accents for nroff and troff
+ .if n \{\
+ . ds ' \&
+ . ds ` \&
+ . ds ^ \&
+ . ds , \&
+ . ds ~ ~
+ . ds /
+ .\}
+ .if t \{\
+ . ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
+ . ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
+ . ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
+ . ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
+ . ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
+ . ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
+ .\}
+ . \" troff and (daisy-wheel) nroff accents
+ .ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
+ .ds 8 \h'\*(#H'\(*b\h'-\*(#H'
+ .ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
+ .ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
+ .ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
+ .ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
+ .ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
+ .ds ae a\h'-(\w'a'u*4/10)'e
+ .ds Ae A\h'-(\w'A'u*4/10)'E
+ . \" corrections for vroff
+ .if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
+ .if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
+ . \" for low resolution devices (crt and lpr)
+ .if \n(.H>23 .if \n(.V>19 \
+ \{\
+ . ds : e
+ . ds 8 ss
+ . ds o a
+ . ds d- d\h'-1'\(ga
+ . ds D- D\h'-1'\(hy
+ . ds th \o'bp'
+ . ds Th \o'LP'
+ . ds ae ae
+ . ds Ae AE
+ .\}
+ .rm #[ #] #H #V #F C
+ .\" ======================================================================
+ .\"
+ .IX Title "LLVM-DB 1"
+ .TH LLVM-DB 1 "1.3" "2004-07-04" "LLVM Command Guide"
+ .UC
+ .SH "NAME"
+ llvm-db \- \s-1LLVM\s0 debugger (alpha)
+ .SH "SYNOPSIS"
+ .IX Header "SYNOPSIS"
+ Details coming soon. Please see
+ http://llvm.cs.uiuc.edu/docs/SourceLevelDebugging.html in the meantime.
+ .SH "AUTHORS"
+ .IX Header "AUTHORS"
+ Maintained by the \s-1LLVM\s0 Team (http://llvm.cs.uiuc.edu).
Index: llvm-www/releases/1.6/docs/CommandGuide/man/man1/llvm-dis.1
diff -c /dev/null llvm-www/releases/1.6/docs/CommandGuide/man/man1/llvm-dis.1:1.1
*** /dev/null Tue Nov 8 14:07:55 2005
--- llvm-www/releases/1.6/docs/CommandGuide/man/man1/llvm-dis.1 Tue Nov 8 14:07:44 2005
***************
*** 0 ****
--- 1,189 ----
+ .\" Automatically generated by Pod::Man version 1.15
+ .\" Sat Jul 10 01:00:17 2004
+ .\"
+ .\" Standard preamble:
+ .\" ======================================================================
+ .de Sh \" Subsection heading
+ .br
+ .if t .Sp
+ .ne 5
+ .PP
+ \fB\\$1\fR
+ .PP
+ ..
+ .de Sp \" Vertical space (when we can't use .PP)
+ .if t .sp .5v
+ .if n .sp
+ ..
+ .de Ip \" List item
+ .br
+ .ie \\n(.$>=3 .ne \\$3
+ .el .ne 3
+ .IP "\\$1" \\$2
+ ..
+ .de Vb \" Begin verbatim text
+ .ft CW
+ .nf
+ .ne \\$1
+ ..
+ .de Ve \" End verbatim text
+ .ft R
+
+ .fi
+ ..
+ .\" Set up some character translations and predefined strings. \*(-- will
+ .\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
+ .\" double quote, and \*(R" will give a right double quote. | will give a
+ .\" real vertical bar. \*(C+ will give a nicer C++. Capital omega is used
+ .\" to do unbreakable dashes and therefore won't be available. \*(C` and
+ .\" \*(C' expand to `' in nroff, nothing in troff, for use with C<>
+ .tr \(*W-|\(bv\*(Tr
+ .ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
+ .ie n \{\
+ . ds -- \(*W-
+ . ds PI pi
+ . if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
+ . if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch
+ . ds L" ""
+ . ds R" ""
+ . ds C` ""
+ . ds C' ""
+ 'br\}
+ .el\{\
+ . ds -- \|\(em\|
+ . ds PI \(*p
+ . ds L" ``
+ . ds R" ''
+ 'br\}
+ .\"
+ .\" If the F register is turned on, we'll generate index entries on stderr
+ .\" for titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and
+ .\" index entries marked with X<> in POD. Of course, you'll have to process
+ .\" the output yourself in some meaningful fashion.
+ .if \nF \{\
+ . de IX
+ . tm Index:\\$1\t\\n%\t"\\$2"
+ ..
+ . nr % 0
+ . rr F
+ .\}
+ .\"
+ .\" For nroff, turn off justification. Always turn off hyphenation; it
+ .\" makes way too many mistakes in technical documents.
+ .hy 0
+ .if n .na
+ .\"
+ .\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
+ .\" Fear. Run. Save yourself. No user-serviceable parts.
+ .bd B 3
+ . \" fudge factors for nroff and troff
+ .if n \{\
+ . ds #H 0
+ . ds #V .8m
+ . ds #F .3m
+ . ds #[ \f1
+ . ds #] \fP
+ .\}
+ .if t \{\
+ . ds #H ((1u-(\\\\n(.fu%2u))*.13m)
+ . ds #V .6m
+ . ds #F 0
+ . ds #[ \&
+ . ds #] \&
+ .\}
+ . \" simple accents for nroff and troff
+ .if n \{\
+ . ds ' \&
+ . ds ` \&
+ . ds ^ \&
+ . ds , \&
+ . ds ~ ~
+ . ds /
+ .\}
+ .if t \{\
+ . ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
+ . ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
+ . ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
+ . ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
+ . ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
+ . ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
+ .\}
+ . \" troff and (daisy-wheel) nroff accents
+ .ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
+ .ds 8 \h'\*(#H'\(*b\h'-\*(#H'
+ .ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
+ .ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
+ .ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
+ .ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
+ .ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
+ .ds ae a\h'-(\w'a'u*4/10)'e
+ .ds Ae A\h'-(\w'A'u*4/10)'E
+ . \" corrections for vroff
+ .if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
+ .if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
+ . \" for low resolution devices (crt and lpr)
+ .if \n(.H>23 .if \n(.V>19 \
+ \{\
+ . ds : e
+ . ds 8 ss
+ . ds o a
+ . ds d- d\h'-1'\(ga
+ . ds D- D\h'-1'\(hy
+ . ds th \o'bp'
+ . ds Th \o'LP'
+ . ds ae ae
+ . ds Ae AE
+ .\}
+ .rm #[ #] #H #V #F C
+ .\" ======================================================================
+ .\"
+ .IX Title "LLVM-DIS 1"
+ .TH LLVM-DIS 1 "1.3" "2004-07-04" "LLVM Command Guide"
+ .UC
+ .SH "NAME"
+ llvm-dis \- \s-1LLVM\s0 disassembler
+ .SH "SYNOPSIS"
+ .IX Header "SYNOPSIS"
+ \&\fBllvm-dis\fR [\fIoptions\fR] [\fIfilename\fR]
+ .SH "DESCRIPTION"
+ .IX Header "DESCRIPTION"
+ The \fBllvm-dis\fR command is the \s-1LLVM\s0 disassembler. It takes an \s-1LLVM\s0
+ bytecode file and converts it into human-readable \s-1LLVM\s0 assembly language.
+ .PP
+ If filename is omitted or specified as \f(CW\*(C`\-\*(C'\fR, \fBllvm-dis\fR reads its
+ input from standard input.
+ .PP
+ If the input is being read from standard input, then \fBllvm-dis\fR
+ will send its output to standard output by default. Otherwise, the
+ output will be written to a file named after the input file, with
+ a \f(CW\*(C`.ll\*(C'\fR suffix added (any existing \f(CW\*(C`.bc\*(C'\fR suffix will first be
+ removed). You can override the choice of output file using the
+ \&\fB\-o\fR option.
+ .SH "OPTIONS"
+ .IX Header "OPTIONS"
+ .Ip "\fB\-f\fR" 4
+ .IX Item "-f"
+ Force overwrite. Normally, \fBllvm-dis\fR will refuse to overwrite
+ an output file that already exists. With this option, \fBllvm-dis\fR
+ will overwrite the output file.
+ .Ip "\fB\*(--help\fR" 4
+ .IX Item "help"
+ Print a summary of command line options.
+ .Ip "\fB\-o\fR \fIfilename\fR" 4
+ .IX Item "-o filename"
+ Specify the output file name. If \fIfilename\fR is \-, then the output is sent
+ to standard output.
+ .Ip "\fB\-time-passes\fR" 4
+ .IX Item "-time-passes"
+ Record the amount of time needed for each pass and print it to standard
+ error.
+ .SH "EXIT STATUS"
+ .IX Header "EXIT STATUS"
+ If \fBllvm-dis\fR succeeds, it will exit with 0. Otherwise, if an error
+ occurs, it will exit with a non-zero value.
+ .SH "SEE ALSO"
+ .IX Header "SEE ALSO"
+ llvm-as
+ .SH "AUTHORS"
+ .IX Header "AUTHORS"
+ Maintained by the \s-1LLVM\s0 Team (http://llvm.cs.uiuc.edu).
Index: llvm-www/releases/1.6/docs/CommandGuide/man/man1/llvm-link.1
diff -c /dev/null llvm-www/releases/1.6/docs/CommandGuide/man/man1/llvm-link.1:1.1
*** /dev/null Tue Nov 8 14:07:55 2005
--- llvm-www/releases/1.6/docs/CommandGuide/man/man1/llvm-link.1 Tue Nov 8 14:07:44 2005
***************
*** 0 ****
--- 1,196 ----
+ .\" Automatically generated by Pod::Man version 1.15
+ .\" Sat Jul 10 01:00:17 2004
+ .\"
+ .\" Standard preamble:
+ .\" ======================================================================
+ .de Sh \" Subsection heading
+ .br
+ .if t .Sp
+ .ne 5
+ .PP
+ \fB\\$1\fR
+ .PP
+ ..
+ .de Sp \" Vertical space (when we can't use .PP)
+ .if t .sp .5v
+ .if n .sp
+ ..
+ .de Ip \" List item
+ .br
+ .ie \\n(.$>=3 .ne \\$3
+ .el .ne 3
+ .IP "\\$1" \\$2
+ ..
+ .de Vb \" Begin verbatim text
+ .ft CW
+ .nf
+ .ne \\$1
+ ..
+ .de Ve \" End verbatim text
+ .ft R
+
+ .fi
+ ..
+ .\" Set up some character translations and predefined strings. \*(-- will
+ .\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
+ .\" double quote, and \*(R" will give a right double quote. | will give a
+ .\" real vertical bar. \*(C+ will give a nicer C++. Capital omega is used
+ .\" to do unbreakable dashes and therefore won't be available. \*(C` and
+ .\" \*(C' expand to `' in nroff, nothing in troff, for use with C<>
+ .tr \(*W-|\(bv\*(Tr
+ .ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
+ .ie n \{\
+ . ds -- \(*W-
+ . ds PI pi
+ . if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
+ . if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch
+ . ds L" ""
+ . ds R" ""
+ . ds C` ""
+ . ds C' ""
+ 'br\}
+ .el\{\
+ . ds -- \|\(em\|
+ . ds PI \(*p
+ . ds L" ``
+ . ds R" ''
+ 'br\}
+ .\"
+ .\" If the F register is turned on, we'll generate index entries on stderr
+ .\" for titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and
+ .\" index entries marked with X<> in POD. Of course, you'll have to process
+ .\" the output yourself in some meaningful fashion.
+ .if \nF \{\
+ . de IX
+ . tm Index:\\$1\t\\n%\t"\\$2"
+ ..
+ . nr % 0
+ . rr F
+ .\}
+ .\"
+ .\" For nroff, turn off justification. Always turn off hyphenation; it
+ .\" makes way too many mistakes in technical documents.
+ .hy 0
+ .if n .na
+ .\"
+ .\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
+ .\" Fear. Run. Save yourself. No user-serviceable parts.
+ .bd B 3
+ . \" fudge factors for nroff and troff
+ .if n \{\
+ . ds #H 0
+ . ds #V .8m
+ . ds #F .3m
+ . ds #[ \f1
+ . ds #] \fP
+ .\}
+ .if t \{\
+ . ds #H ((1u-(\\\\n(.fu%2u))*.13m)
+ . ds #V .6m
+ . ds #F 0
+ . ds #[ \&
+ . ds #] \&
+ .\}
+ . \" simple accents for nroff and troff
+ .if n \{\
+ . ds ' \&
+ . ds ` \&
+ . ds ^ \&
+ . ds , \&
+ . ds ~ ~
+ . ds /
+ .\}
+ .if t \{\
+ . ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
+ . ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
+ . ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
+ . ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
+ . ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
+ . ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
+ .\}
+ . \" troff and (daisy-wheel) nroff accents
+ .ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
+ .ds 8 \h'\*(#H'\(*b\h'-\*(#H'
+ .ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
+ .ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
+ .ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
+ .ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
+ .ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
+ .ds ae a\h'-(\w'a'u*4/10)'e
+ .ds Ae A\h'-(\w'A'u*4/10)'E
+ . \" corrections for vroff
+ .if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
+ .if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
+ . \" for low resolution devices (crt and lpr)
+ .if \n(.H>23 .if \n(.V>19 \
+ \{\
+ . ds : e
+ . ds 8 ss
+ . ds o a
+ . ds d- d\h'-1'\(ga
+ . ds D- D\h'-1'\(hy
+ . ds th \o'bp'
+ . ds Th \o'LP'
+ . ds ae ae
+ . ds Ae AE
+ .\}
+ .rm #[ #] #H #V #F C
+ .\" ======================================================================
+ .\"
+ .IX Title "LLVM-LINK 1"
+ .TH LLVM-LINK 1 "1.3" "2004-07-04" "LLVM Command Guide"
+ .UC
+ .SH "NAME"
+ llvm-link \- \s-1LLVM\s0 linker
+ .SH "SYNOPSIS"
+ .IX Header "SYNOPSIS"
+ \&\fBllvm-link\fR [\fIoptions\fR] \fIfilename ...\fR
+ .SH "DESCRIPTION"
+ .IX Header "DESCRIPTION"
+ The \fBllvm-link\fR command takes several \s-1LLVM\s0 bytecode files and links them
+ together into a single \s-1LLVM\s0 bytecode file. It writes the output file to
+ standard output, unless the \fB\-o\fR option is used to specify a filename.
+ .PP
+ The \fBllvm-link\fR command attempts to load the input files from the current
+ directory. If that fails, it looks for each file in each of the directories
+ specified by the \fB\-L\fR options on the command line. The library search paths
+ are global; each one is searched for every input file if necessary. The
+ directories are searched in the order they were specified on the command line.
+ .SH "OPTIONS"
+ .IX Header "OPTIONS"
+ .Ip "\fB\-L\fR \fIdirectory\fR" 4
+ .IX Item "-L directory"
+ Add the specified \fIdirectory\fR to the library search path. When looking for
+ libraries, \fBllvm-link\fR will look in pathname for libraries. This option can be
+ specified multiple times; \fBllvm-link\fR will search inside these directories in
+ the order in which they were specified on the command line.
+ .Ip "\fB\-f\fR" 4
+ .IX Item "-f"
+ Overwrite output files. By default, \fBllvm-link\fR will not overwrite an output
+ file if it alreadys exists.
+ .Ip "\fB\-o\fR \fIfilename\fR" 4
+ .IX Item "-o filename"
+ Specify the output file name. If \fIfilename\fR is \f(CW\*(C`\-\*(C'\fR, then \fBllvm-link\fR will
+ write its output to standard output.
+ .Ip "\fB\-d\fR" 4
+ .IX Item "-d"
+ If specified, \fBllvm-link\fR prints a human-readable version of the output
+ bytecode file to standard error.
+ .Ip "\fB\*(--help\fR" 4
+ .IX Item "help"
+ Print a summary of command line options.
+ .Ip "\fB\-v\fR" 4
+ .IX Item "-v"
+ Verbose mode. Print information about what \fBllvm-link\fR is doing. This
+ typically includes a message for each bytecode file linked in and for each
+ library found.
+ .SH "EXIT STATUS"
+ .IX Header "EXIT STATUS"
+ If \fBllvm-link\fR succeeds, it will exit with 0. Otherwise, if an error
+ occurs, it will exit with a non-zero value.
+ .SH "SEE ALSO"
+ .IX Header "SEE ALSO"
+ the gccld manpage
+ .SH "AUTHORS"
+ .IX Header "AUTHORS"
+ Maintained by the \s-1LLVM\s0 Team (http://llvm.cs.uiuc.edu).
Index: llvm-www/releases/1.6/docs/CommandGuide/man/man1/llvm-nm.1
diff -c /dev/null llvm-www/releases/1.6/docs/CommandGuide/man/man1/llvm-nm.1:1.1
*** /dev/null Tue Nov 8 14:07:55 2005
--- llvm-www/releases/1.6/docs/CommandGuide/man/man1/llvm-nm.1 Tue Nov 8 14:07:44 2005
***************
*** 0 ****
--- 1,229 ----
+ .\" Automatically generated by Pod::Man version 1.15
+ .\" Sat Jul 10 01:00:17 2004
+ .\"
+ .\" Standard preamble:
+ .\" ======================================================================
+ .de Sh \" Subsection heading
+ .br
+ .if t .Sp
+ .ne 5
+ .PP
+ \fB\\$1\fR
+ .PP
+ ..
+ .de Sp \" Vertical space (when we can't use .PP)
+ .if t .sp .5v
+ .if n .sp
+ ..
+ .de Ip \" List item
+ .br
+ .ie \\n(.$>=3 .ne \\$3
+ .el .ne 3
+ .IP "\\$1" \\$2
+ ..
+ .de Vb \" Begin verbatim text
+ .ft CW
+ .nf
+ .ne \\$1
+ ..
+ .de Ve \" End verbatim text
+ .ft R
+
+ .fi
+ ..
+ .\" Set up some character translations and predefined strings. \*(-- will
+ .\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
+ .\" double quote, and \*(R" will give a right double quote. | will give a
+ .\" real vertical bar. \*(C+ will give a nicer C++. Capital omega is used
+ .\" to do unbreakable dashes and therefore won't be available. \*(C` and
+ .\" \*(C' expand to `' in nroff, nothing in troff, for use with C<>
+ .tr \(*W-|\(bv\*(Tr
+ .ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
+ .ie n \{\
+ . ds -- \(*W-
+ . ds PI pi
+ . if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
+ . if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch
+ . ds L" ""
+ . ds R" ""
+ . ds C` ""
+ . ds C' ""
+ 'br\}
+ .el\{\
+ . ds -- \|\(em\|
+ . ds PI \(*p
+ . ds L" ``
+ . ds R" ''
+ 'br\}
+ .\"
+ .\" If the F register is turned on, we'll generate index entries on stderr
+ .\" for titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and
+ .\" index entries marked with X<> in POD. Of course, you'll have to process
+ .\" the output yourself in some meaningful fashion.
+ .if \nF \{\
+ . de IX
+ . tm Index:\\$1\t\\n%\t"\\$2"
+ ..
+ . nr % 0
+ . rr F
+ .\}
+ .\"
+ .\" For nroff, turn off justification. Always turn off hyphenation; it
+ .\" makes way too many mistakes in technical documents.
+ .hy 0
+ .if n .na
+ .\"
+ .\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
+ .\" Fear. Run. Save yourself. No user-serviceable parts.
+ .bd B 3
+ . \" fudge factors for nroff and troff
+ .if n \{\
+ . ds #H 0
+ . ds #V .8m
+ . ds #F .3m
+ . ds #[ \f1
+ . ds #] \fP
+ .\}
+ .if t \{\
+ . ds #H ((1u-(\\\\n(.fu%2u))*.13m)
+ . ds #V .6m
+ . ds #F 0
+ . ds #[ \&
+ . ds #] \&
+ .\}
+ . \" simple accents for nroff and troff
+ .if n \{\
+ . ds ' \&
+ . ds ` \&
+ . ds ^ \&
+ . ds , \&
+ . ds ~ ~
+ . ds /
+ .\}
+ .if t \{\
+ . ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
+ . ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
+ . ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
+ . ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
+ . ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
+ . ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
+ .\}
+ . \" troff and (daisy-wheel) nroff accents
+ .ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
+ .ds 8 \h'\*(#H'\(*b\h'-\*(#H'
+ .ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
+ .ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
+ .ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
+ .ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
+ .ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
+ .ds ae a\h'-(\w'a'u*4/10)'e
+ .ds Ae A\h'-(\w'A'u*4/10)'E
+ . \" corrections for vroff
+ .if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
+ .if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
+ . \" for low resolution devices (crt and lpr)
+ .if \n(.H>23 .if \n(.V>19 \
+ \{\
+ . ds : e
+ . ds 8 ss
+ . ds o a
+ . ds d- d\h'-1'\(ga
+ . ds D- D\h'-1'\(hy
+ . ds th \o'bp'
+ . ds Th \o'LP'
+ . ds ae ae
+ . ds Ae AE
+ .\}
+ .rm #[ #] #H #V #F C
+ .\" ======================================================================
+ .\"
+ .IX Title "LLVM-NM 1"
+ .TH LLVM-NM 1 "1.3" "2004-07-04" "LLVM Command Guide"
+ .UC
+ .SH "NAME"
+ llvm-nm \- list \s-1LLVM\s0 bytecode file's symbol table
+ .SH "SYNOPSIS"
+ .IX Header "SYNOPSIS"
+ \&\fBllvm-nm\fR [\fIoptions\fR] [\fIfilenames...\fR]
+ .SH "DESCRIPTION"
+ .IX Header "DESCRIPTION"
+ The \fBllvm-nm\fR utility lists the names of symbols from the \s-1LLVM\s0 bytecode files,
+ or \fBar\fR archives containing \s-1LLVM\s0 bytecode files, named on the command line.
+ Each symbol is listed along with some simple information about its provenance.
+ If no filename is specified, or \fI-\fR is used as a filename, \fBllvm-nm\fR will
+ process a bytecode file on its standard input stream.
+ .PP
+ \&\fBllvm-nm\fR's default output format is the traditional \s-1BSD\s0 \fBnm\fR output format.
+ Each such output record consists of an (optional) 8\-digit hexadecimal address,
+ followed by a type code character, followed by a name, for each symbol. One
+ record is printed per line; fields are separated by spaces. When the address is
+ omitted, it is replaced by 8 spaces.
+ .PP
+ Type code characters currently supported, and their meanings, are as follows:
+ .Ip "U" 4
+ .IX Item "U"
+ Named object is referenced but undefined in this bytecode file
+ .Ip "C" 4
+ .IX Item "C"
+ Common (multiple defs link together into one def)
+ .Ip "W" 4
+ .IX Item "W"
+ Weak reference (multiple defs link together into zero or one defs)
+ .Ip "t" 4
+ .IX Item "t"
+ Local function (text) object
+ .Ip "T" 4
+ .IX Item "T"
+ Global function (text) object
+ .Ip "d" 4
+ .IX Item "d"
+ Local data object
+ .Ip "D" 4
+ .IX Item "D"
+ Global data object
+ .Ip "?" 4
+ Something unrecognizable
+ .PP
+ Because \s-1LLVM\s0 bytecode files typically contain objects that are not considered to
+ have addresses until they are linked into an executable image or dynamically
+ compiled \*(L"just-in-time\*(R", \fBllvm-nm\fR does not print an address for any symbol,
+ even symbols which are defined in the bytecode file.
+ .SH "OPTIONS"
+ .IX Header "OPTIONS"
+ .Ip "\fB\-P\fR" 4
+ .IX Item "-P"
+ Use \s-1POSIX\s0.2 output format. Alias for \fB\*(--format=posix\fR.
+ .Ip "\fB\-B\fR (default)" 4
+ .IX Item "-B (default)"
+ Use \s-1BSD\s0 output format. Alias for \fB\*(--format=bsd\fR.
+ .Ip "\fB\*(--help\fR" 4
+ .IX Item "help"
+ Print a summary of command-line options and their meanings.
+ .Ip "\fB\*(--defined-only\fR" 4
+ .IX Item "defined-only"
+ Print only symbols defined in this bytecode file (as opposed to
+ symbols which may be referenced by objects in this file, but not
+ defined in this file.)
+ .Ip "\fB\*(--extern-only\fR, \fB\-g\fR" 4
+ .IX Item "extern-only, -g"
+ Print only symbols whose definitions are external; that is, accessible
+ from other bytecode files.
+ .Ip "\fB\*(--undefined-only\fR, \fB\-u\fR" 4
+ .IX Item "undefined-only, -u"
+ Print only symbols referenced but not defined in this bytecode file.
+ .Ip "\fB\*(--format=\fR\fIfmt\fR, \fB\-f\fR" 4
+ .IX Item "format=fmt, -f"
+ Select an output format; \fIfmt\fR may be \fIsysv\fR, \fIposix\fR, or \fIbsd\fR. The
+ default is \fIbsd\fR.
+ .SH "BUGS"
+ .IX Header "BUGS"
+ \&\fBllvm-nm\fR cannot demangle \*(C+ mangled names, like \s-1GNU\s0 \fBnm\fR can.
+ .SH "EXIT STATUS"
+ .IX Header "EXIT STATUS"
+ \&\fBllvm-nm\fR exits with an exit code of zero.
+ .SH "SEE ALSO"
+ .IX Header "SEE ALSO"
+ llvm-dis, \fIar\fR\|(1), \fInm\fR\|(1)
+ .SH "AUTHOR"
+ .IX Header "AUTHOR"
+ Maintained by the \s-1LLVM\s0 Team (http://llvm.cs.uiuc.edu).
Index: llvm-www/releases/1.6/docs/CommandGuide/man/man1/llvm-prof.1
diff -c /dev/null llvm-www/releases/1.6/docs/CommandGuide/man/man1/llvm-prof.1:1.1
*** /dev/null Tue Nov 8 14:07:55 2005
--- llvm-www/releases/1.6/docs/CommandGuide/man/man1/llvm-prof.1 Tue Nov 8 14:07:44 2005
***************
*** 0 ****
--- 1,183 ----
+ .\" Automatically generated by Pod::Man version 1.15
+ .\" Sat Jul 10 01:00:17 2004
+ .\"
+ .\" Standard preamble:
+ .\" ======================================================================
+ .de Sh \" Subsection heading
+ .br
+ .if t .Sp
+ .ne 5
+ .PP
+ \fB\\$1\fR
+ .PP
+ ..
+ .de Sp \" Vertical space (when we can't use .PP)
+ .if t .sp .5v
+ .if n .sp
+ ..
+ .de Ip \" List item
+ .br
+ .ie \\n(.$>=3 .ne \\$3
+ .el .ne 3
+ .IP "\\$1" \\$2
+ ..
+ .de Vb \" Begin verbatim text
+ .ft CW
+ .nf
+ .ne \\$1
+ ..
+ .de Ve \" End verbatim text
+ .ft R
+
+ .fi
+ ..
+ .\" Set up some character translations and predefined strings. \*(-- will
+ .\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
+ .\" double quote, and \*(R" will give a right double quote. | will give a
+ .\" real vertical bar. \*(C+ will give a nicer C++. Capital omega is used
+ .\" to do unbreakable dashes and therefore won't be available. \*(C` and
+ .\" \*(C' expand to `' in nroff, nothing in troff, for use with C<>
+ .tr \(*W-|\(bv\*(Tr
+ .ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
+ .ie n \{\
+ . ds -- \(*W-
+ . ds PI pi
+ . if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
+ . if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch
+ . ds L" ""
+ . ds R" ""
+ . ds C` ""
+ . ds C' ""
+ 'br\}
+ .el\{\
+ . ds -- \|\(em\|
+ . ds PI \(*p
+ . ds L" ``
+ . ds R" ''
+ 'br\}
+ .\"
+ .\" If the F register is turned on, we'll generate index entries on stderr
+ .\" for titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and
+ .\" index entries marked with X<> in POD. Of course, you'll have to process
+ .\" the output yourself in some meaningful fashion.
+ .if \nF \{\
+ . de IX
+ . tm Index:\\$1\t\\n%\t"\\$2"
+ ..
+ . nr % 0
+ . rr F
+ .\}
+ .\"
+ .\" For nroff, turn off justification. Always turn off hyphenation; it
+ .\" makes way too many mistakes in technical documents.
+ .hy 0
+ .if n .na
+ .\"
+ .\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
+ .\" Fear. Run. Save yourself. No user-serviceable parts.
+ .bd B 3
+ . \" fudge factors for nroff and troff
+ .if n \{\
+ . ds #H 0
+ . ds #V .8m
+ . ds #F .3m
+ . ds #[ \f1
+ . ds #] \fP
+ .\}
+ .if t \{\
+ . ds #H ((1u-(\\\\n(.fu%2u))*.13m)
+ . ds #V .6m
+ . ds #F 0
+ . ds #[ \&
+ . ds #] \&
+ .\}
+ . \" simple accents for nroff and troff
+ .if n \{\
+ . ds ' \&
+ . ds ` \&
+ . ds ^ \&
+ . ds , \&
+ . ds ~ ~
+ . ds /
+ .\}
+ .if t \{\
+ . ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
+ . ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
+ . ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
+ . ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
+ . ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
+ . ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
+ .\}
+ . \" troff and (daisy-wheel) nroff accents
+ .ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
+ .ds 8 \h'\*(#H'\(*b\h'-\*(#H'
+ .ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
+ .ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
+ .ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
+ .ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
+ .ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
+ .ds ae a\h'-(\w'a'u*4/10)'e
+ .ds Ae A\h'-(\w'A'u*4/10)'E
+ . \" corrections for vroff
+ .if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
+ .if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
+ . \" for low resolution devices (crt and lpr)
+ .if \n(.H>23 .if \n(.V>19 \
+ \{\
+ . ds : e
+ . ds 8 ss
+ . ds o a
+ . ds d- d\h'-1'\(ga
+ . ds D- D\h'-1'\(hy
+ . ds th \o'bp'
+ . ds Th \o'LP'
+ . ds ae ae
+ . ds Ae AE
+ .\}
+ .rm #[ #] #H #V #F C
+ .\" ======================================================================
+ .\"
+ .IX Title "LLVM-PROF 1"
+ .TH LLVM-PROF 1 "1.3" "2004-07-04" "LLVM Command Guide"
+ .UC
+ .SH "NAME"
+ llvm-prof \- print execution profile of \s-1LLVM\s0 program
+ .SH "SYNOPSIS"
+ .IX Header "SYNOPSIS"
+ \&\fBllvm-prof\fR [\fIoptions\fR] [\fIbytecode file\fR] [\fIllvmprof.out\fR]
+ .SH "DESCRIPTION"
+ .IX Header "DESCRIPTION"
+ The \fBllvm-prof\fR tool reads in an \fIllvmprof.out\fR file (which can
+ optionally use a specific file with the third program argument), a bytecode file
+ for the program, and produces a human readable report, suitable for determining
+ where the program hotspots are.
+ .PP
+ This program is often used in conjunction with the \fIutils/profile.pl\fR
+ script. This script automatically instruments a program, runs it with the \s-1JIT\s0,
+ then runs \fBllvm-prof\fR to format a report. To get more information about
+ \&\fIutils/profile.pl\fR, execute it with the \fB\*(--help\fR option.
+ .SH "OPTIONS"
+ .IX Header "OPTIONS"
+ .Ip "\fB\*(--annotated-llvm\fR or \fB\-A\fR" 4
+ .IX Item "annotated-llvm or -A"
+ In addition to the normal report printed, print out the code for the
+ program, annotated with execution frequency information. This can be
+ particularly useful when trying to visualize how frequently basic blocks
+ are executed. This is most useful with basic block profiling
+ information or better.
+ .Ip "\fB\*(--print-all-code\fR" 4
+ .IX Item "print-all-code"
+ Using this option enables the \fB\*(--annotated-llvm\fR option, but it
+ prints the entire module, instead of just the most commonly executed
+ functions.
+ .Ip "\fB\*(--time-passes\fR" 4
+ .IX Item "time-passes"
+ Record the amount of time needed for each pass and print it to standard
+ error.
+ .SH "EXIT STATUS"
+ .IX Header "EXIT STATUS"
+ \&\fBllvm-prof|llvm-prof\fR returns 1 if it cannot load the bytecode file or the
+ profile information. Otherwise, it exits with zero.
+ .SH "AUTHOR"
+ .IX Header "AUTHOR"
+ \&\fBllvm-prof\fR is maintained by the \s-1LLVM\s0 Team (http://llvm.cs.uiuc.edu).
Index: llvm-www/releases/1.6/docs/CommandGuide/man/man1/llvmgcc.1
diff -c /dev/null llvm-www/releases/1.6/docs/CommandGuide/man/man1/llvmgcc.1:1.1
*** /dev/null Tue Nov 8 14:07:55 2005
--- llvm-www/releases/1.6/docs/CommandGuide/man/man1/llvmgcc.1 Tue Nov 8 14:07:44 2005
***************
*** 0 ****
--- 1,206 ----
+ .\" Automatically generated by Pod::Man version 1.15
+ .\" Sat Jul 10 01:00:17 2004
+ .\"
+ .\" Standard preamble:
+ .\" ======================================================================
+ .de Sh \" Subsection heading
+ .br
+ .if t .Sp
+ .ne 5
+ .PP
+ \fB\\$1\fR
+ .PP
+ ..
+ .de Sp \" Vertical space (when we can't use .PP)
+ .if t .sp .5v
+ .if n .sp
+ ..
+ .de Ip \" List item
+ .br
+ .ie \\n(.$>=3 .ne \\$3
+ .el .ne 3
+ .IP "\\$1" \\$2
+ ..
+ .de Vb \" Begin verbatim text
+ .ft CW
+ .nf
+ .ne \\$1
+ ..
+ .de Ve \" End verbatim text
+ .ft R
+
+ .fi
+ ..
+ .\" Set up some character translations and predefined strings. \*(-- will
+ .\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
+ .\" double quote, and \*(R" will give a right double quote. | will give a
+ .\" real vertical bar. \*(C+ will give a nicer C++. Capital omega is used
+ .\" to do unbreakable dashes and therefore won't be available. \*(C` and
+ .\" \*(C' expand to `' in nroff, nothing in troff, for use with C<>
+ .tr \(*W-|\(bv\*(Tr
+ .ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
+ .ie n \{\
+ . ds -- \(*W-
+ . ds PI pi
+ . if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
+ . if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch
+ . ds L" ""
+ . ds R" ""
+ . ds C` ""
+ . ds C' ""
+ 'br\}
+ .el\{\
+ . ds -- \|\(em\|
+ . ds PI \(*p
+ . ds L" ``
+ . ds R" ''
+ 'br\}
+ .\"
+ .\" If the F register is turned on, we'll generate index entries on stderr
+ .\" for titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and
+ .\" index entries marked with X<> in POD. Of course, you'll have to process
+ .\" the output yourself in some meaningful fashion.
+ .if \nF \{\
+ . de IX
+ . tm Index:\\$1\t\\n%\t"\\$2"
+ ..
+ . nr % 0
+ . rr F
+ .\}
+ .\"
+ .\" For nroff, turn off justification. Always turn off hyphenation; it
+ .\" makes way too many mistakes in technical documents.
+ .hy 0
+ .if n .na
+ .\"
+ .\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
+ .\" Fear. Run. Save yourself. No user-serviceable parts.
+ .bd B 3
+ . \" fudge factors for nroff and troff
+ .if n \{\
+ . ds #H 0
+ . ds #V .8m
+ . ds #F .3m
+ . ds #[ \f1
+ . ds #] \fP
+ .\}
+ .if t \{\
+ . ds #H ((1u-(\\\\n(.fu%2u))*.13m)
+ . ds #V .6m
+ . ds #F 0
+ . ds #[ \&
+ . ds #] \&
+ .\}
+ . \" simple accents for nroff and troff
+ .if n \{\
+ . ds ' \&
+ . ds ` \&
+ . ds ^ \&
+ . ds , \&
+ . ds ~ ~
+ . ds /
+ .\}
+ .if t \{\
+ . ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
+ . ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
+ . ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
+ . ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
+ . ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
+ . ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
+ .\}
+ . \" troff and (daisy-wheel) nroff accents
+ .ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
+ .ds 8 \h'\*(#H'\(*b\h'-\*(#H'
+ .ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
+ .ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
+ .ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
+ .ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
+ .ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
+ .ds ae a\h'-(\w'a'u*4/10)'e
+ .ds Ae A\h'-(\w'A'u*4/10)'E
+ . \" corrections for vroff
+ .if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
+ .if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
+ . \" for low resolution devices (crt and lpr)
+ .if \n(.H>23 .if \n(.V>19 \
+ \{\
+ . ds : e
+ . ds 8 ss
+ . ds o a
+ . ds d- d\h'-1'\(ga
+ . ds D- D\h'-1'\(hy
+ . ds th \o'bp'
+ . ds Th \o'LP'
+ . ds ae ae
+ . ds Ae AE
+ .\}
+ .rm #[ #] #H #V #F C
+ .\" ======================================================================
+ .\"
+ .IX Title "LLVMGCC 1"
+ .TH LLVMGCC 1 "1.3" "2004-07-04" "LLVM Command Guide"
+ .UC
+ .SH "NAME"
+ llvmgcc \- \s-1LLVM\s0 C front-end
+ .SH "SYNOPSIS"
+ .IX Header "SYNOPSIS"
+ \&\fBllvmgcc\fR [\fIoptions\fR] \fIfilename\fR
+ .SH "DESCRIPTION"
+ .IX Header "DESCRIPTION"
+ The \fBllvmgcc\fR command is the \s-1LLVM\s0 C front end. It is a modified
+ version of gcc that takes C programs and compiles them into \s-1LLVM\s0
+ bytecode or assembly language, depending upon the options.
+ .PP
+ Unless the \fB\-S\fR option is specified, \fBllvmgcc\fR will use the
+ gccas program to perform some optimizations and create an
+ \&\s-1LLVM\s0 bytecode file. Unless the \fB\-c\fR option is specified, \fBllvmgcc\fR
+ will also use the gccld program to perform further
+ optimizations and link the resulting bytecode \fIfile\fR\|(s) with support
+ libraries to create an executable program.
+ .PP
+ Being derived from the \s-1GNU\s0 Compiler Collection, \fBllvmgcc\fR has many
+ of gcc's features and accepts most of gcc's options. It handles a
+ number of gcc's extensions to the C programming language.
+ .SH "OPTIONS"
+ .IX Header "OPTIONS"
+ .Ip "\fB\*(--help\fR" 4
+ .IX Item "help"
+ Print a summary of command line options.
+ .Ip "\fB\-S\fR" 4
+ .IX Item "-S"
+ Do not generate an \s-1LLVM\s0 bytecode file. Rather, compile the source
+ file into an \s-1LLVM\s0 assembly language file.
+ .Ip "\fB\-c\fR" 4
+ .IX Item "-c"
+ Do not generate a linked executable. Rather, compile the source
+ file into an \s-1LLVM\s0 bytecode file. This bytecode file can then be
+ linked with other bytecode files later on to generate a full \s-1LLVM\s0
+ executable.
+ .Ip "\fB\-o\fR \fIfilename\fR" 4
+ .IX Item "-o filename"
+ Specify the output file to be \fIfilename\fR.
+ .Ip "\fB\-I\fR \fIdirectory\fR" 4
+ .IX Item "-I directory"
+ Add a directory to the header file search path. This option can be
+ repeated.
+ .Ip "\fB\-L\fR \fIdirectory\fR" 4
+ .IX Item "-L directory"
+ Add \fIdirectory\fR to the library search path. This option can be
+ repeated.
+ .Ip "\fB\-l\fR\fIname\fR" 4
+ .IX Item "-lname"
+ Link in the library lib\fIname\fR.[bc | a | so]. This library should
+ be a bytecode library.
+ .Ip "\fB\-Wl,\fR\fIoption\fR" 4
+ .IX Item "-Wl,option"
+ Pass \fIoption\fR to the linker (usually gccld).
+ .SH "EXIT STATUS"
+ .IX Header "EXIT STATUS"
+ If \fBllvmgcc\fR succeeds, it will exit with 0. Otherwise, if an error
+ occurs, it will exit with a non-zero value.
+ .SH "SEE ALSO"
+ .IX Header "SEE ALSO"
+ llvmg++, gccas, gccld
+ .SH "AUTHORS"
+ .IX Header "AUTHORS"
+ Maintained by the \s-1LLVM\s0 Team (http://llvm.cs.uiuc.edu).
Index: llvm-www/releases/1.6/docs/CommandGuide/man/man1/llvmgxx.1
diff -c /dev/null llvm-www/releases/1.6/docs/CommandGuide/man/man1/llvmgxx.1:1.1
*** /dev/null Tue Nov 8 14:07:55 2005
--- llvm-www/releases/1.6/docs/CommandGuide/man/man1/llvmgxx.1 Tue Nov 8 14:07:44 2005
***************
*** 0 ****
--- 1,206 ----
+ .\" Automatically generated by Pod::Man version 1.15
+ .\" Sat Jul 10 01:00:17 2004
+ .\"
+ .\" Standard preamble:
+ .\" ======================================================================
+ .de Sh \" Subsection heading
+ .br
+ .if t .Sp
+ .ne 5
+ .PP
+ \fB\\$1\fR
+ .PP
+ ..
+ .de Sp \" Vertical space (when we can't use .PP)
+ .if t .sp .5v
+ .if n .sp
+ ..
+ .de Ip \" List item
+ .br
+ .ie \\n(.$>=3 .ne \\$3
+ .el .ne 3
+ .IP "\\$1" \\$2
+ ..
+ .de Vb \" Begin verbatim text
+ .ft CW
+ .nf
+ .ne \\$1
+ ..
+ .de Ve \" End verbatim text
+ .ft R
+
+ .fi
+ ..
+ .\" Set up some character translations and predefined strings. \*(-- will
+ .\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
+ .\" double quote, and \*(R" will give a right double quote. | will give a
+ .\" real vertical bar. \*(C+ will give a nicer C++. Capital omega is used
+ .\" to do unbreakable dashes and therefore won't be available. \*(C` and
+ .\" \*(C' expand to `' in nroff, nothing in troff, for use with C<>
+ .tr \(*W-|\(bv\*(Tr
+ .ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
+ .ie n \{\
+ . ds -- \(*W-
+ . ds PI pi
+ . if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
+ . if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch
+ . ds L" ""
+ . ds R" ""
+ . ds C` ""
+ . ds C' ""
+ 'br\}
+ .el\{\
+ . ds -- \|\(em\|
+ . ds PI \(*p
+ . ds L" ``
+ . ds R" ''
+ 'br\}
+ .\"
+ .\" If the F register is turned on, we'll generate index entries on stderr
+ .\" for titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and
+ .\" index entries marked with X<> in POD. Of course, you'll have to process
+ .\" the output yourself in some meaningful fashion.
+ .if \nF \{\
+ . de IX
+ . tm Index:\\$1\t\\n%\t"\\$2"
+ ..
+ . nr % 0
+ . rr F
+ .\}
+ .\"
+ .\" For nroff, turn off justification. Always turn off hyphenation; it
+ .\" makes way too many mistakes in technical documents.
+ .hy 0
+ .if n .na
+ .\"
+ .\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
+ .\" Fear. Run. Save yourself. No user-serviceable parts.
+ .bd B 3
+ . \" fudge factors for nroff and troff
+ .if n \{\
+ . ds #H 0
+ . ds #V .8m
+ . ds #F .3m
+ . ds #[ \f1
+ . ds #] \fP
+ .\}
+ .if t \{\
+ . ds #H ((1u-(\\\\n(.fu%2u))*.13m)
+ . ds #V .6m
+ . ds #F 0
+ . ds #[ \&
+ . ds #] \&
+ .\}
+ . \" simple accents for nroff and troff
+ .if n \{\
+ . ds ' \&
+ . ds ` \&
+ . ds ^ \&
+ . ds , \&
+ . ds ~ ~
+ . ds /
+ .\}
+ .if t \{\
+ . ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
+ . ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
+ . ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
+ . ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
+ . ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
+ . ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
+ .\}
+ . \" troff and (daisy-wheel) nroff accents
+ .ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
+ .ds 8 \h'\*(#H'\(*b\h'-\*(#H'
+ .ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
+ .ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
+ .ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
+ .ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
+ .ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
+ .ds ae a\h'-(\w'a'u*4/10)'e
+ .ds Ae A\h'-(\w'A'u*4/10)'E
+ . \" corrections for vroff
+ .if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
+ .if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
+ . \" for low resolution devices (crt and lpr)
+ .if \n(.H>23 .if \n(.V>19 \
+ \{\
+ . ds : e
+ . ds 8 ss
+ . ds o a
+ . ds d- d\h'-1'\(ga
+ . ds D- D\h'-1'\(hy
+ . ds th \o'bp'
+ . ds Th \o'LP'
+ . ds ae ae
+ . ds Ae AE
+ .\}
+ .rm #[ #] #H #V #F C
+ .\" ======================================================================
+ .\"
+ .IX Title "LLVMGXX 1"
+ .TH LLVMGXX 1 "1.3" "2004-07-04" "LLVM Command Guide"
+ .UC
+ .SH "NAME"
+ llvmg++ \- \s-1LLVM\s0 \*(C+ front-end
+ .SH "SYNOPSIS"
+ .IX Header "SYNOPSIS"
+ \&\fBllvmg++\fR [\fIoptions\fR] \fIfilename\fR
+ .SH "DESCRIPTION"
+ .IX Header "DESCRIPTION"
+ The \fBllvmg++\fR command is the \s-1LLVM\s0 \*(C+ front end. It is a modified
+ version of g++ that takes \*(C+ programs and compiles them into \s-1LLVM\s0
+ bytecode or assembly language, depending upon the options.
+ .PP
+ Unless the \fB\-S\fR option is specified, \fBllvmg++\fR will use the
+ gccas program to perform some optimizations and create an
+ \&\s-1LLVM\s0 bytecode file. Unless the \fB\-c\fR option is specified, \fBllvmg++\fR
+ will also use the gccld program to perform further
+ optimizations and link the resulting bytecode \fIfile\fR\|(s) with support
+ libraries to create an executable program.
+ .PP
+ Being derived from the \s-1GNU\s0 Compiler Collection, \fBllvmg++\fR has many
+ of g++'s features and accepts most of g++'s options. It handles a
+ number of g++'s extensions to the \*(C+ programming language.
+ .SH "OPTIONS"
+ .IX Header "OPTIONS"
+ .Ip "\fB\*(--help\fR" 4
+ .IX Item "help"
+ Print a summary of command line options.
+ .Ip "\fB\-S\fR" 4
+ .IX Item "-S"
+ Do not generate an \s-1LLVM\s0 bytecode file. Rather, compile the source
+ file into an \s-1LLVM\s0 assembly language file.
+ .Ip "\fB\-c\fR" 4
+ .IX Item "-c"
+ Do not generate a linked executable. Rather, compile the source
+ file into an \s-1LLVM\s0 bytecode file. This bytecode file can then be
+ linked with other bytecode files later on to generate a full \s-1LLVM\s0
+ executable.
+ .Ip "\fB\-o\fR \fIfilename\fR" 4
+ .IX Item "-o filename"
+ Specify the output file to be \fIfilename\fR.
+ .Ip "\fB\-I\fR \fIdirectory\fR" 4
+ .IX Item "-I directory"
+ Add a directory to the header file search path. This option can be
+ repeated.
+ .Ip "\fB\-L\fR \fIdirectory\fR" 4
+ .IX Item "-L directory"
+ Add \fIdirectory\fR to the library search path. This option can be
+ repeated.
+ .Ip "\fB\-l\fR\fIname\fR" 4
+ .IX Item "-lname"
+ Link in the library lib\fIname\fR.[bc | a | so]. This library should
+ be a bytecode library.
+ .Ip "\fB\-Wl,\fR\fIoption\fR" 4
+ .IX Item "-Wl,option"
+ Pass \fIoption\fR to the linker (usually gccld).
+ .SH "EXIT STATUS"
+ .IX Header "EXIT STATUS"
+ If \fBllvmg++\fR succeeds, it will exit with 0. Otherwise, if an error
+ occurs, it will exit with a non-zero value.
+ .SH "SEE ALSO"
+ .IX Header "SEE ALSO"
+ the llvmgcc manpage, the gccas manpage, the gccld manpage
+ .SH "AUTHORS"
+ .IX Header "AUTHORS"
+ Maintained by the \s-1LLVM\s0 Team (http://llvm.cs.uiuc.edu).
Index: llvm-www/releases/1.6/docs/CommandGuide/man/man1/opt.1
diff -c /dev/null llvm-www/releases/1.6/docs/CommandGuide/man/man1/opt.1:1.1
*** /dev/null Tue Nov 8 14:07:56 2005
--- llvm-www/releases/1.6/docs/CommandGuide/man/man1/opt.1 Tue Nov 8 14:07:44 2005
***************
*** 0 ****
--- 1,216 ----
+ .\" Automatically generated by Pod::Man version 1.15
+ .\" Sat Jul 10 01:00:17 2004
+ .\"
+ .\" Standard preamble:
+ .\" ======================================================================
+ .de Sh \" Subsection heading
+ .br
+ .if t .Sp
+ .ne 5
+ .PP
+ \fB\\$1\fR
+ .PP
+ ..
+ .de Sp \" Vertical space (when we can't use .PP)
+ .if t .sp .5v
+ .if n .sp
+ ..
+ .de Ip \" List item
+ .br
+ .ie \\n(.$>=3 .ne \\$3
+ .el .ne 3
+ .IP "\\$1" \\$2
+ ..
+ .de Vb \" Begin verbatim text
+ .ft CW
+ .nf
+ .ne \\$1
+ ..
+ .de Ve \" End verbatim text
+ .ft R
+
+ .fi
+ ..
+ .\" Set up some character translations and predefined strings. \*(-- will
+ .\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
+ .\" double quote, and \*(R" will give a right double quote. | will give a
+ .\" real vertical bar. \*(C+ will give a nicer C++. Capital omega is used
+ .\" to do unbreakable dashes and therefore won't be available. \*(C` and
+ .\" \*(C' expand to `' in nroff, nothing in troff, for use with C<>
+ .tr \(*W-|\(bv\*(Tr
+ .ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
+ .ie n \{\
+ . ds -- \(*W-
+ . ds PI pi
+ . if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
+ . if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch
+ . ds L" ""
+ . ds R" ""
+ . ds C` ""
+ . ds C' ""
+ 'br\}
+ .el\{\
+ . ds -- \|\(em\|
+ . ds PI \(*p
+ . ds L" ``
+ . ds R" ''
+ 'br\}
+ .\"
+ .\" If the F register is turned on, we'll generate index entries on stderr
+ .\" for titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and
+ .\" index entries marked with X<> in POD. Of course, you'll have to process
+ .\" the output yourself in some meaningful fashion.
+ .if \nF \{\
+ . de IX
+ . tm Index:\\$1\t\\n%\t"\\$2"
+ ..
+ . nr % 0
+ . rr F
+ .\}
+ .\"
+ .\" For nroff, turn off justification. Always turn off hyphenation; it
+ .\" makes way too many mistakes in technical documents.
+ .hy 0
+ .if n .na
+ .\"
+ .\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
+ .\" Fear. Run. Save yourself. No user-serviceable parts.
+ .bd B 3
+ . \" fudge factors for nroff and troff
+ .if n \{\
+ . ds #H 0
+ . ds #V .8m
+ . ds #F .3m
+ . ds #[ \f1
+ . ds #] \fP
+ .\}
+ .if t \{\
+ . ds #H ((1u-(\\\\n(.fu%2u))*.13m)
+ . ds #V .6m
+ . ds #F 0
+ . ds #[ \&
+ . ds #] \&
+ .\}
+ . \" simple accents for nroff and troff
+ .if n \{\
+ . ds ' \&
+ . ds ` \&
+ . ds ^ \&
+ . ds , \&
+ . ds ~ ~
+ . ds /
+ .\}
+ .if t \{\
+ . ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
+ . ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
+ . ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
+ . ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
+ . ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
+ . ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
+ .\}
+ . \" troff and (daisy-wheel) nroff accents
+ .ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
+ .ds 8 \h'\*(#H'\(*b\h'-\*(#H'
+ .ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
+ .ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
+ .ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
+ .ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
+ .ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
+ .ds ae a\h'-(\w'a'u*4/10)'e
+ .ds Ae A\h'-(\w'A'u*4/10)'E
+ . \" corrections for vroff
+ .if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
+ .if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
+ . \" for low resolution devices (crt and lpr)
+ .if \n(.H>23 .if \n(.V>19 \
+ \{\
+ . ds : e
+ . ds 8 ss
+ . ds o a
+ . ds d- d\h'-1'\(ga
+ . ds D- D\h'-1'\(hy
+ . ds th \o'bp'
+ . ds Th \o'LP'
+ . ds ae ae
+ . ds Ae AE
+ .\}
+ .rm #[ #] #H #V #F C
+ .\" ======================================================================
+ .\"
+ .IX Title "OPT 1"
+ .TH OPT 1 "1.3" "2004-07-04" "LLVM Command Guide"
+ .UC
+ .SH "NAME"
+ opt \- \s-1LLVM\s0 optimizer
+ .SH "SYNOPSIS"
+ .IX Header "SYNOPSIS"
+ \&\fBopt\fR [\fIoptions\fR] [\fIfilename\fR]
+ .SH "DESCRIPTION"
+ .IX Header "DESCRIPTION"
+ The \fBopt\fR command is the modular \s-1LLVM\s0 optimizer. It takes \s-1LLVM\s0
+ bytecode as input, runs the specified optimizations on it, and then
+ outputs the optimized \s-1LLVM\s0 bytecode.
+ .PP
+ The optimizations available via \fBopt\fR depend upon what libraries
+ were linked into it as well as any additional libraries that have
+ been loaded with the \fB\-load\fR option. Use the \fB\-help\fR option to
+ determine what optimizations you can use.
+ .PP
+ If no filename is specified on the command line, \fBopt\fR reads its
+ input from standard input.
+ .PP
+ If an output filename is not specified with the \fB\-o\fR option, \fBopt\fR
+ writes its output to the standard output.
+ .SH "OPTIONS"
+ .IX Header "OPTIONS"
+ .Ip "\fB\-f\fR" 4
+ .IX Item "-f"
+ Force overwrite. Normally, \fBopt\fR will refuse to overwrite an
+ output file that already exists. With this option, \fBopt\fR will
+ overwrite the output file and replace it with new bytecode.
+ .Ip "\fB\-help\fR" 4
+ .IX Item "-help"
+ Print a summary of command line options.
+ .Ip "\fB\-o\fR \fIfilename\fR" 4
+ .IX Item "-o filename"
+ Specify the output filename.
+ .Ip "\fB\-profile-info-file\fR \fIfilename\fR" 4
+ .IX Item "-profile-info-file filename"
+ Specify the name of the file loaded by the \-profile-loader option.
+ .Ip "\fB\-stats\fR" 4
+ .IX Item "-stats"
+ Print statistics.
+ .Ip "\fB\-time-passes\fR" 4
+ .IX Item "-time-passes"
+ Record the amount of time needed for each pass and print it to standard
+ error.
+ .Ip "\fB\-debug\fR" 4
+ .IX Item "-debug"
+ If this is a debug build, this option will enable debug printouts
+ from passes which use the \fI\fIDEBUG()\fI\fR macro. See the \fB\s-1LLVM\s0 Programmer's
+ Manual\fR, section \fI#DEBUG\fR for more information.
+ .Ip "\fB\-load\fR=\fIplugin\fR" 4
+ .IX Item "-load=plugin"
+ Load the dynamic object \fIplugin\fR. This object should register new
+ optimization passes. Once loaded, the object will add new command line
+ options to enable various optimizations. To see the new complete list
+ of optimizations, use the \fB\-help\fR and \fB\-load\fR options together:
+ .RS 4
+ .Sp
+ \&\fBopt \-load\fR=\fIplugin\fR \fB\-help\fR
+ .RE
+ .RS 4
+ .RE
+ .Ip "\fB\-p\fR" 4
+ .IX Item "-p"
+ Print module after each transformation.
+ .SH "EXIT STATUS"
+ .IX Header "EXIT STATUS"
+ If \fBopt\fR succeeds, it will exit with 0. Otherwise, if an error
+ occurs, it will exit with a non-zero value.
+ .SH "SEE ALSO"
+ .IX Header "SEE ALSO"
+ analyze
+ .SH "AUTHORS"
+ .IX Header "AUTHORS"
+ Maintained by the \s-1LLVM\s0 Team (http://llvm.cs.uiuc.edu).
Index: llvm-www/releases/1.6/docs/CommandGuide/man/man1/stkrc.1
diff -c /dev/null llvm-www/releases/1.6/docs/CommandGuide/man/man1/stkrc.1:1.1
*** /dev/null Tue Nov 8 14:07:56 2005
--- llvm-www/releases/1.6/docs/CommandGuide/man/man1/stkrc.1 Tue Nov 8 14:07:44 2005
***************
*** 0 ****
--- 1,207 ----
+ .\" Automatically generated by Pod::Man version 1.15
+ .\" Sat Jul 10 16:42:51 2004
+ .\"
+ .\" Standard preamble:
+ .\" ======================================================================
+ .de Sh \" Subsection heading
+ .br
+ .if t .Sp
+ .ne 5
+ .PP
+ \fB\\$1\fR
+ .PP
+ ..
+ .de Sp \" Vertical space (when we can't use .PP)
+ .if t .sp .5v
+ .if n .sp
+ ..
+ .de Ip \" List item
+ .br
+ .ie \\n(.$>=3 .ne \\$3
+ .el .ne 3
+ .IP "\\$1" \\$2
+ ..
+ .de Vb \" Begin verbatim text
+ .ft CW
+ .nf
+ .ne \\$1
+ ..
+ .de Ve \" End verbatim text
+ .ft R
+
+ .fi
+ ..
+ .\" Set up some character translations and predefined strings. \*(-- will
+ .\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
+ .\" double quote, and \*(R" will give a right double quote. | will give a
+ .\" real vertical bar. \*(C+ will give a nicer C++. Capital omega is used
+ .\" to do unbreakable dashes and therefore won't be available. \*(C` and
+ .\" \*(C' expand to `' in nroff, nothing in troff, for use with C<>
+ .tr \(*W-|\(bv\*(Tr
+ .ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
+ .ie n \{\
+ . ds -- \(*W-
+ . ds PI pi
+ . if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
+ . if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch
+ . ds L" ""
+ . ds R" ""
+ . ds C` ""
+ . ds C' ""
+ 'br\}
+ .el\{\
+ . ds -- \|\(em\|
+ . ds PI \(*p
+ . ds L" ``
+ . ds R" ''
+ 'br\}
+ .\"
+ .\" If the F register is turned on, we'll generate index entries on stderr
+ .\" for titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and
+ .\" index entries marked with X<> in POD. Of course, you'll have to process
+ .\" the output yourself in some meaningful fashion.
+ .if \nF \{\
+ . de IX
+ . tm Index:\\$1\t\\n%\t"\\$2"
+ ..
+ . nr % 0
+ . rr F
+ .\}
+ .\"
+ .\" For nroff, turn off justification. Always turn off hyphenation; it
+ .\" makes way too many mistakes in technical documents.
+ .hy 0
+ .if n .na
+ .\"
+ .\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
+ .\" Fear. Run. Save yourself. No user-serviceable parts.
+ .bd B 3
+ . \" fudge factors for nroff and troff
+ .if n \{\
+ . ds #H 0
+ . ds #V .8m
+ . ds #F .3m
+ . ds #[ \f1
+ . ds #] \fP
+ .\}
+ .if t \{\
+ . ds #H ((1u-(\\\\n(.fu%2u))*.13m)
+ . ds #V .6m
+ . ds #F 0
+ . ds #[ \&
+ . ds #] \&
+ .\}
+ . \" simple accents for nroff and troff
+ .if n \{\
+ . ds ' \&
+ . ds ` \&
+ . ds ^ \&
+ . ds , \&
+ . ds ~ ~
+ . ds /
+ .\}
+ .if t \{\
+ . ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
+ . ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
+ . ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
+ . ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
+ . ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
+ . ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
+ .\}
+ . \" troff and (daisy-wheel) nroff accents
+ .ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
+ .ds 8 \h'\*(#H'\(*b\h'-\*(#H'
+ .ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
+ .ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
+ .ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
+ .ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
+ .ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
+ .ds ae a\h'-(\w'a'u*4/10)'e
+ .ds Ae A\h'-(\w'A'u*4/10)'E
+ . \" corrections for vroff
+ .if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
+ .if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
+ . \" for low resolution devices (crt and lpr)
+ .if \n(.H>23 .if \n(.V>19 \
+ \{\
+ . ds : e
+ . ds 8 ss
+ . ds o a
+ . ds d- d\h'-1'\(ga
+ . ds D- D\h'-1'\(hy
+ . ds th \o'bp'
+ . ds Th \o'LP'
+ . ds ae ae
+ . ds Ae AE
+ .\}
+ .rm #[ #] #H #V #F C
+ .\" ======================================================================
+ .\"
+ .IX Title "STKRC 1"
+ .TH STKRC 1 "1.3" "2004-07-10" "LLVM Command Guide"
+ .UC
+ .SH "NAME"
+ stkrc \- Stacker Compiler
+ .SH "SYNOPSIS"
+ .IX Header "SYNOPSIS"
+ \&\fBstkrc\fR [\fIoptions\fR] [\fIfilename\fR]
+ .SH "DESCRIPTION"
+ .IX Header "DESCRIPTION"
+ The \fBstkrc\fR command is the compiler for the Stacker language. Stacker is a
+ simple stack based, Forth-like language that was written as a demonstration
+ language for \s-1LLVM\s0. For details on the language, please see
+ http://llvm.cs.uiuc.edu/docs/Stacker.html . The \fBstkrc\fR compiler is fairly
+ minimal. It compiles to bytecode only and doesn't perform any optimizations.
+ The output of stkrc (a bytecode file) can be piped through other \s-1LLVM\s0 tools
+ for optimization and linking.
+ .PP
+ If \fIfilename\fR is omitted or is \f(CW\*(C`\-\*(C'\fR, then \fBstkrc\fR reads its input
+ from standard input. This is useful for combining the tool into a pipeline.
+ .PP
+ If an output file is not specified with the \fB\-o\fR option, then
+ \&\fBllvm-as\fR sends its output to a file or standard output by following
+ these rules:
+ .Ip "\(bu" 4
+ If the input is standard input, then the output is standard output.
+ .Ip "\(bu" 4
+ If the input is a file that ends with \f(CW\*(C`.st\*(C'\fR, then the output file is of
+ the same name, except that the suffix is changed to \f(CW\*(C`.bc\*(C'\fR.
+ .Ip "\(bu" 4
+ If the input is a file that does not end with the \f(CW\*(C`.st\*(C'\fR suffix, then the
+ output file has the same name as the input file, except that the \f(CW\*(C`.bc\*(C'\fR
+ suffix is appended.
+ .SH "OPTIONS"
+ .IX Header "OPTIONS"
+ .Ip "\fB\-o\fR \fIfilename\fR" 4
+ .IX Item "-o filename"
+ Specify the output file name. If \fIfilename\fR is \f(CW\*(C`\-\*(C'\fR, then \fBllvm-as\fR
+ sends its output to standard output.
+ .Ip "\fB\-stats\fR" 4
+ .IX Item "-stats"
+ Print statistics acquired during compilation.
+ .Ip "\fB\-time-passes\fR" 4
+ .IX Item "-time-passes"
+ Record the amount of time needed for each pass and print it to standard
+ error.
+ .Ip "\fB\-f\fR" 4
+ .IX Item "-f"
+ Force the output to be written. Normally, \fBstkrc\fR won't overwrite an existing
+ bytecode file. This option overrides that behavior.
+ .Ip "\fB\-s=stacksize\fR" 4
+ .IX Item "-s=stacksize"
+ Specify the stack size for the program. The default stack size, 1024, should be
+ sufficient for most programs. For very large, programs, you might want to
+ provide a larger value.
+ .Ip "\fB\-help\fR" 4
+ .IX Item "-help"
+ Print a summary of command line options.
+ .SH "EXIT STATUS"
+ .IX Header "EXIT STATUS"
+ If \fBstkrc\fR succeeds, it will exit with 0. Otherwise, if an error
+ occurs, it will exit with a non-zero value, usually 1.
+ .SH "SEE ALSO"
+ .IX Header "SEE ALSO"
+ the llvm-as manpage, http://llvm.cs.uiuc.edu/docs/Stacker.html
+ .SH "AUTHORS"
+ .IX Header "AUTHORS"
+ Maintained by the \s-1LLVM\s0 Team (http://llvm.cs.uiuc.edu).
More information about the llvm-commits
mailing list