1BKR-JOB-LIST(1)                     Beaker                     BKR-JOB-LIST(1)
2
3
4

NAME

6       bkr-job-list - List Beaker jobs
7

SYNOPSIS

9       bkr job-list [options]
10         [--family <family>] [--tag <tag>] [--product <cpeid>] [--completeDays <days>]
11
12

DESCRIPTION

14       Prints to stdout a list of matching Beaker jobs.
15

OPTIONS

17       --family <family>
18              Limit  to  jobs which ran with distro belonging to <family>, for
19              example RedHatEnterpriseLinuxServer5.
20
21       --completeDays <days>
22              Limit to jobs which finished at least <days> ago.
23
24       --tag <tag>
25              Limit to jobs  which  have  retention  tag  <tag>,  for  example
26              scratch.
27
28       --product <cpeid>
29              Limit  to  jobs  which  were  testing  the product identified by
30              <cpeid>.
31
32       --owner <username>
33              Limit to jobs which are owned by the user identified  by  <user‐
34              name>.
35
36       --whiteboard <string>
37              Limit to jobs whose whiteboard contains <string>.
38
39       --mine Presence  of  --mine  is equivalent to including own username in
40              --owner
41
42       --limit <number>
43              Limit to displaying only the first <number> of results
44
45       --min-id id
46              Query jobs with a minium Job ID of id
47
48       --max-id id
49              Query jobs with a max Job ID of id
50
51       --finished
52              Limit to jobs which are finished (Completed,  Aborted,  or  Can‐
53              celled).   A  finished  job has reached its final state and will
54              not change in future.
55
56       --unfinished
57              Limit to jobs which are not finished.
58
59       --format <format>
60              Display results in the given format, either list or  json.   The
61              list`  format  lists one job ID per line and is useful to be fed
62              as input to other command line utilities. The default format  is
63              json,  which returns the job IDs as a JSON array and is compact.
64              This is useful for quick human observation.
65
66       Common bkr options are described in the Options section of bkr(1).
67

EXIT STATUS

69       Non-zero on error, otherwise zero.
70

EXAMPLES

72       List all scratch jobs which finished 30 or more days ago:
73
74          bkr job-list --tag scratch --completeDays 30
75
76       List all scratch jobs with IDs between 10-100:
77
78          bkr job-list --tag=scratch --min-id=10 --max-id=100
79
80       List all scratch jobs with min ID of 10:
81
82          bkr job-list --tag=scratch --min-id=10
83

SEE ALSO

85       bkr(1)
86

AUTHOR

88       The Beaker team <beaker-devel@lists.fedorahosted.org>
89

91       2013-2023 Red Hat, Inc.
92
93
94
95
9628.3                             Nov 17, 2023                  BKR-JOB-LIST(1)
Impressum