1JULIA(1) General Commands Manual JULIA(1)
3
7 julia - a high-level, high-performance dynamic programming language for
8 technical computing
9
12 julia [OPTIONS...] -- [PROGRAMMFILE] [ARGS...]
13 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
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
37 -v, --version
38 Display version information
39 -h, --help
42 Print help message
43 --help-hidden
46 Print uncommon options not shown by `-h`
47 --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 -J, --sysimage <file>
56 Start up with the given system image file
57 -H, --home <dir>
60 Set location of julia executable
61 --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 --handle-signals={yes*|no}
69 Enable or disable Julia's default signal handlers
70 --sysimage-native-code={yes*|no}
73 Use native code from system image if available
74 --compiled-modules={yes*|no}
77 Enable or disable incremental precompilation of modules
78 -e, --eval <expr>
81 Evaluate <expr>
82 -E, --print <expr>
85 Evaluate <expr> and display the result
86 -L, --load <file>
89 Load <file> immediately on all processors
90 -t, --threads <n>
93 Enable n threads; "auto" tries to infer a useful default number
94 of threads to use but the exact behavior might change in the fu‐
95 ture. Currently, "auto" uses the number of CPUs assigned to
96 this julia process based on the OS-specific affinity assignment
97 interface, if supported (Linux and Windows). If this is not sup‐
98 ported (macOS) or process affinity is not configured, it uses
99 the number of CPU threads.
100 -p, --procs {N|auto}
103 Integer value N launches N additional local worker processes
104 `auto` launches as many workers as the number of local CPU
105 threads (logical cores)
106 --machine-file <file>
109 Run processes on hosts listed in <file>
110 -i Interactive mode; REPL runs and `isinteractive()` is true
113 -q, --quiet
116 Quiet startup: no banner, suppress REPL warnings
117 --banner={yes|no|auto*}
120 Enable or disable startup banner
121 --color={yes|no|auto*}
124 Enable or disable color text
125 --history-file={yes*|no}
128 Load or save history
129 --depwarn={yes|no*|error}
132 Enable or disable syntax and method deprecation warnings (`er‐
133 ror` turns warnings into errors)
134 --warn-overwrite={yes|no*}
137 Enable or disable method overwrite warnings
138 --warn-scope={yes*|no}
141 Enable or disable warning for ambiguous top-level scope
142 -C, --cpu-target=<target>
145 Limit usage of CPU features up to <target>; set to `help` to see
146 the available options
147 -O, --optimize={0,1,2*,3}
150 Set the optimization level (level 3 if `-O` is used without a
151 level)
152 --min-optlevel={0*,1,2,3}
155 Set a lower bound on the optimization level
156 -g {0,1*,2}
159 Set the level of debug info generation (level 2 if `-g` is used
160 without a level)
161 --inline={yes*|no}
164 Control whether inlining is permitted, including overriding @in‐
165 line declarations
166 --check-bounds={yes|no|auto*}
169 Emit bounds checks always, never, or respect @inbounds declara‐
170 tions
171 --math-mode={ieee|user}
174 Disallow or enable unsafe floating point optimizations (over‐
175 rides @fastmath declaration)
176 --code-coverage[={none*|user|all}]
179 Count executions of source lines (omitting setting is equivalent
180 to `user`)
181 --code-coverage=@<path>
184 Count executions of source lines in a file or files under a
185 given directory. A `@` must be placed before the path to indi‐
186 cate this option. A `@` with no path will track the current di‐
187 rectory.
188 --code-coverage=tracefile.info
191 Append coverage information to the LCOV tracefile (filename
192 supports format tokens)
193 --track-allocation[={none*|user|all}]
196 Count bytes allocated by each source line (omitting setting is
197 equivalent to `user`)
198 --track-allocation=@<path>
201 Count bytes allocated by each source line in a file or files un‐
202 der a given directory. A `@` must be placed before the path to
203 indicate this option. A `@` with no path will track the current
204 directory.
205 --bug-report=KIND
208 Launch a bug report session. It can be used to start a REPL, run
209 a script, or evaluate expressions. It first tries to use BugRe‐
210 porting.jl installed in current environment and fallbacks to the
211 latest compatible BugReporting.jl if not. For more information,
212 see --bug-report=help.
213 --heap-size-hint=<size>
216 Forces garbage collection if memory usage is higher than that
217 value. The memory hint might be specified in megabytes (500M) or
218 gigabytes (1.5G)
219 --compile={yes*|no|all|min}
222 Enable or disable JIT compiler, or request exhaustive or minimal
223 compilation
224 --output-o <name>
227 Generate an object file (including system image data)
228 --output-ji <name>
231 Generate a system image data file (.ji)
232 --strip-metadata
235 Remove docstrings and source location info from system image
236 --strip-ir
239 Remove IR (intermediate representation) of compiled functions
240 --output-unopt-bc <name>
243 Generate unoptimized LLVM bitcode (.bc)
244 --output-bc <name>
247 Generate LLVM bitcode (.bc)
248 --output-asm <name>
251 Generate an assembly file (.s)
252 --output-incremental={yes|no*}
255 Generate an incremental output file (rather than complete)
256 --trace-compile={stderr,name}
259 Print precompile statements for methods compiled during execu‐
260 tion or save to a path
261 -image-codegen
264 Force generate code in imaging mode
265
268 See https://docs.julialang.org/en/v1/manual/environment-variables/
269
272 Please report any bugs using the GitHub issue tracker:
273 https://github.com/julialang/julia/issues?state=open
274
278 Contributors: https://github.com/JuliaLang/julia/graphs/contributors
279JULIA 2022-02-17 JULIA(1)