Back to isolabel-0.1.0 documentation.

This page is a HTML version of isolabel manual page, original (plain text) version could be found as ISOLABEL.txt in isolabel-0.1.0 source package.

Name

isolabel - change volume label on ISO 9660 image file

Synopsis

isolabel [OPTION]... IMAGEFILE NEWLABEL

Description

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 'A'-'Z' or '_', and can not be longer than 32 characters.

For Joliet volume label (used with --joliet option), label can be any character except nonprintable ASCII, '*', '/', ':', ';', '?', '\', not longer than 16 characters, and not ending with space.

-j, --joliet
set volume label on Joliet extension, instead of plain ISO 9660
-v, --verbose
display verbose information about the operation
-h, --help
display short help and exit
-V, --version
display version and author information, then exit

Examples

To change ISO 9660 label of imagefile.iso to "NEW_LABEL", use:

isolabel imagefile.iso "NEW_LABEL"

To change Joliet label of imagefile.iso to "Joliet Label", use:

isolabel --joliet imagefile.iso "Joliet Label"

Exit Status

0
if the operation was succeeded
1
if user supplied invalid command line parameters, e.g. specified NEWLABEL for ISO 9660 with more than 32 characters (or 16 characters if --joliet was used), trying to use invalid character in NEWLABEL, or didn't specify IMAGEFILE, NEWLABEL
2
if data inconsistency was detected, e.g. IMAGEFILE is not a valid ISO 9660 disc image, or trying to use --joliet with non-Joliet IMAGEFILE
3
if system error was detected, e.g. IMAGEFILE cannot be opened, file read, write, or seeking error

Author

Written by Nachanon Vetjasit

Bugs

Currently, isolabel assumes that NEWLABEL parameter is using ISO-8859-1 encoding; using non-Latin 1 volume label with --joliet option will result in gibberish volume label.

Report isolabel bugs to http://sourceforge.net/p/isolabel/tickets/
isolabel home page: http://isolabel.sourceforge.net/

Copyright

Copyright © 2014 Nachanon Vetjasit
License: GNU GPL
This is free software, you are free to change and redistribute it. There is NO WARRANTY, to the extent permitted by law.