1
2JULIA(1)                    General Commands Manual                   JULIA(1)
3
4
5

NAME

7       julia - a high-level, high-performance dynamic programming language for
8       technical computing
9
10

SYNOPSIS

12       julia [OPTIONS...] -- [PROGRAMMFILE] [ARGS...]
13
14       If a Julia source file is given as a PROGRAMFILE  (optionally  followed
15       by arguments in ARGS) Julia will execute the program and exit.
16
17

DESCRIPTION

19       Julia  is  a  high-level, high-performance dynamic programming language
20       for technical computing, with syntax that is familiar to users of other
21       technical  computing  environments.   It  provides a sophisticated com‐
22       piler, distributed parallel execution, numerical accuracy, and  an  ex‐
23       tensive mathematical function library.  The library, largely written in
24       Julia itself, also integrates mature, best-of-breed C and  Fortran  li‐
25       braries  for  linear algebra, random number generation, signal process‐
26       ing, and string processing.  In addition, the Julia developer community
27       is  contributing a number of external packages through Julia's built-in
28       package manager at a rapid pace.  Julia programs are  organized  around
29       multiple  dispatch; by defining functions and overloading them for dif‐
30       ferent combinations of argument types, which can also be  user-defined.
31       For a more in-depth discussion of the rationale and advantages of Julia
32       over other systems, please  see  the  online  manual:  https://docs.ju‐
33       lialang.org
34
35

COMMAND-LINE OPTIONS

37       -v, --version
38              Display version information
39
40
41       -h, --help
42              Print help message
43
44
45       --help-hidden
46              Print uncommon options not shown by `-h`
47
48
49       --project[=<dir>/@.]
50              Set <dir> as the home project/environment. The default @. option
51              will search through parent directories until a  Project.toml  or
52              JuliaProject.toml file is found.
53
54
55       -J, --sysimage <file>
56              Start up with the given system image file
57
58
59       -H, --home <dir>
60              Set location of julia executable
61
62
63       --startup-file={yes*|no}
64              Load `JULIA_DEPOT_PATH/config/startup.jl`; if `JULIA_DEPOT_PATH`
65              environment variable is unset, load `~/.julia/config/startup.jl`
66
67
68       --handle-signals={yes*|no}
69              Enable or disable Julia's default signal handlers
70
71
72       --sysimage-native-code={yes*|no}
73              Use native code from system image if available
74
75
76       --compiled-modules={yes*|no}
77              Enable or disable incremental precompilation of modules
78
79
80       -e, --eval <expr>
81              Evaluate <expr>
82
83
84       -E, --print <expr>
85              Evaluate <expr> and display the result
86
87
88       -L, --load <file>
89              Load <file> immediately on all processors
90
91
92       -t, --threads <n>
93              Enable n threads
94
95
96       -p, --procs {N|auto}
97              Integer value N launches N  additional  local  worker  processes
98              `auto`  launches  as  many  workers  as  the number of local CPU
99              threads (logical cores)
100
101
102       --machine-file <file>
103              Run processes on hosts listed in <file>
104
105
106       -i     Interactive mode; REPL runs and `isinteractive()` is true
107
108
109       -q, --quiet
110              Quiet startup: no banner, suppress REPL warnings
111
112
113       --banner={yes|no|auto*}
114              Enable or disable startup banner
115
116
117       --color={yes|no|auto*}
118              Enable or disable color text
119
120
121       --history-file={yes*|no}
122              Load or save history
123
124
125       --depwarn={yes|no*|error}
126              Enable or disable syntax and method deprecation  warnings  (`er‐
127              ror` turns warnings into errors)
128
129
130       --warn-overwrite={yes|no*}
131              Enable or disable method overwrite warnings
132
133
134       --warn-scope={yes*|no}
135              Enable or disable warning for ambiguous top-level scope
136
137
138       -C, --cpu-target=<target>
139              Limit usage of CPU features up to <target>; set to `help` to see
140              the available options
141
142
143       -O, --optimize={0,1,2*,3}
144              Set the optimization level (level 3 if `-O` is  used  without  a
145              level)
146
147
148       --min-optlevel={0*,1,2,3}
149              Set a lower bound on the optimization level
150
151
152       -g {0,1*,2}
153              Set  the level of debug info generation (level 2 if `-g` is used
154              without a level)
155
156
157       --inline={yes*|no}
158              Control whether inlining is permitted, including overriding @in‐
159              line declarations
160
161
162       --check-bounds={yes|no|auto*}
163              Emit  bounds checks always, never, or respect @inbounds declara‐
164              tions
165
166
167       --math-mode={ieee|user}
168              Disallow or enable unsafe floating  point  optimizations  (over‐
169              rides @fastmath declaration)
170
171
172       --code-coverage[={none*|user|all}]
173              Count executions of source lines (omitting setting is equivalent
174              to `user`)
175
176
177       --code-coverage=@<path>
178              Count executions of source lines in a  file  or  files  under  a
179              given  directory.  A `@` must be placed before the path to indi‐
180              cate this option. A `@` with no path will track the current  di‐
181              rectory.
182
183
184        --code-coverage=tracefile.info
185               Append  coverage  information  to  the LCOV tracefile (filename
186              supports format tokens)
187
188
189       --track-allocation[={none*|user|all}]
190              Count bytes allocated by each source line (omitting  setting  is
191              equivalent to `user`)
192
193
194       --track-allocation=@<path>
195              Count bytes allocated by each source line in a file or files un‐
196              der a given directory. A `@` must be placed before the  path  to
197              indicate  this option. A `@` with no path will track the current
198              directory.
199
200
201       --bug-report=KIND
202              Launch a bug report session. It can be used to start a REPL, run
203              a  script, or evaluate expressions. It first tries to use BugRe‐
204              porting.jl installed in current environment and fallbacks to the
205              latest  compatible BugReporting.jl if not. For more information,
206              see --bug-report=help.
207
208
209       --compile={yes*|no|all|min}
210              Enable or disable JIT compiler, or request exhaustive or minimal
211              compilation
212
213
214       --output-o <name>
215              Generate an object file (including system image data)
216
217
218       --output-ji <name>
219              Generate a system image data file (.ji)
220
221
222       --strip-metadata
223              Remove docstrings and source location info from system image
224
225
226       --strip-ir
227              Remove IR (intermediate representation) of compiled functions
228
229
230       --output-unopt-bc <name>
231              Generate unoptimized LLVM bitcode (.bc)
232
233
234       --output-bc <name>
235              Generate LLVM bitcode (.bc)
236
237
238       --output-asm <name>
239              Generate an assembly file (.s)
240
241
242       --output-incremental={yes|no*}
243              Generate an incremental output file (rather than complete)
244
245
246       --trace-compile={stderr,name}
247              Print  precompile  statements for methods compiled during execu‐
248              tion or save to a path
249
250
251       -image-codegen
252              Force generate code in imaging mode
253
254

FILES AND ENVIRONMENT

256       See https://docs.julialang.org/en/v1/manual/environment-variables/
257
258

BUGS

260       Please   report   any   bugs   using   the   GitHub   issue    tracker:
261       https://github.com/julialang/julia/issues?state=open
262
263
264

AUTHORS

266       Contributors: https://github.com/JuliaLang/julia/graphs/contributors
267
268
269
270JULIA                             2022-02-17                          JULIA(1)