Basic User Manual
Before you start
1.0 Introduction
- 1.1 About this manual
- 1.2 Style conventions
- 1.3 About Legion
Getting started
2.0 Setting up and logging in
- 2.1 Preparing your Legion environment
- 2.2 Logging in to a Legion system
- 2.2.1 Logging in as a user
- 2.2.2 Changing your password
- 2.2.3 About object permissions
- 2.2.4 Checking your log in status
- 2.2.5 Logging out
- 2.2.6 Using Legion in a Kerberos environment
Context space
3.0 An introduction to context space
4.0 Context space
- 4.1 Legion object names
- 4.2 About the LOID
- 4.3 Organizing context space
5.0 Working in context space
- 5.1 Viewing contexts
- 5.1.1 View a context's contents
- 5.1.2 Looking up LOIDs
- 5.1.3 Create a new context
- 5.1.4 Changing the working context
- 5.1.5 Verify the current working context
- 5.2 Naming
- 5.2.1 Alternate names for existing contexts
- 5.2.2 Assigning a context name to a LOID
- 5.2.3 Renaming an object
- 5.2.4 Listing an object's names
- 5.2.5 Removing names and objects
- 5.2.6 Using the same name in different contexts
- 5.3 Moving between local files and contexts
- 5.3.1 Copying a local file to a Legion file object
- 5.3.2 Copying a Legion file object
- 5.3.3 Viewing a file object's contents
- 5.3.4 Importing a local Unix tree
- 5.3.5 Link a directory to context space
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 Creating objects on new hosts
- 6.4 Instance placement on hosts and vaults
7.0 The GUI
Running applications
8.0 Running a Legion application
9.0 PVM
- 9.1 Core PVM interface
- 9.2 Tids & LOIDs
- 9.3 Task classes
- 9.4 Installing PVM-Legion
- 9.5 Compilation
- 9.6 Registering compiled tasks
- 9.7 Examples
- 9.8 Running PVM code with the fewest changes
10.0 MPI
- 10.1 Legion MPI
- 10.1.1 Task classes
- 10.1.2 Installing Legion MPI
- 10.1.3 Compilation
- 10.1.4 Register compiled tasks
- 10.1.5 Running the MPI application
- 10.1.6 Example
- 10.1.7 Accessing files in programs using MPI
- 10.1.8 Scheduling MPI processes
- 10.1.9 Debugging support
- 10.1.10 Checkpointing support
- 10.1.10.1 Example
- 10.1.10.2 API (C & Fortran)
- 10.1.10.3 Running the above example
- 10.1.10.4 Recovering from failure
- 10.1.10.5 Restarting application
- 10.1.10.6 Compiling/makefile
- 10.1.10.7 Another example
- 10.1.10.8 Limitations
- 10.1.11 Functions supported
- 10.1.12 Running a Legion MPI code with the fewest changes
- 10.2 Native MPI
- 10.2.1 Task classes
- 10.2.2 Compilation
- 10.2.3 Register compiled tasks
- 10.2.4 Running a native MPI application
- 10.2.5 Making Legion calls from native MPI programs
- 10.2.6 Example
- 10.2.7 Scheduling native MPI processes
11.0 Executing remote programs
- 11.1 Introduction
- 11.2 Linked and independent programs
- 11.3 Registering independent programs
- 11.4 Registering Legion-linked programs
- 11.5 Running a remote program
- 11.6 Converting a C/C++ program
- 11.7 Summary
12.0 Replaying & debugging applications
- 12.1 Sample record and replay
Appendices
A-1 Sample makefile
A-2 About Legion tty objects
- A-2.1 Simple tty management
- A-2.2 Complex tty management
A-3 Alphabetical list of Legion commands
A-4 Subject listing of Legion commands
- A-4.1 Calls on objects
- A-4.2 Calls on class objects
- A-4.3 Calls on LegionClass
- A-4.4 Calls on file and context objects
- A-4.5 Start-up and shutdown functions
- A-4.6 Scheduling support
- A-4.7 General functions about the state of the system
- A-4.8 Security
- A-4.9 Application development
- A-4.10 Program support
Getting help
References
Index
The Legion Group
Department of Computer Science
School of Engineering & Applied Science
University of Virginia
151 Engineer's Way, P.O. Box 400740
Charlottesville, VA 22904-4740
legion@virginia.edu
http://legion.virginia.edu/
Copyright © 1993-2000 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 H207305A
legion@Virginia.edu
http://legion.virginia.edu/