Took into respect that xorriso loads non-RR images

This commit is contained in:
Thomas Schmitt 2008-11-15 13:36:22 +00:00
parent 91ad5bdb0e
commit 1bb20c2b5d

View File

@ -2,7 +2,7 @@
.\" First parameter, NAME, should be all caps .\" First parameter, NAME, should be all caps
.\" Second parameter, SECTION, should be 1-8, maybe w/ subsection .\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
.\" other parameters are allowed: see man(7), man(1) .\" other parameters are allowed: see man(7), man(1)
.TH XORRISO 1 "Nov 11, 2008" .TH XORRISO 1 "Nov 13, 2008"
.\" Please adjust this date whenever revising the manpage. .\" Please adjust this date whenever revising the manpage.
.\" .\"
.\" Some roff macros, for reference: .\" Some roff macros, for reference:
@ -197,17 +197,16 @@ probably show any media as closed CD-ROM resp. DVD-ROM.
Overwriteable media assume this state in such read-only drives or if they Overwriteable media assume this state in such read-only drives or if they
contain unrecognizable data in the first 32 data blocks. contain unrecognizable data in the first 32 data blocks.
.br .br
\fBRead-only\fR drives may or may not show session histories of multi-session Read-only drives may or may not show session histories of multi-session
media. Often only the first and the last session are visible. Sometimes media. Often only the first and the last session are visible. Sometimes
not even that. Option -rom_toc_scan might or might not help in such cases. not even that. Option -rom_toc_scan might or might not help in such cases.
.SS .SS
.B Creating, Growing, Modifying, Blind Growing: .B Creating, Growing, Modifying, Blind Growing:
.br .br
A new empty ISO image gets \fBcreated\fR A new empty ISO image gets \fBcreated\fR
if there is no input drive with a valid if there is no input drive with a valid ISO 9660 image when the first time
ISO 9660 image plus Rock Ridge extensions when the first time an output drive an output drive is defined. This is achieved by option -dev on blank media
is defined. This is achieved by option -dev on blank media or by option -outdev or by option -outdev on media in any state.
on media in any state.
.br .br
The new empty image can be populated with directories and files. The new empty image can be populated with directories and files.
Before it can be written, the media in the output drive must get into Before it can be written, the media in the output drive must get into
@ -260,8 +259,7 @@ Input drive, i.e. source of an existing or empty ISO image, can be any random
access readable libburn drive: optical media with readable data, access readable libburn drive: optical media with readable data,
blank optical media, regular files, block devices. blank optical media, regular files, block devices.
.br .br
Rock Ridge info must be present in existing ISO images and it will be generated Rock Ridge info will be generated by the program unconditionally.
by the program unconditionally.
.PP .PP
Output drive, i.e. target for writing, can be any libburn drive. Output drive, i.e. target for writing, can be any libburn drive.
Some drive types do not support the method of growing but only the methods Some drive types do not support the method of growing but only the methods
@ -337,7 +335,7 @@ with ownership, access permissions, symbolic links, and other attributes.
.PP .PP
This is what xorriso uses for a decent representation of the disk files This is what xorriso uses for a decent representation of the disk files
within the ISO image. Rock Ridge information is produced with any xorriso within the ISO image. Rock Ridge information is produced with any xorriso
image and xorriso will load for manipulation only Rock Ridge enhanced images. image.
.PP .PP
xorriso is not named "porriso" because POSIX only guarantees 14 characters xorriso is not named "porriso" because POSIX only guarantees 14 characters
of filename length. It is the X/Open System Interface standard XSI which of filename length. It is the X/Open System Interface standard XSI which
@ -1516,28 +1514,23 @@ on differently nationalized computers.
The meanings of byte codes are defined in \fBcharacter sets\fR which have The meanings of byte codes are defined in \fBcharacter sets\fR which have
names. Shell command iconv -l lists them. names. Shell command iconv -l lists them.
.br .br
Character sets should not matter as long as only alphanumeric characters are Character sets should not matter as long as only english alphanumeric
used for file names or as long as the shell session which runs xorriso uses the characters are used for file names or as long as all writers and readers
same character set as the one which wrote the loaded image and the same of the media use the same character set.
character set as the computers which shall read the newly emerging ISO image.
Outside these constraints it may be necessary to let xorriso convert byte Outside these constraints it may be necessary to let xorriso convert byte
codes. codes.
.br .br
There is an input conversion from input character set to the local character There is an input conversion from input character set to the local character
set which applies when an ISO image gets loaded. A conversion from local set which applies when an ISO image gets loaded. A conversion from local
character set to the output character set is performed when a new character set to the output character set is performed when an
image tree gets written. The sets can be defined independently by options image tree gets written. The sets can be defined independently by options
-in_charset and -out_charset. Normally one will have both identical, if ever. -in_charset and -out_charset. Normally one will have both identical, if ever.
.br .br
If conversions are desired then it is necessary to know the name of the If conversions are desired then xorriso needs to know the name of the
local character set. xorriso can inquire the same info as shell command local character set. xorriso can inquire the same info as shell command
"locale" with argument "charmap". This may or may not be the correct name. "locale" with argument "charmap". This may be influenced by environment
So one should check. variables LC_ALL, LC_CTYPE, or LANG and should match the expectations of
.br the terminal.
A typical wrong answer would be "ANSI_X3.4-1968" if your shell session supports
non-US-ASCII characters.
It is outside the scope of xorriso how to find out the correct name in such
a case. The author of this text uses -local_charset "ISO-8859-1".
.TP .TP
\fB\-charset\fR character_set_name \fB\-charset\fR character_set_name
Set the character set from which to convert file names when loading an Set the character set from which to convert file names when loading an
@ -1545,6 +1538,8 @@ image and to which to convert when writing an image.
.TP .TP
\fB\-local_charset\fR character_set_name \fB\-local_charset\fR character_set_name
Override the system assumption of the local character set name. Override the system assumption of the local character set name.
If this appears necessary, one should consider to set -backslash_codes to
"on" in order to avoid dangerous binary codes being sent to the terminal.
.TP .TP
.B Exception processing: .B Exception processing:
.PP .PP
@ -2597,9 +2592,9 @@ Now xorriso can burn an El Torito bootable media:
This example assumes that the existing ISO image was written with character This example assumes that the existing ISO image was written with character
set ISO-8859-1 but that the readers expected UTF-8. Now a new session with set ISO-8859-1 but that the readers expected UTF-8. Now a new session with
the same files gets added with converted file names. the same files gets added with converted file names.
In order to avoid any weaknesses of the local character set this command In order to avoid any weaknesses of the local character set, this command
pretends that it uses already the final target set UTF-8. pretends that it uses already the final target set UTF-8.
Therefore strange file names may appear in eventual error messages which Therefore strange file names may appear in eventual messages which
will be made terminal-safe by option -backslash_codes. will be made terminal-safe by option -backslash_codes.
.br .br
\fB$\fR xorriso -in_charset ISO-8859-1 -local_charset UTF-8 \\ \fB$\fR xorriso -in_charset ISO-8859-1 -local_charset UTF-8 \\