diff options
Diffstat (limited to 'docs/en/erlang.mk/1/guide/sfx')
| -rw-r--r-- | docs/en/erlang.mk/1/guide/sfx/index.html | 63 |
1 files changed, 22 insertions, 41 deletions
diff --git a/docs/en/erlang.mk/1/guide/sfx/index.html b/docs/en/erlang.mk/1/guide/sfx/index.html index b9942e94..10b337f4 100644 --- a/docs/en/erlang.mk/1/guide/sfx/index.html +++ b/docs/en/erlang.mk/1/guide/sfx/index.html @@ -62,55 +62,36 @@ <h1 class="lined-header"><span>Self-extracting releases</span></h1> -<div class="paragraph"><p>Erlang.mk allows you to package <a href="../relx">Relx releases</a> as -self-extracting archives. These archives contain all the -files in the release and come in the form of a script that -will extract and run the release automatically.</p></div> -<div class="paragraph"><p>This allows you to package the release as a single file -that can then be executed.</p></div> -<div class="paragraph"><p>This feature is currently experimental. Feedback is much -appreciated.</p></div> -<div class="sect1"> +<p>Erlang.mk allows you to package <a href="../relx">Relx releases</a> as self-extracting archives. These archives contain all the files in the release and come in the form of a script that will extract and run the release automatically.</p> +<p>This allows you to package the release as a single file that can then be executed.</p> +<p>This feature is currently experimental. Feedback is much appreciated.</p> <h2 id="_generating_the_self_extracting_archive">Generating the self-extracting archive</h2> -<div class="sectionbody"> -<div class="paragraph"><p>To generate a self-extracting release, all you need to do -is pass the <code>SFX=1</code> variable to Make when you build the -release:</p></div> -<div class="listingblock"> -<div class="content"><!-- Generator: GNU source-highlight +<p>To generate a self-extracting release, all you need to do is pass the <code>SFX=1</code> variable to Make when you build the release:</p> +<div class="listingblock"><div class="content"><!-- Generator: GNU source-highlight 3.1.8 by Lorenzo Bettini http://www.lorenzobettini.it http://www.gnu.org/software/src-highlite --> -<pre><tt>$ make <span style="color: #009900">SFX</span><span style="color: #990000">=</span><span style="color: #993399">1</span></tt></pre></div></div> -<div class="paragraph"><p>This will create a self-extracting archive in -<code>$RELX_OUTPUT_DIR/<name>.run</code>. For example if the release -is named <code>hello_world</code> and <code>$RELX_OUTPUT_DIR</code> is the default, -the file will be located at <code>_rel/hello_world.run</code>.</p></div> -</div> -</div> -<div class="sect1"> +<pre><tt>$ make <font color="#009900">SFX</font><font color="#990000">=</font><font color="#993399">1</font></tt></pre> +</div></div> +<p>This will create a self-extracting archive in <code>$RELX_OUTPUT_DIR/<name>.run</code>. For example if the release is named <code>hello_world</code> and <code>$RELX_OUTPUT_DIR</code> is the default, the file will be located at <code>_rel/hello_world.run</code>.</p> <h2 id="_running_the_release">Running the release</h2> -<div class="sectionbody"> -<div class="paragraph"><p>Simply execute the script to get started:</p></div> -<div class="listingblock"> -<div class="content"><!-- Generator: GNU source-highlight +<p>Simply execute the script to get started:</p> +<div class="listingblock"><div class="content"><!-- Generator: GNU source-highlight 3.1.8 by Lorenzo Bettini http://www.lorenzobettini.it http://www.gnu.org/software/src-highlite --> -<pre><tt>$ <span style="color: #990000">./</span>_rel/hello_world<span style="color: #990000">.</span>run -Exec<span style="color: #990000">:</span> /tmp/tmp<span style="color: #990000">.</span>3eeEq7E1ta/erts-<span style="color: #993399">8.1</span>/bin/erlexec <span style="color: #990000">...</span> -Root<span style="color: #990000">:</span> /tmp/tmp<span style="color: #990000">.</span>3eeEq7E1ta -/tmp/tmp<span style="color: #990000">.</span>3eeEq7E1ta -Erlang/OTP <span style="color: #993399">19</span> <span style="color: #990000">[</span>erts-<span style="color: #993399">8.1</span><span style="color: #990000">]</span> <span style="color: #990000">[</span><span style="font-weight: bold"><span style="color: #0000FF">source</span></span><span style="color: #990000">]</span> <span style="color: #990000">[</span><span style="color: #993399">64</span>-bit<span style="color: #990000">]</span> <span style="color: #990000">[</span>smp<span style="color: #990000">:</span><span style="color: #993399">4</span><span style="color: #990000">:</span><span style="color: #993399">4</span><span style="color: #990000">]</span> <span style="color: #990000">...</span> - -Eshell V8<span style="color: #990000">.</span><span style="color: #993399">1</span> <span style="color: #990000">(</span>abort with <span style="color: #990000">^</span>G<span style="color: #990000">)</span> -<span style="color: #990000">(</span>hello_world@localhost<span style="color: #990000">)</span><span style="color: #993399">1</span><span style="color: #990000">></span></tt></pre></div></div> -<div class="paragraph"><p>As you can see the archive is extracted to a temporary -directory before the release can be started.</p></div> -<div class="paragraph"><p>The self-extracting script currently only supports starting -the release in <code>console</code> mode.</p></div> -</div> -</div> +<pre><tt>$ <font color="#990000">./</font>_rel/hello_world<font color="#990000">.</font>run +Exec<font color="#990000">:</font> /tmp/tmp<font color="#990000">.</font>3eeEq7E1ta/erts-<font color="#993399">8.1</font>/bin/erlexec <font color="#990000">...</font> +Root<font color="#990000">:</font> /tmp/tmp<font color="#990000">.</font>3eeEq7E1ta +/tmp/tmp<font color="#990000">.</font>3eeEq7E1ta +Erlang/OTP <font color="#993399">19</font> <font color="#990000">[</font>erts-<font color="#993399">8.1</font><font color="#990000">]</font> <font color="#990000">[</font><b><font color="#0000FF">source</font></b><font color="#990000">]</font> <font color="#990000">[</font><font color="#993399">64</font>-bit<font color="#990000">]</font> <font color="#990000">[</font>smp<font color="#990000">:</font><font color="#993399">4</font><font color="#990000">:</font><font color="#993399">4</font><font color="#990000">]</font> <font color="#990000">...</font> + +Eshell V8<font color="#990000">.</font><font color="#993399">1</font> <font color="#990000">(</font>abort with <font color="#990000">^</font>G<font color="#990000">)</font> +<font color="#990000">(</font>hello_world@localhost<font color="#990000">)</font><font color="#993399">1</font><font color="#990000">></font></tt></pre> +</div></div> +<p>As you can see the archive is extracted to a temporary directory before the release can be started.</p> +<p>The self-extracting script currently only supports starting the release in <code>console</code> mode.</p> + |