aboutsummaryrefslogtreecommitdiffstats
path: root/lib/kernel/doc/src/erl_boot_server.xml
blob: a8015fa453d51c2984010bc8b6218b35b49e54e9 (plain) (blame)
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
<?xml version="1.0" encoding="utf-8" ?>
<!DOCTYPE erlref SYSTEM "erlref.dtd">

<erlref>
  <header>
    <copyright>
      <year>1996</year><year>2013</year>
      <holder>Ericsson AB. All Rights Reserved.</holder>
    </copyright>
    <legalnotice>
      Licensed under the Apache License, Version 2.0 (the "License");
      you may not use this file except in compliance with the License.
      You may obtain a copy of the License at
 
          http://www.apache.org/licenses/LICENSE-2.0

      Unless required by applicable law or agreed to in writing, software
      distributed under the License is distributed on an "AS IS" BASIS,
      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
      See the License for the specific language governing permissions and
      limitations under the License.
    
    </legalnotice>

    <title>erl_boot_server</title>
    <prepared></prepared>
    <docno></docno>
    <date></date>
    <rev></rev>
  </header>
  <module>erl_boot_server</module>
  <modulesummary>Boot Server for Other Erlang Machines</modulesummary>
  <description>
    <p>This server is used to assist diskless Erlang nodes which fetch
      all Erlang code from another machine.</p>
    <p>This server is used to fetch all code, including the start
      script, if an Erlang runtime system is started with
      the <c>-loader inet</c> command line flag. All hosts specified
      with the <c>-hosts Host</c> command line flag must have one
      instance of this server running.</p>
    <p>This server can be started with the <c>kernel</c> configuration
      parameter <c>start_boot_server</c>.</p>
    <p>The <c>erl_boot_server</c> can both read regular files as well as
      files in archives. See <seealso marker="code">code(3)</seealso>
      and <seealso marker="erts:erl_prim_loader">erl_prim_loader(3)</seealso>.</p>
    <warning><p>The support for loading of code from archive files is
     experimental. The sole purpose of releasing it before it is ready
     is to obtain early feedback. The file format, semantics,
     interfaces etc. may be changed in a future release.</p></warning>
  </description>
  <funcs>
    <func>
      <name name="start" arity="1"/>
      <fsummary>Start the boot server</fsummary>
      <desc>
        <p>Starts the boot server. <c><anno>Slaves</anno></c> is a list of IP
          addresses for hosts which are allowed to use this server as a
          boot server.</p>
      </desc>
    </func>
    <func>
      <name name="start_link" arity="1"/>
      <fsummary>Start the boot server and links the caller</fsummary>
      <desc>
        <p>Starts the boot server and links to the caller. This function
          is used to start the server if it is included in a supervision
          tree.</p>
      </desc>
    </func>
    <func>
      <name name="add_slave" arity="1"/>
      <fsummary>Add a slave to the list of allowed slaves</fsummary>
      <desc>
        <p>Adds a <c><anno>Slave</anno></c> node to the list of allowed slave hosts.</p>
      </desc>
    </func>
    <func>
      <name name="delete_slave" arity="1"/>
      <fsummary>Delete a slave from the list of allowed slaves</fsummary>
      <desc>
        <p>Deletes a <c><anno>Slave</anno></c> node from the list of allowed slave
          hosts.</p>
      </desc>
    </func>
    <func>
      <name name="which_slaves" arity="0"/>
      <fsummary>Return the current list of allowed slave hosts</fsummary>
      <desc>
        <p>Returns the current list of allowed slave hosts.</p>
      </desc>
    </func>
  </funcs>

  <section>
    <title>SEE ALSO</title>
    <p><seealso marker="erts:init">init(3)</seealso>,  
      <seealso marker="erts:erl_prim_loader">erl_prim_loader(3)</seealso></p>
  </section>
</erlref>