Ada Conformity Assessment Authority      Home Conformity Assessment   Test Suite ARGAda Standard
Annotated Ada Reference Manual (Ada 2022)Legal Information
Contents   Index   References   Search   Previous   Next 

E.2 Categorization of Library Units

[Library units can be categorized according to the role they play in a distributed program. Certain restrictions are associated with each category to ensure that the semantics of a distributed program remain close to the semantics for a nondistributed program.]
{AI05-0243-1} {AI12-0417-1} A categorization aspect A categorization pragma is a library unit pragma (see 10.1.5) that specifies a corresponding categorization aspect. A categorization aspect restricts the declarations, child units, or semantic dependences of the library unit to which it applies. A categorized library unit is a library unit that has a categorization aspect that is True.
{AI05-0243-1} {AI12-0417-1} The aspects pragmas Shared_Passive, Remote_Types, and Remote_Call_Interface are categorization aspects pragmas, and the associated aspects are categorization aspects. In addition, for the purposes of this Annex, the aspect Pure (see 10.2.1) is considered a categorization aspect and the pragma Pure is considered a categorization pragma.
{8652/0078} {AI95-00048-01} {AI05-0243-1} [ A library package or generic library package is called a shared passive library unit if the Shared_Passive aspect of the unit is True. A library package or generic library package is called a remote types library unit if the Remote_Types aspect of the unit is True. A library unit is called a remote call interface if the Remote_Call_Interface aspect of the unit is True.] A normal library unit is one for which no categorization aspect is True. 
Proof: {AI05-0243-1} {AI05-0299-1} These terms (other than “normal library unit”) are really defined in the following subclauses. 
Ramification: {8652/0078} {AI95-00048-01} A library subprogram can be a remote call interface, but it cannot be a remote types or shared passive library unit. 
{AI05-0206-1} {AI05-0243-1} {AI05-0269-1} {AI05-0299-1} [The various categories of library units and the associated restrictions are described in this and the following subclauses. The categories are related hierarchically in that the library units of one category can depend semantically only on library units of that category or an earlier one in the hierarchy, except that the body of a remote types or remote call interface library unit is unrestricted, the declaration of a remote types or remote call interface library unit may depend on preelaborated normal library units that are mentioned only in private with clauses, and all categories can depend on limited views.
{AI05-0243-1} {AI05-0269-1} The overall hierarchy (including declared pure) is as follows, with a lower-numbered category being “earlier in the hierarchy” in the sense of the previous paragraph: 
Declared Pure
Shared Passive
Remote Types
Remote Call Interface
Normal (no restrictions) 
Paragraphs 7 through 11 were deleted. 
Declared pure and shared passive library units are preelaborated. The declaration of a remote types or remote call interface library unit is required to be preelaborable. ]
Paragraph 13 and 14 were was deleted. 

Implementation Permissions

{AI12-0417-1} Implementations are allowed to define other categorization pragmas.

Wording Changes from Ada 95

{8652/0078} {AI95-00048-01} Corrigendum: Clarified that a library subprogram can be a remote call interface unit.
{8652/0079} {AI95-00208-01} Corrigendum: Removed the requirement that types be represented the same in all partitions, because it prevents the definition of heterogeneous distributed systems and goes much further than required. 

Wording Changes from Ada 2005

{AI05-0206-1} {AI05-0299-1} We now allow private withs of preelaborated units in Remote Types and Remote Call Interface units; this is documented as an extension in the subclauses where this is defined normatively.
{AI05-0243-1} {AI05-0299-1} We have introduced categorization aspects; these are documented as extensions in the subclauses where they actually are defined. 

Wording Changes from Ada 2012

{AI12-0417-1} Categorization pragmas are now obsolescent.

Contents   Index   References   Search   Previous   Next 
Ada-Europe Ada 2005 and 2012 Editions sponsored in part by Ada-Europe