Quick list of Legion 1.4 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:
  Logging in to a running Legion system
Legion graphical user interface
Introduction to Legion context space
Context-related commands
How to start remote programs in Legion
Object permissions
Legion tty objects
Running an MPI code in Legion
Running a PVM code in Legion
Quick list of all Legion commands
Usage of all Legion commands
Starting and shutting down Legion 1.4
Using Legion security features
Legion host and vault objects
Adding host and vault objects
The list of all on-line 1.4 tutorials


The Legion tutorials offer quick and simple instructions for various key procedures for a Legion system. More complete explanations of all of the procedures discussed here are available on separate pages, and can be found by clicking on the icon.

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 command 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.


Alphabetical list of Legion commands

legion_activate_instances
legion_activate_object
legion_add_class_mapping
legion_bfs
legion_cat
legion_change_owner
legion_change_permissions
legion_check_system
legion_class_host_list
legion_class_vault_list
legion_classof
legion_combine_domains
legion_context_add
legion_context_create
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_host
legion_destroy_instances
legion_destroy_object
legion_destroy_vault
legion_direct_output
legion_exports_interface
legion_generate_idl
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_init_security
legion_initialize
legion_instance_host_list
legion_java
legion_link
legion_list_attributes
legion_list_domains
legion_list_implementations
legion_list_instances
legion_list_invocations
legion_list_names
legion_list_objects
legion_list_oprs
legion_ln
legion_login
legion_ls
legion_make
legion_make_idl
legion_make_multi
legion_make_setup_script
legion_mpi_debug
legion_mpi_register
legion_mpi_run
legion_mplc
legion_mplc_reg_impl
legion_mv
legion_object_info
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_stateless_add_workers
legion_stateless_configure
legion_stateless_remove_workers
legion_tty
legion_tty_off
legion_tty_redirect
legion_tty_unredirect
legion_tty_watch
legion_update_attributes
legion_vault_host_list
legion_version
legion_wellknown_class
legion_whereis
legion_whoami

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

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

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_implementations [-v] {-l <class LOID> | -c <class 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_combine_domains [-help] [-v] [-C <target domain context path>]
         <OPR Directory for target domain>

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

legion_init_arch

legion_list_domains

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_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_list_names {-l <object LOID> | -c <object 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_destroy_host [-help] [-v] 
         {-l <host LOID> | -c <host context path>}

legion_destroy_vault {-l <vault LOID> | -c <vault context path>}

legion_initialize

legion_make_setup_script [-help] [-o <script basename>] [-OPR <OPR dir name>]
         [-L <$LEGION dir name>]

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_list_oprs {-l <vault LOID> | -c <vault context path>}

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_check_system [-help] [-v] [-q]

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_version

legion_wellknown_class <wellknown class name>

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

legion_whoami

Security

legion_change_owner [-h] [-v] [-r]
         {-l <object LOID> | -c <object context path>}
         {-l <target owner LOID> | -c <target owner context path>}

legion_change_permissions [+-rwx] [-v] [-help] 
         <group/user context path> <target context path>

legion_create_user <user id>

legion_get_acl {-l <LOID> | -c <context>}

legion_get_implicit_params {-l <LOID> | -c <context>}

legion_init_security

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_generate_idl [<flags>] <input file local path>

legion_make [-help] [-v] [-a <architecture>] [-h <host context path>]
         [-e <make command>] [-OUT <remote file>] [<arg1> <arg2> ... <argn>]

legion_make_idl [-notrans] [-noclient] [-v] [-noreg]
         [-s <suffix string>] [-run] [-help] 

legion_make_multi [-help] [-v] [-a <architecture>][-e <make command>]
         [<arg1> <arg2> ... <argn>]

legion_mplc

legion_mplc_reg_impl <class name> <binary path> 
         <stateless | stateful | sequential> <arch>

legion_java <java options>


legion_stateless_add_workers <class name>
         <worker name1> <worker name2> ... <worker nameN>

legion_stateless_configure <stateless class context path> 
         [-n <number of replicas>] [-Ch <host context path>]
         [-w <max number work requests>] [-update] [-Flush] [-status]

legion_stateless_remove_workers <class name>
         <worker name1> <worker name2> ... <worker nameN>

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 [-v] {-n <number of processors>}
         [-s <schedule file name>]
         {-f <specification file name>}
         <program class name>] [<arg1> <arg2> ... <argn>]