Home My Page Projects Code Snippets Project Openings diderot
Summary Activity Tracker Tasks SCM

SCM Repository

[diderot] Annotation of /branches/vis12/doc/report/diderotc-1.tex
ViewVC logotype

Annotation of /branches/vis12/doc/report/diderotc-1.tex

Parent Directory Parent Directory | Revision Log Revision Log


Revision 2653 - (view) (download) (as text)

1 : jhr 1684 %!TEX root = report.tex
2 :     %
3 :    
4 :     \begin{ManPage}{1}{diderotc}{}
5 :     \begin{NAME}
6 :     \Prog{diderotc} --- Diderot compiler
7 :     \end{NAME}
8 :     \begin{SYNOPSIS}
9 :     \Prog{diderotc}
10 :     \Arg{options}
11 :     \Dots{}
12 :     \Arg{file}
13 :     \end{SYNOPSIS}
14 :     \begin{DESCRIPTION}
15 : jhr 1846 The \Prog{diderotc} command is used to compile Diderot programs.
16 : jhr 1684 \end{DESCRIPTION}
17 :     \begin{OPTIONS}
18 :     \begin{Flag}{\Opt{-h}, \Opt{--help}}
19 :     Display a list of command-line options and then exit.
20 : jhr 1846 This list includes additional options used to support development and debugging of
21 :     the compiler.
22 : jhr 1684 \end{Flag}
23 : jhr 1846 \begin{Flag}{\Opt{--exec}}
24 :     Compile the Diderot program to run as a standalone executable.
25 :     \end{Flag}
26 : jhr 2653 \begin{Flag}{\OptArg{-o}{ outfile}, \OptEqArg{--output}{outfile}}
27 : jhr 1846 Use the name \Arg{outfile} as the stem for the generated code files.
28 :     When coupled with the \Opt{--exec} flag, \Arg{outfile} will be the name of
29 :     the executable.
30 : jhr 1684 \end{Flag}
31 : jhr 1846 \begin{Flag}{\OptEqArg{--namespace}{prefix}}
32 :     Specify a namespace prefix for generated interface to the Diderot program.
33 :     The default namespace prefix is \texttt{Diderot}.
34 :     \end{Flag}
35 : jhr 2653 \begin{Flag}{\Opt{--snapshot}}
36 :     Generate functions to get a snapshot of the strand state during execution.
37 :     \end{Flag}
38 : jhr 1684 \begin{Flag}{\OptEqArg{--target}{tgt}}
39 :     Specifies the target platform for the generated code. The \Prog{diderotc} compiler
40 :     currently supports the following choices for \Arg{tgt}:
41 :     \begin{description}
42 :     \item[c] --- single-threaded sequential implementation
43 :     \item[pthread] --- parallel implementation for multiprocessors using pthreads
44 :     \item[cl] --- parallel implementation for GPUs using OpenCL
45 :     \end{description}%
46 :     \end{Flag}
47 : jhr 1846 \begin{Flag}{\Opt{--double}}
48 :     Use double-precision floating-point for the Diderot real type.
49 :     \end{Flag}
50 : jhr 2653 \begin{Flag}{\Opt{--force-bsp}}
51 :     Forces the generated strand scheduler to faithfully implement
52 :     the \emph{Bulk synchronous parallelism} model by requiring a global barrier synchronization
53 :     at the end of each super step.
54 :     Without this flag, the compiler will try to specialize the scheduler for more efficient
55 :     execution.
56 :     \end{Flag}
57 : jhr 1846 \begin{Flag}{\Opt{-g}, \Opt{--debug}}
58 :     Enable assertions and debugging information in the generated code and runtime system.
59 :     \end{Flag}
60 :     \begin{Flag}{\Opt{--log}}
61 :     Emit a log file of the compiler's intermediate representations.
62 :     This option is mainly used to debug the compiler.
63 :     \end{Flag}
64 : jhr 1684 \end{OPTIONS}%
65 :     \begin{SECTION}{RUNTIME OPTIONS}
66 : jhr 1846 The executables produced by the compiler when using the \Opt{--exec} option recognize
67 :     a number of options.
68 : jhr 2653 These include options to specify the values of input variables and the following standard
69 :     options:
70 :     \begin{OptionList}
71 :     \begin{Flag}{\Opt{-verbose}}
72 :     Enables runtime-system messages, which are printed to \texttt{stderr}.
73 :     \end{Flag}
74 :     \begin{Flag}{\Opt{-timing}}
75 :     Enables execution timing; the timing results are printed to \texttt{stdout}, unless
76 :     the \Opt{-verbose} option is specified, in which case they are printed to \texttt{stderr}.
77 :     \end{Flag}
78 :     \end{OptionList}%
79 : jhr 1684 \end{SECTION}
80 :     \end{ManPage}%

root@smlnj-gforge.cs.uchicago.edu
ViewVC Help
Powered by ViewVC 1.0.0