1 <?xml version="1.0" encoding="UTF-8"?>
2 <refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns:ns3="http://www.w3.org/1999/xhtml" xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org" xml:id="scilab" xml:lang="pt">
4 <refname>scilab</refname>
5 <refpurpose>principal script para executar o Scilab e ferramentas de
10 <title>Sqeüência de Chamamento</title>
11 <synopsis>scilab <Options></synopsis>
13 <refsection role="arguments">
14 <title>Parâmetros</title>
17 <term>-args Arguments</term>
19 <para>Se esta opção estiver presente, os argumentos são passados ao
20 Scilab. Eles podem ser recebidos pela função <link linkend="sciargs">sciargs</link>. para passagem de múltiplos
21 argumentos use, seqüências de palavras separadas por espaços entre
22 aspas simples: <literal>scilab -args 'foo1 foo2'</literal>
27 <term>-display Display</term>
29 <para>Para uso apenas em sistemas Xwindow para ajustar um display de
30 servidor X. O display padrão é unix:0.0
33 <literal>-display</literal> pode ser abreviado por
41 <para>Inicia o Scilab no debugger gdb (apenas para
47 <term>-e Instrução</term>
49 <para>Se esta opção estiver presente, então a instrução Scilab
50 <literal>Instrução</literal> é executada primeiro (logo após a
51 execução do arquivo de inicialização) no Scilab. As opções
52 <literal>-e</literal> e <literal>-f</literal> são mutuamente
58 <term>-f arquivo</term>
60 <para>Se esta opção estiver presente, então o script Scilab
61 <literal>arquivo</literal> é executado primeiro (logo após a
62 execução do arquivo de inicialização) no Scilab. As opções
63 <literal>-e</literal> e <literal>-f</literal> são mutuamente
71 <para>This option forces scilab to always exit after the instruction(s) passed with the <literal>-e</literal>
72 option, or the script referred to by the <literal>-f</literal> option, have been executed,
73 even in case of a runtime error. This option should always be used in batch mode.
74 It is ignored if neither <literal>-e</literal> nor <literal>-f</literal> options are present.
79 <term>-l idioma</term>
81 <para>Se esta opção estiver presente, ela fica o idioma do usuário.
82 Os possíveis valores para <literal>idioma</literal> são
83 <literal>'fr'</literal> para francês, <literal>'en'</literal> para
84 inglês e 'br' para português brasileiro. O idioma padrão é inglês. O
85 valor padrão é fixado no arquivo
86 <literal>scilab.start</literal>.
93 <para>Se esta opção está presente, então o cartão de boas-vindas não
101 <para>Se esta opção está presente, o arquivo de inicialização
102 <literal>SCI/etc/scilab.start</literal> e os arquivos de
103 inicialização do usuário <literal>SCIHOME/.scilab</literal>,
104 <literal>SCIHOME/scilab.ini</literal> não são executados.
109 <term>-nouserstartup</term>
111 <para>Se esta opção estiver presente, os arquivos de inicialização
112 do usuário <literal>SCIHOME/.scilab</literal>,
113 <literal>SCIHOME/scilab.ini</literal> não são executados.
120 <para>Se esta opção estiver presente, então o Scilab não é executado
121 em uma janela específica.
126 <term>-nwni / -nogui</term>
128 <para>Se esta opção estiver presente, então o Scilab não é executado
129 em uma janela específica e não aceita interação do usuário. Esta
130 opção pode ser utilizada com as opções -f ou -e .
135 <term>--texmacs</term>
137 <para>Esta opção é reservada para TexMacs.</para>
141 <term>-version</term>
143 <para>Esta opção imprime a versão do produto e sai.</para>
148 <refsection role="description">
149 <title>Description of environment variables</title>
152 <term>SCIVERBOSE</term>
155 If this variable is present, Scilab startup script will show a startup debug information.
156 Mainly used for bug report and debugging purposes.
161 <term>JAVA_HOME</term>
164 Specify which Java to use. For example,
165 <literal>JAVA_HOME=/usr/lib/jvm/java-7-openjdk/ scilab</literal> will start Scilab with Java 7.
170 <term>SCI_DISABLE_TK</term>
172 <para>Disable Tk (but not Tcl) features.</para>
176 <term>SCI_JAVA_ENABLE_HEADLESS</term>
179 Enable Java Headless VM (i.e. without GUI features).
185 <refsection role="description">
186 <title>Java Virtual Machine options</title>
187 <para>Starting from Scilab 5.0, the graphical user interface (GUI) and the
188 build documentation are based on Java features. In some cases, it can be
189 important to edit the JVM options (Java Virtual Machine).
191 <para>These options are available in the
192 <emphasis>jvm_options.xml</emphasis> file.
194 <para>In version 5.0.X and 5.1.X, this file is stored as
195 <emphasis>SCI/modules/jvm/etc/jvm_options.xml</emphasis>.
197 <para>In version >= 5.2.0, the file is available in
198 <emphasis>etc/jvm_options.xml</emphasis>.
202 By default, the three following options are
203 easily accessible in the configuration file:
208 <term>-XmxXXXm</term>
210 <para>This option set the amount of memory available by the Java
211 Virtual Machine. By default, 256M are allocated. If you change this
212 value, check that the value does not exceed the memory available on
215 <para>Since Scilab 5.4.0, this value can be changed in the preferences menu.</para>
219 <term>-Djava.compiler=JIT</term>
222 This option with the argument <emphasis>JIT</emphasis> enables
223 the Java Just In Time compiler. It is activated by default.
224 <emphasis>NONE</emphasis> disables the JIT and decreases
225 dramatically performances.
230 <term>-verbose:jni / -Xcheck:jni</term>
232 <para>These options enable more checks and output from the JNI
233 calls. These options are useful in case of debugging and are
234 disabled by default since they decreases performances.
239 <para>Many more options are available. They can improve the performances,
240 change look and feel, change memory managements... See: <ulink url="http://www.oracle.com/technetwork/java/javase/tech/vmoptions-jsp-140102.html">http://www.oracle.com/technetwork/java/javase/tech/vmoptions-jsp-140102.html</ulink>.
243 <refsection role="examples">
244 <title>Exemplos</title>
245 <programlisting role="no-scilab-exec"><![CDATA[
246 # Let's start Scilab in profiling mode without attaching a gdb once a SIGSEGV is met.
247 # We are under Bash shell
248 export SCILAB_VALGRIND_OPT="--db-attach=no --log-file=myfile.txt"
251 # Let's start Scilab in debug mode without stopping after each SIGSEGV
252 # First, we write a small command file
253 echo "handle SIGSEGV nostop" &> debug.txt
254 # Now set the custom option
255 # We are under Bash shell
256 export SCILAB_GDB_OPT="--command=debug.txt"
257 # Start Scilab in debug mode
258 scilab -debug]]></programlisting>
259 <programlisting role="no-scilab-exec"><![CDATA[
260 # Under GNU/Linux, Mac OS X or Unix:
261 $ echo "disp(%pi)"|scilab-cli
263 $ echo "disp(%pi)"|scilab -nwni
265 # Only open the Scilab help window:
266 $ scilab-adv-cli -e "help()"
268 $ scilab -nw -e "help()"
271 # Scilab can be used for scripting aspects:
272 echo "if 1<>2 then exit(99) end"|scilab-cli
273 echo $? ]]></programlisting>
275 <refsection role="see also">
276 <title>Ver também</title>
277 <simplelist type="inline">
279 <link linkend="exit">exit</link>
282 <link linkend="startup">startup</link>
286 <refsection role="history">
287 <title>Histórico</title>
290 <revnumber>5.4.0</revnumber>
291 <revremark>-noatomsautoload added.</revremark>
294 <revnumber>5.4.1</revnumber>
295 <revremark>scinotes and xcos individual scripts introduced. See SEP #87.</revremark>
298 <revnumber>6.0.0</revnumber>
300 <literal>-quit</literal> option added. <literal>-mem</literal> option removed.