File: condor_tail.rst

package info (click to toggle)
condor 23.9.6%2Bdfsg-2.1
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid, trixie
  • size: 60,012 kB
  • sloc: cpp: 528,272; perl: 87,066; python: 42,650; ansic: 29,558; sh: 11,271; javascript: 3,479; ada: 2,319; java: 619; makefile: 615; xml: 613; awk: 268; yacc: 78; fortran: 54; csh: 24
file content (61 lines) | stat: -rw-r--r-- 1,953 bytes parent folder | download
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
56
57
58
59
60
61
*condor_tail*
==============

Display the last contents of a running job's standard output or file
:index:`condor_tail<single: condor_tail; HTCondor commands>`\ :index:`condor_tail command`

Synopsis
--------

**condor_tail** [**-help** ] | [**-version** ]

**condor_tail** [**-pool** *centralmanagerhostname[:portnumber]*]
[**-name** *name*] [**-debug** ] [**-maxbytes** *numbytes*]
[**-auto-retry** ] [**-follow** ] [**-no-stdout** ] [**-stderr** ]
*job-ID* [*filename1* ] [*filename2 ...* ]

Description
-----------

*condor_tail* displays the last bytes of a file in the sandbox of a
running job identified by the command line argument *job-ID*. ``stdout``
is tailed by default. The number of bytes displayed is limited to 1024,
unless changed by specifying the **-maxbytes** option. This limit is
applied for each individual tail of a file; for example, when following
a file, the limit is applied each subsequent time output is obtained.

If you specify *filename*, that name must be specifically listed in the job's
``transfer_output_files``.

Options
-------

 **-help**
    Display usage information and exit.
 **-version**
    Display version information and exit.
 **-pool** *centralmanagerhostname[:portnumber]*
    Specify a pool by giving the central manager's host name and an
    optional port number.
 **-name** *name*
    Query the *condor_schedd* daemon identified with *name*.
 **-debug**
    Display extra debugging information.
 **-maxbytes** *numbytes*
    Limits the maximum number of bytes transferred per tail access. If
    not specified, the maximum number of bytes is 1024.
 **-auto-retry**
    Retry the tail of the file(s) every 2 seconds, if the job is not yet
    running.
 **-follow**
    Repetitively tail the file(s), until interrupted.
 **-no-stdout**
    Do not tail ``stdout``.
 **-stderr**
    Tail ``stderr`` instead of ``stdout``.

Exit Status
-----------

The exit status of *condor_tail* is zero on success.