NAME

       mnesia_registry - Dump support for registries in erl_interface.

DESCRIPTION

       This module is usually part of the erl_interface application, but is currently part of the
       Mnesia application.

       This module is mainly intended for internal use within OTP, but it has two functions  that
       are exported for public use.

       On  C-nodes,  erl_interface has support for registry tables. These tables reside in RAM on
       the C-node, but can also be dumped into Mnesia tables. By default, the dumping of registry
       tables  through  erl_interface  causes  a  corresponding  Mnesia  table to be created with
       mnesia_registry:create_table/1, if necessary.

       Tables that are created with these functions can  be  administered  as  all  other  Mnesia
       tables.  They can be included in backups, replicas can be added, and so on. The tables are
       normal Mnesia tables owned by the user of the corresponding erl_interface registries.

EXPORTS

       create_table(Tab) -> ok | exit(Reason)

              A wrapper function for mnesia:create_table/2, which creates a table (if there is no
              existing  table)  with  an appropriate set of attributes. The table only resides on
              the local node and its storage type is the same as the schema table  on  the  local
              node, that is, {ram_copies,[node()]} or {disc_copies,[node()]}.

              This  function  is  used by erl_interface to create the Mnesia table if it does not
              already exist.

       create_table(Tab, TabDef) -> ok | exit(Reason)

              A wrapper function for mnesia:create_table/2, which creates a table (if there is no
              existing  table)  with  an appropriate set of attributes. The attributes and TabDef
              are forwarded to mnesia:create_table/2. For example, if the table is to  reside  as
              disc_only_copies on all nodes, a call looks as follows:

                        TabDef = [{{disc_only_copies, node()|nodes()]}],
                        mnesia_registry:create_table(my_reg, TabDef)

SEE ALSO

       erl_interface(3erl), mnesia(3erl)