'\" t
.\" Title: grml2iso
.\" Author: [see the "Authors" section]
.\" Generator: DocBook XSL Stylesheets v1.79.1
.\" Date: 02/28/2019
.\" Manual: \ \&
.\" Source: \ \&
.\" Language: English
.\"
.TH "GRML2ISO" "8" "02/28/2019" "\ \&" "\ \&"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
grml2iso \- create a multiboot Grml ISO using grml2usb
.SH "SYNOPSIS"
.sp
grml2iso \-o
.sp
Important! The grml team does not take responsibility for loss of any data!
.SH "INTRODUCTION"
.sp
grml2iso allows you to create a multiboot Grml ISO\&. You can specify two or more Grml ISOs and will get one single multiboot ISO as a result\&. grml2iso requires and uses grml2usb for this task and installs grub2 as bootmanager on the multiboot ISO\&.
.SH "OPTIONS"
.sp
grml2iso supports the environment variables GRML2USB and WRKDIR\&. GRML2USB specifies the path to the grml2usb script you\(cqd like to use\&. WRKDIR specifies the work directory for creating the filesystem\&. The work directory needs at least as much free disk space as the sum of all specified ISOs\&.
.PP
\fB\-o \fR
.RS 4
This option is mandatory and specifies where the resulting multiboot Grml ISO should be placed\&. Note that (to avoid any possible data loss) grml2iso will exit if the specified target\&.iso exists already\&.
.RE
.PP
\fB\-c \fR
.RS 4
The content of the specified directory will be copied to the resulting multiboot Grml ISO\&.
.RE
.PP
\fB\-b \fR
.RS 4
Use specified default bootoptions as default\&.
.RE
.PP
\fB\-f\fR
.RS 4
Force the program to run and overwrite an existing ISO image\&.
.RE
.PP
\fB\-r \fR
.RS 4
Remove specified boot parameter from existing command line\&. Could be specified multiple times\&.
.RE
.PP
\fB\-p \fR
.RS 4
Execute grml2usb with the specified parameters\&. For a list of valid parameters have a look at the
\m[blue]\fBgrml2usb webpage\fR\m[]\&\s-2\u[1]\d\s+2
or the grml2usb manpage
.RE
.PP
\fB\-s \fR
.RS 4
Generate a small ISO file which downloads the squashfs file from the specified URI\&. Due to current limitations in busyboxs wget and DNS resolution, an URL can not contain a hostname but an IP only\&. This is useful if you want to boot systems which support booting ISO image from your local system\&. Besides the iso image this command also copies the squashfs file to the output directory\&.
.RE
.SH "USAGE EXAMPLES"
.sp
.if n \{\
.RS 4
.\}
.nf
# grml2iso \-o /tmp/grml\&.iso grml_2009\&.05\&.iso grml64_2009\&.05\&.iso
.fi
.if n \{\
.RE
.\}
.sp
Create multiboot ISO /tmp/grml\&.iso with grml_2009\&.05\&.iso and grml64_2009\&.05\&.iso\&.
.sp
.if n \{\
.RS 4
.\}
.nf
# grml2iso \-b \*(Aqlang=de ssh=passwd\*(Aq \-c /tmp/grml\-content \-o /srv/grml\&.iso /srv/grml/grml_2009\&.10\&.iso
.fi
.if n \{\
.RE
.\}
.sp
Create a new ISO with additional boot parameters and copy the content from /tmp/grml\-content to the generated ISO image\&.
.sp
.if n \{\
.RS 4
.\}
.nf
# grml2iso \-r quiet \-r vga=791 \-o /srv/grml\&.iso /srv/grml\-small_2009\&.10\&.iso
.fi
.if n \{\
.RE
.\}
.sp
Create a new ISO and remove existing boot parameters quiet and vga=791\&.
.sp
.if n \{\
.RS 4
.\}
.nf
# GRML2USB=/srv/git/grml2usb grml2iso \-o /srv/grml\&.iso /srv/grml/grml_2009\&.05\&.iso /srv/grml/grml64\-medium_2009\&.05\&.iso
.fi
.if n \{\
.RE
.\}
.sp
Create multiboot ISO /srv/grml\&.iso with grml_2009\&.05\&.iso and grml64\-medium_2009\&.05\&.iso using /srv/git/grml2usb as grml2usb script\&.
.sp
.if n \{\
.RS 4
.\}
.nf
# WRKDIR=/mnt/test/grml\-tmp grml2iso \-o /mnt/test/grml\&.iso grml_2009\&.05\&.iso grml64_2009\&.05\&.iso
.fi
.if n \{\
.RE
.\}
.sp
Use /mnt/test/grml\-tmp as working directory for creating the multiboot ISO /mnt/test/grml\&.iso with grml_2009\&.05\&.iso and grml64_2009\&.05\&.iso\&.
.sp
.if n \{\
.RS 4
.\}
.nf
# grml2iso \-p \-\-skip\-addons \-o /srv/grml\&.iso /srv/grml\-small_2009\&.10\&.iso /srv/grml64\-small_2009\&.10\&.iso
.fi
.if n \{\
.RE
.\}
.sp
Don\(cqt copy the addons from the specified ISO images
.SH "ONLINE RESOURCES"
.sp
Check out the \m[blue]\fBgrml2usb webpage\fR\m[]\&\s-2\u[1]\d\s+2 and the \m[blue]\fBgrml2usb git repository\fR\m[]\&\s-2\u[2]\d\s+2\&.
.SH "BUGS"
.sp
Please report feedback, bugreports and wishes to the author\&.
.SH "AUTHORS"
.sp
Michael Prokop <\m[blue]\fBmika@grml\&.org\fR\m[]\&\s-2\u[3]\d\s+2> and Thorsten Glaser <\m[blue]\fBtg@mirbsd\&.org\fR\m[]\&\s-2\u[4]\d\s+2>
.SH "NOTES"
.IP " 1." 4
grml2usb webpage
.RS 4
\%http://grml.org/grml2usb/
.RE
.IP " 2." 4
grml2usb git repository
.RS 4
\%http://git.grml.org/?p=grml2usb.git
.RE
.IP " 3." 4
mika@grml.org
.RS 4
\%mailto:mika@grml.org
.RE
.IP " 4." 4
tg@mirbsd.org
.RS 4
\%mailto:tg@mirbsd.org
.RE