NAME
as_run - as_run command
SYNOPSIS
A short usage summary.
as_run action [ options ] [ arguments ]
DESCRIPTION
This manual page documents briefly the as_run command
FUNCTIONS
as_run --getop [options] commande[.capy]
Return the main subroutine of a code_aster command
as_run --getversion [options]
- Return current release number of the development version
as_run --get [options] obj1 [obj2...]
Copy a source file in current directory
as_run --show [options] obj1 [obj2...]
Show a source file : fortran, c, python, capy, cata, histor or
test
as_run --diff [options] obj1 [obj2...]
Show the diff of a source file : fortran, c, python, capy, cata
or test
as_run --get_export testcase_name
Build an export file to run a testcase and print it to stdout
as_run --make [--vers=VERS] [target]
Build a code_aster version (executable, libraries, catalogues).
target may be all or clean
as_run --update [options] fich1.tar.gz [fich2.tar.gz...]
Perform one or several updates of a development version
as_run --auto_update [--vers=...] [--force_upgrade] [--keep_increment]
[other options]
Download available updates from a server and apply them to the
current development version
as_run --astk_update [options]
Download available updates from a server and update astk/as_run
itself
as_run --diag [--astest_dir=DIR1,[DIR2]] [--test_list=LIST]
[--only_nook] [diag_result.pick]
Build the diagnosis of code_aster testcases (from dir or default
astest directory) and write a pickled file of the result.
as_run --list [--all] [--test_list=FILE] [--filter=...] [--command=...]
[--user_filter=...] [test1 [test2 ..]]
Build a list of testcases using a list of command/keywords
and/or verifying some criterias about cputime or memory.
as_run --ctags [--vers=VERS]
Build ctags file
as_run --messages subroutine | message_number | check [--fort=...]
[--python=...] [--unigest=...] | move old_msgid new_msgid
Operation on code_aster messages catalogues. subroutine returns
messages called by "subroutine". message_number returns
subroutines calling this message. check returns check messages
catalogues and print some stats. move a message from a
catalogue to another and produce new catalogues and new source
files.
as_run --sendmail [--report_to=EMAIL1,EMAIL2] filename
Send the content of filename (may be on a remote host) to
EMAIL1,EMAIL2,..
as_run --get_infos host1 [host2 [...]]
Return cpu and memory informations about given hosts
as_run --run [options] profile
Execute the execution described by the profile (default action)
as_run --serv user@mach:/nom_profil.export
Start an execution (calling as_run in a separate process)
as_run --info
Returns informations from astk server configuration : batch,
interactive (yes/no, limits), compute nodes, versions
as_run --actu job_number job_name mode
Returns the state, diagnosis, execution node, spent cpu time and
working directory of a job
as_run --edit job_number job_name mode output|error DISPLAY
Opens output or error file on the provided display
as_run --tail job_number job_name mode fdest nb_lines [regexp]
Output the last part of fort.6 file or filter lines matching a
pattern
as_run --del job_number job_name mode [node] [--signal=...]
Kill a job and delete related files
as_run --purge_flash job_number1 [job_number2 [...]]]
Delete files of jobs which are not in the list
as_run --create_issue issue_file [export_file]
Insert a new issue in database and copy attached files if an
export file is provided
as_run --extract_histor [--status=STAT] [--format=FORM] [--all_msg]
input_file histor
Extract the content of issues listed in input_file to histor
as_run --close_issue --vers=VERS histor
Fill "corrvdev" or "corrvexpl" field (depends on vers) in issues
found in histor and eventually close them
as_run --insert_in_db [export_file]
Prepare the profile to insert an execution into a database.
OPTIONS
General options
--version
show program’s version number and exit
-h, --help
show this help message and exit
-v, --verbose
increase verbosity
--silent
run as silent as possible
-g, --debug
print debugging information
--nodebug_stderr
disable printing of debugging information to stderr
-f, --force
force operations which can be cached (download,
compilation...)
--display=DISPLAY
value of DISPLAY variable (NOTE : some functions read
it from a file)
--rcdir=SUFFIX
use resources directory $HOME/.astkrc_’SUFFIX’
--remote_shell_protocol=REMOTE_SHELL_PROTOCOL
remote protocol used for shell commands
--remote_copy_protocol=REMOTE_COPY_PROTOCOL
remote protocol used to copy files and directories
--editor=EDITOR
editor command
--devel_server_user=DEVEL_SERVER_USER
login on the development server (name/ip address is
usually set in /etc/codeaster/asrun)
Options for maintenance operations
--filter=FILTER
filters applied to the testcases parameters :
’nom_para < valeur’ (supported comparison <, >, =).
--vers=VERS
Code_Aster version to used (for get, show, getop)
--force_upgrade
Force upgrade to the next release (for example from
10.1.xx to 10.2.0)
-o FILE, --output=FILE
redirect the result to FILE instead of stdout.
--surch_pyt=REP
one or more directories (comma separated) containing
additionnal python source files
--config=FILE
use another "config.txt" file (only used for make,
update and auto_update).
--only_nook
report only errors (but time spent by passed testcases
is included)
--surch_fort=REP
one or more directories (comma separated) containing
additionnal fortran source files
-a, --all
get all the files of the test
--destdir=DIR
root directory to install
--keep_increment
update a version increment by increment and keep
intermediate executable
--search=REGEXP
keep testcases matching the given regular expression
(or simple string).
--unigest=FILE
a unigest file (for deletion)
--command=COMMANDE[/MOTCLEFACT[/MOTCLE[=VALEUR]]]
keep testcases using the given command and keywords.
--test_list=FILE
list of the testcases
--report_to=EMAIL
email address to send the report of a execution (only
used for --auto_update)
--user_filter=FILE
file containing testlist.FILTRE classes. See
[...]/share/codeaster/asrun/examples/user_filter.py
for an example.
--astest_dir=DIR
testcases directory to watch
--version_dev=VERS
development version of Code_Aster (for make, update,
auto_update, getversion)
-l, --local
files will not been searched on a server but on the local
machine
-nolocal
force remote files search (reverse of --local)
Options for operations on jobs
--signal=SIGNAL
signal to the job (KILL|USR1)
Options for issue tracker interface
--status=STAT
raise an error if issues are not in this status
--all_msg
retrieve all the messages of issues
--format=FORM
format of generated histor file (text or html)
FILES
/etc/codeaster default configuration directory
/etc/codeaster/astkrc default configuration directory for astk
AUTHOR
The Debian Scientific Computing Team