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

Reacted on complaints of lintian spelling check

Browse Source
This commit is contained in:
Thomas Schmitt
2015-09-20 12:51:53 +00:00
parent fca6e259da
commit 06b2949040
19 changed files with 320 additions and 315 deletions
Download Patch File Download Diff File Expand all files Collapse all files

251
libisoburn/trunk/xorriso/xorriso.info
View File

@ -46,7 +46,7 @@ File: xorriso.info, Node: Overview, Next: Model, Prev: Top, Up: Top
**********
'xorriso' is a program which copies file objects from POSIX compliant
filesystems into Rock Ridge enhanced ISO 9660 filesystems and allows
filesystems into Rock Ridge enhanced ISO 9660 filesystems and performs
session-wise manipulation of such filesystems. It can load the
management information of existing ISO images and it writes the session
results to optical media or to filesystem objects.
@ -104,8 +104,8 @@ images from devices that represent arbitrary media or from regular disk
files.
This session usage model has been extended on CD media by the concept
of *multi-session* , which allows to add information to the CD and gives
the mount programs of the operating systems the addresses of the entry
of *multi-session* , which adds information to the CD and gives the
mount programs of the operating systems the addresses of the entry
points of each session. The mount programs recognize block devices
which represent CD media and will by default mount the image in the last
session.
@ -126,7 +126,7 @@ modifications. See paragraph Creating, Growing, Modifying, Blind
Growing below.
'xorriso' adopts the concept of multi-session by loading an image
directory tree if present, by allowing to manipulate it by several
directory tree if present, by offering to manipulate it by several
actions, and by writing the new image to the target medium. The first
session of a 'xorriso' run begins by the definition of the input drive
with the ISO image or by the definition of an output drive. The session
@ -155,11 +155,11 @@ There are two families of media in the MMC standard:
unformatted DVD-RW. These media provide a table of content which
describes their existing sessions. See command *-toc*.
Similar to multi-session media are DVD-R DL and minimally blanked
DVD-RW. They allow 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".
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.
They allow random write access but do not provide information about
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
content can be emulated. Else only a single overall session will be
@ -293,8 +293,8 @@ bundle the authorized users in a group like old "floppy".
Filesystem objects of nearly any type can be addressed by prefix
"stdio:" and their path in the filesystem. E.g.:
-dev stdio:/dev/sdc
The default setting of -drive_class allows to address files outside the
/dev tree without that prefix. E.g.:
The default setting of -drive_class allows the user to address files
outside the /dev tree without that prefix. E.g.:
-dev /tmp/pseudo_drive
If path leads to a regular file or to a block device then the emulated
drive is random access readable and can be used for the method of
@ -325,7 +325,7 @@ file or device by using its path with the "stdio:" prefix. By default
any address in the /dev tree without prefix "stdio:" will work only if
it leads to a MMC drive.
One may use command *-ban_stdio_write* to surely prevent this risk and
to allow only MMC drives.
to restrict drive usage to MMC drives.
One may prepend "mmc:" to a path to surely disallow any automatic
"stdio:". By command -drive_class one may ban certain paths or allow
access without prefix "stdio:" to other paths.
@ -398,11 +398,11 @@ only on GNU/Linux and FreeBSD.
*xattr* (aka EA, or extattr) are pairs of name and value which can be
attached to file objects. AAIP is able to represent them and 'xorriso'
allows to record and restore pairs which have names out of the user
namespace. I.e. those which begin with "user.", like "user.x" or
"user.whatever". Name has to be a 0 terminated string. Value may be
any array of bytes which does not exceed the size of 4095 bytes. xattr
processing happens only if it is enabled by command *-xattr*.
can record and restore pairs which have names out of the user namespace.
I.e. those which begin with "user.", like "user.x" or "user.whatever".
Name has to be a 0 terminated string. Value may be any array of bytes
which does not exceed the size of 4095 bytes. xattr processing happens
only if it is enabled by command *-xattr*.
As with ACL, currently only 'xorriso' is able to retrieve xattr from
AAIP enhanced images, to restore them to xattr capable file systems, or
to print them.
@ -465,7 +465,7 @@ line to be appended.
Quoted input accepts any 8-bit character except NUL (0) as the content
of the quotes. Nevertheless it can be cumbersome for the user to
produce those characters directly. Therefore quoted input and program
arguments allow optional *Backslash Interpretation* which can represent
arguments offer optional *Backslash Interpretation* which can represent
all 8-bit characters except NUL (0) via backslash codes as in $'...' of
bash.
This is not enabled by default. See command -backslash_codes.
@ -494,10 +494,10 @@ services to make dialog more comfortable.
it from the bash shell. Whether it is available in 'xorriso' depends on
the availability of package readline-dev at the time when 'xorriso' was
built from its sourcecode.
Readline allows to move the cursor over the text in the line by help of
the Left and the Right arrow keys. Text may be inserted at the cursor
position. The Delete key removes the character under the cursor. Up
and Down arrow keys navigate through the history of previous input
Readline lets the user move the cursor over the text in the line by help
of the Left and the Right arrow keys. Text may be inserted at the
cursor position. The Delete key removes the character under the cursor.
Up and Down arrow keys navigate through the history of previous input
lines.
See info readline for more info about libreadline.
@ -860,10 +860,10 @@ activate them only after image loading.
-disk_dev_ino "on"|"ino_only"|"off"
Enable or disable processing of recorded file identification
numbers (dev_t and ino_t). If enabled they are stored as xattr and
allow to substantially accelerate file comparison. The root node
gets a global start timestamp. If during comparison a file with
younger timestamps is found in the ISO image, then it is suspected
to have inconsistent content.
can substantially accelerate file comparison. The root node gets a
global start timestamp. If during comparison a file with younger
timestamps is found in the ISO image, then it is suspected to have
inconsistent content.
If device numbers and inode numbers of the disk filesystems are
persistent and if no irregular alterations of timestamps or system
clock happen, then potential content changes can be detected
@ -888,7 +888,7 @@ activate them only after image loading.
the file paths with truncated components. To avoid confusion by
having both truncated and untrancated names in the same directory,
it is not possible to change this setting after a drive was
aquired. All file names get truncated by the same length.
acquired. All file names get truncated by the same length.
File name patterns will only work if they match the truncated name.
This might change in future.
Linux kernels up to at least 4.1 misrepresent names of length 254
@ -1275,12 +1275,12 @@ File: xorriso.info, Node: SetInsert, Next: Manip, Prev: Insert, Up: Commands
"off" disables pathspecs of the form target=source and re-enables
-disk_pattern expansion.
-overwrite "on"|"nondir"|"off"
Allow or disallow to overwrite existing files in the ISO image by
Allow or disallow overwriting of existing files in the ISO image by
files with the same name.
With setting "off", name collisions cause FAILURE events. With
setting "nondir", only directories are protected by such events,
other existing file types get treated with -rm before the new file
gets added. Setting "on" allows automatic -rm_r. I.e. a
gets added. Setting "on" enables automatic -rm_r. I.e. a
non-directory can replace an existing directory and all its
subordinates.
If restoring of files is enabled, then the overwrite rule applies
@ -1937,7 +1937,7 @@ there are many small files.
"--remove-all-filters+" to prevent any suffix renaming.
Attaching or detaching filters will not alter the state of
-changes_pending. If the filter manipulations shall be the only
changes in a write run, then explicitely execute -changes_pending
changes in a write run, then explicitly execute -changes_pending
"yes".
-set_filter_r name iso_rr_path [***]
Like -set_filter but affecting all data files below eventual
@ -2514,7 +2514,7 @@ according to the setting of command -acl.
Set the write type for the next burn run. "auto" will select SAO
with blank CD media, DAO with blank DVD-R[W] if -close is "on", and
elsewise CD TAO or the equivalent write type of the particular
DVD/BD media. Choosing TAO or SAO/DAO explicitely might cause the
DVD/BD media. Choosing TAO or SAO/DAO explicitly might cause the
burn run to fail if the desired write type is not possible with the
given media state.
-padding number["k"|"m"]|"included"|"appended"
@ -2804,8 +2804,8 @@ Examples:
*partition_sec_hd=*number gives the number of sectors per head for
the partition table. 0 chooses a default value. Maximum is 63.
The product partition_sec_hd * partition_hd_cyl * 512 is the
cylinder size. It should be divisible by 2048 in order to allow
exact alignment. With appended partitions and
cylinder size. It should be divisible by 2048 in order to make
exact alignment possible. With appended partitions and
"appended_part_as=gpt" there is no limit for the number of
cylinders. Else there may be at most 1024 of them. If the
cylinder size is too small to stay below the limit, then
@ -2836,10 +2836,10 @@ Examples:
data provided by system_area=. Only a single boot file can be
declared by mipsel_path=.
*sparc_label=*text causes the production of a SUN Disk Label with
the given text as ASCII label. This boot block format allows to
append images for partitions 2 to 8. Partition 1 will always be
the ISO image. See command -append_partition. The first 512 bytes
of any data provided by system_area= will be overwritten.
the given text as ASCII label. Partitions 2 to 8 may occupied by
appended images. Partition 1 will always be the ISO image. See
command -append_partition. The first 512 bytes of any data
provided by system_area= will be overwritten.
*grub2_sparc_core=*iso_rr_path causes the content address and size
of the given file to be written after the SUN Disk Label. Both
numbers are counted in bytes. The address is written as 64 bit
@ -3257,16 +3257,16 @@ File: xorriso.info, Node: Inquiry, Next: Navigate, Prev: DialogCtl, Up: Comm
sessions is supposed to be the most recent real session then.
Some read-only drives and media show no usable session history at
all. Command -rom_toc_scan might help.
If input device and output device are both aquired and not the
If input device and output device are both acquired and not the
same, then both tables-of-content get shown.
-toc_of "in"|"out"|"all"[":short"]
Like command -toc but explicitely choosing which drive's
Like command -toc but explicitly choosing which drive's
table-of-content to show. "in" shows -indev or -dev, "out" shows
-outdev or -dev, "all" shows the same as -toc.
If ":short" is appended to the drive choosing word, then only a
short summary of drive state and medium content is printed.
As further difference to -toc, this command does not emit FAILURE
events if the desired drive is not aquired.
events if the desired drive is not acquired.
-mount_cmd drive entity id path
Emit an appropriate command line for mounting the ISO session
indicated by drive, entity and id. The result will be different on
@ -3287,9 +3287,9 @@ File: xorriso.info, Node: Inquiry, Next: Navigate, Prev: DialogCtl, Up: Comm
is only option "exclusive" which is default and its counterpart
"shared". The latter causes 'xorriso' not to give up the affected
drive with command -mount. On GNU/Linux it adds mount option
"loop" which may allow to mount several sessions of the same block
device at the same time. One should not write to a mounted optical
medium, of course. Take care to umount all sessions before
"loop" which may enable mounting of several sessions of the same
block device at the same time. One should not write to a mounted
optical medium, of course. Take care to umount all sessions before
ejecting.
-session_string drive entity id format
Print to the result channel a text which gets composed according to
@ -3650,11 +3650,11 @@ transmission errors.
tries to read the file given by disk_path as sector bitmap and
to store such a map file after the scan run. The bitmap tells
which blocks have been read successfully in previous runs. It
allows to do several scans on the same medium, even with
intermediate eject, in order to collect readable blocks
whenever the drive is lucky enough to produce them. The
stored file contains a human readable TOC of tracks and their
start block addresses, followed by binary bitmap data.
is the persistent memory for several scans on the same medium,
even with intermediate eject, in order to collect readable
blocks whenever the drive is lucky enough to produce them.
The stored file contains a human readable TOC of tracks and
their start block addresses, followed by binary bitmap data.
By default, untested blocks are not considered bad, but rather
as intentionally unread. If you expect time_limit= or
item_limit= to abort the run, then consider to use
@ -3759,7 +3759,7 @@ The directory permissions on disk have to allow rwx.
directories are owned by the effective user who runs 'xorriso'.
This happens by temporarily granting rwx permission to the owner.
Option "sort_lba_on" may improve read performance with optical
drives. It allows to restore large numbers of hard links without
drives. It can restore large numbers of hard links without
exhausting -temp_mem_limit. It does not preserve directory mtime
and it needs -osirrox option auto_chmod_on in order to extract
directories which offer no write permission. Default is
@ -3767,7 +3767,7 @@ The directory permissions on disk have to allow rwx.
Option "o_excl_on" is the default unless the program was started
with leafname "osirrox". On GNU/Linux it tries to avoid using
drives which are mounted or in use by other libburn programs.
Option "o_excl_off" allows on GNU/Linux to access such drives.
Option "o_excl_off" on GNU/Linux enables access to such drives.
Drives which get acquired while "o_excl_off" will refuse to get
blanked, formatted, written, or ejected. But be aware that even
harmless inquiries can spoil ongoing burns of CD-R[W] and DVD-R[W].
@ -3796,10 +3796,9 @@ The directory permissions on disk have to allow rwx.
iso_rr_prefix by disk_prefix.
-extract_cut iso_rr_path byte_offset byte_count disk_path
Copy a byte interval from a data file out of an ISO image into a
newly created disk file. The main purpose for this is to allow
handling of large files if they are not supported by mount -t
iso9660 and if the reading system is unable to buffer them as a
whole.
newly created disk file. The main purpose for this is to offer a
way of handling large files if they are not supported by mount -t
iso9660 or if the target disk filesystem cannot store large files.
If the data bytes of iso_rr_path are stored in the loaded ISO
image, and no filter is applied, and byte_offset is a multiple of
2048, then a special run of -check_media is performed. It may be
@ -4171,7 +4170,7 @@ File: xorriso.info, Node: Scripting, Next: Frontend, Prev: Emulation, Up: Co
Show text at beginning of output line and wait for the user to hit
the Enter key or to send a line via stdin.
-sleep seconds
Wait for the given number of seconds before perfoming the next
Wait for the given number of seconds before performing the next
command. Expect coarse granularity no better than 1/100 seconds.
-errfile_log mode path|channel
@ -4612,8 +4611,8 @@ devices:
If /dev/sdb is to be used frequently and /dev/sda is the system disk,
then consider to place the following lines in a 'xorriso' Startup File.
They allow to use /dev/sdb without prefix and protect disk /dev/sda from
'xorriso':
They allow you to use /dev/sdb without prefix and protect disk /dev/sda
from 'xorriso':
-drive_class banned /dev/sda*
-drive_class harmless /dev/sdb
@ -4889,9 +4888,9 @@ their program name pre-select certain settings:
*xorrisofs* starts 'xorriso' with -as mkisofs emulation.
*xorrecord* starts 'xorriso' with -as cdrecord emulation.
*osirrox* starts with -osirrox "on:o_excl_off" which allows to copy
files from ISO image to disk and to apply command -mount to one or more
of the existing ISO sessions.
*osirrox* starts with -osirrox "on:o_excl_off" which allows further
commands to copy files from ISO image to disk and to apply command
-mount to one or more of the existing ISO sessions.
11.2 Startup Files
==================
@ -5047,14 +5046,14 @@ File: xorriso.info, Node: CommandIdx, Next: ConceptIdx, Prev: Legal, Up: Top
* -compare_l reports ISO/disk differences: Navigate. (line 144)
* -compare_r reports ISO/disk differences: Navigate. (line 140)
* -compliance controls standard compliance: SetWrite. (line 56)
* -concat copies ISO file content: Restore. (line 119)
* -concat copies ISO file content: Restore. (line 118)
* -copyright_file sets copyright file name: SetWrite. (line 223)
* -cpax copies files to disk: Restore. (line 101)
* -cpax copies files to disk: Restore. (line 100)
* -cpr inserts like with cp -r: Insert. (line 143)
* -cpx copies files to disk: Restore. (line 90)
* -cpx copies files to disk: Restore. (line 89)
* -cp_clone copies ISO directory tree: Insert. (line 175)
* -cp_rx copies file trees to disk: Restore. (line 104)
* -cp_rx copies file trees to disk <1>: Restore. (line 112)
* -cp_rx copies file trees to disk: Restore. (line 103)
* -cp_rx copies file trees to disk <1>: Restore. (line 111)
* -cut_out inserts piece of data file: Insert. (line 118)
* -data_cache_size adjusts read cache size: Loading. (line 312)
* -dev acquires one drive for input and output: AqDrive. (line 12)
@ -5135,7 +5134,7 @@ File: xorriso.info, Node: CommandIdx, Next: ConceptIdx, Prev: Legal, Up: Top
* -md5 controls handling of MD5 sums: Loading. (line 173)
* -mkdir creates ISO directory: Insert. (line 156)
* -modesty_on_drive keep drive buffer hungry: SetWrite. (line 320)
* -mount issues mount command for ISO session: Restore. (line 147)
* -mount issues mount command for ISO session: Restore. (line 146)
* -mount_cmd composes mount command line: Inquiry. (line 49)
* -mount_cmd controls mount command: Inquiry. (line 64)
* -msg_op perform operations on program messages: Frontend. (line 27)
@ -5155,7 +5154,7 @@ File: xorriso.info, Node: CommandIdx, Next: ConceptIdx, Prev: Legal, Up: Top
* -pacifier controls pacifier text form: Emulation. (line 166)
* -padding sets amount or mode of image padding: SetWrite. (line 394)
* -page set terminal geometry: DialogCtl. (line 18)
* -paste_in copies file into disk file: Restore. (line 115)
* -paste_in copies file into disk file: Restore. (line 114)
* -pathspecs sets meaning of = with -add: SetInsert. (line 115)
* -path_list inserts paths from disk file: Insert. (line 75)
* -pkt_output consolidates text output: Frontend. (line 7)
@ -5319,7 +5318,7 @@ File: xorriso.info, Node: ConceptIdx, Prev: CommandIdx, Up: Top
* Emulation, pacifier form, -pacifier: Emulation. (line 166)
* Examples: Examples. (line 6)
* extattr, _definition: Extras. (line 66)
* File content, copy, -concat: Restore. (line 119)
* File content, copy, -concat: Restore. (line 118)
* File names, curb length, -file_name_limit: Loading. (line 237)
* File names, if neither Rock Ridge nor Joliet: Loading. (line 205)
* Filter, apply to file tree, -set_filter_r: Filter. (line 84)
@ -5474,14 +5473,14 @@ File: xorriso.info, Node: ConceptIdx, Prev: CommandIdx, Up: Top
* Relocation directory, set name, -rr_reloc_dir: SetWrite. (line 144)
* Rename, in ISO image, -move: Manip. (line 31)
* Rename, in ISO image, -mv: Manip. (line 37)
* Restore, copy file into disk file, -paste_in: Restore. (line 115)
* Restore, copy file into disk file, -paste_in: Restore. (line 114)
* Restore, copy file piece to disk, -extract_cut: Restore. (line 80)
* Restore, copy file to disk, -extract_single: Restore. (line 73)
* Restore, copy file tree to disk, -extract: Restore. (line 62)
* Restore, copy file trees to disk, -cp_rx: Restore. (line 104)
* Restore, copy file trees to disk, -cp_rx <1>: Restore. (line 112)
* Restore, copy files to disk, -cpax: Restore. (line 101)
* Restore, copy files to disk, -cpx: Restore. (line 90)
* Restore, copy file trees to disk, -cp_rx: Restore. (line 103)
* Restore, copy file trees to disk, -cp_rx <1>: Restore. (line 111)
* Restore, copy files to disk, -cpax: Restore. (line 100)
* Restore, copy files to disk, -cpx: Restore. (line 89)
* Restore, copy files to disk, -extract_l: Restore. (line 76)
* Restore, enable ISO-to-disk, -osirrox: Restore. (line 18)
* Result layout, more shell-like, -sh_style_result: Scripting.
@ -5489,7 +5488,7 @@ File: xorriso.info, Node: ConceptIdx, Prev: CommandIdx, Up: Top
* Rock Ridge, _definition: Extras. (line 6)
* Session, altered start address, -displacement: Loading. (line 57)
* Session, info string, -session_string: Inquiry. (line 73)
* Session, issue mount command, -mount: Restore. (line 147)
* Session, issue mount command, -mount: Restore. (line 146)
* Session, log when written, -session_log: Scripting. (line 134)
* Session, mount command line, -mount_cmd: Inquiry. (line 49)
* Session, mount parameters, -mount_opts: Inquiry. (line 64)
@ -5547,58 +5546,58 @@ File: xorriso.info, Node: ConceptIdx, Prev: CommandIdx, Up: Top
Tag Table:
Node: Top415
Node: Overview1369
Node: Model3404
Node: Media6317
Node: Methods9003
Node: Drives11589
Node: Extras15144
Node: Processing19620
Node: Dialog23255
Node: Commands24941
Node: ArgSort26618
Node: AqDrive28112
Node: Loading31167
Node: Insert50158
Node: SetInsert60383
Node: Manip69231
Node: CmdFind79014
Node: Filter97109
Node: Writing101732
Node: SetWrite111887
Node: Bootable134832
Node: Jigdo157368
Node: Charset161627
Node: Exception164954
Node: DialogCtl171083
Node: Inquiry173685
Node: Navigate182130
Node: Verify190425
Node: Restore200287
Node: Emulation208908
Node: Scripting219318
Node: Frontend227099
Node: Examples236734
Node: ExDevices237912
Node: ExCreate238573
Node: ExDialog239873
Node: ExGrowing241144
Node: ExModifying241953
Node: ExBootable242463
Node: ExCharset243018
Node: ExPseudo243914
Node: ExCdrecord244837
Node: ExMkisofs245157
Node: ExGrowisofs246514
Node: ExException247668
Node: ExTime248126
Node: ExIncBackup248584
Node: ExRestore252610
Node: ExRecovery253556
Node: Files254128
Node: Seealso255445
Node: Bugreport256160
Node: Legal256751
Node: CommandIdx257763
Node: ConceptIdx274732
Node: Model3406
Node: Media6310
Node: Methods8997
Node: Drives11583
Node: Extras15160
Node: Processing19628
Node: Dialog23263
Node: Commands24952
Node: ArgSort26629
Node: AqDrive28123
Node: Loading31178
Node: Insert50165
Node: SetInsert60390
Node: Manip69241
Node: CmdFind79024
Node: Filter97119
Node: Writing101741
Node: SetWrite111896
Node: Bootable134840
Node: Jigdo157365
Node: Charset161624
Node: Exception164951
Node: DialogCtl171080
Node: Inquiry173682
Node: Navigate182132
Node: Verify190427
Node: Restore200304
Node: Emulation208917
Node: Scripting219327
Node: Frontend227109
Node: Examples236744
Node: ExDevices237922
Node: ExCreate238583
Node: ExDialog239883
Node: ExGrowing241154
Node: ExModifying241963
Node: ExBootable242473
Node: ExCharset243028
Node: ExPseudo243924
Node: ExCdrecord244851
Node: ExMkisofs245171
Node: ExGrowisofs246528
Node: ExException247682
Node: ExTime248140
Node: ExIncBackup248598
Node: ExRestore252624
Node: ExRecovery253570
Node: Files254142
Node: Seealso255476
Node: Bugreport256191
Node: Legal256782
Node: CommandIdx257794
Node: ConceptIdx274763

End Tag Table