Quick reference for Legion commands
classes
 
 
legion_activate_instances {-l <class LOID> |-c <class context path> }
 
 
legion_classof {-l <object LOID | -c <context path>>}
 
 
legion_deactivate_instances {-l <class LOID> | -c <class context path>}
 
 
legion_destroy_instances {-l <class LOID> | -c <class context path>}
 
 
 
legion_exports_interface {-l <LOID> | -c <context path>} 
{-w <well known class type> | -f <function signature>}+
 
 
legion_get_interface {-l <class LOID> | -c <context path>}
 
 
legion_list_attributes {-l <object LOID> | -c <context path>} 
[-L] [<attribute name>]
 
 
legion_list_instances {-l <class LOID> | -c <context path>}
 
 
legion_shutdown_class {-l <class LOID> | -c <context path>}
 
 
legion_update_attributes {-l <object LOID> | -c <context path>} 
[{-a | -d | -t} <attribute description>] [-u]

Activate a class's instances.

Display the LOID of an object's class.

Deactivate a class's instances.

Destroy all of a class's instances. NOTE: this command will not destroy instances' context names.

Create an interface for an object.

Retrieve an object's interface.

List an object's attributes.

List the instances of a class.

Deactivate a class and all of its instances.

Change an object's attributes.

context space
 
 
legion_context_add <object LOID> <context name>
 
 
legion_context_create <context path>
 
 
legion_context_list [<context path>]
 
 
legion_context_lookup <context path>
 
 
legion_context_remove <context path>
 
 
legion_cp [-localsource | -localdest] <source file> <destination file>
 
 
 
legion_import_tree [<unix directory path> [<legion context path>]]
 
 
legion_ln <context path> <new alias>
 
 
legion_ls [-lLa] <context path>
 
 
legion_mv <context path> <new context path>
 
 
legion_rm [-deactivate | -destroy] <context path>
 
 
legion_set_context <context path>

Give an object a context name.

Create a new sub-context.

List a context's contents.

Display an object's LOID.

Delete an object's context name.
NOTE: this command does not remove an object's LOID.

Copy a Legion file object

Copy a local Unix directory tree into a Legion context.

Give an object an additional context name.

List a context's contents.

Change an object's context name.

Remove, deactivate, or destroy a context name.

Change the current working context.

LegionClass
 
 
legion_add_class_mapping <metaclass LOID> <class LOID>
 
 
legion_create_implementation <binary path name> <architecture> 
[-l <class LOID> | -c <context path>]
 
 
legion_init_arch

Tell Legion that a given class is another's class's metaclass.

Create a new implementation object.

Create and register implementation objects for commonly used classes in the current architecture.

objects
 
 
legion_activate_object {-l <object LOID> | -c <context path>}
 
 
legion_cat <context path>
 
 
legion_classof {-l <object LOID> | -c <context path>}
 
 
legion_create_object {-l <class LOID> | -c <class context path>} 
<new object context path> 
[-h <host name on which to place new object>]
[-v <vault on which to place new object>]
[-H <context path of preferred host class>] 
[-V <context path of preferred vault class>]
[-Ch <context containing list of preferred hosts>] 
[-Cv <context containing list of preferred vaults>]
 
 
legion_create_object_r {-l <class LOID> | -c <class context path>} 
<context path> <host name> <host architecture> <$LEGION> <$LEGION_OPR> <$LEGION_OPA> <binary path> [<user id>]
 
 
legion_deactivate_object {-l <object LOID> | -c <context path>}
 
 
legion_destroy_object {-l <object LOID> | -c <context path>}
 
 
legion_get_host {-l <object LOID> | -c <object context path>}
 
 
legion_get_vault {-l <object LOID> | -c <object context path>}
 
 
legion_ping {-l <object LOID> | -c <context path>}
 
 
legion_set_host {-l <object LOID> | -c <object context path}
 {-l <host LOID> | -c <host context path>}
 
 
legion_set_vault {-l <object LOID> | -c <object context path}
 {-l <vault LOID> | -c <vault context path>}

Activate an object (move it to an active state).

Print a Legion file object's contents to standard output.

Display the LOID of an object's class.

Create a new instance of a class.






Create a new object using the rsh (remote shell) mechanism.
Note that ssh can be used in place of rsh.

Deactivate an object (move it to an inert state).

Delete an object. NOTE: this command destroys the object's LOID but not its context name(s).

Return the LOID of an object's host

Return the LOID of an object's vault.

Ping an object to see if it is active.

Move an object to a different host object.

Move an object's OPR to a different vault object.

Resource management
 
 
legion_class_host_list {-l <class LOID> | -c <class context path>}
 [{-a | -d} <host name>] [-p] [-u]
 
 
legion_class_vault_list {-l <class LOID> | -c <class context path>}
[{-a | -d} <vault name>] [-p] [-u]
 
 
legion_get_candidate_hosts {-l <object LOID> | -c <object context path>}
 
l 
egion_get_candidate_placements {-l <class LOID> <instance LOID>} | 
{-c <class context path> <instance context path>}
[<max placements>]

(cont'd)

Change a class's list of acceptable hosts (these will be listed by LOID).

Change a class's list of acceptable vaults (these will be listed by LOID).

Display an object's list of acceptable hosts (these will be listed be LOID).

Display a list of a class and instance's acceptable host-vault pairings (these will be listed by LOID).

 
 
 
legion_get_candidate_vaults {-l <object LOID> | -c <object context path>}
 
 
legion_host_vault_list {-l <host LOID> | -c <host context path>} 
[{-a | -d} <vault name>] [-p] [-u]
 
 
legion_instance_host_list {-l <LOID> | -c <context path>}
[{-a | -d} <host name>] [-p] [-u]
 
 
legion_starthost {-L <$LEGION>] [-O <$LEGION_OPR>}
 [-A <$LEGION_ARCH>] [-N <context name>] 
[-U <user id>] {<new host name>} [<compatible vault list>]
 
 
legion_startvault {-L <$LEGION>] [-O <$LEGION_OPR>}
[-A <$LEGION_ARCH>] [-N <context name>] 
[-U <user id] {<host name>} [<compatible host list>]
 
 
legion_vault_host_list {-l <vault LOID> | -c <vault context path>} 
[{-a | -d} <host name>] [-p] [-u]

Display an object's list of acceptable vaults (these will be listed by LOID).

Change a host object's list of the vault objects that it can be paired with.

Change an object's list of the hosts on which it can be placed.

Create a new host object.

Create a new vault object.

Change a vault's list of the host objects that it can be paired with.

Running applications
 
legion_bfs <file>[-o <out file>] [-BackEnd]
 
legion_flogger [-v] {-n <number of processors>}
{-f <specification file name>} <program class name>
[<arg1>, <arg2>, ... <argn>]
 
 
legion_mpi_debug [-q] {-c <instance context path>}
 
 
legion_mpi_register <class name> <binary local path name> 
<platform type>
 
 
legion_mpi_run {-f <options file> [<flags>] | -n <number of hosts> [<flags>] <command> [<arguments>]} 
 
 
legion_mplc
 
 
legion_pvm_register <class path name> <binary local path name> <platform type>
 
 
legion_register_program <program class> <executable path>
 <legion arch>
 
 
legion_register_runnable <program class> <executable path> 
<legion arch>
 
 
legion_run [-help] [-w] [-a <architecture>]
[-in <context path name>] [-out <context path name>]  
[-IN <local file name>] [-OUT <local file name>] 
[-f <options file>] <program class> [<arg1>, <arg2>, ... <argn>] 

Parses Fortran programs containing Legion Basic Fortran Support

Runs a serial program with specified input file

Examine the state of MPI objects and print out their message queues.

Register an MPI program for use with Legion-MPI.

Run an MPI program in Legion (see the Reference Manual for informtion about using < flags >)

Compile a Mentat Programming Language program.

Register a PVM task for use with Legion.

Register a non-Legion-compatible program for use with Legion.

Register a Legion-compatible program for use with Legion.

Remotely execute a registered program in Legion.

Security
 
 
legion_create_user <user id>
 
 
legion_get_acl {-l <LOID> | -c <context>}
 
 
legion_get_implicit_params {-l <LOID> | -c <context>}
 
 
legion_login [-l <user LOID> | <user id>] [-e <command>]

(cont'd)

Creates a new user id in a Legion system.

Print the access control list of an object.

Print the implicit parameters of an object or of the current environment.

Log into a running Legion system as a user.

 
 
legion_passwd {-l <user LOID> | <user id>}
 
 
legion_set_acl {-l <object LOID> | -c <object context path>} 
[-s | filename]
 
 
legion_set_implicit_params [-l <object LOID> | -c <object context path>]
[-s | filename]

Change a user password.

Set the access control list of a Legion object.

Set an AuthenticationObject's or current environment's implicit parameters.

the state of the system
 
 
legion_classof {-l <object LOID> | -c <context path>}
 
 
legion_create_stat_tree <base context path>
 
 
legion_host_stats {-l <host LOID> | -c <host context path>}
 
 
legion_list_objects {-l <host LOID> | -c <host context path>}
 
 
legion_wellknown_class <wellknown class name>

Display the LOID of an object's class.

Create a database of current loads on all host objects in a system.

Print the number of objects and current load for a particular host object.

List the Legion objects currently managed by a given host object.

Print the LOID of a "well-known" Legion class.

Starting up / shutting down the system
 
 
legion_create_class [-c < context path>]
 
 
legion_initialize
 
 
legion_print_config
 
 
legion_setup_state [-i]
 
 
legion_shutdown [-local] [-fhi]
 
 
legion_shutdown_class  {-l <class LOID> | -c <context path>}
 
 
legion_starthost [-L <$LEGION>] [-O <$LEGION_OPR>] 
[-A <$LEGION_ARCH>] [-N <context name>] 
[-U <user id>] {<new host name>} [<compatible vault list>]
 
 
legion_startup [-local]
 
 
legion_startvault [-L <$LEGION>] [-O <$LEGION_OPR>] [-A <$LEGION_ARCH>] [-N <context name>] 
[-U <user id] {<host name>} [<compatible host list>]

Create a new instance of the class VanillaMetaClass.

Create basic classes and implementations in a new Legion system.

Print the "well-known" binding for LegionClass in the current Legion configuration.

Create OPRs for basic Legion system objects.

Shut down a Legion system.

Deactivate a class and all of its instances.

Create a new host object.

Start up a system

Create a new vault object

tty objects
 
legion_direct_output {-l <object LOID> |-c <object path> } 
{-l {tty LOID> | -c <tty path>}
 
 
legion_set_tty <tty context path>
 
 
legion_tty_redirect <context path>
 
 
legion_tty_unredirect <context path>
 
 
legion_tty_watch {-l <tty LOID> | -c <tty context path>}

Direct an object's output to a Legion tty object.

Tell Legion which tty object should be used.

Redirect the current Legion tty object's output to a specified file object.

Stop directing the current Legion tty object's output to a specified file object.

Directs the current Legion tty object's output to print to standard output.