agas¶
The contents of this module can be included with the header
hpx/modules/agas.hpp
. These headers may be used by user-code but are not
guaranteed stable (neither header location nor contents). You are using these at
your own risk. If you wish to use non-public functionality from a module we
strongly suggest only including the module header hpx/modules/agas.hpp
, not
the particular header in which the functionality you would like to use is
defined. See Public API for a list of names that are part of the public
HPX API.
-
namespace
hpx
AGAS’s primary namespace maps 128-bit global identifiers (GIDs) to resolved addresses.
The following is the canonical description of the partitioning of AGAS’s primary namespace.
|-----MSB------||------LSB-----| BBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBB |prefix||RC||----identifier----| MSB - Most significant bits (bit 64 to bit 127) LSB - Least significant bits (bit 0 to bit 63) prefix - Highest 32 bits (bit 96 to bit 127) of the MSB. Each locality is assigned a prefix. This creates a 96-bit address space for each locality. RC - Bit 88 to bit 92 of the MSB. This is the log2 of the number of reference counting credits on the GID. Bit 93 is used by the locking scheme for gid_types. Bit 94 is a flag which is set if the credit value is valid. Bit 95 is a flag that is set if a GID's credit count is ever split (e.g. if the GID is ever passed to another locality). - Bit 87 marks the gid such that it will not be stored in any of the AGAS caches. This is used mainly for ids which represent 'one-shot' objects (like promises). identifier - Bit 64 to bit 86 of the MSB, and the entire LSB. The content of these bits depends on the component type of the underlying object. For all user-defined components, these bits contain a unique 88-bit number which is assigned sequentially for each locality. For \a hpx#components#component_runtime_support the high 24 bits are zeroed and the low 64 bits hold the LVA of the component.
- Note
The layout of the address space is implementation defined, and subject to change. Never write application code that relies on the internal layout of GIDs. AGAS only guarantees that all assigned GIDs will be unique.
The following address ranges are reserved. Some are either explicitly or implicitly protected by AGAS. The letter x represents a single-byte wild card.
00000000xxxxxxxxxxxxxxxxxxxxxxxx Historically unused address space reserved for future use. xxxxxxxxxxxx0000xxxxxxxxxxxxxxxx Address space for LVA-encoded GIDs. 00000001xxxxxxxxxxxxxxxxxxxxxxxx Prefix of the bootstrap AGAS locality. 00000001000000010000000000000001 Address of the primary_namespace component on the bootstrap AGAS locality. 00000001000000010000000000000002 Address of the component_namespace component on the bootstrap AGAS locality. 00000001000000010000000000000003 Address of the symbol_namespace component on the bootstrap AGAS locality. 00000001000000010000000000000004 Address of the locality_namespace component on the bootstrap AGAS locality.
-
namespace
agas
¶ Typedefs
-
using
iterate_types_function_type
= hpx::util::function<void(std::string const&, components::component_type)>¶
-
using
-
namespace
components
-
namespace
naming
¶ -
Functions
-
resolver_client &
get_agas_client
()¶
-
resolver_client &
-
namespace
hpx
AGAS’s primary namespace maps 128-bit global identifiers (GIDs) to resolved addresses.
The following is the canonical description of the partitioning of AGAS’s primary namespace.
|-----MSB------||------LSB-----| BBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBB |prefix||RC||----identifier----| MSB - Most significant bits (bit 64 to bit 127) LSB - Least significant bits (bit 0 to bit 63) prefix - Highest 32 bits (bit 96 to bit 127) of the MSB. Each locality is assigned a prefix. This creates a 96-bit address space for each locality. RC - Bit 88 to bit 92 of the MSB. This is the log2 of the number of reference counting credits on the GID. Bit 93 is used by the locking scheme for gid_types. Bit 94 is a flag which is set if the credit value is valid. Bit 95 is a flag that is set if a GID's credit count is ever split (e.g. if the GID is ever passed to another locality). - Bit 87 marks the gid such that it will not be stored in any of the AGAS caches. This is used mainly for ids which represent 'one-shot' objects (like promises). identifier - Bit 64 to bit 86 of the MSB, and the entire LSB. The content of these bits depends on the component type of the underlying object. For all user-defined components, these bits contain a unique 88-bit number which is assigned sequentially for each locality. For \a hpx#components#component_runtime_support the high 24 bits are zeroed and the low 64 bits hold the LVA of the component.
- Note
The layout of the address space is implementation defined, and subject to change. Never write application code that relies on the internal layout of GIDs. AGAS only guarantees that all assigned GIDs will be unique.
The following address ranges are reserved. Some are either explicitly or implicitly protected by AGAS. The letter x represents a single-byte wild card.
00000000xxxxxxxxxxxxxxxxxxxxxxxx Historically unused address space reserved for future use. xxxxxxxxxxxx0000xxxxxxxxxxxxxxxx Address space for LVA-encoded GIDs. 00000001xxxxxxxxxxxxxxxxxxxxxxxx Prefix of the bootstrap AGAS locality. 00000001000000010000000000000001 Address of the primary_namespace component on the bootstrap AGAS locality. 00000001000000010000000000000002 Address of the component_namespace component on the bootstrap AGAS locality. 00000001000000010000000000000003 Address of the symbol_namespace component on the bootstrap AGAS locality. 00000001000000010000000000000004 Address of the locality_namespace component on the bootstrap AGAS locality.
-
namespace
agas
Functions
-
struct
gva
¶ -
Public Functions
-
gva
()¶
-
gva
(naming::gid_type const &p, component_type t = components::component_invalid, std::uint64_t c = 1, lva_type a = 0, std::uint64_t o = 0)¶
-
gva
(void *a)¶
-
void
lva
(void *a)¶
Public Members
-
component_type
type
¶
Private Functions
Friends
-
friend
hpx::agas::hpx::serialization::access
-
-
struct
-
namespace
hpx
AGAS’s primary namespace maps 128-bit global identifiers (GIDs) to resolved addresses.
The following is the canonical description of the partitioning of AGAS’s primary namespace.
|-----MSB------||------LSB-----| BBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBB |prefix||RC||----identifier----| MSB - Most significant bits (bit 64 to bit 127) LSB - Least significant bits (bit 0 to bit 63) prefix - Highest 32 bits (bit 96 to bit 127) of the MSB. Each locality is assigned a prefix. This creates a 96-bit address space for each locality. RC - Bit 88 to bit 92 of the MSB. This is the log2 of the number of reference counting credits on the GID. Bit 93 is used by the locking scheme for gid_types. Bit 94 is a flag which is set if the credit value is valid. Bit 95 is a flag that is set if a GID's credit count is ever split (e.g. if the GID is ever passed to another locality). - Bit 87 marks the gid such that it will not be stored in any of the AGAS caches. This is used mainly for ids which represent 'one-shot' objects (like promises). identifier - Bit 64 to bit 86 of the MSB, and the entire LSB. The content of these bits depends on the component type of the underlying object. For all user-defined components, these bits contain a unique 88-bit number which is assigned sequentially for each locality. For \a hpx#components#component_runtime_support the high 24 bits are zeroed and the low 64 bits hold the LVA of the component.
- Note
The layout of the address space is implementation defined, and subject to change. Never write application code that relies on the internal layout of GIDs. AGAS only guarantees that all assigned GIDs will be unique.
The following address ranges are reserved. Some are either explicitly or implicitly protected by AGAS. The letter x represents a single-byte wild card.
00000000xxxxxxxxxxxxxxxxxxxxxxxx Historically unused address space reserved for future use. xxxxxxxxxxxx0000xxxxxxxxxxxxxxxx Address space for LVA-encoded GIDs. 00000001xxxxxxxxxxxxxxxxxxxxxxxx Prefix of the bootstrap AGAS locality. 00000001000000010000000000000001 Address of the primary_namespace component on the bootstrap AGAS locality. 00000001000000010000000000000002 Address of the component_namespace component on the bootstrap AGAS locality. 00000001000000010000000000000003 Address of the symbol_namespace component on the bootstrap AGAS locality. 00000001000000010000000000000004 Address of the locality_namespace component on the bootstrap AGAS locality.
-
namespace
agas
-
struct
primary_namespace
¶ -
Public Functions
-
primary_namespace
()¶
-
~primary_namespace
()¶
-
naming::address::address_type
ptr
() const¶
-
hpx::future<std::pair<naming::id_type, naming::address>>
begin_migration
(naming::gid_type const &id)¶
-
resolved_type
resolve_gid
(naming::gid_type const &id)¶
-
future<resolved_type>
resolve_full
(naming::gid_type id)¶
-
future<std::int64_t>
increment_credit
(std::int64_t credits, naming::gid_type lower, naming::gid_type upper)¶
-
void
unregister_server_instance
(error_code &ec)¶
-
server::primary_namespace &
get_service
()¶
Public Static Functions
Private Members
-
std::unique_ptr<server::primary_namespace>
server_
¶
-
-
struct
Variables
-
HPX_ACTION_USES_MEDIUM_STACK ( hpx::agas::server::primary_namespace::allocate_action) HPX_REGISTER_ACTION_DECLARATION( hpx typedef std::pair<hpx::naming::id_type, hpx::naming::address> std_pair_address_id_type
-
namespace
hpx
AGAS’s primary namespace maps 128-bit global identifiers (GIDs) to resolved addresses.
The following is the canonical description of the partitioning of AGAS’s primary namespace.
|-----MSB------||------LSB-----| BBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBB |prefix||RC||----identifier----| MSB - Most significant bits (bit 64 to bit 127) LSB - Least significant bits (bit 0 to bit 63) prefix - Highest 32 bits (bit 96 to bit 127) of the MSB. Each locality is assigned a prefix. This creates a 96-bit address space for each locality. RC - Bit 88 to bit 92 of the MSB. This is the log2 of the number of reference counting credits on the GID. Bit 93 is used by the locking scheme for gid_types. Bit 94 is a flag which is set if the credit value is valid. Bit 95 is a flag that is set if a GID's credit count is ever split (e.g. if the GID is ever passed to another locality). - Bit 87 marks the gid such that it will not be stored in any of the AGAS caches. This is used mainly for ids which represent 'one-shot' objects (like promises). identifier - Bit 64 to bit 86 of the MSB, and the entire LSB. The content of these bits depends on the component type of the underlying object. For all user-defined components, these bits contain a unique 88-bit number which is assigned sequentially for each locality. For \a hpx#components#component_runtime_support the high 24 bits are zeroed and the low 64 bits hold the LVA of the component.
- Note
The layout of the address space is implementation defined, and subject to change. Never write application code that relies on the internal layout of GIDs. AGAS only guarantees that all assigned GIDs will be unique.
The following address ranges are reserved. Some are either explicitly or implicitly protected by AGAS. The letter x represents a single-byte wild card.
00000000xxxxxxxxxxxxxxxxxxxxxxxx Historically unused address space reserved for future use. xxxxxxxxxxxx0000xxxxxxxxxxxxxxxx Address space for LVA-encoded GIDs. 00000001xxxxxxxxxxxxxxxxxxxxxxxx Prefix of the bootstrap AGAS locality. 00000001000000010000000000000001 Address of the primary_namespace component on the bootstrap AGAS locality. 00000001000000010000000000000002 Address of the component_namespace component on the bootstrap AGAS locality. 00000001000000010000000000000003 Address of the symbol_namespace component on the bootstrap AGAS locality. 00000001000000010000000000000004 Address of the locality_namespace component on the bootstrap AGAS locality.
-
namespace
agas
Functions
-
namespace
server
¶ Variables
-
constexpr char const *const
primary_namespace_service_name
= "primary/"¶
-
struct
primary_namespace
: public components::fixed_component_base<primary_namespace>¶ Public Types
-
typedef components::fixed_component_base<primary_namespace>
base_type
¶
-
typedef std::map<naming::gid_type, gva_table_data_type>
gva_table_type
¶
Public Functions
-
primary_namespace
()¶
-
void
finalize
()¶
-
void
register_server_instance
(char const *servicename, std::uint32_t locality_id = naming::invalid_locality_id, error_code &ec = throws)¶
-
void
unregister_server_instance
(error_code &ec = throws)¶
-
resolved_type
resolve_gid
(naming::gid_type const &id)¶
-
std::int64_t
increment_credit
(std::int64_t credits, naming::gid_type lower, naming::gid_type upper)¶
-
std::vector<std::int64_t>
decrement_credit
(std::vector<hpx::tuple<std::int64_t, naming::gid_type, naming::gid_type>> const &requests)¶
-
HPX_DEFINE_COMPONENT_ACTION
(primary_namespace, allocate)¶
-
HPX_DEFINE_COMPONENT_ACTION
(primary_namespace, bind_gid)¶
-
HPX_DEFINE_COMPONENT_ACTION
(primary_namespace, colocate)¶
-
HPX_DEFINE_COMPONENT_ACTION
(primary_namespace, begin_migration)¶
-
HPX_DEFINE_COMPONENT_ACTION
(primary_namespace, end_migration)¶
-
HPX_DEFINE_COMPONENT_ACTION
(primary_namespace, decrement_credit)¶
-
HPX_DEFINE_COMPONENT_ACTION
(primary_namespace, increment_credit)¶
-
HPX_DEFINE_COMPONENT_ACTION
(primary_namespace, resolve_gid)¶
-
HPX_DEFINE_COMPONENT_ACTION
(primary_namespace, unbind_gid)¶
Public Members
-
counter_data
counter_data_
¶
Private Types
-
typedef std::map<naming::gid_type, hpx::tuple<bool, std::size_t, lcos::local::detail::condition_variable>>
migration_table_type
¶
-
using
free_entry_allocator_type
= util::internal_allocator<free_entry>¶
-
using
free_entry_list_type
= std::list<free_entry, free_entry_allocator_type>¶
Private Functions
-
void
wait_for_migration_locked
(std::unique_lock<mutex_type> &l, naming::gid_type const &id, error_code &ec)¶
-
resolved_type
resolve_gid_locked
(std::unique_lock<mutex_type> &l, naming::gid_type const &gid, error_code &ec)¶
-
void
increment
(naming::gid_type const &lower, naming::gid_type const &upper, std::int64_t &credits, error_code &ec)¶
-
void
resolve_free_list
(std::unique_lock<mutex_type> &l, std::list<refcnt_table_type::iterator> const &free_list, free_entry_list_type &free_entry_list, naming::gid_type const &lower, naming::gid_type const &upper, error_code &ec)¶
-
void
decrement_sweep
(free_entry_list_type &free_list, naming::gid_type const &lower, naming::gid_type const &upper, std::int64_t credits, error_code &ec)¶
-
void
free_components_sync
(free_entry_list_type &free_list, naming::gid_type const &lower, naming::gid_type const &upper, error_code &ec)¶
Private Members
-
mutex_type
mutex_
¶
-
gva_table_type
gvas_
¶
-
refcnt_table_type
refcnts_
¶
-
migration_table_type
migrating_objects_
¶
-
struct
counter_data
¶ Public Functions
-
HPX_NON_COPYABLE
(counter_data)¶
-
counter_data
()¶
-
void
increment_route_count
()¶
-
void
increment_bind_gid_count
()¶
-
void
increment_resolve_gid_count
()¶
-
void
increment_unbind_gid_count
()¶
-
void
increment_increment_credit_count
()¶
-
void
increment_decrement_credit_count
()¶
-
void
increment_allocate_count
()¶
-
void
increment_begin_migration_count
()¶
-
void
increment_end_migration_count
()¶
-
void
enable_all
()¶
Public Members
-
api_counter_data
route_
¶
-
api_counter_data
bind_gid_
¶
-
api_counter_data
resolve_gid_
¶
-
api_counter_data
unbind_gid_
¶
-
api_counter_data
increment_credit_
¶
-
api_counter_data
decrement_credit_
¶
-
api_counter_data
allocate_
¶
-
api_counter_data
begin_migration_
¶
-
api_counter_data
end_migration_
¶
-
-
typedef components::fixed_component_base<primary_namespace>
-
constexpr char const *const
-
namespace