---
name: "as_run"
section: "1"
platform: "linux"
package: "code-aster-run"
version: "1.13.1-2.1"
release: "Debian 10 (Buster)"
platforms: ["linux"]
url: "https://new.carta.tech/as_run"
---

# as\_run(1)

as\_run command

## 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