.\" generated with Ronn-NG/v0.8.0
.\" http://github.com/apjanke/ronn-ng/tree/0.8.0
.TH "LTSP\-KERNEL" "8" "October 2019" "LTSP 19.10-1" "LTSP Manual"
.SH "NAME"
\fBltsp\-kernel\fR \- copy the kernel and initrd from an image to TFTP
.SH "SYNOPSIS"
\fBltsp\fR [\fIltsp\-options\fR] \fBkernel\fR [\fB\-k\fR \fIkernel\-initrd\fR] [\fIimage\fR] \|\.\|\.\|\.
.SH "DESCRIPTION"
Copy vmlinuz and initrd\.img from an image or chroot to TFTP\. If \fIimage\fR is unspecified, process all of them\. For simplicity, only chroot directories and raw images are supported, either full filesystems (squashfs, ext4) or full disks (flat VMs)\. They may be sparse to preserve space\. Don\'t use a separate /boot nor LVM in disk images\. The targets will always be named vmlinuz and initrd\.img to simplify ltsp\.ipxe\.
.SH "OPTIONS"
See the \fBltsp(8)\fR man page for \fIltsp\-options\fR\.
.TP
\fB\-k\fR, \fB\-\-kernel\-initrd=\fR\fIglob\-regex\fR
Specify a kernel glob and an initrd regex to locate them inside the \fIimage\fR; try to autodetect if undefined\. See the EXAMPLES section below\.
.SH "DIRECT IMAGES"
This section is for advanced LTSP sysadmins\. Let\'s suppose that you want to test if your users would prefer Xubuntu to your existing Ubuntu MATE\. First, move and rename your Xubuntu CD to this location, without using symlinks, and then update kernels and ipxe:
.IP "" 4
.nf
mv xubuntu\-18\.04\-desktop\-amd64\.iso /srv/ltsp/images/xubuntu\-18\.04\.img
ltsp kernel xubuntu\-18\.04
ltsp \-o ipxe  # note, this overwrites ltsp\.ipxe
.fi
.IP "" 0
.P
If you reboot your clients, they\'ll now have the option to boot with the Xubuntu live CD in LTSP mode! This is like booting with the live CD, except that all the users and their homes are available! So the users can normally login and work for days or weeks in the new environment, before you decide that they like Xubuntu and that you want to move from using the live CD to maintaining a Xubuntu image using a virtual machine\.
.P
You can also do this with virtual machine images! For example:
.IP "" 4
.nf
    mv ~/VirtualBox\e VMs/debian/debian\-flat\.vmdk /srv/ltsp/images/debian\-vm\.img
    ln \-rs /srv/ltsp/images/debian\-vm\.img ~/VirtualBox\e VMs/debian/debian\-flat\.vmdk
    ltsp kernel debian\-vm
    ltsp \-o ipxe  # note, this overwrites ltsp\.ipxe
.fi
.IP "" 0
.P
These commands move your "debian" VM to the LTSP images directory, symlink it back to where VirtualBox expects it, and update the kernels and ipxe\. After these, you\'ll be able to boot directly from the "debian\-vm" iPXE menu item without having to run \fBltsp image\fR! It\'s the fastest way to test image changes without waiting 10 minutes for \fBltsp image\fR each time\.
.P
Some advanced users may think of using the opposite symlink instead:
.IP "" 4
.nf
    ln \-rs ~/VirtualBox\e VMs/debian/debian\-flat\.vmdk /srv/ltsp/images/debian\-vm\.img
.fi
.IP "" 0
.P
Unfortunately NFS doesn\'t follow symlinks outside of the exported directories, so the clients wouldn\'t be able to boot in this case\. Advanced users may use bind mounts though, e\.g\.:
.IP "" 4
.nf
    mount \-\-bind ~/VirtualBox\e VMs/debian/debian\-flat\.vmdk /srv/ltsp/images/debian\-vm\.img
.fi
.IP "" 0
.SH "EXAMPLES"
Typical use:
.IP "" 4
.nf
ltsp kernel x86_64
.fi
.IP "" 0
.P
Passing a glob to locate the kernel and a regex to locate the initrd in a Debian live CD:
.IP "" 4
.nf
ltsp kernel \-\-kernel\-initrd="live/vmlinuz\-* s|vmlinuz|initrd\.img|"
.fi
.IP "" 0
.SH "COPYRIGHT"
Copyright 2019 the LTSP team, see AUTHORS
.SH "SEE ALSO"
\fBltsp\fR(8), \fBltsp\.conf\fR(5), \fBltsp\-dnsmasq\fR(8), \fBltsp\-image\fR(8), \fBltsp\-info\fR(8), \fBltsp\-initrd\fR(8), \fBltsp\-ipxe\fR(8), \fBltsp\-kernel\fR(8), \fBltsp\-nfs\fR(8)