libburnia/libisoburn
2
0
Fork 0
Code Issues Pull Requests Releases Wiki Activity

Fixed spelling errors found by fossies.org with codespell

Browse Source
This commit is contained in:
Thomas Schmitt
2019-10-28 15:34:56 +01:00
parent 5903885d45
commit c8b9c9a244
46 changed files with 375 additions and 375 deletions
Download Patch File Download Diff File Expand all files Collapse all files

60
xorriso/xorriso.1
View File

@ -9,7 +9,7 @@
.\" First parameter, NAME, should be all caps
.\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
.\" other parameters are allowed: see man(7), man(1)
.TH XORRISO 1 "Version 1.5.3, Oct 27, 2019"
.TH XORRISO 1 "Version 1.5.3, Oct 28, 2019"
.\" Please adjust this date whenever revising the manpage.
.\"
.\" Some roff macros, for reference:
@ -78,7 +78,7 @@ Can check media for damages and copy readable blocks to disk.
.br
Can attach MD5 checksums to each data file and the whole session.
.br
Scans for optical drives, blanks re\-useable optical media.
Scans for optical drives, blanks re\-usable optical media.
.br
Reads its instructions from command line arguments, dialog, and files.
.br
@ -141,7 +141,7 @@ Adding a session to an existing ISO image is in this text referred as
.br
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.
.PP
\fBxorriso\fR provides growing as well as an own method named
@ -180,7 +180,7 @@ 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.
\fBxorriso\fR will write onto them only if command \-close is set to "on".
.br
\fBOverwriteable media\fR are DVD\-RAM, DVD+RW, BD\-RE, and formatted DVD\-RW.
\fBOverwritable media\fR 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 \fBxorriso\fR, then a table of content can
@ -189,7 +189,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".
.br
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.
.PP
These media can assume several states in which they offer different
@ -200,13 +200,13 @@ suitable for \fBxorriso\fR.
.br
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 \fBxorriso\fR.
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.
.br
\fBAppendable\fR 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 \fBxorriso\fR.
.br
Appendable is the state after writing a session with command \-close off.
@ -218,7 +218,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.
.br
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.
.br
Read\-only drives may or may not show session histories of multi\-session
@ -289,7 +289,7 @@ of modifying and blind growing. They all are suitable for newly created images.
.PP
All drive file objects have to offer rw\-permission to the user of
\fBxorriso\fR.
Even those which will not be useable for reading an ISO image.
Even those which will not be usable for reading an ISO image.
.br
With any type of drive object, the data are considered to be organized in
blocks of 2 KiB. Access happens in terms of Logical Block Address
@ -414,7 +414,7 @@ hard\-disk\-like media. Several options install a \fBMBR\fR
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.
.br
MBR is read by PC\-BIOS when booting from USB stick or hard disk,
and by PowerPC CHRP or PReP when booting.
@ -1115,7 +1115,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.)
.br
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
@ -1129,11 +1129,11 @@ multi\-session DVD or BD. If on such a system \fBxorriso\fR 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".
.br
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.
.br
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
@ -1162,7 +1162,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.
.br
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.
.br
@ -2526,16 +2526,16 @@ then this command leads to a FAILURE event.
Defined modes are:
as_needed, fast, all, deformat, deformat_quickest
.br
"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.
.br
"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.
.br
"deformat" converts overwriteable DVD\-RW into unformatted ones.
"deformat" converts overwritable DVD\-RW into unformatted ones.
.br
"deformat_quickest" is a faster way to deformat or blank DVD\-RW
but produces media which are only suitable for a single session.
@ -2555,7 +2555,7 @@ Blanking will nevertheless only succeed if the drive is willing to do it.
.br
.TP
\fB\-format\fR mode
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.
.br
Defined modes are:
@ -2811,7 +2811,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.
.br
"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.
.br
"iso_9660_1999" causes the production of an additional directory tree
@ -3201,7 +3201,7 @@ The same effect is achieved by \-padding mode "included".
.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.
.br
But with multi\-session media CD\-R[W], DVD\-R[W], DVD+R, it implies that the
@ -3213,7 +3213,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.
.br
Normally the boot images are data files inside the ISO filesystem. By
special path "\-\-interval:appended_partition_NNN:all::" it is possible to
@ -4165,9 +4165,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.
.br
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 \fBxorriso\fR then a complete
overwritable media was written by \fBxorriso\fR then a complete
session history can be emulated.
.br
A drive which is incapable of writing may show any media as CD\-ROM or DVD\-ROM
@ -5002,7 +5002,7 @@ same name and hardcoded parameter "on", e.g. \-acl "on".
Explicit parameters are expected by \-\-stdio_sync
and \-\-scdbackup_tag.
.br
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 \-\-emul\-toc
with the first session. See \-compliance no_emul_toc.
.br
@ -5074,7 +5074,7 @@ It ignores most other options of cdrecord and cdrskin but refuses on
\-audio, \-scanbus, and on blanking modes unknown to \fBxorriso\fR.
.br
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.
.br
If an input drive was acquired, then it is given up.
@ -5087,7 +5087,7 @@ If a track source is given, then an automatic \-commit happens at the end of
the "cdrecord" option list.
.br
\-\-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 \-\-grow_overwriteable_iso
write_start_address=32s with \-as cdrecord.
@ -5899,7 +5899,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 \-\-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.
.SS
.B Let xorriso work underneath growisofs
growisofs expects an ISO formatter program which understands options \-C and
@ -5930,7 +5930,7 @@ $ growisofs \-Z /dev/dvd \-\- outdev \- \-update_r /my/files /files
$ growisofs \-M /dev/dvd \-\- outdev \- \-update_r /my/files /files
.br
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.
.SS
.B Adjust thresholds for verbosity, exit value and program abort
Be quite verbose, exit 32 if severity "FAILURE" was encountered,
@ -6034,7 +6034,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=".
.br
Multi\-session media and most overwriteable media written by \fBxorriso\fR
Multi\-session media and most overwritable media written by \fBxorriso\fR
can tell the sbsectors of their sessions by \fBxorriso\fR command \-toc.
Used after \-commit the following command prints the matching mount command for
the newly written session (here for mount point /mnt):