File: cli-output.rst

package info (click to toggle)
openmpi 5.0.7-1
  • links: PTS, VCS
  • area: main
  • in suites: trixie
  • size: 202,312 kB
  • sloc: ansic: 612,441; makefile: 42,495; sh: 11,230; javascript: 9,244; f90: 7,052; java: 6,404; perl: 5,154; python: 1,856; lex: 740; fortran: 61; cpp: 20; tcl: 12
file content (55 lines) | stat: -rw-r--r-- 2,155 bytes parent folder | download | duplicates (4)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
.. -*- rst -*-

   Copyright (c) 2022-2023 Nanook Consulting.  All rights reserved.
   Copyright (c) 2023 Jeffrey M. Squyres.  All rights reserved.

   $COPYRIGHT$

   Additional copyrights may follow

   $HEADER$

.. The following line is included so that Sphinx won't complain
   about this file not being directly included in some toctree

The ``output`` command line directive must be accompanied by a
comma-delimited list of case-insensitive options that control how
output is generated. The full directive need not be provided |mdash| only
enough characters are required to uniquely identify the directive. For
example, ``MERGE`` is sufficient to represent the
``MERGE-STDERR-TO-STDOUT`` directive |mdash| while ``TAG`` can not be
used to represent ``TAG-DETAILED`` (though ``TAG-D`` would suffice).

Supported values include:

* ``TAG`` marks each output line with the ``[job,rank]<stream>:`` of
  the process that generated it

* ``TAG-DETAILED`` marks each output line with a detailed annotation
  containing ``[namespace,rank][hostname:pid]<stream>:`` of the
  process that generated it

* ``TAG-FULLNAME`` marks each output line with the
  ``[namespace,rank]<stream>:`` of the process that generated it

* ``TAG-FULLNAME`` marks each output line with the
  ``[namespace,rank]<stream>:`` of the process that generated it

* ``TIMESTAMP`` prefixes each output line with a ``[datetime]<stream>:``
  stamp. Note that the timestamp will be the time when the line is
  output by the DVM and not the time when the source output it

* ``XML`` provides all output in a pseudo-XML format
  ``MERGE-STDERR-TO-STDOUT`` merges stderr into stdout

* ``DIR=DIRNAME`` redirects output from application processes into
  ``DIRNAME/job/rank/std[out,err,diag]``. The provided name will be
  converted to an absolute path

* ``FILE=FILENAME`` redirects output from application processes into
  ``filename.rank.`` The provided name will be converted to an absolute
  path

Supported qualifiers include ``NOCOPY`` (do not copy the output to the
stdout/err streams), and ``RAW`` (do not buffer the output into complete
lines, but instead output it as it is received).