A-4.0 Subject listing of Legion commands

Full documentation of these commands can be found in the Reference Manual, in Command-line functions, and on the Legion web site at <http://legion.virginia.edu/documentation.html>. There are also man pages for all Legion commands included in the system release package.

A-4.1 Calls on objects

legion_exports_interface 
     {[-c] <context path> | -l <LOID>}
     {-w <well-known class type> | -f <function signature>}+
     [-debug] [-help]

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

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

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

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

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

legion_set_worm
     [[-c] <object context path> | -l <object LOID>]

legion_update_attributes 
     {[-c] <object context path> | -l <object LOID>} 
     [-a <new attribute>] [-d <attribute>] 
     [-r <old attribute> <new attribute>] 
     [-debug] [-help]

legion_unset_worm
     {[-c] <instance context path> | -l <instance LOID>}

A-4.2 Calls on class objects

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

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]

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]

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

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

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

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

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

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

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

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

legion_refresh_local_cache

legion_set_backup_vaults
     {[-c] <instance context path> | -l <instance LOID>}
     [-nodeac[tivate]] 
     {[-a | -d] [-c <vault1 context path> | -l <vault1 LOID>]
          [-a | -d] [-c <vault2 context path> | -l <vault2 LOID>] ...
          [-a | -d] [-c <vaultn context path> | -l <vaultn LOID>]}
      | {-Cv <vault context path> -n <total number of vaults>}

legion_set_binding_agent
     [-unset] [-make_default] [-make_default_only]
     {-l <object context path> | -c <object LOID>}

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

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

legion_synch_vaults
     {[-c] <instance context path> | -l <instance LOID>}
     [-nodeac[tivate]]

A-4.3 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>
     {[-c] <context path> | -l <class LOID>} 
     [-debug] [-help]

legion_generate_domain_cookie 
     [-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]

A-4.4 Calls on file and context objects

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

legion_allow_activation
     [-entire_class] [-debug] [-help]
     {[-c] <context path> | -l <LOID>}

legion_cat 
     <context path> 
     [-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 path> <destination path> 
     [-debug] [-help]

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

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

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

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

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

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

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

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

legion_make_hostlist
     {-h <new host context>} {-f <file1> <file2> ... <filen>}
     [<host context path>] [-v] 
     [-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 
     [[-c] <tty context path> | -l <tty LOID>] 
     [-debug] [-help]

A-4.5 Start-up and shutdown functions

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

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

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

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

legion_initialize
     [-debug] [-help]

legion_list_host_accounts
     {[-c] <host object context path> | -l <host object LOID>}
     <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
     [[-c] <host object context path> | -l <host object LOID>]
     [-debug] [-help]

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

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

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

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]

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

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

A-4.6 Scheduling support

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

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

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

legion_config_scheduler 
     {[-c] <Scheduler context name> | -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]

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

A-4.7 General functions about the state of the system

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

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

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

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

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

legion_version
     [-debug] [-help]

legion_wellknown_class 
     <well-known class name> 
     [-debug] [-help]

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

legion_whoami
     [-debug] [-help]

A-4.8 Security

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

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

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

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

legion_create_user 
     <user id> 
     [-debug] [-help]

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]

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

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

legion_init_security
     [-debug] [-help]

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

legion_logout
     [-debug] [-help]

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

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

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

legion_set_message_security
     [-c <AuthenticationObject context path> | -l <AuthenticationObject LOID>]
     {Off | Protected | Private} [-help]

A-4.9 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] <application name> 
     [-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
     {[-c] <object context path> | -l <object LOID>} | 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>
     [-debug] [-help]

A-4.10 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_probe
     [-help] [-debug] [-v[erbose]] [-all] [-list]
     [-in <context path name>] [-out <context path name>]
     [-IN <local file name>] [-OUT <local file name>]
     [-showscratch] [-stat <remote file name>]
     <pid context name>

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

legion_mpi_run 
     {-f <options file> [<flags>]} | 
      {-n <number of processors> [<flags>] <program class> 
        [<arg1> <arg2> ... <argn>]}

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] 
     [-debug] [-help]
     <program context path> [<arg 1> <arg 2> ... <arg n>]

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

legion_run_multi 
     [-v[erbose]] [-z[ero]] [-r[estart]] 
[-e[xec] command] [-x <exceptions file path>] 
{-n <number of processors> | -s[chedule] <schedule file path>} 
{-f <specification file path>} 
     [-help] [-debug]
     <program class> [<arg1> <arg2> ... <argn>] 

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