apport/man/dupdb-admin.1

69 lines
1.7 KiB
Groff

.TH dupdp\-admin 1 "August 01, 2007" "Martin Pitt"
.SH NAME
dupdb\-admin \- Manage the duplicate database for apport\-retrace.
.SH SYNOPSIS
.B dupdb\-admin \-f
.I dbpath
.B dump
.B dupdb\-admin \-f
.I dbpath
.B changeid
.I oldid newid
.B dupdb\-admin \-f
.I dbpath
.B publish
.I path
.SH DESCRIPTION
.BR apport\-retrace (1)
has the capability of checking for duplicate bugs (amonst other
things). It uses an SQLite database for keeping track of master bugs.
.B dupdb\-admin
is a small tool to manage that database.
The central concept in that database is a "crash signature", a string
that uniquely identifies a particular crash. It is built from the
executable path name, the signal number or exception name, and the
topmost functions of the stack trace.
The database maps crash signatures to the 'master' crash id and thus
can close duplicate crash reports with a reference to that master ID.
It also tracks the status of crashes (open/fixed in a particular
version) to be able to identify regressions.
.SH MODES
.TP
.B dump
Print a list of all database entries.
.TP
.B changeid
Change the associated crash ID for a particular crash.
.TP
.B publish
Export the duplicate database into a set of text files in the given directory
which is suitable for WWW publishing.
If the directory already exists, it will be updated. The new content is built
in a new directory which is the given one with ".new" appended, then moved to
the given name in an almost atomic way.
.SH OPTIONS
.TP
.B \-f \fIpath\fR, \fB\-\-database-file\fR=\fIpath
Path to the duplicate database SQLite file.
.SH AUTHOR
.B apport
and the accompanying tools are developed by Martin Pitt
<martin.pitt@ubuntu.com>.