Took into respect that xorriso loads non-RR images
This commit is contained in:
parent
91ad5bdb0e
commit
1bb20c2b5d
@ -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 \\
|
||||||
|
Loading…
Reference in New Issue
Block a user