Legion 1.4
Basic User Manual

4.0 What am I looking at?

Legion is an object-based system organized by classes and metaclasses (classes of classes). Every part of Legion, including classes and metaclasses, is represented by a Legion object. You manipulate these parts by controlling their representative objects. Objects are automatically assigned system-level names called Legion Object Identifiers (LOIDs) but LOIDs are impractical at best to use. Instead, Legion allows you to assign string names to any Legion objects and to organize those names according to your own preferences. New Legion systems include the basic outlines of context space but you can arrange your space as you wish. You can run programs, use far-flung resources, and take advantage of Legion's other features from your context space.

You will probably spend a great deal of time working in context space, so it is important to understand the initial geography of your system's context space and how to negotiate that space. A typical newly installed system provides some starter contexts and context names to allow you access to commonly used objects. See Figure 10, below, shows some of the default contexts and context names of a newly installed Legion system's context space. (Note that your context space may not look like this.)

Figure 10: Contents of a typical new Legion system context space

Think of the different levels of context space as directories and sub-directories. Each of the contexts in Figure 10 can hold sets of sub-contexts, just as Unix directories hold sets of subdirectories. Context names are organized in contexts, just as file names are organized in directories. Context path names use Unix-style slash ("/") as a default, and the examples here follow that style (e.g., the full context path name for BootstrapHost in the system shown in Figure 10 is /hosts/BootstrapHost). It is possible to change Unix-style slash to the DOS-style backslash ("\") via the primitive context manipulation routines provided by the Legion library.

You can control your context space from the Context Manager, discussed in Graphical user interface. Or, you can work from the command line by using context-related command tools, discussed in Working in context space.

A new system contains default names for the basic objects, such as the bootstrap host and vault. These objects are in the /hosts, /vaults, /impl, and /class contexts (shown in Figure 10). The /hosts context contains names of the host objects currently in your system. A new system will have two context names, BootstrapHost and the DNS name of the bootstrap host.1 Both of these names point to the bootstrap host object, which represents the bootstrap host. The /vaults context contains names of the vault objects currently in your system. A new system contains only one context name, BootstrapVault, which points to the bootstrap vault object. (See Host and vault objects for more information on hosts and vaults.) The /impl context contains the names of implementation objects. A new /class context contains context names for all of the initial Legion object classes, such as AuthenticationObjectClass and BasicFileClass. All Legion classes are objects and can be assigned context names. Legion objects are organized by their classes and the classes are in turn organized into a hierarchical structures of metaclasses. The top metaclass is the LegionClass, which is responsible for every other object in the system.

Note, however, that the context space illustrated in Figure 10 does not reflect this hierarchy. This is a key feature of context space: the physical location and organization of Legion objects is unrelated to any user's context space. The objects named in a /host context do not have be able to communicate with each other or even know of each other's existence. They do not even have to be host objects: you can organize your contexts as you wish.

1. A host is a machine in a Legion system. A vault is a file storage system used to store inactive Legion objects. A host object represents and manages a given host in a Legion system, and a vault object represents and manages a given vault in a Legion system. back

Back to Basic User Manual Table of Contents