Find file Copy path
Fetching contributors…
Cannot retrieve contributors at this time
135 lines (134 sloc) 2.96 KB
.\" Hey, EMACS: -*- nroff -*-
.TH KETCHUP 1 "February 16, 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)
ketchup \- Utility to update the kernel source
.B ketchup
[\fIoptions\fR] \fI<ver>\fR
This tool synchronises a local kernel tree with a desired kernel version and
patch set from a mirror. The default requires a GPG key on your
keyring, to verify the identity of the patches and source archives. Entire
kernel images are not downloaded unless necessary, so bandwidth is saved.
Patches are applied and removed as necessary to attain the requested version.
.B \-a
.B \-\-archive
cache directory
.B \-d
.B \-\-directory
directory to update
.B \-f
.B \-\-full\-tarball
if unpacking a tarball, download the latest
.B \-g
.B \-\-gpg\-path
path for GnuPG
.B \-G
.B \-\-no\-gpg
disable GPG signature verification
.B \-k
.B \-\-kernel\-url
base url for mirror
.B \-l
.B \-\-list\-trees
list supported trees
.B \-m
.B \-\-show\-makefile
output version in makefile <arg>
.B \-n
.B \-\-dry\-run
don't download or apply patches
.B \-o
.B \-\-only\-dl
don't apply patches
.B \-p
.B \-\-show\-previous
output version previous to <arg>
.B \-q
.B \-\-quiet
reduce output
.B \-r
.B \-\-rename\-directory
rename updated directory to linux\-<v>
.B \-s
.B \-\-show\-latest
output the latest version of <arg>
.B \-u
.B \-\-show\-url
output URL for <arg>
.B \-w
.B \-\-wget
command to use for wget
Ketchup will read files named \fI.ketchuprc\fP in $HOME and in the target kernel directory, with the kernel directory taking precedence.
A \fI.ketchuprc\fP file uses the Python syntax and may set the following variables:
.B default_tree
The \fBdefault_tree\fP option specifies the kernel version to work with if one is not given on the command line.
.B precommand
The \fBprecommand\fP option specifies a command to run before synchronising the kernel tree to the required version.
.B postcommand
The \fBpostcommand\fP option specifies a command to run after synchronising the kernel tree to the required version.
ketchup was written by Matt Mackall <>.
This manual page was written by Baruch Even <>,
for the Debian project (but may be used by others). Description text taken from
a former packaging attempt of Jack Wasey <>.