Quick list of Legion 1.7 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:
- Unix, DOS, and local path names appear in
normal face.
Context names and paths appear in fixed face.
Alphabetical list of Legion commands
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 FAQ
[-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] [-debug]
<program context path> [<arg 1> <arg 2> ... <arg n>]
legion_object_info {[-c] <object context path> | -l <object LOID>} [-v]
[-debug] [-help]
legion_set_worm
[[-c] <object context path> | -l <object LOID>]
legion_unset_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]
Calls on class objects
legion_activate_object
{-c <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
{-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
[-debug] [-help] [-stay_down] {-l <object LOID> | -c <context path>}
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
[-vL] {-l <class LOID> | [-c] <class context path>}
[-debug] [-help]
legion_list_instances
{-l <class LOID> | -c <context path>} [-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
{-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]
legion_synch_vaults
{[-c] <instance context path> | -l <instance LOID>}
[-nodeac[tivate]]
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_allow_activation
[-entire_class] [-debug] [-help] {-l <LOID> | -c <context path>}
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
[-debug] [-help] [-stay_down] {-l <class LOID> | -c <class context path>}
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_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 [-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
[<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
[-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]
legion_set_message_security
[-c <AuthenticationObject context path> | -l <AuthenticationObject LOID>]
{Off | Protected | Private} [-help]
Application development
legion_bfs
<file> [-o <out file>] [-BackEnd] [-help]
legion_generate_idl
[<flags>] <input file local path> [-debug] [-help]
legion_make FAQ
[-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>] FAQ
[<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 <program instance context>} [-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 FAQ
{-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_probe_run
[-help] [-debug]
[-pwd] [-hostname] [-list] [-stat <remote file name] [-statjob]
[-in <context path name>] [-out <context path name>]
[-IN <local file name>] [-OUT <local file name>]
[-setscratch <context path>] [-showscratch] [-kill]
{-p[robe] <local file name> | -l <probe LOID>}
legion_register_program
<program class> <executable path> <legion arch>
[-debug] [-help]
legion_register_runnable
<program class> <executable path> <legion arch>
[-debug] [-help]
legion_run FAQ
[-w] [-v] [-a <architecture>] [-h <host context path>]
[-nonblock | -block] [-d <remote host directory>] [-D <var=value>]
[-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 <option file>] [-novrun] [-t <minutes>] [-n <nodes>]
[-p[robe] <local file name>] [-setscratch <context path>]
[-debug] [-help] <program class> [<arg1> <arg2> ... <argn>]
legion_run_multi FAQ
[-v[erbose]] [-z[ero]] [-r[estart]]
[-e[xec] command] [-x <exceptions file path>]
{[-n <number of processors>] |
[-s[chedule] <schedule file path>] |
[-n <number of processors> -s[chedule] <schedule file path>]}
{-f <specification file path>} <program class name>
[<arg1> <arg2> ... <argn>] [-help] [-debug]
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 Mar 22 16:49:03 2001
