Clarification about -as mkisofs pathspecs

This commit is contained in:
2011-04-07 17:59:31 +00:00
parent 77c7de4ce6
commit f0316cebf7
3 changed files with 59 additions and 42 deletions

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 XORRISOFS 1 "Mar 26, 2011"
.TH XORRISOFS 1 "Apr 07, 2011"
.\" Please adjust this date whenever revising the manpage.
.\"
.\" 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
recognized as original mkisofs option or additional xorrisofs option.
A pathspec 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 of the ISO image.
If option -graft-points is not present, then the behavior depends on the
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
If -graft-points is present then each pathspec gets split at the first
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
as \fBsource\fR, the disk_path of the input object.
as \fBsource\fR, i.e. the disk_path of the input object.
.br
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
@ -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.
It is possible to exclude particular files from being inserted
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
\fBRelation to program xorriso:\fR
.br