1fsc(1) USER COMMANDS fsc(1)
2
6 fsc - Fast offline compiler for the Scala 2 language
7
9 fsc [ <options> ] <source files>
10
12 <options>
13 Command line options. See OPTIONS below.
14 <source files>
16 One or more source files to be compiled (such as MyClass.scala).
17
19 The offline compiler supports all options of scalac plus the following:
20 -reset Reset compile server caches.
22 -shutdown
24 Shut down the compilation daemon. The daemon attempts to
25 restart itself as necessary, but sometimes an explicit shutdown
26 is required. A common example is if jars on the class path have
27 changed.
28 -server <hostname:portnumber>
30 Specify compile server host at port number. Usually this option
31 is not needed. Note that the hostname must be for a host that
32 shares the same filesystem.
33 -J<flag>
35 Pass <flag> directly to the Java VM for the compilation daemon.
36
38 The fsc tool submits Scala compilation jobs to a compilation daemon.
39 The first time it is executed, the daemon is started automatically. On
40 subsequent runs, the same daemon can be reused, thus resulting in a
41 faster compilation. The tool is especially effective when repeatedly
42 compiling with the same class paths, because the compilation daemon can
43 reuse a compiler instance.
44 The compilation daemon is smart enough to flush its cached compiler
46 when the class path changes. However, if the contents of the class
47 path change, for example due to upgrading a library, then the daemon
48 should be explicitly shut down with -shutdown.
49 Note that the scala script runner will also use the offline compiler by
51 default, with the same advantages and caveats.
52
54 The following session shows a typical speed up due to using the offline
55 compiler.
56 > fsc -verbose -d /tmp test.scala
58 ...
59 [Port number: 32834]
60 [Starting new Scala compile server instance]
61 [Classpath = ...]
62 [loaded directory path ... in 692ms]
63 ...
64 [parsing test.scala]
65 ...
66 [total in 943ms]
67 > fsc -verbose -d /tmp test.scala
69 ...
70 [Port number: 32834]
71 [parsing test.scala]
72 ...
73 [total in 60ms]
74 > fsc -verbose -d /tmp test.scala
76 ...
77 [Port number: 32834]
78 [parsing test.scala]
79 ...
80 [total in 42ms]
81 > fsc -verbose -shutdown
83 [Scala compile server exited]
84
87 JAVACMD
88 Specify the java command to be used for running the Scala code.
89 Arguments may be specified as part of the environment variable;
90 spaces, quotation marks, etc., will be passed directly to the
91 shell for expansion.
92 JAVA_HOME
94 Specify JDK/JRE home directory. This directory is used to locate
95 the java command unless JAVACMD variable set.
96 JAVA_OPTS
98 Specify the options to be passed to the java command defined by
99 JAVACMD.
100 With Java 1.5 (or newer) one may for example configure the mem‐
102 ory usage of the JVM as follows: JAVA_OPTS="-Xmx512M -Xms16M
103 -Xss16M"
104
106 fsc returns a zero exit status if it succeeds to compile the specified
107 input files. Non zero is returned in case of failure.
108
110 Written by Martin Odersky and other members of the Scala team.
111
113 Report bugs to https://github.com/scala/bug/issues.
114
116 This is open-source software, available to you under the Apache License
117 2.0. See accompanying "copyright" or "LICENSE" file for copying condi‐
118 tions. There is NO warranty; not even for MERCHANTABILITY or FITNESS
119 FOR A PARTICULAR PURPOSE.
120
122 scala(1), scalac(1), scaladoc(1), scalap(1)
123version 0.5 March 2012 fsc(1)