nbdkit-iso-plugin - Man Page

create virtual ISO (CD-ROM) from directory

Synopsis

 nbdkit iso [dir=]DIRECTORY [[dir=]DIRECTORY ...]
            [prog=mkisofs] [params='-JrT']
 nbdkit iso --dump-plugin

Description

nbdkit-iso-plugin is a plugin for nbdkit(1) which creates a virtual ISO (CD-ROM) image from a directory on the fly.  The files from DIRECTORY are added to a virtual ISO image which is served read-only over the NBD protocol.

This plugin uses xorriso(1), genisoimage(1) or mkisofs(1) to create the ISO content.  See also "Dump Plugin Output" below.

To create a FAT-formatted virtual floppy disk instead of a CD, see nbdkit-floppy-plugin(1).  To create a Linux compatible virtual disk, see nbdkit-linuxdisk-plugin(1).

Example

Create a virtual ISO which supports Joliet, Rock Ridge and TRANS.TBL extensions, from files in a directory:

 nbdkit iso /path/to/directory params='-JrT'

params adds -JrT to the xorriso(1), genisoimage(1) or mkisofs(1) command line, specifying the required extensions.  Note that unless you use at least one of these extensions, filenames inside the ISO will be truncated because of limitations of the basic ISO 9660 format.

Parameters

[dir=]DIRECTORY

Specify the directory containing files and subdirectories which will be added to the virtual ISO.  Files inside this directory will appear in the root directory of the ISO.

This parameter is required and may be specified one or more times.  If multiple directories are specified, they are merged together.

dir= is a magic config key and may be omitted in most cases. See "Magic parameters" in nbdkit(1).

params='parameters ...'

Any other parameters may be passed through to xorriso(1), genisoimage(1) or mkisofs(1) by specifying this option.

For example:

 params='-JrT -V "My Disk Image"'

would specify Joliet (-J), Rock Ridge (-r) and TRANS.TBL (-T) extensions, and specify the volume ID (-V) as My Disk Image.

Take care when quoting this parameter; nbdkit passes the resulting string through another layer of shell interpretation without any sanity checks for unquoted shell metacharacters.

prog=mkisofs

Choose which program to use to create the ISO content.  The default is xorriso(1), genisoimage(1) or mkisofs(1) and is picked when nbdkit is compiled.  You only need to use this parameter if you want to override it at run time.

Dump Plugin Output

Use:

 nbdkit iso --dump-plugin

to find out which mkisofs-like program was used when the plugin was compiled.  For example:

 $ nbdkit iso --dump-plugin | grep ^iso_prog=
 iso_prog=xorriso

Environment Variables

PATH

xorriso(1), genisoimage(1), mkisofs(1) or whatever you supply to the optional prog parameter must be available on the $PATH.

TMPDIR

A temporary copy of the ISO is created in TMPDIR.  If this environment variable is not set then /var/tmp is used instead. There must be enough free space here to store the ISO, which might be quite large.

Files

$plugindir/nbdkit-iso-plugin.so

The plugin.

Use nbdkit --dump-config to find the location of $plugindir.

Version

nbdkit-iso-plugin first appeared in nbdkit 1.8.

See Also

nbdkit(1), nbdkit-plugin(3), nbdkit-file-plugin(1), nbdkit-floppy-plugin(1), nbdkit-linuxdisk-plugin(1), nbdkit-torrent-plugin(1), genisoimage(1), mkisofs(1), xorriso(1).

Authors

Richard W.M. Jones

License

Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:

THIS SOFTWARE IS PROVIDED BY RED HAT AND CONTRIBUTORS ''AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL RED HAT OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

Referenced By

nbdkit(1), nbdkit-floppy-plugin(1), nbdkit-linuxdisk-plugin(1), nbdkit-partitioning-plugin(1), nbdkit-plugin(3), nbdkit-release-notes-1.38(1), nbdkit-release-notes-1.8(1), nbdkit-torrent-plugin(1).

2024-10-14 nbdkit-1.41.8