Quick list of Legion 1.3 commands


Table of Contents

Alphabetical list of 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
Security
Application Development
Program Support


Other relevant on-line documents:
  Starting and shutting down Legion 1.3
Logging in to a Legion system
Legion context space
How to start remote programs in Legion
Legion host and vault objects
Legion graphical user interface
Legion tty objects
Usage of all Legion commands

To view more detailed information on any of these commands, click on the next to each command.

Depending on how your system is set up, you may need to set up your access to your system before you can run Legion commands. This will probably involve running a script such as this:

$ . ~LEGION/setup.sh

or

$ source ~LEGION/setup.csh
The exact syntax will depend on what kind of shell you are using and on where your Legion files are installed. Consult your system administrator for more information.

Full documentation of these commands can be found on-line as well as in the Reference Manual.


Alphabetical list of Legion commands

legion_activate_instances
legion_activate_object
legion_add_class_mapping
legion_bfs
legion_cat
legion_class_host_list
legion_class_vault_list
legion_classof
legion_context_add
legion_context_create
legion_context_list
legion_context_lookup
legion_context_remove
legion_cp
legion_create_class
legion_create_implementation
legion_create_object
legion_create_object_r
legion_create_stat_tree
legion_create_user
legion_deactivate_instances
legion_deactivate_object
legion_destroy_instances
legion_destroy_object
legion_direct_output
legion_exports_interface
legion_get_acl
legion_get_candidate_hosts
legion_get_candidate_placements
legion_get_candidate_vaults
legion_get_host
legion_get_implicit_params
legion_get_interface
legion_get_vault
legion_host_stats
legion_host_vault_list
legion_import_tree
legion_init_arch
legion_initialize
legion_instance_host_list
legion_java
legion_link
legion_list_attributes
legion_list_instances
legion_list_objects
legion_ln
legion_login
legion_ls
legion_mpi_debug
legion_mpi_register
legion_mpi_run
legion_mplc
legion_mv
legion_passwd
legion_ping
legion_print_config
legion_pvm_register
legion_pwd
legion_register_program
legion_register_runnable
legion_rm
legion_run
legion_run_multi
legion_set_acl
legion_set_context
legion_set_host
legion_set_implicit_params
legion_set_tty
legion_set_vault
legion_setup_state
legion_shutdown
legion_shutdown_class
legion_starthost
legion_startup
legion_startvault
legion_tty
legion_tty_off
legion_tty_redirect
legion_tty_unredirect
legion_tty_watch
legion_update_attributes
legion_vault_host_list
legion_wellknown_class

Calls on Objects

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_ping {-l <object LOID> | -c <context path>}

legion_list_attributes
         {-l <object LOID> | -c <context path>} [-L] [<attribute name>]

legion_update_attributes
         {-l <object LOID> | -c <context path>}
         [{-a | -d | -t} <attribute description>] [-u]

Calls on Class Objects

legion_activate_object
         {-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_list_instances {-l <class 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>}

Calls on 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


Calls on File and Context Objects

legion_activate_instances
         {-l <class LOID> | -c <class context path>}

legion_cat <context path>

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_deactivate_instances 
         {-l <class LOID> | -c <class context path>}

legion_destroy_instances 
         {-l <class LOID> | -c <class context path>}

legion_direct_output {-l <object LOID> | -c <object path>}
         {-l <tty LOID> | -c <tty context path>}

legion_get_host {-l <object LOID> | -c <object context path>}

legion_get_vault {-l <object LOID> | -c <object context path>}

legion_import_tree [<unix directory path> [<legion context path>]]

legion_ln <context path> <new alias>

legion_ls [-laLAdqvh] <context path>

legion_mv <context path> <new context path>

legion_pwd

legion_rm [-r] [-f] [-v] <context path list>

legion_set_context <context path>

legion_set_tty <context path>

legion_tty <context path>

legion_tty_off

legion_tty_redirect <context path>

legion_tty_unredirect <context path>

legion_tty_watch [-l <LOID> | -c <context path>]

Start-Up and Shutdown Functions

legion_create_class [-c < context path>]

legion_initialize

legion_print_config

legion_setup_state [-i]

legion_shutdown [-local] [-f] [-i] [-h]

legion_shutdown_class 
         {-l <class LOID> | -c <context path>}

legion_starthost 
         [-L <$LEGION>] [-O <$LEGION_OPR>] [-A <$LEGION_ARCH>] 
         [-B <path>] [-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>]

Scheduling Support

legion_class_host_list 
         {-l <class LOID> | -c <class context path>}
         [{-a | -d | -t} <host1>, <host2>, ... <hostn>] [-p] [-u]

legion_class_vault_list 
         {-l <class LOID> | -c <class context path>}
         [{-a | -d | -t ] <vault1>, <vault2>, ... <vaultn>] [-p] [-u]

legion_get_candidate_hosts
         {-l <object LOID> | -c <object context path>}

legion_get_candidate_placements 
         {-l <class LOID> <instance LOID>} | {-c <class context path> 
         <instance context path>} [<max placements>]

legion_get_candidate_vaults
         {-l <object LOID> | -c <object context path>}

legion_host_vault_list 
         {-l <host LOID> | -c <host context path>}
         [{-a | -d | -t} <vault1>, <vault2>, ... <vaultn>] [-p] [-u]

legion_instance_host_list
         {-l <LOID> | -c <context path>}
         [{-a | -d | -t} <host1>, <host2>, ... <hostn>] [-p] [-u]

legion_vault_host_list
         {-l <vault LOID> | -c <vault context path>}
         [{-a | -d | -t} <host1>, <host2>, ... <hostn>] [-p] [-u]

General Functions About 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>

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>]
legion_login -x [-e <command>]

legion_passwd {-l <user LOID> | <user name>}

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]

Application Development

legion_bfs <file> [-o <out file>] [-BackEnd]

legion_mplc

legion_java <java options>

Program Support


legion_link [-CC <compiler>] [-Fortran] [-pvm] [-mpi] [-L<library path>]
         [-l<library>] [-v] [-o <output file>] [-bfs] [-help] <object file list>

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_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>]
         [-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> [<arg1>, <arg2>, ... <argn>]

legion_run_multi [-n <number of processors>]
         [-p <program class name>] [-f <specification file name>]