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.
basic_html(Bool) -> ok
Types:
Bool = true | false
If set to true, the ct_master logs are written on a primitive
HTML format, not using the Common Test CSS style sheet.
get_event_mgr_ref() -> MasterEvMgrRef
Types:
MasterEvMgrRef = atom()
Gets a reference to the Common Test master event manager. The
reference can be used to, for example, add a user-specific event
handler while tests are running.
Example:
gen_event:add_handler(ct_master:get_event_mgr_ref(), my_ev_h, [])
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 are not yet finished.
run(TestSpecs) -> ok
Types:
TestSpecs = string() | [SeparateOrMerged]
Equivalent to ct_master:run(TestSpecs, false, [], []).
run(TestSpecs, InclNodes, ExclNodes) -> ok
Types:
TestSpecs = string() | [SeparateOrMerged]
SeparateOrMerged = string() | [string()]
InclNodes = [atom()]
ExclNodes = [atom()]
Equivalent to ct_master:run(TestSpecs, false, InclNodes, ExclN-
odes).
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 is handled separately. However, it is
also possible to specify a list of specifications to be merged
into one specification before the tests are executed. Any test
without a particular node specification is also executed on the
nodes in InclNodes. Nodes in the ExclNodes list are excluded
from the test.
run_on_node(TestSpecs, Node) -> ok
Types:
TestSpecs = string() | [SeparateOrMerged]
SeparateOrMerged = string() | [string()]
Node = atom()
Equivalent to ct_master: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} | {al-
low_user_terms, Bool} | {logdir, LogDir} | {event_handler,
EventHandlers} | {silent_connections, Conns} | {cover, Cover-
SpecFile} | {cover_stop, Bool} | {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
Ericsson AB common_test 1.19 ct_master(3erl)