.\"                                      Hey, EMACS: -*- nroff -*-
.\" First parameter, NAME, should be all caps
.\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
.\" other parameters are allowed: see man(7), man(1)
.TH KCOV 1 "October  31, 2010"
.\" Please adjust this date whenever revising the manpage.
.\"
.\" Some roff macros, for reference:
.\" .nh        disable hyphenation
.\" .hy        enable hyphenation
.\" .ad l      left justify
.\" .ad b      justify to both left and right margins
.\" .nf        disable filling
.\" .fi        enable filling
.\" .br        insert line break
.\" .sp <n>    insert n+1 empty lines
.\" for manpage-specific macros, see man(7)
.SH NAME
kcov \- Code coverage analysis using DWARF debugging information
.SH SYNOPSIS
.B kcov
.RI [ options ] " outdir executable [ args for executable ]
.SH DESCRIPTION
This manual page documents briefly the
.B kcov
command.
.PP
.\" TeX users may be more comfortable with the \fB<whatever>\fP and
.\" \fI<whatever>\fP escape sequences to invode bold face and italics, 
.\" respectively.
\fBkcov\fP is a code coverage analysis tool using DWARF debugging information.
.SH OPTIONS
.B \-p PID
trace PID instead of executing executable, executable is optional in this case
.TP
.B \-s sort-type
How to sort files: f[ilename] (default), p[ercent].
.TP
.B \-l low,high
Setup limits for low/high coverage (default 16,50).
.TP
.B \-p only-include-paths  
Comma-separated list of paths to include in the report.
.TP
.B \-x exclude-paths
Comma-separated list of paths to exclude in the report.
.TP
.B \-w write-file
File to write breakpoints to for kernel usage.
.TP
.B \-r read-file
File to read hit breakpoints from for kernel usage.
.PP
.SH AUTHOR
Kcov was written by Simon Kagstrom, building upon bcov by Thomas Neumann.
.PP
This manual page was written by Michael Tautschnig <mt@debian.org>,
for the Debian project (but may be used by others).