Legion 1.8
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
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
2.3 Changing your profile

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 Read a context's contents
5.1.2 Look up LOIDs
5.1.3 Create a new context
5.1.4 Change your current context
5.1.5 Check your current context
5.2 Naming objects
5.2.1 Assign a context name to a LOID
5.2.2 Give an object extra context names
5.2.3 Change an object's context path
5.2.4 List context names
5.2.5 Remove names and objects
5.2.6 Remove an entire context
5.2.7 Use the same name in different contexts
5.3 Moving between local files and contexts
5.3.1 Copying
5.3.1.1 Copy a local file to Legion
5.3.1.2 Copy from Legion to a local file
5.3.1.3 Copy from Legion to another Legion file object
5.3.1.4 Using wildcards when copying
5.3.2 Look at a file object's contents
5.3.3 Import a local Unix tree
5.3.4 File sharing: temporarily link files to Legion
6.0 Host and vault objects
6.1 Host/vault versus host/vault object
6.2 About the bootstrap host/vault
6.3 Creating objects on new hosts
6.4 Look up an object's host
6.5 Instance placement on hosts and vaults
6.6 Backup vaults
6.6.1 WORM objects
6.6.2 Assigning and synchronizing backup vaults
6.6.3 Using replication

Running applications

7.0 Running a Legion application
8.0 Executing programs remotely
8.1 Linked and independent programs
8.2 Registering independent programs
8.2.1 Independent programs
8.2.2 Legion-linked programs
8.3 Running a program remotely
8.3.1 Choosing a remote host
8.3.2 Command-line arguments
8.3.3 Getting input files to the remote host
8.3.3.1 Before the program starts
8.3.3.2 After the program has started
8.3.4 Getting output files from the remote host
8.3.4.1 Before the program starts
8.3.4.2 After the program has started
8.3.5 Option file
8.3.6 Creating and using a probe file
8.3.7 Blocking vs. nonblocking
8.3.8 About legion_probe_run
8.3.9 Context scratch space
8.3.10 Retrieving files from context scratch space
8.4 Example
8.5 Converting a C/C++ program
9.0 PVM
9.1 Core PVM interface
9.2 Tids & LOIDs
9.3 Task classes
9.3.1 Legion-PVM library
9.4 Compilation
9.5 Registering compiled tasks
9.6 Examples
9.7 Running PVM code with the fewest changes
10.0 MPI
10.1 Legion MPI
10.1.1 Task classes
10.1.2 Legion MPI libraries
10.1.3 Compilation
10.1.4 Register compiled tasks
10.1.5 Running the MPI application
10.1.6 Example
10.1.7 Input and output files
10.1.7.1 Input and output flags
10.1.7.2 Subroutines
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 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 Replaying & debugging applications
11.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/

Directory of Legion 1.8 Manuals
[Home] [General] [Documentation] [Software]
[Testbeds] [Et Cetera] [Map/Search]

legion@Virginia.edu
http://legion.virginia.edu/