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

199
xorriso/xorriso.info
View File

@ -77,7 +77,7 @@ Content may get zisofs compressed or filtered by external processes.
Can issue commands to mount older sessions on GNU/Linux or FreeBSD.
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.
Provides navigation commands for interactive ISO image manipulation.
Adjustable thresholds for abort, exit value, and problem reporting.
@ -118,7 +118,7 @@ Adding a session to an existing ISO image is in this text referred as
*growing*.
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
functionality to overwritable media or disk files which carry valid ISO
9660 filesystems.
'xorriso' provides growing as well as an own method named *modifying*
@ -159,7 +159,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. 'xorriso' will write onto them only if command -close
is set to "on".
*Overwriteable media* are DVD-RAM, DVD+RW, BD-RE, and formatted DVD-RW.
*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 'xorriso', then a table of
@ -167,7 +167,7 @@ content can 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.
@ -178,13 +178,13 @@ capabilities.
suitable for '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 'xorriso'. Action -blank "as_needed" can be
used to do this marking on overwriteable media, or to apply mandatory
used to do this marking on overwritable media, or to apply mandatory
formatting to new media if necessary.
*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 'xorriso'.
Appendable is the state after writing a session with command -close off.
@ -194,8 +194,8 @@ suitable for 'xorriso'.
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 contain unrecognizable data in the first 32 data blocks.
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
media. Often only the first and the last session are visible.
Sometimes not even that. Command -rom_toc_scan might or might not help
@ -267,7 +267,7 @@ modifying and blind growing. They all are suitable for newly created
images.
All drive file objects have to offer rw-permission to the user of
'xorriso'. Even those which will not be useable for reading an ISO
'xorriso'. Even those which will not be usable for reading an ISO
image.
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
@ -369,7 +369,7 @@ hard-disk-like media. Several options install a *MBR* (Master Boot
Record), It may get adjusted according to the needs of the 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.
session can get in effect 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. An MBR partition with type 0xee
indicates the presence of GPT.
@ -1000,7 +1000,7 @@ activate them only after image loading.
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
even be completely false. (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
@ -1014,11 +1014,11 @@ activate them only after image loading.
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
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
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
@ -1044,7 +1044,7 @@ activate them only after image loading.
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, read-only, write-only, or uselessly empty. This may
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.
Mode "appendable_wo" is like "on" with the additional property that
@ -2157,15 +2157,15 @@ File: xorriso.info, Node: Writing, Next: SetWrite, Prev: Filter, Up: Command
the same and if the ISO image was altered 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
"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.
"deformat" converts overwriteable DVD-RW into unformatted ones.
overwritable ISO images. "all" might work more thoroughly and need
more time.
"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. Some
drives announce this state by not offering feature 21h, but some
@ -2181,9 +2181,8 @@ File: xorriso.info, Node: Writing, Next: SetWrite, Prev: Filter, Up: Command
Blanking will nevertheless only succeed if the drive is willing to
do it.
-format mode
Convert unformatted DVD-RW into overwriteable ones, "de-ice"
DVD+RW, format newly purchased BD-RE or BD-R, re-format DVD-RAM or
BD-RE.
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:
as_needed, full, fast, by_index_<num>, fast_by_index_<num>,
by_size_<num>, fast_by_size_<num>, without_spare
@ -2404,7 +2403,7 @@ according to the setting of command -acl.
"aaip_susp_1_10_off".
"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
"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
@ -2720,7 +2719,7 @@ File: xorriso.info, Node: Bootable, Next: Jigdo, Prev: SetWrite, Up: Command
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
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 whole bootable system has to reside already in the first session and
@ -2729,7 +2728,7 @@ system expects after mounting the ISO image.
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.
of the existing sessions, unless one 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
refer to an appended partition. The number NNN gives the partition
@ -3502,9 +3501,9 @@ File: xorriso.info, Node: Inquiry, Next: Navigate, Prev: DialogCtl, Up: Comm
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
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 'xorriso' then a
session on the overwritable media was written by '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 with only one or two sessions on it. The last of these
@ -4219,7 +4218,7 @@ said programs trigger comparable actions.
'xorriso' commands with the same name and hardcoded parameter "on",
e.g. -acl "on". Explicit parameters are expected by --stdio_sync
and --scdbackup_tag.
The capability to preserve multi-session history on overwriteable
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.
--sort-weight gets as parameters a number and an iso_rr_path. The
@ -4270,7 +4269,7 @@ said programs trigger comparable actions.
It ignores most other options of cdrecord and cdrskin but refuses
on -audio, -scanbus, and on blanking modes unknown to 'xorriso'.
The scope is only a single data track per session to be written to
blank, overwriteable, or appendable media. The medium gets closed
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. This is only
allowed if no image changes are pending.
@ -4279,7 +4278,7 @@ said programs trigger comparable actions.
If a track source is given, then an automatic -commit happens at
the end of the "cdrecord" option list.
--grow_overwriteable_iso enables emulation of multi-session on
overwriteable media. To enable emulation of a TOC, the first
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.
@ -4950,7 +4949,7 @@ 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.
multi-session emulation on overwritable media.

File: xorriso.info, Node: ExGrowisofs, Next: ExException, Prev: ExMkisofs, Up: Examples
@ -4981,7 +4980,7 @@ but -outdev must be set to "-". So use "outdev" instead:
$ growisofs -M /dev/dvd -- outdev - -update_r /my/files /files
growisofs has excellent burn capabilities with DVD and BD. It does
not emulate session history on overwriteable media, though.
not emulate session history on overwritable media, though.

File: xorriso.info, Node: ExException, Next: ExTime, Prev: ExGrowisofs, Up: Examples
@ -5075,10 +5074,10 @@ With *mount* option *-o "sbsector="* on GNU/Linux or *-s* on FreeBSD or
NetBSD 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 'xorriso'
can tell the sbsectors of their sessions by 'xorriso' command -toc.
Used after -commit the following command prints the matching mount
command for the newly written session (here for mount point /mnt):
Multi-session media and most overwritable media written by 'xorriso' can
tell the sbsectors of their sessions by 'xorriso' command -toc. Used
after -commit the following command prints the matching mount command
for the newly written session (here for mount point /mnt):
-mount_cmd "indev" "auto" "auto" /mnt
@ -5339,7 +5338,7 @@ File: xorriso.info, Node: CommandIdx, Next: ConceptIdx, Prev: Legal, Up: Top
* -chown_r sets ownership in ISO image: Manip. (line 47)
* -clone copies ISO directory tree: Insert. (line 185)
* -close controls media closing: SetWrite. (line 401)
* -close_damaged closes damaged track and session: Writing. (line 164)
* -close_damaged closes damaged track and session: Writing. (line 163)
* -close_filter_list bans filter registration: Filter. (line 50)
* -commit writes pending ISO image: Writing. (line 27)
* -commit_eject writes and ejects: Writing. (line 53)
@ -5398,7 +5397,7 @@ File: xorriso.info, Node: CommandIdx, Next: ConceptIdx, Prev: Legal, Up: Top
* -getfattr shows xattr in ISO image: Navigate. (line 69)
* -getfattr_r shows xattr in ISO image: Navigate. (line 75)
* -gid sets global ownership: SetWrite. (line 287)
* -grow_blindly overides next writeable address: AqDrive. (line 112)
* -grow_blindly overrides next writeable address: AqDrive. (line 112)
* -hardlinks controls handling of hard links: Loading. (line 107)
* -help prints help text: Scripting. (line 19)
* -hfsplus enables production of HFS+ partition: SetWrite. (line 14)
@ -5416,9 +5415,9 @@ File: xorriso.info, Node: CommandIdx, Next: ConceptIdx, Prev: Legal, Up: Top
* -list_arg_sorting prints sorting order of -x: ArgSort. (line 26)
* -list_delimiter replaces '--': Scripting. (line 55)
* -list_extras lists compile time extra features: Scripting. (line 24)
* -list_formats lists available formats: Writing. (line 129)
* -list_profiles lists supported media: Writing. (line 177)
* -list_speeds lists available write speeds: Writing. (line 140)
* -list_formats lists available formats: Writing. (line 128)
* -list_profiles lists supported media: Writing. (line 176)
* -list_speeds lists available write speeds: Writing. (line 139)
* -lns creates ISO symbolic link: Insert. (line 181)
* -load addresses a particular session as input: Loading. (line 33)
* -local_charset sets terminal character set: Charset. (line 57)
@ -5588,7 +5587,7 @@ File: xorriso.info, Node: ConceptIdx, Prev: CommandIdx, Up: Top
* Create, new ISO image, _definition: Methods. (line 7)
* Cylinder alignment, _definition: Bootable. (line 338)
* Cylinder size, _definition: Bootable. (line 323)
* Damaged track and session, close, -close_damaged: Writing. (line 164)
* Damaged track and session, close, -close_damaged: Writing. (line 163)
* DEC Alpha SRM boot sector, production: Bootable. (line 398)
* Delete, from ISO image, -rm: Manip. (line 20)
* Delete, from ISO image, -rm_r: Manip. (line 26)
@ -5614,7 +5613,7 @@ File: xorriso.info, Node: ConceptIdx, Prev: CommandIdx, Up: Top
* Drive, for output, -outdev: AqDrive. (line 29)
* Drive, get drive list, -devices: Inquiry. (line 7)
* Drive, get drive list, -device_links: Inquiry. (line 17)
* Drive, list supported media, -list_profiles: Writing. (line 177)
* Drive, list supported media, -list_profiles: Writing. (line 176)
* Drive, reduce activity, -calm_drive: Loading. (line 303)
* Drive, report SCSI commands, -scsi_log: Scripting. (line 143)
* Drive, write and eject, -commit_eject: Writing. (line 53)
@ -5717,8 +5716,8 @@ File: xorriso.info, Node: ConceptIdx, Prev: CommandIdx, Up: Top
* MD5, control handling, -md5: Loading. (line 163)
* Media, erase, -blank: Writing. (line 57)
* Media, format, -format: Writing. (line 87)
* Media, list formats, -list_formats: Writing. (line 129)
* Media, list write speeds, -list_speeds: Writing. (line 140)
* Media, list formats, -list_formats: Writing. (line 128)
* Media, list write speeds, -list_speeds: Writing. (line 139)
* MIPS boot file, activation: Bootable. (line 360)
* mkisofs, Emulation: Emulation. (line 17)
* Modifying, _definition: Methods. (line 28)
@ -5742,7 +5741,7 @@ File: xorriso.info, Node: ConceptIdx, Prev: CommandIdx, Up: Top
* Navigate, tell ISO working directory, -pwd: Navigate. (line 19)
* Next writeable address, -grow_blindly: AqDrive. (line 112)
* Output Character Set, _definition: Charset. (line 26)
* Overwriteable media, _definition: Media. (line 14)
* Overwritable media, _definition: Media. (line 14)
* Ownership, global in ISO image, -uid: SetWrite. (line 284)
* Ownership, in ISO image, -chown: Manip. (line 43)
* Ownership, in ISO image, -chown_r: Manip. (line 47)
@ -5865,59 +5864,59 @@ File: xorriso.info, Node: ConceptIdx, Prev: CommandIdx, Up: Top
Tag Table:
Node: Top415
Node: Overview1405
Node: Model3442
Node: Media6346
Node: Methods9033
Node: Drives11619
Node: Extras15561
Node: Processing20274
Node: Dialog23909
Node: Commands25598
Node: ArgSort27275
Node: AqDrive28769
Node: Loading35926
Node: Insert55883
Node: SetInsert67386
Node: Manip76818
Node: CmdFind86918
Node: Filter105847
Node: Writing110469
Node: SetWrite120625
Node: Bootable145384
Node: Jigdo172341
Node: Charset176600
Node: Exception179929
Node: DialogCtl186058
Node: Inquiry188660
Node: Navigate197544
Node: Verify206001
Node: Restore216472
Node: Emulation225149
Node: Scripting235608
Node: Frontend243391
Node: Examples253017
Node: ExDevices254195
Node: ExCreate254856
Node: ExDialog256156
Node: ExGrowing257427
Node: ExModifying258236
Node: ExBootable258746
Node: ExCharset259301
Node: ExPseudo260197
Node: ExCdrecord261124
Node: ExMkisofs261444
Node: ExGrowisofs263342
Node: ExException264496
Node: ExTime264954
Node: ExIncBackup265412
Node: ExRestore269438
Node: ExRecovery270384
Node: Files270956
Node: Environ272290
Node: Seealso273038
Node: Bugreport273755
Node: Legal274346
Node: CommandIdx275358
Node: ConceptIdx292901
Node: Model3441
Node: Media6344
Node: Methods9025
Node: Drives11611
Node: Extras15552
Node: Processing20264
Node: Dialog23899
Node: Commands25588
Node: ArgSort27265
Node: AqDrive28759
Node: Loading35916
Node: Insert55869
Node: SetInsert67372
Node: Manip76804
Node: CmdFind86904
Node: Filter105833
Node: Writing110455
Node: SetWrite120602
Node: Bootable145360
Node: Jigdo172315
Node: Charset176574
Node: Exception179903
Node: DialogCtl186032
Node: Inquiry188634
Node: Navigate197516
Node: Verify205973
Node: Restore216444
Node: Emulation225121
Node: Scripting235577
Node: Frontend243360
Node: Examples252986
Node: ExDevices254164
Node: ExCreate254825
Node: ExDialog256125
Node: ExGrowing257396
Node: ExModifying258205
Node: ExBootable258715
Node: ExCharset259270
Node: ExPseudo260166
Node: ExCdrecord261093
Node: ExMkisofs261413
Node: ExGrowisofs263310
Node: ExException264463
Node: ExTime264921
Node: ExIncBackup265379
Node: ExRestore269405
Node: ExRecovery270351
Node: Files270923
Node: Environ272257
Node: Seealso273005
Node: Bugreport273722
Node: Legal274313
Node: CommandIdx275325
Node: ConceptIdx292868

End Tag Table