Quick list of Legion 1.6.5 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 on-line tutorials & documentation
Click on the to move to the selected text.


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 where your Legion files are installed (i.e., the value of ~legion will depend on your individual Legion net). Consult your system administrator for more information.

The following style conventions are used in these tutorials:


Alphabetical list of Legion commands

legion_activate_instances
legion_activate_object
legion_add_acl
legion_add_class_mapping
legion_add_host_account
legion_add_implicit_params
legion_add_sub_collection
legion_bfs
legion_cat
legion_cd
legion_change_owner
legion_change_permissions
legion_check_system
legion_class_host_list
legion_class_vault_list
legion_classof
legion_combine_domains
legion_config_scheduler
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_create_user_object
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_exports_dir
legion_generate_idl
legion_generate_domain_cookie
legion_get_acl
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_instance_vault_list
legion_join_collection
legion_leave_collection
legion_link
legion_list_attributes
legion_list_domains
legion_list_host_accounts
legion_list_implementations
legion_list_instances
legion_list_invocations
legion_list_names
legion_list_objects
legion_list_oprs
legion_list_sub_collections
legion_ln
legion_login
legion_logout
legion_ls
legion_make
legion_make_idl
legion_make_multi
legion_make_schedule
legion_make_setup_script
legion_mkdir
legion_mpi_debug
legion_mpi_register
legion_mpi_run
legion_mplc
legion_mplc_reg_impl
legion_mv
legion_native_mpi_config_host
legion_native_mpi_init
legion_native_mpi_register
legion_native_mpi_run
legion_object_info
legion_output_state
legion_passwd
legion_ping
legion_print_config
legion_print_domain_cookie
legion_pvm_register
legion_pwd
legion_query_collection
legion_record
legion_register_program
legion_register_runnable
legion_replay
legion_remove_host_account
legion_remove_sub_collection
legion_rm
legion_run
legion_run_multi
legion_set_acl
legion_set_context
legion_set_default_placement
legion_set_host
legion_set_implicit_params
legion_set_scheduler
legion_set_scheduler_policy
legion_set_tty
legion_set_vault
legion_set_varch
legion_set_vrun
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>}+
         [-debug] [-help]

legion_get_interface {-l <class LOID> | -c <context path>}
         [-debug] [-help]

legion_ping {-l <object LOID> | -c <context path>} [-timeout <seconds>]
         [-debug] [-help]

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

legion_list_invocations {-l <object LOID> | -c <object context path>}
         [-debug] [-help]

legion_native_mpi_config_host [<wrapper>] [-debug] [-help]

legion_native_mpi_init [<architecture>] [-debug] [-help]

legion_native_mpi_register 
         <class name> <binary path> <architecture> [-help]

legion_native_mpi_run 
         [-v] [-a <architecture>] [-h <host context path>]
         [-IN <local input file>] [-OUT <local result file>]
         [-in <Legion input file>] [-out <Legion result file>]
         [-n <nodes>] [-t <minutes>] [-legion] [-help] 
         <program context path> [<arg 1> <arg 2> ... <arg n>]

legion_object_info {-l <object LOID> | -c <object context path>} [-v]
         [-debug] [-help]

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

Calls on class objects

legion_activate_object
         {-l <object LOID> | -c <context path>} [-debug] [-help]

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>]
         [-d <recorder context path> <debug session name>]
         [-debug] [-help]

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>] [-debug] [-help]

legion_deactivate_object
         {-l <object LOID> | -c <context path>} [-debug] [-help]

legion_destroy_object 
         {-l <object LOID> | -c <context path>} [-debug] [-help]

legion_get_host 
         {-l <object LOID> | -c <object context path>} [-debug] [-help]

legion_get_vault 
         {-l <object LOID> | -c <object context path>} [-debug] [-help]

legion_list_implementations 
         [-v] {-l <class LOID> | -c <class context path>}
         [-debug] [-help]

legion_list_instances 
         {-l <class LOID> | -c <context path>} [-debug] [-help]

legion_set_host {-l <instance LOID> | -c <instance context path} 
         {-l <host LOID> | -c <host context path>} [-debug] [-help]

legion_set_vault {-l <instance LOID> | -c <instance context path>} 
         {-l <vault LOID> | -c <vault context path>} [-permanent]  
         [-debug] [-help]

Calls on LegionClass

legion_add_class_mapping 
         <metaclass LOID> <class LOID> [-debug] [-help]

legion_combine_domains  
         [-v] <list of domain cookie files> [-debug] [-help]

legion_create_implementation 
         <binary path name> <architecture>
         [-l <class LOID> | -c <class context path>]
         [-c <object context path>] [-nc] [-help] [-v] [-a <attribute>]
         [-debug] [-help]

legion_generate_domain_cookie
         [-help] [-o <cookie output filename>] [-debug] [-help]

legion_init_arch [-debug] [-help]

legion_list_domains [-debug] [-help]

legion_print_domain_cookie
         [-i <cookie input file>] [-debug] [-help]

Calls on file and context objects

legion_activate_instances
         {-l <class LOID> | -c <class context path>} [-debug] [-help]

legion_cat 
         <context path1> <context path2> .. <context pathN> [-debug] [-help]

legion_cd <context path> [-debug] [-help]

legion_context_add 
         <object LOID> <context name> [-debug] [-help]

legion_context_create <context path> [-debug] [-help]

legion_cp
         [-r] [-v] [-m] [-p] [-localsrc] [-localdest] 
         [-V <vault context path>] <source file> <destination file> 
         [-debug] [-help]

legion_deactivate_instances 
         {-l <class LOID> | -c <class context path>} [-debug] [-help]

legion_destroy_instances 
         {-l <class LOID> | -c <class context path>} [-debug] [-help]

legion_direct_output {-l <object LOID> | -c <object path>}
         {-l <tty LOID> | -c <tty context path>} [-debug] [-help]

legion_export_dir 
         [-v] [-fc] [-cc] 
         <local base directory path> <target base context path> 
         [-debug] [-help]

legion_get_host 
         {-l <object LOID> | -c <object context path>} [-debug] [-help]

legion_get_vault 
         {-l <object LOID> | -c <object context path>} [-debug] [-help]

legion_import_tree 
         [<unix directory path> [<legion context path>]] [-debug] [-help]

legion_list_names 
         {-l <object LOID> | -c <object context path>} [-debug] [-help]

legion_ln <context path> <new alias> [-debug] [-help]

legion_ls [-laLRAdqv] [<context path>] [-debug] [-help]

legion_mkdir <context path> [-debug] [-help]

legion_mv <context path> <new context path> [-debug] [-help]

legion_pwd [-debug] [-help]

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

legion_set_context <context path> [-debug] [-help]

legion_set_tty <tty context path> [-debug] [-help]

legion_tty <tty context path> [-debug] [-help]

legion_tty_off [-debug] [-help]

legion_tty_redirect <object context path> [-debug] [-help]

legion_tty_unredirect <object context path> [-debug] [-help]

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

Start-up and shutdown functions


legion_add_host_account
         {-l <host object LOID> | [-c] <host object context path>}
         {[-f <mapping file name>] | [<Unix user id>
              [-l <owner LOID> | -c <owner context path>]]}
         [-debug] [-help]

legion_create_class
         [-c <context path>] 
         [-sc <scheduler context path>] [-sl <scheduler LOID>] 
         [-debug] [-help]

legion_destroy_host 
         [-v] {-l <host LOID> | -c <host context path>}  
         [-debug] [-help]

legion_destroy_vault  
         {-l <vault LOID> | -c <vault context path>} [-debug] [-help]

legion_initialize [-debug] [-help]

legion_list_host_accounts
         {-l <host object LOID> | [-c ]<host object context path>}
         <user id> [-debug] [-help]

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

legion_print_config [-debug] [-help]

legion_remove_host_account
         [-l <host object LOID> | [-c] <host object context path>]
         [-debug] [-help]

legion_setup_state [-i] [-debug] [-help]

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

legion_shutdown_class 
         {-l <class LOID> | -c <context path>} [-debug] [-help]

legion_starthost 
         [-L <$LEGION>] [-O <$LEGION_OPR>] [-A <$LEGION_ARCH>] 
         [-B <path>] [-N <context name>] [-U <user id>]  
         <new host name> [<compatible vault list>]  
         [-debug] [-help]

legion_startup [-local] [-debug] [-help]

legion_startvault 
         [-L <$LEGION>] [-O <$LEGION_OPR>] [-A <$LEGION_ARCH>] 
         [-N <context name>] [-U <user id>] <host name>
         [<compatible host list>] [-debug] [-help]

Scheduling support

legion_add_sub_collection
         {-l <collection LOID> | -c <collection path>}
         {-l <member LOID> | -c <member path>} [-q <query>]

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

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

legion_config_scheduler
         {-l <Scheduler LOID> | -c <Scheduler context path>} 
         [-get_enactor] [-get_collection] 
         [-set_enactor {-l <Enactor LOID> | -c <Enactor path>}] 
         [-set_collection {-l <Collection LOID> | -c <Collection path>}]  
         [-debug] [-help]

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

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

legion_instance_vault_list
         {-l <instance LOID> | -c <instance context path>}
         [{-a | -d | -t} <vault1> <vault2> ... <vaultn>]  
         [-p] [-u] [-debug] [-help]

legion_join_collection
         {-l <Collection LOID> | -c <Collection path>}
         {-l <member LOID> | -c <member path>} [-debug] [-help]

legion_leave_collection
         {-l <Collection LOID> | -c <Collection path>}
         {-l <member LOID> | -c <member path>} [-debug] [-help]

legion_list_oprs 
         {[-c] <vault context path> | -l <vault LOID>} [-debug] [-help]

legion_list_sub_collections
         {-l <collection LOID> | -c <collection path>}

legion_make_schedule
         {-c <class context path> | -l <class LOID>}
         [-n <number of nodes>] [-f <specification file>]
         [-q <query>] [-help]

legion_query_collection
         {-l <Collection LOID> | -c <Collection path>} <query> 
         [-debug] [-help]

legion_remove_sub_collection
         {-l <collection LOID> | -c <collection path>}
         {-l <member LOID> | -c <member path>} [-q <query>]

legion_set_default_placement 
         {-l <class LOID> | -c <class context name>}
         {-l <host LOID> | -c <host context name>}
         {-l <vault LOID> | -c <vault context name>} 
         [-debug] [-help]

legion_set_scheduler 
         {-l <class LOID> | -c <class context path>}
         {-l <Scheduler LOID> | -c <Scheduler context path>} 
         [-debug] [-help]

legion_set_scheduler_policy 
         {-l <class LOID> | -c <class context path>} 
         <policy> [-debug] [-help]

legion_set_varch
         {-l lt;host LOID> | -c lt;host context path>} <arch> 
         [-debug] [-help]

legion_set_vrun
         {-l lt;host LOID> | -c lt;host context path>} <path> 
         [-debug] [-help] 

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

General functions about the state of the system

legion_check_system  
         [-v] [-q] [-fix CommandLine | -fix Contexts] [-debug] [-help]

legion_classof 
         {-l <object LOID> | -c <context path>} [-debug] [-help]

legion_create_stat_tree <base context path> [-debug] [-help]

legion_host_stats  
         {-l <host loid> | -c <host context path>} [-debug] [-help]

legion_list_objects 
         {-l <host LOID> | -c <host context path>} [-debug] [-help]

legion_version [-debug] [-help]

legion_wellknown_class <wellknown class name> [-debug] [-help]

legion_whereis 
         {-l <object LOID> | -c <object context path>} [-debug] [-help]

legion_whoami [-debug] [-help]

Security

legion_add_acl 
         [-l <object LOID> | -c <object context name>] 
         {-s | <filename>} [-debug] [-help]

legion_add_implicit_params
         [-l <AuthenticationObject LOID> | -c <AuthenticationObject context path>]
         {-s | <filename>} [-debug] [-help]

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

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

legion_create_user  
         [-a <admin path>] [-z <password>]  
         [-h <new home context>] [-c <AuthenticationObject path>]  
         <user id path> [-debug] [-help]

legion_create_user_object 
         {-l <class LOID> | -c <class context path>}
         [-h <host for new object> | -v <vault for new object>]
         [-f <implicit parameter file>] [-z <password>] 
         <user name> [-debug] [-help]

legion_get_acl 
         {-l <object LOID> | -c <object context name>} [-debug] [-help]

legion_get_implicit_params 
         {-l <object LOID> | -c <object context name>} [-debug] [-help]

legion_init_security [-debug] [-help]

legion_login  
         [-l <user LOID> | <user id>] [-debug] [-help]

legion_logout [-debug] [-help]

legion_passwd 
         {-l <user LOID> | <user name>} [-debug] [-help]

legion_set_acl 
         [-l <object LOID> | -c <object context path>] 
         {-s | <filename>} [-debug] [-help]

legion_set_implicit_params 
         [-l <object LOID> | -c <object context path>] 
         {-s | <filename>} [-debug] [-help]

Application development

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

legion_generate_idl 
         [<flags>] <input file local path> [-debug] [-help]

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

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

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

legion_mplc [<flags>]

legion_mplc_reg_impl <class name> <binary path> 
         <stateless | stateful | sequential> <arch> [-help]

legion_output_state
         {-l <object loid> | -c <object context path>} 
            | StartupState [-debug] [-help]

legion_record
         {-uf <local storage file name> | -c <recorder context path>}
         [-name <debug session name> ] [-t <interval>]
         <client application> [<arg1> <arg2> ... <argN>] [-debug] [-help]

legion_replay
         {-uf <local storage file name> 
           | -c <recorder context path> -name <debug session name>}
         {-list | [-cmd <debugger name>] [-local] <session number>} 
         [-debug] [-help]

legion_stateless_add_workers <class name>
         <worker name1> <worker name2> ... <worker nameN> 
         [-debug] [-help]

legion_stateless_configure <stateless class context path> 
         [-n <number of replicas>] [-Ch <host context path>]
         [-w <max number work requests>] [-FlUsH] [-debug] [-help]

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

Program support


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

legion_mpi_debug [-q] {-c <instance context path>} [-help]

legion_mpi_register 
         <class name> <binary local path name> <platform type> 
         [-help]

legion_mpi_run 
         {-f <options file> [<flags>]} |
         {-n <number of hosts> <flags> <command> [<arguments>]} 
         [-help]

legion_pvm_register 
         <class path name> <binary local path name> <platform type> 
         [-help]

legion_register_program 
         <program class> <executable path> <legion arch> 
         [-debug] [-help]

legion_register_runnable 
         <program class> <executable path> <legion arch> 
         [-debug] [-help]

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>]
         [-t <minutes>] [-n <nodes>]
         [-f <options file>] <program class> [<arg1> <arg2> ... <argn>] 
         [-debug] [-help]

legion_run_multi 
         [-v] {-n <number of processors>}
         [-s <schedule file name>] {-f <specification file name>}
         <program class name> [<arg1> <arg2> ... <argn>] 
         [-debug] [-help]


Other relevant on-line documents:
Click on the to go to the page.
Logging in to a running Legion system
Introduction to Legion context space
Context-related commands
Legion tty objects
Running a PVM code in Legion
Running a Legion MPI code
Running native MPI code
Quick list of all 1.7 Legion commands
Usage of all 1.7 Legion commands
FAQs for running programs in Legion
Starting a new Legion system
Legion security
Legion host and vault objects
Adding host and vault objects
Brief descriptions of all on-line tutorials

Last modified: Thu Jun 15 14:02:23 2000

 

[Home] [General] [Documentation] [Software]
[Testbeds] [Et Cetera] [Map/Search]

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