'\" t
.\" Title: grml2iso
.\" Author: [see the "Author" section]
.\" Generator: DocBook XSL Stylesheets vsnapshot
.\" Date: 02/20/2023
.\" Manual: \ \&
.\" Source: \ \&
.\" Language: English
.\"
.TH "GRML2ISO" "8" "02/20/2023" "\ \&" "\ \&"
.\" -----------------------------------------------------------------
.\" * 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\&.
.SH "IMPORTANT"
.sp
The order of the provided ISOs matters for two reasons:
.sp
1) order in boot menu entries: the first ISO specified is listed as first (default) option in the boot menu, further ISOs will be listed below as next options
.sp
2) EFI image to be used: the EFI image for booting via (U)EFI will be taken from the last provided ISO\&. Therefore to be able to boot on 64bit EFI systems, you need to provide a 64bit ISO (like grml64\-small or grml64\-full) as \fIlast\fR ISO in the grml2iso command line\&.
.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\&. Can 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 grml2usb(8) manual page\&.
.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\-multiboot\&.iso grml32\-small_2020\&.06\&.iso grml64\-small_2020\&.06\&.iso
.fi
.if n \{\
.RE
.\}
.sp
Create multiboot ISO /tmp/grml\-multiboot\&.iso with grml32\-small_2020\&.06\&.iso and grml64\-small_2020\&.06\&.iso\&.
.sp
.if n \{\
.RS 4
.\}
.nf
# grml2iso \-b \*(Aqlang=de ssh=passwd\*(Aq \-c /tmp/grml\-content \-o /srv/grml\-multiboot\&.iso /srv/grml/grml32\-small_2020\&.06\&.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\-multiboot\&.iso /srv/grml64\-small_2020\&.06\&.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/grml2usb grml2iso \-o /srv/grml\-multiboot\&.iso /srv/grml/grml32\-small_2020\&.06\&.iso /srv/grml/grml64\-medium_2020\&.06\&.iso
.fi
.if n \{\
.RE
.\}
.sp
Create multiboot ISO /srv/grml\-multiboot\&.iso with grml32\-small_2020\&.06\&.iso and grml64\-medium_2020\&.06\&.iso using /srv/git/grml2usb/grml2usb as grml2usb script\&.
.sp
.if n \{\
.RS 4
.\}
.nf
# WRKDIR=/mnt/test/grml\-tmp grml2iso \-o /mnt/test/grml\-multiboot\&.iso grml32\-small_2020\&.06\&.iso grml64\-small_2020\&.06\&.iso
.fi
.if n \{\
.RE
.\}
.sp
Use /mnt/test/grml\-tmp as working directory for creating the multiboot ISO /mnt/test/grml\-multiboot\&.iso with grml32\-small_2020\&.06\&.iso and grml64\-small_2020\&.06\&.iso\&.
.sp
.if n \{\
.RS 4
.\}
.nf
# grml2iso \-p \-\-skip\-addons \-o /srv/grml\-multiboot\&.iso /srv/grml64\-small_2020\&.06\&.iso /srv/grml64\-small_2020\&.06\&.iso
.fi
.if n \{\
.RE
.\}
.sp
Don\(cqt copy the addons from the specified ISO images
.SH "BUGS"
.sp
Please report feedback, bug reports and wishes at \m[blue]\fBhttps://github\&.com/grml/grml2usb/\fR\m[]
.SH "AUTHOR"
.sp
Michael Prokop <\m[blue]\fBmika@grml\&.org\fR\m[]\&\s-2\u[1]\d\s+2>
.SH "NOTES"
.IP " 1." 4
mika@grml.org
.RS 4
\%mailto:mika@grml.org
.RE