From 87677f64629f1f738e132659c445c3431b02c0b2 Mon Sep 17 00:00:00 2001
From: Rickard Green
Date: Fri, 30 Jun 2017 16:34:26 +0200
Subject: Example of using distribution controller processes
---
erts/doc/src/Makefile | 2 ++
erts/doc/src/alt_dist.xml | 14 ++++++++++++++
2 files changed, 16 insertions(+)
(limited to 'erts/doc')
diff --git a/erts/doc/src/Makefile b/erts/doc/src/Makefile
index b96cbbce40..444adf4a6e 100644
--- a/erts/doc/src/Makefile
+++ b/erts/doc/src/Makefile
@@ -173,6 +173,8 @@ release_docs_spec: docs
"$(RELSYSDIR)/doc/html"
$(INSTALL_DATA) $(ERL_TOP)/erts/example/time_compat.erl \
"$(RELSYSDIR)/doc/html"
+ $(INSTALL_DATA) $(ERL_TOP)/lib/kernel/examples/gen_tcp_dist/src/gen_tcp_dist.erl \
+ "$(RELSYSDIR)/doc/html"
$(INSTALL_DATA) $(INFO_FILE) "$(RELSYSDIR)"
$(INSTALL_DIR) "$(RELEASE_PATH)/man/man3"
$(INSTALL_DATA) $(MAN3DIR)/* "$(RELEASE_PATH)/man/man3"
diff --git a/erts/doc/src/alt_dist.xml b/erts/doc/src/alt_dist.xml
index 3d87e9dcdb..300f75dc13 100644
--- a/erts/doc/src/alt_dist.xml
+++ b/erts/doc/src/alt_dist.xml
@@ -64,6 +64,11 @@
etc in this example). That is, depending on what you want
to do you perhaps do not need to implement a driver at all
and can then skip the driver related sections below.
+ The gen_tcp_dist example described in the
+ Distribution
+ Module section utilize distribution controller
+ processes and can be worth having a look at if you want to
+ use distribution controller processes.
@@ -181,6 +186,15 @@
ignore exit signals. It is allowed to trap exits, but it should
then voluntarily terminate when an exit signal is received.
+
+ An example implementation of a distribution module can be found
+ in
+ $ERL_TOP/lib/kernel/examples/gen_tcp_dist/src/gen_tcp_dist.erl.
+ It implements the distribution over TCP/IP using the gen_tcp
+ API with distribution controllers implemented by processes. This
+ instead of using port distribution controllers as the ordinary TCP/IP
+ distribution uses.
+