Quick reference for Legion 1.6.3 commands

Context Space

legion_cat
  <context path1> <context path2> ... <context pathN>
  [-debug] [-help]
Print the contents of a Legion file object to standard output.
legion_cd <context path> [-debug] [-help]
Change the current working context.
legion_context_add 
  <object LOID> <context name> [-debug] [-help]
Give an object a context name.
legion_context_create 
  <context path> [-debug] [-help]
Create a new sub-context.
legion_cp
  [-r][-v][-m][-p][-localsrc][-localdest]
  [-V <vault context path>] 
  <source path> <destination path>
  [-debug] [-help]
Copy a Legion file object
legion_export_dir [-v] [-fc] [-cc]
  <local base directory path> <target base context path> 
  [-debug] [-help]
Export a local directory to context space without copying it to Legion space.
legion_import_tree 
  [<unix directory path> [<legion context path>]]
  [-debug] [-help]
Copy a local Unix directory tree into a Legion context.
legion_list_names
  {[-c] <object context path>| -l <object LOID>}
  [-debug] [-help]
List an object's context names.
legion_ln 
  <context path> <new alias> 
  [-debug] [-help]
Give an object an additional context name.
legion_ls 
  [-laLRAdqv] <context path> [-debug] [-help]
List a context's contents.
legion_mkdir 
  <context path> [-debug] [-help]
Create a new subcontext.
legion_mv
  <context path> <new context path>
  [-debug] [-help]
Change an object's context name.
legion_pwd [-debug] [-help] Print the current context path
legion_rm
  [-r] [-f] [-v] <context path list> 
  [-debug] [-help]
Remove one or more context name[s].
legion_set_context 
  <context path> [-debug] [-help]
Change the current working context.

Starting up / shutting down the system

legion_create_class
  [[-c] <context path>] [-sc <scheduler context path>] 
  [-sl <scheduler LOID>]
  [-debug] [-help]
Create a new instance of the class VanillaMetaClass.
legion_init_arch [-debug] [-help]
Create and register implementation objects for commonly used classes in the current architecture.
legion_initialize [-debug] [-help]
Create basic classes and implementations in a new Legion system.
legion_make_setup_script [-o <script basename>]
  [-OPR <OPR dir name>] [-L <$LEGION dir name>]
  [-debug] [-help]
Generates a Legion setup script for your system.
legion_print_config [-debug] [-help]
Print the "well-known" LegionClass binding in the current Legion configuration.
legion_setup_state [-i] [-debug] [-help]
Create OPRs for basic Legion system objects.
legion_shutdown  
  [-local] [-f] [-i] [-debug] [-help]
Shut down a Legion system.
legion_shutdown_class  
  {[-c] <context path> | -l <class LOID>}
  [-debug] [-help]
Deactivate a class and all of its instances.
legion_starthost  
  [-L <$LEGION>] [-O <$LEGION_OPR>] 
  [-A <$LEGION_ARCH>] [-B <path>] [-N <context name>] 
  [-U <user id>] [-C <host class>] 
  {<new host name>} [<compatible vault list>]  
  [-debug] [-help]
Create a new host object.
legion_startup [-local]
Start up a system
legion_startvault  
  [-L <$LEGION>] [-O <$LEGION_OPR>] 
  [-A <$LEGION_ARCH>] [-N <context name>] 
  [-U <user id] {<host name>} [<compatible host list>] 
  [-debug] [-help]
Create a new vault object

Security

legion_add_acl  
  [[-c] <object context path> | -l <object LOID>]
  {-s | <filename>} [-debug] [-help]
Adds in a new access control list.
legion_add_implicit_params  
  [[-c] <AuthenticationObject context path> | 
  -l <AuthenticationObject LOID>] {-s | <filename>} 
  [-debug] [-help]
Add implicit parameters to an object or environment.
legion_change_owner [-v] [-r] 
  {[-c] <object context path> | -l <object LOID>}
  {[-c] <target owner context path> | -l <target owner LOID>}
  [-debug] [-help]
Change an object's owner.
legion_change_permissions [+-rwx] [-v] 
  <group/user context path> <target context path> 
  [-debug] [-help]
Change an object's read, write, and execute permissions
legion_create_user <user id> [-debug] [-help]
Create a new Legion user id.
legion_create_user_object
  {[-c] <class context path> | -l <class LOID>}
  [-h <host for new object> | -v <vault for new object>]
  [-f <implicit parameter file>] [-z <password>] 
  <user name> [-debug] [-help]
Create a new user object.
legion_get_acl
  [[-c] <object context path> | -l <object LOID>]
  [-debug] [-help]
Print the access control list of an object.
legion_get_implicit_params 
  [[-c] <object context path> | -l <object LOID>]
  [-debug] [-help]
Print the implicit parameters of an object or of the current environment.
legion_init_security [-debug] [-help]
Create the initial user (called by default /user/admin) in a new Legion system.
legion_login 
  [-l <user LOID> | <user id>] 
  [-debug] [-help]
Log into a running Legion system.
legion_logout [-debug] [-help]
Log out of Legion
legion_passwd 
  {-l <user LOID> | <user id>} [-debug] [-help]
Change a user password.
legion_set_acl 
  {[-c] <object context path> | -l <object LOID>} 
  [-s | <filename>] [-debug] [-help]
Set the access control list of a Legion object.
legion_set_implicit_params 
  [[-c] <object context path> | -l <object LOID>]
  [-s | <filename>] [-debug] [-help]
Set an AuthenticationObject's or current environment's implicit parameters.
legion_whereis 
  {[-c] <object context path> | -l <object LOID>} 
  [-debug] [-help]
Return a specified object's host and vault object.
legion_whoami [-debug] [-help]
Print current user name, if you are currently logged in to a security-enabled system.

Objects

legion_activate_object 
  {[-c] <context path> | -l <object LOID>} 
  [-debug] [-help]
Activate an object (move it to an active state).
legion_cat <context path> [-debug] [-help]
Print a Legion file object's contents to standard output.
legion_classof 
  {[-c] <context path> | -l <object LOID>} 
  [-debug] [-help]
Display the LOID of an object's class.
legion_create_object ; 
  {[-c] <class context path> | -l <class LOID>} 
  <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>]
  [-d <recorder context path> <debug session name>]
  [-debug] [-help]
Create a new instance of a class.
legion_create_object_r 
  {[-c] <class context path> | -l <class LOID>} 
  <context path> <host name> <host architecture> 
  <$LEGION> <$LEGION_OPR> <$LEGION_OPA> 
  <binary path> [<user id>]
  [-debug] [-help]
Create a new object using the rsh (remote shell) mechanism. Note that ssh can be used in place of rsh.
legion_deactivate_object 
  {[-c] <context path> | -l <object LOID>}
  [-debug] [-help]
Deactivate an object (move it to an inert state).
legion_destroy_object 
  {[-c] <context path> | -l <object LOID>}
  [-debug] [-help]
Delete an object's LOID.
legion_get_host 
  {[-c] <object context path> | -l <object LOID>}
  [-debug] [-help]
Return the LOID of an object's host
legion_get_vault 
  {[-c] <object context path> | -l <object LOID>}
  [-debug] [-help]
Return the LOID of an object's vault.
legion_list_attributes 
  {[-c] <context path> | -l <object LOID>} 
  [-L] [<attribute name>] [-debug] [-help]
List an object's attributes.
legion_list_invocations 
  {[-c] <object context path> | -l <object LOID>}
  [-debug] [-help]
Return current pending and started invocations for an object
legion_object_info 
  {[-c] <object context path> | -l <object LOID>} 
  [-v] [-debug] [-help]
Get information (host, vault, OA, owner, etc.) about an object
legion_ping 
  {[-c] <context path> | -l <object LOID>} 
  [-timeout <seconds>]
  [-debug] [-help]
Ping an object to see if it is active.
legion_set_host 
  {[-c] <instance context path> | -l <instance LOID>}
  {[-c] <host context path> | -l <host LOID>} 
  [-debug] [-help]
Move an object to a different host object.
legion_set_vault
  {[-c] <instance context path> | -l <instance LOID>}
  {[-c] <vault context path> | -l <vault LOID>}
  [-permanent] [-debug] [-help]
Move an object's OPR to a different vault object.
legion_update_attributes  
  {[-c] <context path> | -l <object LOID>} 
  [{-a | -d | -t} <attribute description>]  
  [-u] [-debug] [-help]
Change an object's attributes.

Classes

legion_activate_instances
  {[-c] <class context path> | -l <class LOID>}
  [-debug] [-help]
Activate a class's instances.
legion_classof 
  {-l <object LOID | [-c] <context path>} 
  [-debug] [-help]
Display the LOID of an object's class.
legion_deactivate_instances 
  {[-c] <class context path> | -l <class LOID>}
  [-debug] [-help]
Deactivate a class's instances.
legion_destroy_instances 
  {[-c] <class context path> | -l <class LOID>}
  [-debug] [-help]
Destroy all of a class's instances' LOIDs.
legion_exports_interface 
  {[-c] <context path> | -l <LOID>} 
  {-w <well-known class type> | -f <function signature>}+
  [-debug] [-help]
Create an interface for an object.
legion_get_interface 
  {[-c] <context path> | -l <class LOID>} 
  [-debug] [-help]
Retrieve an interface for objects of a given class.
legion_list_implementations 
  [-v] {[-c] <class context path> | -l <class LOID>}
  [-debug] [-help]
List a class's implementation objects
legion_list_instances 
  {[-c] <class context path> | -l <class LOID>}
  [-debug] [-help]
List the instances of a class.
legion_shutdown_class 
  {[-c] <class context path> | -l <class LOID>}
  [-debug] [-help]
Deactivate a class and all of its instances.

LegionClass

legion_add_class_mapping 
  <metaclass LOID> <class LOID> 
  [-debug] [-help]
Tell Legion that a given class is another's class's metaclass.
legion_combine_domains 
  [-v] <list of domain cookie files>
  [-debug] [-help]
Combine one or more Legion domains.
legion_create_implementation 
  <binary path name> <architecture> 
  [[-c] <class context path> | -l <class LOID>] 
  [[-c] <object context path>] [-nc]  
  [-v] [-a <attribute>]
  [-debug] [-help]
Create a new implementation object.
legion_generate_domain_cookie 
  [-o <cookie output filename> 
  [-debug] [-help]
Generate a domain cookie.
legion_list_domains [-debug] [-help]
List domains connected to the current domains
legion_print_domain_cookie 
  [-i <cookie input file> [-debug] [-help]
Display the current domain's cookie file.

Running applications

legion_make_idl [-notrans] [-noclient] 
  [-v] [-noreg] [-s <suffix string>] 
  [-run] <application name> [-debug] [-help]
Compiles Legion stubs and implementation code of CORBA client and server classes.
legion_make [-v] [-a <architecture>] 
  [-h <host context path>]
  [-e <make command>] [-OUT <remote file>] 
  [<arg1> <arg2> ... <argn>] 
  [-debug] [-help]
Compile programs on a remote host.
legion_make_multi [-v] 
  [-a <architecture>] [-e <make command>] 
  [<arg1> <arg2> ... <argn>] 
  [-debug] [-help]
Compile a program on multiple platforms.
legion_mpi_debug [-q] 
  {[-c] <instance context path>} [-debug] [-help]
Examine the state of MPI objects and print their message queues.
legion_mpi_register 
  <class name> <binary local path name> 
  <platform type> [-debug] [-help]
Register an MPI program for use with Legion-MPI.
legion_mpi_run  
  {-f <options file> [<flags>]} | 
    {-n <number of hosts> [<flags>] 
    <command> [<arguments>]} 
  [-debug] [-help]
Run an MPI program in Legion (see the Reference Manual for informtion about <flags>).
legion_mplc [-debug] [-help]
Compile a Mentat Programming Language program.
legion_mplc_reg_impl <class name> <binary path> 
  <stateless | stateful | sequential> 
  <arch> [-debug] [-help]
Register the given binary as a stateful, stateless, or sequential Mentat object for a given architecture.
legion_pvm_register <class path name> 
  <binary local path name> <platform type> 
  [-debug] [-help]
Register a PVM task for use with Legion.
legion_register_program <program class> 
  <executable path>
  <legion arch> [-debug] [-help]
Register a non-Legion-compatible program for use with Legion.
legion_register_runnable 
  <program class> <executable path> 
  <legion arch> [-debug] [-help]
Register a Legion-compatible program for use with Legion.
legion_run 
  [-w] [-v] [-a <architecture>] 
  [-h <host context path name>]
  [-in <context path name>] 
  [-out <context path name>]  
  [-IN <local file name>] 
  [-OUT <local file name>] 
  [-f <options file>] <program class> 
  [-t <minutes>] [-n <nodes>] 
  [<arg1> <arg2> ... <argn>] 
  [-debug] [-help]
Remotely execute a registered program in Legion.
legion_run_multi 
  [-v] {-n <number of processors>} 
  [-s <specification file name>] 
  {-f <specification file name>} <program class name> 
  [<arg1> <arg2> ... <argn>] 
  [-debug] [-help]
Run a serial program with specified input file
legion_stateless_add_workers <class name> 
  <worker name1> <worker name2> ... <worker nameN> 
  [-debug] [-help]
Create additional MPL stateless object workers. Adding more workers allows message calls to be handled more efficiently.
legion_stateless_configure 
  <stateless class context path> 
  [-n <number of replicas>] 
  [-Ch <host context path>]
  [-w <max number work requests>] 
  [-FlUsH] [-debug] [-help]
Configure stateless Legion classes.
legion_stateless_remove_workers <class name>
  <worker name1> <worker name2> ... <worker nameN>
  [-debug] [-help]
Remove MPL stateless object workers.

tty Objects

legion_direct_output  
  [[-c] <objectcontext path> | -l <object LOID> } 
  {[-c] <tty context path> | -l <tty LOID>}  
  [-debug] [-help]
Direct an object's output to a Legion tty object.
legion_set_tty <tty context path> [-debug] [-help]
Set a tty object.
legion_tty <tty context path> [-debug] [-help]
Create, set,and watch a tty object.
legion_tty_off [-debug] [-help]
Stop watching the current tty object (works only with tty object created with the legion_tty command).
legion_tty_redirect  
  <object context path> [-debug] [-help]
Redirect the current Legion tty object's output to a specified file object.
legion_tty_unredirect  
  <object context path> [-debug] [-help]
Stop directing the current tty object's output to a specified file object.
legion_tty_watch  
  [[-c] <tty context path> | -l <tty LOID>]  
  [-debug] [-help]
Direct the current tty object's output to print to standard output.

The state of the system

legion_check_system [-v] [-q] 
  [-fix CommandLine | -fix Contexts]
  [-debug] [-help]
Check the status of key elements in your Legion system.
legion_classof 
  {[-c] <context path> | -l <object LOID>} 
  [-debug] [-help]
Display the LOID of an object's class.
legion_create_stat_tree 
  <base context path> [-debug] [-help]
Create a database of current loads on all host objects in a system.
legion_host_stats 
  {[-c] <host context path> | -l <host LOID>} 
  [-debug] [-help]
Print the number of objects and current load for a particular host object.
legion_list_objects 
  {[-c] <host context path> | -l <host LOID>} 
  [-debug] [-help]
List the Legion objects currently managed by a given host object.
legion_wellknown_class 
  <well-known class name> [-debug] [-help]
Print the LOID of a "well-known" Legion class.

Scheduling

legion_config_scheduler 
  {[-c] <scheduler path> | -l <scheduler LOID>} 
  [-get_enactor] [-get_collection] 
  [-set_enactor 
    {[-c] <Enactor path> | -l <Enactor LOID>}] 
  [-set_collection 
    {[-c] <Collection path> | -l <Collection LOID>}] 
  [-debug] [-help]
Configure a Legion scheduler's Collection and Enactor
legion_join_collection 
  {[-c] <Collection path> | -l <Collection LOID>}
  {[-c] <member path> | -l <member LOID>} 
  [-debug] [-help]
Joins objects to a Collection.
legion_leave_collection 
  {-l <Collection LOID> | [-c] <Collection path>}
  {[-c] <member path> | -l <member LOID>} 
  [-debug] [-help]
Remove objects from a Collection.
legion_query_collection [-v] 
  {[-c] <Collection context path> | -l <Collection LOID>} 
  <query> [-debug] [-help]
Get information on a Collection.
legion_set_scheduler 
  {[-c] <class context path> | -l <class LOID>}
  {[-c] <Schedulercontext path> | -l <Scheduler LOID>} 
  [-debug] [-help]
Set a the default Scheduler for a class.
legion_set_scheduler_policy 
  {[-c] <class context path> | -l <class LOID>} 
  <policy> [-debug] [-help]
Set a class's policy for using its default Scheduler.

Resource management

legion_class_host_list 
  {[-c] <class context path> | -l <class LOID>}
  [{-a | -d | -t} <host1> <host2> ... <hostn>] 
  [-p] [-debug] [-help]
Change a class's list of acceptable hosts (these will be listed by LOID).
legion_class_vault_list 
  {[-c] <class context path> | -l <class LOID>}
  [{-a | -d | -t} <vault1> <vault2> ... <vaultn>] 
  [-p] [-debug] [-help]
Change a class's list of acceptable vaults (these will be listed by LOID).
legion_destroy_host [-v] 
  {[-c] <host context path> | -l <host LOID>}
  [-debug] [-help]
Destroy a host.
legion_destroy_vault 
  {[-c] <vault context path> | -l <vault LOID>}
  [-debug] [-help]
Destroy a vault.
legion_host_vault_list 
  {[-c] <host context path> | -l <host LOID>} 
  [{-a | -d | -t} <vault1> <vault2> ... <vaultn>] 
  [-p] [-debug] [-help]
Change a host object's list of compatible vault objects.
legion_instance_host_list 
  {[-c] <instance context path> | -l <instance LOID>}
  [{-a | -d | -t} <host1> <host2> ... <hostn>] 
  [-p] [-debug] [-help]
Change an object's list of acceptable hosts.
legion_instance_vault_list 
  {[-c] <instance context path> | -l <instance LOID>}
  [{-a | -d | -t} <vault1> <vault2> ... <vaultn>] 
  [-p] [-debug] [-help]
Change an object's list of acceptable vaults.
legion_list_oprs 
  {[-c] <vault context path> | -l <vault LOID>} 
  [-debug] [-help]
Change an object's list of the hosts on which it cist all OPRs stored on a given vault.
legion_set_default_placement 
  {[-c] <class context path> | -l <class LOID>}
  {[-c] <host context path> | -l <host LOID>}
  {[-c] <vault context path> | -l <vault LOID>}
  [-debug] [-help]
Set default placement for a class's instances, if it can't contact its associated Scheduler.
legion_set_varch
  {[-c] <host context path> | -l <host LOID>} 
  <arch> [-debug] [-help]
Set a virtual architecture for a host object.
legion_set_vrun
  {[-c] <host context path> | -l <host LOID>} 
  <path> [-debug] [-help]
Run a virtual host object.
legion_starthost {-L <$LEGION>] [-O <$LEGION_OPR>}
   [-A <$LEGION_ARCH>] [-B <path>] 
  [-N <context name>] [-U <user id>] 
  [-C <host class>] <new host name>
  [<compatible vault list>] [-debug] [-help]
Create a new host object.
legion_startvault [-L <$LEGION>] [-O <$LEGION_OPR>] 
  [-A <$LEGION_ARCH>] [-N <context name>] 
  [-U <user id>] <host name> 
  [<compatible host list>] [-debug] [-help]
Create a new vault object.
legion_vault_host_list 
  {[-c] <vault context path> | -l <vault LOID>} 
  [{-a | -d | -t} <host1> <host2> ... <hostn>] 
  [-p] [-debug] [-help]
Change a vault's list of compatible host objects.

Debugging

legion_output_state 
  {[-c] <object context path> | -l <object LOID>}  
    | StartupState
  [-debug] [-help]
An output device for debugging and information reporting.
legion_record  
  {-uf <local storage file name> | [-c] <recorder context path>}
  [-name <debug session name>] [-t <interval>]
  <client application> [<arg1> <arg2> ... <argN>]
  [-debug] [-help]
Execute an application in record mode.
legion_replay  
  {-uf <local storage file name> |  
    [-c] <recorder context path> -name <debug session name>}
  {-list | [-cmd <debugger name>]  
  [-local] <session number>} [-debug] [-help]
Start a replay or playback session for a recorded object.

Last modified: Tue Mar 7 14:36:47 2000

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

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