rpmgrill(1)

1RPMGRILL(1)           User Contributed Perl Documentation          RPMGRILL(1)
2
3
4

NAME

6       rpmgrill - static analysis of koji builds
7

SYNOPSIS

9       rpmgrill [--disable=LIST] [--verbose] [--blacklist-config=FILE] BASEDIR
10
11       rpmgrill  --help  |  --version | --man
12

DESCRIPTION

14       rpmgrill analyzes a set of RPMs (typically from a Koji build), looking
15       for problems with the source and/or generated RPMs.  Unlike rpmlint,
16       rpmgrill analyzes full builds, not individual RPMs.
17
18       rpmgrill is not intended to be run directly by humans: it requires
19       complex prep work to fetch and unpack the build RPMs. rpmgrill is best
20       suited toward a CI environment in which other tools monitor builds,
21       fetch them, run rpmgrill, and report results.
22
23       If you are reading this as a casual user, you are almost certainly
24       better off looking into rpmgrill-analyze-local.
25

OPTIONS

27       --list-plugins
28           List available plugins, then exit.
29
30       --disable=LIST
31           Disable the given plugins when running. LIST is a comma-separated
32           list of plugin names as listed with "--list-plugins". This can be
33           useful for development, when you might want to do quick iterations
34           of a test but not spend 10 minutes in the VirusCheck plugin.
35
36       --verbose
37           Show progress messages.
38
39       --blacklist-config=FILE
40           Blacklisted tests will not be reported by rpmgrill. Blacklist
41           configuration FILE is in YAML format:
42
43           blacklist:
44             Plugin1: test1, test2
45             Plugin2: test3
46             ...
47
48           and tells rpmgrill that it should not report fails for specified
49           tests within certain plugins.
50
51       --help
52           Emit usage hints.
53
54       --version
55           Display program version.
56
57       --man
58           Display this man page.
59

DIAGNOSTICS

61       rpmgrill writes its results to the files "rpmgrill.*" in its working
62       directory, for "*" in json, xml, yaml. Unexpected errors (probably bugs
63       or FIXMEs in rpmgrill) are emitted to stderr.
64

FILES

66       rpmgrill requires a pre-set-up directory hierarchy containing unpacked
67       RPMs. Documenting that is way beyond the scope of this man page. See
68       README.unpacking in the rpmgrill source tree, or the rpmgrill-fetch-
69       build tool, for more details.
70

Examples

72       Test a new set of builds from Koji:
73
74           $ mkdir testdir && cd testdir
75           $ koji download-task --logs <task id>
76
77           # unpack all rpms in the current directory
78           $ rpmgrill-unpack .
79
80           # the unpacked directory is created by rpmgrill-unpack
81           $ rpmgrill unpacked
82

AUTHOR

87       Ed Santiago <santiago@redhat.com>
88
89       Please report bugs or suggestions on bugzilla
90       <https://bugzilla.redhat.com/enter_bug.cgi?product=Fedora&component=rpmgrill>
91
92
93
94perl v5.36.0                      2023-01-20                       RPMGRILL(1)