mkisofs.8

创建一个符合iso-9660标准的iso文件系统

.I globs
to be exclude as above.
.TP
.B \-max-iso9660-filenames
Allow 37 chars in iso9660 filenames.
This option forces the
.B \-N
option as the extra name space is taken from the space reserved for
ISO-9660 version numbers.
.br
This violates the ISO9660 standard, but it happens to work on many systems.
Although a conforming application needs to provide a buffer space of at
least 37 characters, disks created with this option may cause a buffer
overflow in the reading operating system. Use with extreme care.
.TP
.BI \-M " path
or
.TP
.BI \-M " device
Specifies path to existing iso9660 image to be merged. The alternate form
takes a SCSI device specifier that uses the same syntax as the
.B "dev=
parameter of
.B cdrecord.
The output of 
.B mkisofs
will be a new session which should get written to the end of the
image specified in \-M.  Typically this requires multi-session capability
for the recorder and cdrom drive that you are attempting to write this
image to.
This option may only be used in conjunction with the
.B \-C
option.
.TP
.B \-N
Omit version numbers from ISO9660 file names.
.br
This violates the ISO9660 standard, but no one really uses the
version numbers anyway.
Use with caution.
.TP
.B \-nobak
.TP
.B \-no-bak
Do not include backup files files on the iso9660 filesystem.
If the
.B \-no-bak
option is specified, files that contain the characters '~' or '#'
or end in '.bak' will not be included (these are typically backup files
for editors under unix).
.TP
.B \-no-rr
Do not use the Rock Ridge attributes from previous sessions.
This may help to avoid getting into trouble when
.B mkisofs
finds illegal Rock Ridge signatures on an old session.
.TP
.B \-no-split-symlink-components
Don't split the SL components, but begin a new Continuation Area (CE)
instead. This may waste some space, but the SunOS 4.1.4 cdrom driver
has a bug in reading split SL components (link_size = component_size 
instead of link_size += component_size).
.TP
.B \-no-split-symlink-fields
Don't split the SL fields, but begin a new Continuation Area (CE)
instead. This may waste some space, but the SunOS 4.1.4 and
Solaris 2.5.1 cdrom driver have a bug in reading split SL fields
(a `/' can be dropped).
.TP
.BI \-o " filename
is the name of the file to which the iso9660 filesystem image should be
written.  This can be a disk file, a tape drive, or it can correspond directly
to the device name of the optical disc writer.  If not specified, stdout is
used.  Note that the output can also be a block special device for a regular
disk drive, in which case the disk partition can be mounted and examined to
ensure that the premastering was done correctly.
.TP
.B \-pad
Pad the end of the ISO9660 by 16 sectors (32kB). If the total size then
is not a multiple of 16 sectors, the needed number of sectors is added.
If the option
.B \-B
is used, then there is a second padding at the end of the boot partitions.
.sp
The padding is needed as many operating systems (e.g. Linux)
implement read ahead bugs in their filesystem I/O. These bugs result in read
errors on one or more files that are located at the end of a track. They are
usually present when the CD is written in Track at Once mode or when
the disk is written as mixed mode CD where an audio track follows the
data track.
.TP
.BI \-path-list " file
A file containing a list of
.I pathspec
directories and filenames to be added to the ISO9660 filesystem. This list
of pathspecs are processed after any that appear on the command line. If the
argument is
.IR \- ,
then the list is read from the standard input. There must be at least one
.I pathspec
given on the command line as well.
.TP
.BI \-P " publisher_id
Specifies a text string that will be written into the volume header.
This should describe the publisher of the CDROM, usually with a
mailing address and phone number.  There is space on the disc for 128
characters of information.  This parameter can also be set in the file
.B \&.m\&kisofsrc
with PUBL=.
If specified in both places, the command line version is used.
.TP
.BI \-p " preparer_id
Specifies a text string that will be written into the volume header.
This should describe the preparer of the CDROM, usually with a mailing
address and phone number.  There is space on the disc for 128
characters of information.  This parameter can also be set in the file
.B \&.m\&kisofsrc
with PREP=.
If specified in both places, the command line version is used.
.TP
.B \-print-size
Print estimated filesystem size and exit. This option is needed for
Disk At Once mode and with some CD-R drives when piping directly into
.B cdrecord.
In this case it is needed to know the size of the filesystem before the
actual CD-creation is done.
The option \-print-size allows to get this size from a "dry-run" before
the CD is actually written.
.TP
.B \-quiet
This makes
.B mkisofs
even less verbose.  No progress output will be provided.
.TP
.B \-R
Generate SUSP and RR records using the Rock Ridge protocol to further describe
the files on the iso9660 filesystem.
.TP
.B \-r
This is like the \-R option, but file ownership and modes are set to
more useful values.  The uid and gid are set to zero, because they are
usually only useful on the author's system, and not useful to the
client.  All the file read bits are set true, so that files and
directories are globally readable on the client.  If any execute bit is
set for a file, set all of the execute bits, so that executables are
globally executable on the client.  If any search bit is set for a
directory, set all of the search bits, so that directories are globally
searchable on the client.  All write bits are cleared, because the
CD-Rom will be mounted read-only in any case.  If any of the special
mode bits are set, clear them, because file locks are not useful on a
read-only file system, and set-id bits are not desirable for uid 0 or
gid 0.
When used on Win32, the execute bit is set on
.I all
files. This is a result of the lack of file permissions on Win32 and the
Cygwin POSIX emulation layer.
.TP
.B \-relaxed-filenames
The option
.B \-relaxed-filenames
allows ISO9660 filenames to include digits, uppercase characters
and all other 7 bit ASCII characters (resp. anything except lowercase
characters).
.br
This violates the ISO9660 standard, but it happens to work on many systems.
Use with caution.
.TP
.BI \-sort " sort file
Sort file locations on the media. Sorting is controlled by a file that
contains pairs of filenames and sorting offset weighting.
If the weighting is higher, the file will be located closer to the
beginning of the media, if the weighting is lower, the file will be located
closer to the end of the media. There must be only one space or tabs
character between the filename and the
weight and the weight must be the last characters on a line. The filename
is taken to include all the characters up to, but not including the last
space or tab character on a line. This is to allow for space characters to
be in, or at the end of a filename. See README.sort for more details.
.TP
.BI \-sysid " ID
Specifies the system ID.
This parameter can also be set in the file
.B \&.m\&kisofsrc
with SYSI=system_id.
If specified in both places, the command line version is used.
.TP
.B \-T
Generate a file TRANS.TBL in each directory on the CDROM, which can be used
on non-Rock Ridge capable systems to help establish the correct file names.
There is also information present in the file that indicates the major and
minor numbers for block and character devices, and each symlink has the name of
the link file given.
.TP
.BI \-table-name " TABLE_NAME
Alternative translation table file name (see above). Implies the
.B \-T
option.
If you are creating a multi-session image you must use the same name
as in the previous session.
.TP
.BI \-ucs-level " level
Set Unicode conformance level in the Joliet SVD. The default level is 3.
It may be set to 1..3 using this option.
.TP
.B \-use-fileversion
The option 
.B \-use-fileversion
allows mkisofs to use file version numbers from the filesystem.
If the option is not specified, 
.B mkisofs
creates a version if 1 for all files.
File versions are strings in the range 
.I ";1"
to
.I ";32767"
This option is the default on VMS. 
.TP
.B \-U
Allows "Untranslated" filenames, completely violating the iso9660 standards
described above. Forces on the \-d, \-l, \-L, \-N, \-relaxed-filenames,
\-allow-lowercase, \-allow-multidot and \-no-iso-translate
flags. It allows more
than one '.' character in the filename, as well as mixed case filenames.
This is useful on HP-UX system, where the built-in CDFS filesystem does
not recognize ANY extensions. Use with extreme caution.
.TP
.B \-no-iso-translate
Do not translate the characters '#' and '~' which are invalid for iso9660 filenames.
These characters are though invalid often used by Microsoft systems.
.br
This violates the ISO9660 standard, but it happens to work on many systems.
Use with caution.
.TP
.BI \-V " volid
Specifies the volume ID (volume name or label) to be written into the
master block.  This parameter can also be set in the file
.B \&.m\&kisofsrc
with VOLI=id.
If specified in both places, the command line version is used.  Note that
if you assign a volume ID, this is the name that will be used as the mount
point used by the Solaris volume management system and the name that is
assigned to the disc on a Windows or Mac platform.
.TP
.BI \-volset " ID
Specifies the volset ID.
This parameter can also be set in the file
.B \&.m\&kisofsrc
with VOLS=volset_id.
If specified in both places, the command line version is used.
.TP
.BI \-volset-size " #
Sets the volume set size to #.
The volume set size is the number of CD's that are in a CD set.
The
.B \-volset-size
option may be used to create CD's that are part of e.g. a Operation
System installation set of CD's.
The option
.B \-volset-size
must be specified before
.B \-volset-seqno
on each command line.
.TP
.BI \-volset-seqno " #
Sets the volume set sequence number to #.
The volume set sequence number is the index number of the current
CD in a CD set.
The option
.B \-volset-size
must be specified before
.B \-volset-seqno
on each command line.
.TP
.B \-v
Verbose execution. If given twice on the command line, extra debug information
will be printed.
.TP
.BI \-x " path
Exclude
.I path
from being written to CDROM.
.I path
must be the complete pathname that results from concatenating the pathname
given as command line argument and the path relative to this directory.
Multiple paths may be excluded.
Example: 

mkisofs \-o cd \-x /local/dir1 \-x /local/dir2 /local
.sp
NOTE: The \-m and \-x option description should both be updated, they are wrong.
Both now work identical and use filename globbing. A file is excluded if either
the last component matches or the whole path matches.
.TP
.B \-z
Generate special SUSP records for transparently compressed files.  This is
only of use and interest for hosts that support transparent decompression.
This is an experimental feature, and no hosts yet support this, but there
are ALPHA patches for Linux that can make use of this feature.

.SH "HFS OPTIONS
.TP
.B \-hfs
Create an ISO9660/HFS hybrid CD. This option should be used in conjunction
with the
.BR \-map ,
.R \-magic
and/or the various
.I double dash
options given below.
.TP
.B \-apple
Create an ISO9660 CD with Apple's extensions. Similar to the
.B \-hfs
option, except that the Apple Extensions to ISO9660 are added instead of
creating an HFS hybrid volume.
.TP
.BI \-map " mapping_file
Use the
.I mapping_file
to set the CREATOR and TYPE information for a file based on the
filename's extension. A filename is 
mapped only if it is not one of the know Apple/Unix file formats. See the
.B "HFS CREATOR/TYPE
section below.
.TP
.BI \-magic " magic_file
The CREATOR and TYPE information is set by using a file's
.I magic number
(usually the first few bytes of a file). The
.I magic_file
is only used if a file is not one of the known Apple/Unix file formats, or
the filename extension has not been mapped using the
.B \-map
option. See the 
.B "HFS CREATOR/TYPE
section below for more details.
.TP
.BI \-hfs-creator " CREATOR
Set the default CREATOR for all files. Must be exactly 4 characters. See the
.B "HFS CREATOR/TYPE
section below for more details.
.TP
.BI \-hfs-type " TYPE
Set the default TYPE for all files. Must be exactly 4 characters. See the
.B "HFS CREATOR/TYPE
section below for more details.
.TP
.B \-probe
Search the contents of files for all the known Apple/Unix file formats.
See the
.B HFS MACINTOSH FILE FORMATS
section below for more about these formats.
However, the only way to check for
.I MacBinary
and
.I AppleSingle
files is to open and read them. Therefore this option
.I may
increase processing time. It is better to use one or more
.I double dash
options given below if the Apple/Unix formats in use are known.
.TP
.B \-no-desktop
Do not create (empty) Desktop files. New HFS Desktop files will be created
when the CD is used on a Macintosh (and stored in the System Folder).
By default, empty Desktop files are added to the HFS volume.
.TP
.B \-mac-name
Use the HFS filename as the starting point for the ISO9660, Joliet and
Rock Ridge file names. See the
.B HFS MACINTOSH FILE NAMES
section below for more information.
.TP
.BI \-boot-hfs-file " driver_file
Installs the
.I driver_file
that
.I may
make the CD bootable on a Macintosh. See the
.B HFS BOOT DRIVER
section below. (Alpha).
.TP
.B \-part
Generate an HFS partition table. By default, no partition table is generated,
but some older Macintosh CDROM drivers need an HFS partition table on the
CDROM to be able to recognize a hybrid CDROM.
.TP
.BI \-auto " AutoStart_file
Make the HFS CD use the QuickTime 2.0 Autostart feature to launch an
application or document. The given filename must be the name of a document or
application located at the top level of the CD. The filename must be less
than 12 characters. (Alpha).
.TP
.BI \-cluster-size " size
Set the size in bytes of the cluster or allocation units of PC Exchange
files. Implies the
.B \--exchange
option. See the
.B HFS MACINTOSH FILE FORMATS
section below.
.TP
.BI \-hide-hfs " glob
Hide
.I glob
from the HFS volume. The file or directory will still exist in the
ISO9660 and/or Joliet directory.
.I glob
is a shell wild-card-style pattern that must match any part of the filename
Multiple globs may be excluded.
Example:

mkisofs \-o rom \-hfs \-hide-hfs '*.o' \-hide-hfs foobar

would exclude all files ending in ".o" or called "foobar" 
from the HFS volume. Note that if you had a directory called
"foobar" it too (and of course all its descendants) would be excluded.
The
.I glob
can also be a path name relative to the source directories given on the
command line. Example:

mkisofs \-o rom \-hfs \-hide-hfs src/html src

would exclude just the file or directory called "html" from the "src"
directory. Any other file or directory called "html" in the tree will
not be excluded.
Should be used with the
.B \-hide
and/or
.B \-hide-joliet
options.
.TP
.BI \-hide-hfs-list " file
A file containing a list of
.I globs
to be hidden as above.
.TP
.BI \-hfs-volid " hfs_volid
Volume name for the HFS partition. This is the name that is
assigned to the disc on a Macintosh and replaces the
.I volid
used with the 
.B \-V
option
.TP
.B \-icon-position
Use the icon position information, if it exists, from the Apple/Unix file.
The icons will appear in the same position as they would on a Macintosh