File 0204-ERL-1046-Document-nocookie-argument.patch of Package erlang
From 53e08a5d027ae209afb786ad424644eb7cabd781 Mon Sep 17 00:00:00 2001 From: Wade Mealing <wmealing@gmail.com> Date: Thu, 15 Jan 2026 14:33:14 +1000 Subject: [PATCH] ERL-1046: Document -nocookie argument This fix documents the -nocookie argument used in lib/kernel/src/auth.erl because it is useful for preventing $HOME/.erlang.cookie from being automatically being automatically created. This patch was made in response to: https://github.com/erlang/otp/issues/3814 --- erts/doc/references/erl_cmd.md | 12 ++++++++++++ 1 file changed, 12 insertions(+) diff --git a/erts/doc/references/erl_cmd.md b/erts/doc/references/erl_cmd.md index 49f27d938f..343020bf93 100644 --- a/erts/doc/references/erl_cmd.md +++ b/erts/doc/references/erl_cmd.md @@ -349,6 +349,18 @@ described in the corresponding application documentation. > extension the cluster. When using un-secure distributed nodes, make sure > that the network is configured to keep potential attackers out. +- **`-nocookie`** - Prevents the node from creating or using the magic + cookie. + + When this flag is used, the node will not read the `~/.erlang.cookie` file on startup. + + The node's own cookie will remain "undefined" unless explicitly set later via + `erlang:set_cookie/1` or `erlang:set_cookie/2`. + + This effectively prevents the node from participating in a distributed Erlang + cluster with nodes that require cookie authentication. It is primarily used + for nodes that are intended to be isolated. + - **`-no_epmd`** - Specifies that the distributed node does not need [epmd](epmd_cmd.md) at all. -- 2.51.0
