檢視原始碼 erl_epmd (kernel v10.2)

-spec address_please(Name, Host, AddressFamily) -> Success | {error, term()}
                        when
                            Name :: string(),
                            Host :: string() | inet:ip_address(),
                            AddressFamily :: inet | inet6,
                            Port :: non_neg_integer(),
                            Version :: non_neg_integer(),
                            Success :: {ok, inet:ip_address()} | {ok, inet:ip_address(), Port, Version}.

由分散式模組呼叫，以將遠端節點的 Host 解析為 IP 位址。

作為最佳化，此函式也可能會傳回遠端節點的埠號和版本。如果傳回埠號和版本，則不會呼叫 port_please/3。

listen_port_please(Name, Host)

(自 OTP 23.0 起)

-spec listen_port_please(Name, Host) -> {ok, Port}
                            when
                                Name :: atom() | string(),
                                Host :: atom() | string() | inet:ip_address(),
                                Port :: non_neg_integer().

由分散式模組呼叫，以取得本機節點在接受新的分散式請求時應監聽的埠號。

names(Host)

(自 OTP 21.0 起)

-spec names(Host) -> {ok, [{Name, Port}]} | {error, Reason}
               when
                   Host :: atom() | string() | inet:ip_address(),
                   Name :: string(),
                   Port :: non_neg_integer(),
                   Reason :: address | file:posix().

範例

(arne@dunn)1> erl_epmd:names(localhost).
{ok,[{"arne",40262}]}

port_please(Name, Host)

(自 OTP 21.0 起)

-spec port_please(Name, Host) -> {port, Port, Version} | noport | closed | {error, term()}
                     when
                         Name :: atom() | string(),
                         Host :: atom() | string() | inet:ip_address(),
                         Port :: non_neg_integer(),
                         Version :: non_neg_integer().

等同於 port_please(Name, Host, infinity)。

port_please(Name, Host, Timeout)

(自 OTP 21.0 起)

-spec port_please(Name, Host, Timeout) -> {port, Port, Version} | noport | closed | {error, term()}
                     when
                         Name :: atom() | string(),
                         Host :: atom() | string() | inet:ip_address(),
                         Timeout :: non_neg_integer() | infinity,
                         Port :: non_neg_integer(),
                         Version :: non_neg_integer().

請求 EPMD 實例中給定節點的分散式埠號。連同埠號，它會傳回自 Erlang/OTP R6 以來的分散式協定版本，該版本為 5。

register_node(Name, Port)

(自 OTP 21.0 起)

-spec register_node(Name, Port) -> Result
                       when
                           Name :: string(),
                           Port :: non_neg_integer(),
                           Creation :: non_neg_integer(),
                           Result :: {ok, Creation} | {error, already_registered} | term().

等同於 register_node(Name, Port, inet)。

register_node(Name, Port, Driver)

(自 OTP 21.0 起)

-spec register_node(Name, Port, Driver) -> Result
                       when
                           Name :: string(),
                           Port :: non_neg_integer(),
                           Driver :: inet_tcp | inet6_tcp | inet | inet6,
                           Creation :: non_neg_integer() | -1,
                           Result :: {ok, Creation} | {error, already_registered} | term().

在節點成功向 epmd 註冊後，如果連線中斷，它會自動嘗試重新連線至常駐程式。

start_link()

(自 OTP 21.0 起)

-spec start_link() -> {ok, pid()} | ignore | {error, term()}.

當此模組新增為 erl_distribution Supervisor 的子項目時，會呼叫此函式。