Provided by: ltsp_20.04-1_all bug

NAME
       ltsp-kernel - copy the kernel and initrd from an image to TFTP


SYNOPSIS
       ltsp [ltsp-options] kernel [-k kernel-initrd] [image] ...


DESCRIPTION
       Copy  vmlinuz  and  initrd.img  from  an image or chroot to TFTP. If image 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.


OPTIONS
       See the ltsp(8) man page for ltsp-options.

       -k, --kernel-initrd=glob-regex
              Specify  a  kernel  glob and an initrd regex to locate them inside the image; try to autodetect if
              undefined. See the EXAMPLES section below.


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:

           mv xubuntu-18.04-desktop-amd64.iso /srv/ltsp/images/xubuntu-18.04.img
           ltsp kernel xubuntu-18.04
           ltsp ipxe

       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.

       You can also do this with virtual machine images! For example:

               mv ~/VirtualBox\ VMs/debian/debian-flat.vmdk /srv/ltsp/images/debian-vm.img
               ln -rs /srv/ltsp/images/debian-vm.img ~/VirtualBox\ VMs/debian/debian-flat.vmdk
               ltsp kernel debian-vm
               ltsp ipxe

       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 ltsp image! It's the fastest way to test  image  changes
       without waiting 10 minutes for ltsp image each time.

       Some advanced users may think of using the opposite symlink instead:

               ln -rs ~/VirtualBox\ VMs/debian/debian-flat.vmdk /srv/ltsp/images/debian-vm.img

       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.:

               mount --bind ~/VirtualBox\ VMs/debian/debian-flat.vmdk /srv/ltsp/images/debian-vm.img


EXAMPLES
       Typical use:

           ltsp kernel x86_64

       Passing a glob to locate the kernel and a regex to locate the initrd in a Debian live CD:

           ltsp kernel --kernel-initrd="live/vmlinuz-* s|vmlinuz|initrd.img|"


COPYRIGHT
       Copyright 2019 the LTSP team, see AUTHORS


SEE ALSO
       ltsp(8),   ltsp.conf(5),  ltsp-dnsmasq(8),  ltsp-image(8),  ltsp-info(8),  ltsp-initrd(8),  ltsp-ipxe(8),
       ltsp-kernel(8), ltsp-nfs(8)

LTSP 20.04-1                                       April 2020                                     LTSP-KERNEL(8)