Added mk-sbuild-lv.1

This commit is contained in:
Ryan Kavanagh 2008-08-27 14:02:14 -04:00
commit 8892c00d8d
2 changed files with 76 additions and 2 deletions

5
debian/changelog vendored
View File

@ -8,10 +8,11 @@ ubuntu-dev-tools (0.43ubuntu1) intrepid; urgency=low
[Ryan Kavanagh]
* dgetlp.1: New manpage
* dgetlp: fix typo in usage
* hugdaylist: New manpage
* hugdaylist.1: New manpage
* s/requestsync/pull-lp-source/g in doc/pull-lp-source.1
* mk-sbuild-lv.1: New manpage
-- Ryan Kavanagh <ryanakca@kubuntu.org> Wed, 27 Aug 2008 11:20:11 -0400
-- Ryan Kavanagh <ryanakca@kubuntu.org> Wed, 27 Aug 2008 13:51:15 -0400
ubuntu-dev-tools (0.42ubuntu1) intrepid; urgency=low

73
doc/mk-sbuild-lv.1 Normal file
View File

@ -0,0 +1,73 @@
.TH MK-SBUILD-LV "1" "27 August 2008" "ubuntu-dev-tools"
.SH NAME
mk-sbuild-lv \- creates LVM snapshot chroots via schroot and sbuild
.SH SYNOPSIS
\fB mk-sbuild-lv\fR [\fB--arch=ARCH\fR] [\fB--name=NAME\fR]
[\fB--personality=PERSONALITY\fR] [\fB--debug\fR] [\fB--source-template=FILE\fR]
[\fB--debootstrap-mirror=URL\fR] <\fBVG\fR> <\fBRelease\fR>
.SH DESCRIPTION
.PP
\fBmk-sbuild-lv\fR creates LVM snapshot chroots via schroot and sbuild.
.SH OPTIONS
.PP
Listed below are the command line options for mk-sbuild-lv:
.TP
.B \-\-arch=ARCH
What architecture to select (defaults to the native architecture).
.TP
.B \-\-name=NAME
Base name for the schroot (arch is appended)
.TP
.B \-\-personality=PERSONALITY
What personality to use (defaults to match --arch)
.TP
.B \-\-debug
Turn on script debugging
.TP
.B \-\-source-template=FILE
Use FILE as the sources.list template (defaults to $HOME/.mk-sbuild-lv.sources)
.TP
.B \-\-debootstrap-mirror=URL
Use URL as the debootstrap source (defaults to http://ports.ubuntu.com for lpia,
official Ubuntu repositories for the supported architectures).
.SH ENVIRONMENT VARIABLES
.TP
.B LV_SIZE
Size of source LVs (defaults to 5G)
.TP
.B SNAPSHOT_SIZE
Size of snapshot LVs (defaults to 4G)
.TP
.B SCHROOT_CONF_SUFFIX
Lines to append to schroot entries
.SH FILES
.TP
.B $HOME/.mk-sbuild-lv.sources
Can contain a customized sources.list. It will be read when creating the
schroot, see sources.list(5) for more details on format.
.TP
.B $HOME/.mk-sbuild-lv.schroot.conf
Can contain a customized configuration section to be inserted into
/etc/schroot/schroot.conf, see schroot.conf(5) for more details on format.
.SH USING THE CHROOTS
.TP
To UPDATE the golden image: \fBschroot -c ${CHROOT_NAME}-source -u root -- sh -c apt-get update && apt-get -y upgrade\fR
.TP
To ENTER an image snapshot: \fBschroot -c ${CHROOT_NAME}\fR
.TP
To BUILD within a snapshot: \fBsbuild -d ${SCHROOT_NAME} PACKAGE*.dsc\fR
.SH SEE ALSO
.BR sbuild-setup (7), sources.list (5), schroot.conf (5), https://help.ubuntu.com/community/SbuildLVMHowto
.SH AUTHOR
.PP
\fBmk-sbuild-lv\fR was written written by Kees Cook <kees@ubuntu.com>. This
man page was written by Ryan Kavanagh <ryanakca@kubuntu.org>. Both are released
under the GNU General Public License, version 3 or later.