Legion 1.2
Basic User Manual

Table of Contents


1.0 About Legion

Getting started

2.0 Before you start
2.1 Preparing the Legion environment
2.2 Logging in to a Legion system
3.0 What am I looking at?
4.0 Context space
4.1 What is context space?
4.2 How context space works
4.3 About the LOID
4.4 Organizing context space
5.0 Working in context space
5.1 View a context's contents
5.2 Looking up an object's LOID
5.3 Create a new context
5.4 Changing the working context
5.5 Assigning alternate names to existing contexts
5.6 Assigning a context name to a LOID
5.7 Renaming an object
5.8 Removing names
5.9 Using the same name in different contexts
5.1 Copying a local file to a Legion file object
5.11 Copying a Legion file object
5.12 Viewing a file object's contents
5.13 Importing a local Unix directory tree
6.0 Host and vault objects
6.1 What is a host object and vault object?
6.2 About the bootstrap host and vault
6.3 Adding a new host
6.4 Adding a new vault
6.5 About host-vault pairs
6.6 Creating objects on new hosts
6.7 Controlling instance placement on hosts and vaults
7.0 Graphic user interface
7.1 Starting the Context Manager from the command-line
7.2 Running the GUI on Windows95
7.3 Shutting down the Context Manager
7.4 Restarting the Context Manager
7.5 Using the Legion GUI
8.0 Running a Legion application
9.0 PVM
9.1 Core PVM interface
9.2 Tids & LOIDs
9.3 Task classes
9.4 Using PVM-Legion
9.5 Installation
9.6 Compilation
9.7 Registering compiled tasks
9.8 Examples
10.0 MPI
10.1 Task classes
10.2 Using Legion MPI
10.3 Example
10.4 Scheduling MPI processes
10.5 Debugging support
10.6 Functions supported
11.0 Executing remote programs
11.1 Introduction
11.2 Registering non-Legion-compatible programs
11.3 Registering Legion-compatible programs
11.4 Running a remote program
11.5 Converting a C/C++ program
11.6 Summary
11.7 Running a remote program from the GUI


A-1.0 Alphabetical list of Legion commands
A-2.0 Subject listing of Legion commands
Calls on Objects
Calls on Class Objects
Calls on LegionClass
Calls on File and Context Objects
Start-Up and Shutdown Functions
Scheduling Support
General Functions About the State of the System
Application Development
Program Support
A-3.0 More information on adding host and vault objects
Adding new hosts
Adding new vaults
Manipulating host-vault pairing

Getting help



The Legion Research Group
Department of Computer Science
University of Virginia
Charlottesville, VA 22903


Copyright © 1993-1998 by the Rector and Visitors of the University of Virginia.

All rights reserved.

Permission is granted to copy and distribute this manual so long as this copyright page accompanies any copies. The Legion system software herein described is intended for research and is available free-of-charge for that purpose. Permission is not granted for distributing the Legion system software outside of your site.

In no event shall the University of Virginia be liable to any party for direct, indirect, special, incidental, or consequential damages arising out of the use of the Legion system software and its documentation.

The University of Virginia specifically disclaims any warranties, including but not limited to the implied warranties of merchantability and fitness for a particular purpose. The software provided hereunder is on an "as is" basis, and the University of Virginia has no obligation to provide maintenance, support, updates, enhancements, or modifications.

This work partially supported by DARPA (Navy) contract # N66001-96-C-8527, DOE grant DE-FD02-96ER25290, DOE contract Sandia LD-9391, Northrup-Grumman (for the DoD HPCMOD/PET program), DOE D459000-16-3C and DARPA (GA) SC H607305A