1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
|
.It Fl h , -help
Displays the help message to the standard error (stderr) and exits.
.It Fl v , -version
Displays the Elixir version to the standard output (stdout) and exits.
.It Fl e , -eval Ar expression
Evaluates the specified expression
.Pq see the Fl -rpc-eval No option .
.It Fl r Ar file
Requires the specified file. In other words, the file is checked for existence at the start of
.Nm .
.It Fl S Ar script
Runs the specified script.
.It Fl pa Ar directory
Adds the specified directory to the beginning of the code path. If the directory already exists, it will be removed from its old position and put to the beginning.
.Pp
See also the function
.Sy Code.prepend_path/1 .
.It Fl pr Ar file
Does the same thing as
.Fl r
.Pq see above
but in parallel.
.It Fl pz Ar directory
Adds the specified directory to the end of the code path. If the directory already exists, it will be neither removed from its old position nor put to the end.
.Pp
See also the function
.Sy Code.append_path/1 .
.It Fl -app Ar application
Starts the specified application and all its dependencies.
.It Fl -boot Ar file
Specifies the name of the boot file,
.Ar file Ns .boot, which is used to start the system. Unless File contains an absolute path, the system searches for Ar file Ns .boot in the current and $ROOT/bin directories.
.Pp
Defaults to $ROOT/bin/start.boot.
.Pp
The option is equivalent to Erlang's
.Fl boot .
.It Fl -boot-var Ar var Ar dir
If the boot script contains a path variable
.Ar var
other than $ROOT, this variable is expanded to
.Ar dir .
Used when applications are installed in another directory than $ROOT/lib.
.Pp
The option is equivalent to Erlang's
.Fl boot_var .
.Pp
See also the function
.Sy :systools.make_script/1,2 No in SASL .
.It Fl -erl Ar parameters
Serves the same purpose as ELIXIR_ERL_OPTIONS
.Pq see the Sy ENVIRONMENT No section
.It Fl -erl-config Ar file
Specifies the name of a configuration file,
.Ar file Ns .config, which is used to configure applications. Note that the configuration file must be written in Erlang.
.Pp
The option is equivalent to Erlang's
.Fl config .
.It Fl -cookie Ar value
Specifies the magic cookie value. If the value isn't specified via the option when the node starts, it will be taken from the file
.Pa ~/.erlang.cookie
.Pq see the Sy FILES No section .
Distributed nodes can interact with each other only when their magic cookies are equal.
.Pp
See also the function
.Sy Node.set_cookie/2 .
.It Fl -hidden
Starts a hidden node.
.Pp
Connections between nodes are transitive. For example, if node A is connected to node B, and node B is connected to node C, then node A is connected to node C. The option
.Fl -hidden
allows creating a node which can be connected to another node, escaping redundant connections.
.Pp
The function
.Sy Node.list/0
allows getting the list of nodes connected to the target node; however, the list won't include hidden nodes. Depending on the input parameter, the function
.Sy Node.list/1
allows getting the list which contains only hidden nodes
.Pq the parameter Ar :hidden
or both hidden and not hidden nodes
.Pq the parameter Ar :connected .
.It Fl -logger-otp-reports Ar val
Enables or disables OTP reporting
.Pq Ar val No can be either true or false .
.It Fl -logger-sasl-reports Ar val
Enables or disables SASL reporting
.Pq Ar val No can be either true or false .
.It Fl -sname Ar name
Gives a node a short name and starts it. Short names take the form of
.Ar name Ns
@host, where host is the name of the target host
.Pq Xr hostname 1
which runs the node. The nodes with short names can interact with each other only in the same local network.
.It Fl -name Ar name
Gives a node a long name and starts it. Long names take the form of
.Ar name Ns
@host, where host is the IP address of the host which runs the node. In contrast to the nodes with short names, the nodes with long names aren't limited by boundaries of a local network
.Pq see above .
.It Fl -pipe-to Ar pipedir Ar logdir
Starts the Erlang VM as a named
.Ar pipedir
and
.Ar logdir
.Pq only for Unix-like operating systems .
.It Fl -rpc-eval Ar node Ar expression
Evaluates the specified expression on the specified node
.Pq see the Fl -eval No option .
.It Fl -vm-args Ar file
Reads the command-line arguments from
.Ar file
and passes them to the Erlang VM.
.Pp
The option is equivalent to Erlang's
.Fl args_file .
.It Fl -werl
Uses Erlang's Windows shell GUI
.Pq only for Windows .
|
