net_adm(3erl) [linux man page]

net_adm(3erl)						     Erlang Module Definition						     net_adm(3erl)

NAME

       net_adm - Various Erlang Net Administration Routines

DESCRIPTION

       This module contains various network utility functions.

EXPORTS

       dns_hostname(Host) -> {ok, Name} | {error, Host}

	      Types  Host = atom() | string()
		     Name = string()

	      Returns the official name of Host , or {error, Host} if no such name is found. See also inet(3erl) .

       host_file() -> Hosts | {error, Reason}

	      Types  Hosts = [Host]
		     Host = atom()
		     Reason = term()

	      Reads  the  .hosts.erlang file, see the section Files below. Returns the hosts in this file as a list, or returns {error, Reason} if
	      the file could not be read. See file(3erl) for possible values of Reason .

       localhost() -> Name

	      Types  Name = string()

	      Returns the name of the local host. If Erlang was started with the -name command line flag, Name is the fully qualified name.

       names() -> {ok, [{Name, Port}]} | {error, Reason}
       names(Host) -> {ok, [{Name, Port}]} | {error, Reason}

	      Types  Name = string()
		     Port = int()
		     Reason = address | term()

	      Similar to epmd -names , see epmd(1) . Host defaults to the local host. Returns the names and associated port numbers of the  Erlang
	      nodes that epmd at the specified host has registered.

	      Returns {error, address} if epmd is not running. See inet(3erl) for other possible values of Reason .

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

       ping(Node) -> pong | pang

	      Types  Node = node()

	      Tries to set up a connection to Node . Returns pang if it fails, or pong if it is successful.

       world() -> [node()]
       world(Arg) -> [node()]

	      Types  Arg = silent | verbose

	      This  function  calls names(Host) for all hosts which are specified in the Erlang host file .hosts.erlang , collects the replies and
	      then evaluates ping(Node) on all those nodes. Returns the list of all nodes that were, successfully pinged.

	      Arg defaults to silent . If Arg == verbose , the function writes information about which nodes it is pinging to stdout.

	      This function can be useful when a node is started, and the names of the other nodes in the network are not initially known.

	      Failure: {error, Reason} if host_file() returns {error, Reason} .

       world_list(Hosts) -> [node()]
       world_list(Hosts, Arg) -> [node()]

	      Types  Hosts = [Host]
		     Host = atom()
		     Arg = silent | verbose

	      As world/0,1 , but the hosts are given as argument instead of being read from .hosts.erlang .

FILES

       The .hosts.erlang file consists of a number of host names written as Erlang terms. It is looked for in  the  current  work  directory,  the
       user's home directory, and $OTP_ROOT (the root directory of Erlang/OTP), in that order.

       The  format  of the .hosts.erlang file must be one host name per line. The host names must be within quotes as shown in the following exam-
       ple:

       ^ (new line)

Ericsson AB							   kernel 2.14.3						     net_adm(3erl)

ct_master(3erl) 					     Erlang Module Definition						   ct_master(3erl)

NAME

       ct_master - Distributed test execution control for Common Test.

DESCRIPTION

       Distributed test execution control for Common Test.

       This module exports functions for running Common Test nodes on multiple hosts in parallel.

EXPORTS

       abort() -> ok

	      Stops all running tests.

       abort(Nodes) -> ok

	      Types  Nodes = atom() | [atom()]

	      Stops tests on specified nodes.

       progress() -> [{Node, Status}]

	      Types  Node = atom()
		     Status = finished_ok | ongoing | aborted | {error, Reason}
		     Reason = term()

	      Returns test progress. If Status is ongoing , tests are running on the node and have not yet finished.

       run(TestSpecs) -> ok

	      Types  TestSpecs = string() | [SeparateOrMerged]

	      Equivalent to run(TestSpecs, false, [], []) .

       run(TestSpecs, InclNodes, ExclNodes) -> ok

	      Types  TestSpecs = string() | [SeparateOrMerged]
		     SeparateOrMerged = string() | [string()]
		     InclNodes = [atom()]
		     ExclNodes = [atom()]

	      Equivalent to run(TestSpecs, false, InclNodes, ExclNodes) .

       run(TestSpecs, AllowUserTerms, InclNodes, ExclNodes) -> ok

	      Types  TestSpecs = string() | [SeparateOrMerged]
		     SeparateOrMerged = string() | [string()]
		     AllowUserTerms = bool()
		     InclNodes = [atom()]
		     ExclNodes = [atom()]

	      Tests  are spawned on the nodes as specified in TestSpecs . Each specification in TestSpec will be handled separately. It is however
	      possible to also specify a list of specifications that should be merged into one before the tests are executed. Any test	without  a
	      particular  node	specification  will also be executed on the nodes in InclNodes . Nodes in the ExclNodes list will be excluded from
	      the test.

       run_on_node(TestSpecs, Node) -> ok

	      Types  TestSpecs = string() | [SeparateOrMerged]
		     SeparateOrMerged = string() | [string()]
		     Node = atom()

	      Equivalent to run_on_node(TestSpecs, false, Node) .

       run_on_node(TestSpecs, AllowUserTerms, Node) -> ok

	      Types  TestSpecs = string() | [SeparateOrMerged]
		     SeparateOrMerged = string() | [string()]
		     AllowUserTerms = bool()
		     Node = atom()

	      Tests are spawned on Node according to TestSpecs .

       run_test(Node, Opts) -> ok

	      Types  Node = atom()
		     Opts = [OptTuples]
		     OptTuples	=  {config,  CfgFiles}	|  {dir,  TestDirs}  |	{suite,  Suites}  |  {testcase,  Cases}  |  {spec,  TestSpecs}	 |
		     {allow_user_terms,  Bool}	| {logdir, LogDir} | {event_handler, EventHandlers} | {silent_connections, Conns} | {cover, Cover-
		     SpecFile} | {userconfig, UserCfgFiles}
		     CfgFiles = string() | [string()]
		     TestDirs = string() | [string()]
		     Suites = atom() | [atom()]
		     Cases = atom() | [atom()]
		     TestSpecs = string() | [string()]
		     LogDir = string()
		     EventHandlers = EH | [EH]
		     EH = atom() | {atom(), InitArgs} | {[atom()], InitArgs}
		     InitArgs = [term()]
		     Conns = all | [atom()]

	      Tests are spawned on Node using ct:run_test/1 .

AUTHORS

       <>

								 common_test 1.5.3						   ct_master(3erl)