This page is a HTML version of isolabel manual page.
Original (plain text) version could be found as
ISOLABEL.txt in isolabel-0.2.0, isolabel-0.2.1, isolabel-0.2.2, and isolabel-0.2.3 source package.
isolabel - change volume label on ISO 9660 image file
isolabel [OPTION]... IMAGEFILE NEWLABEL
isolabel sets IMAGEFILE's ISO 9660 volume label to the NEWLABEL. If
--joliet option was specified, volume label on IMAGEFILE's Joliet
extension will be changed instead of ISO 9660's one.
IMAGEFILE is assumed to be a plain ISO 9660 image file (CD-ROM MODE 1, MODE 2 form 1, DVD, BD user data with 2048 bytes/sector, single track). Other sector size or other mode (e.g. CD RAW mode 2532 bytes/sector) are not supported.
Characters in plain ISO 9660 volume label can only be uppercase '
--force was used), and can not be longer than 32 characters.
For Joliet volume label (used with
--joliet option), label can be any
character except nonprintable ASCII, '
--force was used), not longer than 16 characters, and not ending with space.
- set volume label on Joliet extension, instead of plain ISO 9660
- allow label that violates ISO 9660 or Joliet extension, label can now be any character, but still cannot end with space and not longer than 32 characters (or 16 characters in case of Joliet)
- display verbose information about the operation
- display short help and exit
- display version and author information, then exit
To change ISO 9660 label of
imagefile.iso to "
isolabel imagefile.iso "NEW_LABEL"
To change Joliet label of
imagefile.iso to "
Joliet Label", use:
isolabel --joliet imagefile.iso "Joliet Label"
- if the operation was succeeded
if user supplied invalid command line parameters, e.g. specified
NEWLABEL for ISO 9660 with more than 32 characters (or 16
--jolietwas used), trying to use invalid character in NEWLABEL, or didn't specify IMAGEFILE, NEWLABEL
if data inconsistency was detected, e.g. IMAGEFILE is not a
valid ISO 9660 disc image, or trying to use
--jolietwith non-Joliet IMAGEFILE
- if system error was detected, e.g. IMAGEFILE cannot be opened, file read, write, seeking error, or character encoding conversion failed
Written by Nachanon Vetjasit
On systems other than Unix-like and Windows, isolabel currently assumes
that NEWLABEL parameter is using ISO-8859-1 encoding; using non-Latin 1
volume label with
--joliet option on those systems will result in
gibberish volume label.