Fixed spelling errors found by fossies.org with codespell
This commit is contained in:
@ -50,7 +50,7 @@
|
||||
@c man .\" First parameter, NAME, should be all caps
|
||||
@c man .\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
|
||||
@c man .\" other parameters are allowed: see man(7), man(1)
|
||||
@c man .TH XORRISO 1 "Version 1.5.3, Oct 27, 2019"
|
||||
@c man .TH XORRISO 1 "Version 1.5.3, Oct 28, 2019"
|
||||
@c man .\" Please adjust this date whenever revising the manpage.
|
||||
@c man .\"
|
||||
@c man .\" Some roff macros, for reference:
|
||||
@ -168,7 +168,7 @@ Can check media for damages and copy readable blocks to disk.
|
||||
@*
|
||||
Can attach MD5 checksums to each data file and the whole session.
|
||||
@*
|
||||
Scans for optical drives, blanks re-useable optical media.
|
||||
Scans for optical drives, blanks re-usable optical media.
|
||||
@*
|
||||
Reads its instructions from command line arguments, dialog, and files.
|
||||
@*
|
||||
@ -241,7 +241,7 @@ Adding a session to an existing ISO image is in this text referred as
|
||||
@*
|
||||
The multi-session model of the MMC standard does not apply to all media
|
||||
types. But program growisofs by Andy Polyakov showed how to extend this
|
||||
functionality to overwriteable media or disk files which carry valid ISO 9660
|
||||
functionality to overwritable media or disk files which carry valid ISO 9660
|
||||
filesystems.
|
||||
@c man .PP
|
||||
@sp 1
|
||||
@ -287,8 +287,8 @@ Similar to multi-session media are DVD-R DL and minimally blanked DVD-RW.
|
||||
They record only a single session of which the size must be known in advance.
|
||||
@command{xorriso} will write onto them only if command -close is set to "on".
|
||||
@*
|
||||
@cindex Overwriteable media, _definition
|
||||
@strong{Overwriteable media} are DVD-RAM, DVD+RW, BD-RE, and formatted DVD-RW.
|
||||
@cindex Overwritable media, _definition
|
||||
@strong{Overwritable media} are DVD-RAM, DVD+RW, BD-RE, and formatted DVD-RW.
|
||||
They offer random write access but do not provide information about their
|
||||
session history. If they contain one or more ISO 9660 sessions and if the
|
||||
first session was written by @command{xorriso}, then a table of content can
|
||||
@ -297,7 +297,7 @@ be emulated. Else only a single overall session will be visible.
|
||||
DVD-RW media can be formatted by -format "full".
|
||||
They can be made unformatted by -blank "deformat".
|
||||
@*
|
||||
Regular files and block devices are handled as overwriteable media.
|
||||
Regular files and block devices are handled as overwritable media.
|
||||
Pipes and other writeable file types are handled as blank multi-session media.
|
||||
@c man .PP
|
||||
@sp 1
|
||||
@ -311,15 +311,15 @@ suitable for @command{xorriso}.
|
||||
@*
|
||||
Blank is the state of newly purchased optical media.
|
||||
With used CD-RW and DVD-RW it can be achieved by action -blank "as_needed".
|
||||
Overwriteable media are considered blank if they are new or if they have
|
||||
Overwritable media are considered blank if they are new or if they have
|
||||
been marked as blank by @command{xorriso}.
|
||||
Action -blank "as_needed" can be used to do this marking on overwriteable
|
||||
Action -blank "as_needed" can be used to do this marking on overwritable
|
||||
media, or to apply mandatory formatting to new media if necessary.
|
||||
@*
|
||||
@sp 1
|
||||
@cindex Appendable media, _definition
|
||||
@strong{Appendable} media accept further sessions. Either they are MMC
|
||||
multi-session media in appendable state, or they are overwriteable media
|
||||
multi-session media in appendable state, or they are overwritable media
|
||||
which contain an ISO image suitable for @command{xorriso}.
|
||||
@*
|
||||
Appendable is the state after writing a session with command -close off.
|
||||
@ -333,7 +333,7 @@ Closed is the state of DVD-ROM media and of multi-session media which were
|
||||
written with command -close on. If the drive is read-only hardware then it will
|
||||
probably show any media as closed CD-ROM or DVD-ROM.
|
||||
@*
|
||||
Overwriteable media assume this state in such read-only drives or if they
|
||||
Overwritable media assume this state in such read-only drives or if they
|
||||
contain unrecognizable data in the first 32 data blocks.
|
||||
@*
|
||||
Read-only drives may or may not show session histories of multi-session
|
||||
@ -418,7 +418,7 @@ of modifying and blind growing. They all are suitable for newly created images.
|
||||
@sp 1
|
||||
All drive file objects have to offer rw-permission to the user of
|
||||
@command{xorriso}.
|
||||
Even those which will not be useable for reading an ISO image.
|
||||
Even those which will not be usable for reading an ISO image.
|
||||
@*
|
||||
@cindex LBA, _definition
|
||||
With any type of drive object, the data are considered to be organized in
|
||||
@ -555,7 +555,7 @@ hard-disk-like media. Several options install a @strong{MBR}
|
||||
intended boot firmware and the involved boot loaders, e.g. GRUB2 or ISOLINUX.
|
||||
A MBR contains boot code and a partition table.
|
||||
The new MBR of a follow-up session can get in effect
|
||||
only on overwriteable media.
|
||||
only on overwritable media.
|
||||
@*
|
||||
MBR is read by PC-BIOS when booting from USB stick or hard disk,
|
||||
and by PowerPC CHRP or PReP when booting.
|
||||
@ -989,7 +989,7 @@ If you decide so, consider to put the command into a global startup file like
|
||||
/etc/opt/xorriso/rc.
|
||||
@c man .TP
|
||||
@item -grow_blindly "off"|predicted_nwa
|
||||
@kindex -grow_blindly overides next writeable address
|
||||
@kindex -grow_blindly overrides next writeable address
|
||||
@cindex Next writeable address, -grow_blindly
|
||||
If predicted_nwa is a non-negative number then perform blind growing rather
|
||||
than modifying if -indev and -outdev are set to different drives.
|
||||
@ -1375,7 +1375,7 @@ Else just avoid names longer than 253 characters.
|
||||
Read-only drives do not tell the actual media type but show any media as
|
||||
ROM (e.g. as DVD-ROM). The session history of MMC multi-session media might
|
||||
be truncated to first and last session or even be completely false.
|
||||
(The emulated history of overwriteable media is not affected by this.)
|
||||
(The emulated history of overwritable media is not affected by this.)
|
||||
@*
|
||||
To have in case of failure a chance of getting the session history and
|
||||
especially the address of the last session, there is a scan for ISO 9660
|
||||
@ -1389,11 +1389,11 @@ multi-session DVD or BD. If on such a system @command{xorriso} has no own MMC
|
||||
capabilities then it may still find that session from a scanned table of
|
||||
content. Setting "force" handles any media like a ROM medium with setting "on".
|
||||
@*
|
||||
On the other hand the emulation of session history on overwriteable media
|
||||
On the other hand the emulation of session history on overwritable media
|
||||
can hamper reading of partly damaged media. Setting "off:emul_off" disables
|
||||
the elsewise trustworthy table-of-content scan for those media.
|
||||
@*
|
||||
The table-of-content scan on overwriteable media normally searches only up to
|
||||
The table-of-content scan on overwritable media normally searches only up to
|
||||
the end of the session that is pointed to by the superblock at block 0.
|
||||
Setting "on:emul_wide" lets the scan continue up to the end of the medium.
|
||||
This may be useful after copying a medium with -check_media patch_lba0=on
|
||||
@ -1428,7 +1428,7 @@ effective access permissions. This implies to try opening those files for
|
||||
writing, which otherwise will happen only later and only if actual
|
||||
writing is desired.
|
||||
@*
|
||||
The test result is used for classifying the pseudo drives as overwriteable,
|
||||
The test result is used for classifying the pseudo drives as overwritable,
|
||||
read-only, write-only, or uselessly empty. This may lead to earlier detection
|
||||
of severe problems, and may avoid some less severe error events.
|
||||
@*
|
||||
@ -2979,16 +2979,16 @@ then this command leads to a FAILURE event.
|
||||
Defined modes are:
|
||||
as_needed, fast, all, deformat, deformat_quickest
|
||||
@*
|
||||
"as_needed" cares for used CD-RW, DVD-RW and for used overwriteable media
|
||||
"as_needed" cares for used CD-RW, DVD-RW and for used overwritable media
|
||||
by applying -blank "fast". It applies -format "full" to yet unformatted
|
||||
DVD-RAM and BD-RE. Other media in blank state are gracefully ignored.
|
||||
Media which cannot be made ready for writing from scratch cause a FAILURE
|
||||
event.
|
||||
@*
|
||||
"fast" makes CD-RW and unformatted DVD-RW re-usable, or invalidates
|
||||
overwriteable ISO images. "all" might work more thoroughly and need more time.
|
||||
overwritable ISO images. "all" might work more thoroughly and need more time.
|
||||
@*
|
||||
"deformat" converts overwriteable DVD-RW into unformatted ones.
|
||||
"deformat" converts overwritable DVD-RW into unformatted ones.
|
||||
@*
|
||||
"deformat_quickest" is a faster way to deformat or blank DVD-RW
|
||||
but produces media which are only suitable for a single session.
|
||||
@ -3010,7 +3010,7 @@ Blanking will nevertheless only succeed if the drive is willing to do it.
|
||||
@item -format mode
|
||||
@kindex -format formats media
|
||||
@cindex Media, format, -format
|
||||
Convert unformatted DVD-RW into overwriteable ones, "de-ice" DVD+RW, format
|
||||
Convert unformatted DVD-RW into overwritable ones, "de-ice" DVD+RW, format
|
||||
newly purchased BD-RE or BD-R, re-format DVD-RAM or BD-RE.
|
||||
@*
|
||||
Defined modes are:
|
||||
@ -3290,7 +3290,7 @@ Default is "old_rr" which uses Rock Ridge version 1.10. This implies also
|
||||
"aaip_susp_1_10" allows AAIP to be written as unofficial extension of RRIP
|
||||
rather than as official extension under SUSP-1.12.
|
||||
@*
|
||||
"no_emul_toc" saves 64 kB with the first session on overwriteable media
|
||||
"no_emul_toc" saves 64 kB with the first session on overwritable media
|
||||
but makes the image incapable of displaying its session history.
|
||||
@*
|
||||
"iso_9660_1999" causes the production of an additional directory tree
|
||||
@ -3737,7 +3737,7 @@ The same effect is achieved by -padding mode "included".
|
||||
@c man .PP
|
||||
Contrary to published specifications many BIOSes will load an El Torito
|
||||
record from the first session on media and not from the last one, which
|
||||
gets mounted by default. This makes no problems with overwriteable media,
|
||||
gets mounted by default. This makes no problems with overwritable media,
|
||||
because they appear to inadverted readers as one single session.
|
||||
@*
|
||||
But with multi-session media CD-R[W], DVD-R[W], DVD+R, it implies that the
|
||||
@ -3749,7 +3749,7 @@ If a boot image from ISOLINUX or GRUB is known to be present on media then
|
||||
it is advised to patch it
|
||||
when a follow-up session gets written. But one should not rely on the
|
||||
capability to influence the bootability of the existing sessions, unless one
|
||||
can assume overwriteable media.
|
||||
can assume overwritable media.
|
||||
@*
|
||||
Normally the boot images are data files inside the ISO filesystem. By
|
||||
special path "--interval:appended_partition_NNN:all::" it is possible to
|
||||
@ -4798,9 +4798,9 @@ Precedence is: "dvdrw", "cdrw", "dvd", "cdrom", "cd".
|
||||
Show media specific tables of content. This is the session history
|
||||
of the medium, not the ISO image directory tree.
|
||||
@*
|
||||
In case of overwriteable media holding a valid ISO image, it may happen that
|
||||
In case of overwritable media holding a valid ISO image, it may happen that
|
||||
only a single session gets shown. But if the first session on the
|
||||
overwriteable media was written by @command{xorriso} then a complete
|
||||
overwritable media was written by @command{xorriso} then a complete
|
||||
session history can be emulated.
|
||||
@*
|
||||
A drive which is incapable of writing may show any media as CD-ROM or DVD-ROM
|
||||
@ -5771,7 +5771,7 @@ same name and hardcoded parameter "on", e.g. -acl "on".
|
||||
Explicit parameters are expected by @minus{}@minus{}stdio_sync
|
||||
and @minus{}@minus{}scdbackup_tag.
|
||||
@*
|
||||
The capability to preserve multi-session history on overwriteable media
|
||||
The capability to preserve multi-session history on overwritable media
|
||||
gets disabled by default. It can be enabled by using @minus{}@minus{}emul-toc
|
||||
with the first session. See -compliance no_emul_toc.
|
||||
@*
|
||||
@ -5847,7 +5847,7 @@ It ignores most other options of cdrecord and cdrskin but refuses on
|
||||
-audio, -scanbus, and on blanking modes unknown to @command{xorriso}.
|
||||
@*
|
||||
The scope is only a single data track per session to be written
|
||||
to blank, overwriteable, or appendable media. The medium gets closed if
|
||||
to blank, overwritable, or appendable media. The medium gets closed if
|
||||
closing is applicable and not option -multi is present.
|
||||
@*
|
||||
If an input drive was acquired, then it is given up.
|
||||
@ -5860,7 +5860,7 @@ If a track source is given, then an automatic -commit happens at the end of
|
||||
the "cdrecord" option list.
|
||||
@*
|
||||
@minus{}@minus{}grow_overwriteable_iso
|
||||
enables emulation of multi-session on overwriteable
|
||||
enables emulation of multi-session on overwritable
|
||||
media. To enable emulation of a TOC, the first session needs -C 0,32 with
|
||||
-as mkisofs (but no -M) and @minus{}@minus{}grow_overwriteable_iso
|
||||
write_start_address=32s with -as cdrecord.
|
||||
@ -6845,7 +6845,7 @@ If this does not help, insert a run of "sleep 10" between xorriso and dd.
|
||||
This example works for multi-session media only.
|
||||
Add cdrskin option @minus{}@minus{}grow_overwriteable_iso
|
||||
to all -as cdrecord runs
|
||||
in order to enable multi-session emulation on overwriteable media.
|
||||
in order to enable multi-session emulation on overwritable media.
|
||||
@c man .SS
|
||||
@c man .B Let xorriso work underneath growisofs
|
||||
@node ExGrowisofs, ExException, ExMkisofs, Examples
|
||||
@ -6884,7 +6884,7 @@ $ growisofs -M /dev/dvd @minus{}@minus{} outdev - -update_r /my/files /files
|
||||
@*
|
||||
@sp 1
|
||||
growisofs has excellent burn capabilities with DVD and BD.
|
||||
It does not emulate session history on overwriteable media, though.
|
||||
It does not emulate session history on overwritable media, though.
|
||||
@c man .SS
|
||||
@c man .B Adjust thresholds for verbosity, exit value and program abort
|
||||
@node ExException, ExTime, ExGrowisofs, Examples
|
||||
@ -7021,7 +7021,7 @@ it is possible to access the session trees which represent the older backup
|
||||
versions. With CD media, GNU/Linux mount accepts session numbers directly by
|
||||
its option "session=".
|
||||
@*
|
||||
Multi-session media and most overwriteable media written by @command{xorriso}
|
||||
Multi-session media and most overwritable media written by @command{xorriso}
|
||||
can tell the sbsectors of their sessions by @command{xorriso} command -toc.
|
||||
Used after -commit the following command prints the matching mount command for
|
||||
the newly written session (here for mount point /mnt):
|
||||
|
Reference in New Issue
Block a user