From b051513f18653113ac2c23008836c500e1425283 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Lo=C3=AFc=20Hoguin?= Date: Sat, 5 Nov 2016 14:26:30 +0200 Subject: Update docs --- docs/en/erlang.mk/1/guide/sfx/index.html | 206 +++++++++++++++++++++++++++++++ 1 file changed, 206 insertions(+) create mode 100644 docs/en/erlang.mk/1/guide/sfx/index.html (limited to 'docs/en/erlang.mk/1/guide/sfx') diff --git a/docs/en/erlang.mk/1/guide/sfx/index.html b/docs/en/erlang.mk/1/guide/sfx/index.html new file mode 100644 index 00000000..8433ab9c --- /dev/null +++ b/docs/en/erlang.mk/1/guide/sfx/index.html @@ -0,0 +1,206 @@ + + + + + + + + + + + + Nine Nines: Self-extracting releases + + + + + + + + + + + + + + + + +
+
+
+
+

99s

+
+
+ +
+ +
    +
  • + Github +
    • +
  • + +
    • +
  • + +
    • +
+
+
+
+
+ + +
+ +
+
+
+
+ +

Self-extracting releases

+ +

Erlang.mk allows you to package Relx releases 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.

+

This allows you to package the release as a single file +that can then be executed.

+

This feature is currently experimental. Feedback is much +appreciated.

+
+

Generating the self-extracting archive

+
+

To generate a self-extracting release, all you need to do +is pass the SFX=1 variable to Make when you build the +release:

+
+
+
$ make SFX=1
+

This will create a self-extracting archive in +$RELX_OUTPUT_DIR/<name>.run. For example if the release +is named hello_world and $RELX_OUTPUT_DIR is the default, +the file will be located at _rel/hello_world.run.

+
+
+
+

Running the release

+
+

Simply execute the script to get started:

+
+
+
$ ./_rel/hello_world.run
+Exec: /tmp/tmp.3eeEq7E1ta/erts-8.1/bin/erlexec ...
+Root: /tmp/tmp.3eeEq7E1ta
+/tmp/tmp.3eeEq7E1ta
+Erlang/OTP 19 [erts-8.1] [source] [64-bit] [smp:4:4] ...
+
+Eshell V8.1  (abort with ^G)
+(hello_world@localhost)1>
+

As you can see the archive is extracted to a temporary +directory before the release can be started.

+

The self-extracting script currently only supports starting +the release in console mode.

+
+
+ + + + + + + + + + + + +
+ +
+ + +

+ Erlang.mk + 1 + + User Guide +

+ +
    + + + +
+ +

Navigation

+ +

Version select

+
    + + + +
  • 1
    • + +
+ +
+
+
+
+ + + + + + + + + + + + -- cgit v1.2.3