Clarification about -as mkisofs pathspecs

This commit is contained in:
Thomas Schmitt 2011-04-07 17:59:31 +00:00
parent c569b4d4ce
commit 2fdc41a357
3 changed files with 59 additions and 42 deletions

View File

@ -9,7 +9,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 XORRISOFS 1 "Mar 26, 2011" .TH XORRISOFS 1 "Apr 07, 2011"
.\" 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:
@ -92,14 +92,15 @@ confuse with the lowlevel ISO 9660 names visible if Rock Ridge gets ignored.)
A program argument is handled as a \fBpathspec\fR, if it is not A program argument is handled as a \fBpathspec\fR, if it is not
recognized as original mkisofs option or additional xorrisofs option. recognized as original mkisofs option or additional xorrisofs option.
A pathspec depicts an input file object by a disk_path. A pathspec depicts an input file object by a disk_path.
If option -graft-points is not present, then this file object gets If option -graft-points is not present, then the behavior depends on the
copied into the /-directory of the ISO image. file type of disk_path. Directories get merged with the /-directory of the
ISO image. Files of other types get copied into the /-directory.
.br .br
If -graft-points is present then each pathspec gets split at the first If -graft-points is present then each pathspec gets split at the first
occurence of the =-character. occurence of the =-character.
The part before the = is taken as \fBtarget\fR, the iso_rr_path for The part before the = is taken as \fBtarget\fR, i.e. the iso_rr_path for
the file object in the ISO image. The part after the first = is taken the file object in the ISO image. The part after the first = is taken
as \fBsource\fR, the disk_path of the input object. as \fBsource\fR, i.e. the disk_path of the input object.
.br .br
It is possible to make =-characters part of the iso_rr_path by preceeding It is possible to make =-characters part of the iso_rr_path by preceeding
them with a \\-character. The same must be done for \\-characters which them with a \\-character. The same must be done for \\-characters which
@ -110,6 +111,11 @@ If the source part of the pathspec leads to a directory, then all files
underneath this directory get inserted into the image, too. underneath this directory get inserted into the image, too.
It is possible to exclude particular files from being inserted It is possible to exclude particular files from being inserted
by help of option -m. by help of option -m.
.br
In case that target already exists, the following rules apply:
Directories and other files may overwrite existing non-directories.
Directories get merged with existing directories.
Non-directories may not overwrite existing directories.
.SS .SS
\fBRelation to program xorriso:\fR \fBRelation to program xorriso:\fR
.br .br

View File

@ -95,13 +95,14 @@ Ridge gets ignored.)
A program argument is handled as a *pathspec*, if it is not recognized A program argument is handled as a *pathspec*, if it is not recognized
as original mkisofs option or additional xorrisofs option. A pathspec as original mkisofs option or additional xorrisofs option. A pathspec
depicts an input file object by a disk_path. If option -graft-points depicts an input file object by a disk_path. If option -graft-points
is not present, then this file object gets copied into the /-directory is not present, then the behavior depends on the file type of
of the ISO image. disk_path. Directories get merged with the /-directory of the ISO
image. Files of other types get copied into the /-directory.
If -graft-points is present then each pathspec gets split at the first If -graft-points is present then each pathspec gets split at the first
occurence of the =-character. The part before the = is taken as occurence of the =-character. The part before the = is taken as
*target*, the iso_rr_path for the file object in the ISO image. The *target*, i.e. the iso_rr_path for the file object in the ISO image.
part after the first = is taken as *source*, the disk_path of the input The part after the first = is taken as *source*, i.e. the disk_path of
object. the input object.
It is possible to make =-characters part of the iso_rr_path by It is possible to make =-characters part of the iso_rr_path by
preceeding them with a \-character. The same must be done for preceeding them with a \-character. The same must be done for
\-characters which shall be part of the iso_rr_path. \-characters which shall be part of the iso_rr_path.
@ -110,6 +111,10 @@ If the source part of the pathspec leads to a directory, then all files
underneath this directory get inserted into the image, too. It is underneath this directory get inserted into the image, too. It is
possible to exclude particular files from being inserted by help of possible to exclude particular files from being inserted by help of
option -m. option -m.
In case that target already exists, the following rules apply:
Directories and other files may overwrite existing non-directories.
Directories get merged with existing directories. Non-directories may
not overwrite existing directories.
 
File: xorrisofs.info, Node: Xorriso, Next: Options, Prev: Insert, Up: Top File: xorrisofs.info, Node: Xorriso, Next: Options, Prev: Insert, Up: Top
@ -1780,32 +1785,32 @@ Node: Top397
Node: Overview1052 Node: Overview1052
Node: Standards1488 Node: Standards1488
Node: Insert3163 Node: Insert3163
Node: Xorriso4584 Node: Xorriso4932
Node: Options5720 Node: Options6068
Node: Loading6437 Node: Loading6785
Node: SetInsert8731 Node: SetInsert9079
Node: SetProduct13133 Node: SetProduct13481
Node: SetCompl16840 Node: SetCompl17188
Node: SetExtras19159 Node: SetExtras19507
Node: SetHide22031 Node: SetHide22379
Node: ImageId23039 Node: ImageId23387
Node: Bootable26543 Node: Bootable26891
Node: SystemArea30623 Node: SystemArea30971
Node: Charset36983 Node: Charset37331
Node: Jigdo38008 Node: Jigdo38356
Node: Miscellaneous42289 Node: Miscellaneous42637
Node: Examples43462 Node: Examples43810
Node: ExSimple43948 Node: ExSimple44296
Node: ExGraft44427 Node: ExGraft44775
Node: ExMkisofs45674 Node: ExMkisofs46022
Node: ExGrowisofs46925 Node: ExGrowisofs47273
Node: ExIncBackup48097 Node: ExIncBackup48445
Node: ExIncBckAcc51146 Node: ExIncBckAcc51494
Node: ExBootable52821 Node: ExBootable53169
Node: Files54920 Node: Files55268
Node: Seealso55990 Node: Seealso56338
Node: Legal56505 Node: Legal56853
Node: CommandIdx57301 Node: CommandIdx57649
Node: ConceptIdx68634 Node: ConceptIdx68982
 
End Tag Table End Tag Table

View File

@ -44,7 +44,7 @@
@c man .\" First parameter, NAME, should be all caps @c man .\" First parameter, NAME, should be all caps
@c man .\" Second parameter, SECTION, should be 1-8, maybe w/ subsection @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 .\" other parameters are allowed: see man(7), man(1)
@c man .TH XORRISOFS 1 "Mar 26, 2011" @c man .TH XORRISOFS 1 "Apr 07, 2011"
@c man .\" Please adjust this date whenever revising the manpage. @c man .\" Please adjust this date whenever revising the manpage.
@c man .\" @c man .\"
@c man .\" Some roff macros, for reference: @c man .\" Some roff macros, for reference:
@ -182,14 +182,15 @@ confuse with the lowlevel ISO 9660 names visible if Rock Ridge gets ignored.)
A program argument is handled as a @strong{pathspec}, if it is not A program argument is handled as a @strong{pathspec}, if it is not
recognized as original mkisofs option or additional xorrisofs option. recognized as original mkisofs option or additional xorrisofs option.
A pathspec depicts an input file object by a disk_path. A pathspec depicts an input file object by a disk_path.
If option -graft-points is not present, then this file object gets If option -graft-points is not present, then the behavior depends on the
copied into the /-directory of the ISO image. file type of disk_path. Directories get merged with the /-directory of the
ISO image. Files of other types get copied into the /-directory.
@* @*
If -graft-points is present then each pathspec gets split at the first If -graft-points is present then each pathspec gets split at the first
occurence of the =-character. occurence of the =-character.
The part before the = is taken as @strong{target}, the iso_rr_path for The part before the = is taken as @strong{target}, i.e. the iso_rr_path for
the file object in the ISO image. The part after the first = is taken the file object in the ISO image. The part after the first = is taken
as @strong{source}, the disk_path of the input object. as @strong{source}, i.e. the disk_path of the input object.
@* @*
It is possible to make =-characters part of the iso_rr_path by preceeding It is possible to make =-characters part of the iso_rr_path by preceeding
them with a \-character. The same must be done for \-characters which them with a \-character. The same must be done for \-characters which
@ -201,6 +202,11 @@ If the source part of the pathspec leads to a directory, then all files
underneath this directory get inserted into the image, too. underneath this directory get inserted into the image, too.
It is possible to exclude particular files from being inserted It is possible to exclude particular files from being inserted
by help of option -m. by help of option -m.
@*
In case that target already exists, the following rules apply:
Directories and other files may overwrite existing non-directories.
Directories get merged with existing directories.
Non-directories may not overwrite existing directories.
@c man .SS @c man .SS
@node Xorriso, Options, Insert, Top @node Xorriso, Options, Insert, Top
@chapter Relation to program xorriso @chapter Relation to program xorriso