SDT-KISO(1) SUSE Driver Tools

Scott Bahling

23-07-2013

NAME

sdt kiso - tool for creating kISO images

SYNOPSIS

sdt kiso [options]

DESCRIPTION

kISO

The kISO is an ISO image containing a copy of a portion of the /boot section of the SUSE Linux Enterprise installation media with updates to the kernel, kernel modules, or other files based on the updates provided by the user.

Creating kISO images

To create a kISO kit use the kiso sub-command of the sdt tool.

sdt kiso -u updates -b ./distro/sles11sp1-x86_64

The -b/--base option to points to the distro installation media used as a basis of the bootable driver kit.

The -u/--updatedir option specifies a directory where the sdt tool will find the files to be added to the Update Medium. Any KMPs, kernel packages, or other files found in the directory will be added to the kISO boot structure appropriately.

Creating a merged media

To create an ISO image that merges the kISO contents with the base SUSE product onto a single media, use the -M/--merge option:

 sdt kiso -M -u updates -b ./distro/sles11sp1-x86_64

This will generate the kISO as usual and copy it’s content along with the base SUSE Product repository to the new ISO image. The ISO boot structure will be updated to include any updated kernel, kernel modules or other updates just as with the bootable driver kit.

OPTIONS

-b BASE_MEDIA, –base BASE_MEDIA

Points to the contents of the initial installation media of the SUSE Linux Enterprise Product that the driver kit is designed to work with. Option can point to either a directory containing the contents of the installation media, or the media ISO image itself.

This option will cause the driver kit to be built as a bootable driver kit.

-u UPDATEDIR, –updatedir=UPDATEDIR

Directory to be scanned for update files to be added to driver kit. Directory will be scanned for kernel packages, KMP packages, YaST2 modules (.ybc), and tar files (.tgz).

-w WORKDIR, –workdir WORKDIR

Work directory. Created if non-existent and remains after completion. If this option is not specified, temporary directory is created and deleted on exit.

-m MODSPEC, –modspec MODSPEC

Additional module to add to module.config such that it’s added to initrd and linuxrc considers it while probing hardware. MODSPEC is of the following format:

SECTION:MODULE,DESCR,PARAM,PRE_INST,POST_INST,INITRD,AUTO

If the kernel doesn’t contain any new driver which should be loaded for installation compared to the kernel contained in the base ISO, this option isn’t necessary.

–boot-param BOOTPARAMS

Specify a parameter to add to the isolinux.cfg/elilo.conf file. Format is “label:param” where label is the label of the section in the config file to add the param to.

Example: Add “install=” param to the section labeled “linux”:

--boot-param="linux:install=http://installserver/repo"

–no-initrd-mod-updates

Do not update the kernel modules in the initrd. When updating the initrd, the kernel modules and related files will be copied as-is from the base media to the bootable driverkit initrd.

–no-uni-dud

By default DUDs are generated to work with both SUSE Linux Enterprise Server and Desktop products. Use this option to disable this and have the DUD structure created to only work with the specified base product.

-E, –no-efi

Do not generate efi boot loader. Only applies to x86_64 arch.

-M, –merge

Merge driver kit with base SUSE Linux Enterprise installation media. A new ISO image is created containing the standard SUSE Linux Enterprise installation repository in addition to the driver kit repository along with the boot loader and installer. The installation process will automatically add the driver kit as an add-on product to be installed in tandem with the base SUSE Linux Enterprise product.

-s {u,p,f,up,pf,upf}, –steps {u,p,f,up,pf,upf}

Specifies steps to perform. STEPS is any combination of “u”, “p” and “f”. “u” stands for Unpack, “p” for Prepare and “f” for Finish. The default is to perform all steps, that is, “-s upf”.

Unpack step copies necessary directories and files from base ISO under workdir/boot.staging, unpacks initrd from it under workdir/initrd.staging and kernel package under kernel.staging. module.config is copied to module.config under workdir and –module options are applied.

Prepare step installs the new kernel, modules and kernel package under appropriate staging directories.

Finish step packs the initrd and then produces the ISO.

This option allows manual customization or fix up of media. Note that –workdir must be specified when this option is used.

-o OUTPUT, –output OUTPUT

Output file to be created. Defaults to out.iso.

-V VOLUME, –volume VOLUME

ISO9660 Volume Identification for the ISO image.

-p PREPARER, –preparer PREPARER

ISO9660 Preparer Identification for the ISO image.

-P PUBLISHER, –publisher PUBLISHER

ISO9660 Publisher Identification for ISO image.

-A APPLICATION, –application APPLICATION

ISO9660 Application spec for the ISO image.

FILES DETECTED IN UPDATEDIR

When scanning the UPDATEDIR for files to be added to the driver kit, certain files will be automatically detected and specific actions taken. See sdt-file-detection (7) for more information on how files are detected.

SEE ALSO

sdt(1), sdt-file-detection(7)