mkisofs.man
上传用户:xiejiait
上传日期:2007-01-06
资源大小:881k
文件大小:46k
源码类别:

SCSI/ASPI

开发平台:

MultiPlatform

  1. MKISOFS(8)           Maintenance Procedures            MKISOFS(8)
  2. NNNNAAAAMMMMEEEE
  3.      mkisofs - create a iso9660  filesystem  with  optional  Rock
  4.      Ridge attributes.
  5. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  6.      mmmmkkkkiiiissssooooffffssss [ ----aaaa ] [ ----aaaabbbbssssttttrrrraaaacccctttt _F_I_L_E ] [ ----bbbbiiiibbbblllliiiioooo _F_I_L_E  ]  [   ---- bbbb
  7.      _e_l_t_o_r_i_t_o__b_o_o_t__i_m_a_g_e  ]  [   ---- BBBB _s_p_a_r_c__b_o_o_t__i_m_a_g_e__l_i_s_t ] [ ----GGGG
  8.      _g_e_n_e_r_i_c__b_o_o_t__i_m_a_g_e ] [ ----gggguuuuiiii ] [ ----CCCC #,# ] [ ----hhhhaaaarrrrdddd----ddddiiiisssskkkk----bbbbooooooootttt ]
  9.      [   ----nnnnoooo----eeeemmmmuuuullll----bbbbooooooootttt ] [ ----nnnnoooo----bbbbooooooootttt ] [ ----bbbbooooooootttt----llllooooaaaadddd----sssseeeegggg ] [ ----bbbbooooooootttt----
  10.      llllooooaaaadddd----ssssiiiizzzzeeee ] [ ----bbbbooooooootttt----iiiinnnnffffoooo----ttttaaaabbbblllleeee ] [ ----cccc _b_o_o_t__c_a_t_a_l_o_g  ]  [   ----
  11.      ccccooooppppyyyyrrrriiiigggghhhhtttt  _F_I_L_E ] [ ----AAAA _a_p_p_l_i_c_a_t_i_o_n__i_d ] [ ----ffff ] [ ----dddd ] [ ----DDDD ]
  12.      [ ----hhhhiiiiddddeeee _g_l_o_b ] [ ----hhhhiiiiddddeeee----lllliiiisssstttt _f_i_l_e ] [ ----hhhhiiiiddddeeee----jjjjoooolllliiiieeeetttt _g_l_o_b ] [ ----
  13.      hhhhiiiiddddeeee----jjjjoooolllliiiieeeetttt----lllliiiisssstttt  _f_i_l_e ] [ ----hhhhiiiiddddeeee----jjjjoooolllliiiieeeetttt----ttttrrrraaaannnnssss----ttttbbbbllll ] [ ----hhhhiiiiddddeeee----
  14.      rrrrrrrr----mmmmoooovvvveeeedddd ] [ ----JJJJ ] [ ----llll ] [ ----LLLL ] [ ----lllloooogggg----ffffiiiilllleeee _l_o_g__f_i_l_e ] [ ---- MMMM
  15.      _p_a_t_h  | _d_e_v_i_c_e ] [ ----nnnnoooobbbbaaaakkkk ] [ ----nnnnoooo----bbbbaaaakkkk ] [ ----nnnnoooo----sssspppplllliiiitttt----ssssyyyymmmmlllliiiinnnnkkkk----
  16.      ccccoooommmmppppoooonnnneeeennnnttttssss ] [ ----nnnnoooo----sssspppplllliiiitttt----ssssyyyymmmmlllliiiinnnnkkkk----ffffiiiieeeellllddddssss ] [ ----ppppaaaatttthhhh----lllliiiisssstttt  _f_i_l_e
  17.      ]  [ ----pppp _p_r_e_p_a_r_e_r ] [ ----pppprrrriiiinnnntttt----ssssiiiizzzzeeee ] [ ----PPPP _p_u_b_l_i_s_h_e_r ] [ ----qqqquuuuiiiieeeetttt
  18.      ] [ ----rrrr ] [ ----RRRR ] [ ----ssssyyyyssssiiiidddd _I_D ] [ ----TTTT ] [ ----UUUU ] [ ----vvvv  ]  [   ---- VVVV
  19.      _v_o_l_i_d  ] [ ----vvvvoooollllsssseeeetttt _I_D ] [ ----vvvvoooollllsssseeeetttt----ssssiiiizzzzeeee # ] [ ----vvvvoooollllsssseeeetttt----sssseeeeqqqqnnnnoooo #
  20.      ] [ ----xxxx _p_a_t_h ] [ ----eeeexxxxcccclllluuuuddddeeee----lllliiiisssstttt _f_i_l_e ] [ ----zzzz ] [ ----mmmm _g_l_o_b ]  ---- oooo
  21.      _f_i_l_e_n_a_m_e _p_a_t_h_s_p_e_c [_p_a_t_h_s_p_e_c]
  22. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  23.      mmmmkkkkiiiissssooooffffssss is effectively a pre-mastering program  to  generate
  24.      the  iso9660  filesystem  -  it  takes a snapshot of a given
  25.      directory tree, and generates  a  binary  image  which  will
  26.      correspond  to an iso9660 filesystem when written to a block
  27.      device.
  28.      mmmmkkkkiiiissssooooffffssss is also capable of generating the System Use Sharing
  29.      Protocol  records  specified  by  the Rock Ridge Interchange
  30.      Protocol.  This is used to further describe the files in the
  31.      iso9660  filesystem to a unix host, and provides information
  32.      such as longer filenames, uid/gid,  posix  permissions,  and
  33.      block and character devices.
  34.      Each file written to the  iso9660  filesystem  must  have  a
  35.      filename  in the 8.3 format (8 characters, period, 3 charac-
  36.      ters, all upper case), even if Rock Ridge is in  use.   This
  37.      filename is used on systems that are not able to make use of
  38.      the  Rock  Ridge  extensions  (such  as  MS-DOS),  and  each
  39.      filename  in each directory must be different from the other
  40.      filenames in the same directory.  mmmmkkkkiiiissssooooffffssss generally tries to
  41.      form  correct  names  by  forcing the unix filename to upper
  42.      case and truncating as required, but often times this yields
  43.      unsatisfactory  results when there are cases where the trun-
  44.      cated names are not all unique.  mmmmkkkkiiiissssooooffffssss assigns  weightings
  45.      to  each  filename,  and if two names that are otherwise the
  46.      same are found the name with the lower priority  is  renamed
  47.      to  have  a 3 digit number as an extension (where the number
  48.      is guaranteed to be unique).  An example of  this  would  be
  49.      the  files  foo.bar  and  foo.bar.~1~ - the file foo.bar.~1~
  50. Version 1.12b5      Last change: 7. Jan 2000                    1
  51. MKISOFS(8)           Maintenance Procedures            MKISOFS(8)
  52.      would be written as FOO.000;1 and the file foo.bar would  be
  53.      written as FOO.BAR;1
  54.      Note that mmmmkkkkiiiissssooooffffssss is not designed to  communicate  with  the
  55.      writer directly.  Most writers have proprietary command sets
  56.      which vary from one manufacturer to another, and you need  a
  57.      specialized  tool  to  actually  burn the disk.  The ccccddddwwwwrrrriiiitttteeee
  58.      utility is one such tool that runs under Linux and  performs
  59.      this task.  The latest version of ccccddddwwwwrrrriiiitttteeee is capable of com-
  60.      municating with the Phillips/IMS/Kodak, HP and Yamaha drives
  61.      that  have been manufactured before 1997.  Most writers come
  62.      with some version of DOS software that allows a direct image
  63.      copy of an iso9660 image to the writer.  The current version
  64.      of ccccddddwwwwrrrriiiitttteeee is available from  sunsite.unc.edu:  /utils/disk-
  65.      management/cdwrite-2.0.tar.gz Note that cdwrite has not been
  66.      actively maintained since 1995.
  67.      The ccccddddrrrreeeeccccoooorrrrdddd utility is another utility capable  of  burning
  68.      an actual disc.  The latest version of ccccddddrrrreeeeccccoooorrrrdddd is available
  69.      from  ftp://ftp.fokus.gmd.de/pub/unix/cdrecord  Cdrecord  is
  70.      under constant development.
  71.      Also you should know that most cd writers are very  particu-
  72.      lar about timing.  Once you start to burn a disc, you cannot
  73.      let their buffer empty before you are done, or you will  end
  74.      up  with  a  corrupt  disc.  Thus it is critical that you be
  75.      able to maintain an uninterrupted data stream to the  writer
  76.      for the entire time that the disc is being written.
  77.      ppppaaaatttthhhhssssppppeeeecccc is the path of the directory tree to be copied into
  78.      the  iso9660  filesystem.   Multiple paths can be specified,
  79.      and mmmmkkkkiiiissssooooffffssss will merge the files found in all of the  speci-
  80.      fied path components to form the cdrom image.
  81.      It is possible to graft the paths at points other  than  the
  82.      root  directory, and it is possible to graft files or direc-
  83.      tories onto the cdrom image with names different  than  what
  84.      they  have  in  the  source  filesystem.  This is easiest to
  85.      illustrate with a  couple  of  examples.    Let's  start  by
  86.      assuming  that  a local file ../old.lis exists, and you wish
  87.      to include it in the cdrom image.
  88.           foo/bar/=../old.lis
  89.      will  include  the  file  old.lis  in  the  cdrom  image  at
  90.      /foo/bar/old.lis, while
  91.           foo/bar/xxx=../old.lis
  92.      will  include  the  file  old.lis  in  the  cdrom  image  at
  93.      /foo/bar/xxx.   The  same  sort  of  syntax can be used with
  94. Version 1.12b5      Last change: 7. Jan 2000                    2
  95. MKISOFS(8)           Maintenance Procedures            MKISOFS(8)
  96.      directories as well.  mmmmkkkkiiiissssooooffffssss wwwwiiiillllllll  ccccrrrreeeeaaaatttteeee  aaaannnnyyyy  ddddiiiirrrreeeeccccttttoooorrrriiiieeeessss
  97.      rrrreeeeqqqquuuuiiiirrrreeeedddd ssssuuuucccchhhh tttthhhhaaaatttt tttthhhheeee ggggrrrraaaafffftttt points exist on the cdrom image
  98.      - the directories do not need to appear in one of the paths.
  99.      Any  directories  that are created on the fly like this will
  100.      have permissions 0555 and appear to be owned by  the  person
  101.      running mkisofs.  If you wish other permissions or owners of
  102.      the intermediate directories, the  easiest  solution  is  to
  103.      create  real  directories  in  the  path  such  that mkisofs
  104.      doesn't have to invent them.
  105. OOOOPPPPTTTTIIIIOOOONNNNSSSS
  106.      ----aaaa    Include all files on the iso9660 filesystem.  Normally
  107.           files  that  contain the characters '~' or '#' will not
  108.           be included (these are typically backup files for  edi-
  109.           tors  under  unix).  This  option  is now obsolete (see
  110.           -no-bak option).
  111.      ----aaaabbbbssssttttrrrraaaacccctttt _F_I_L_E
  112.           Specifies the abstract file name.  This  parameter  can
  113.           also  be set in the file ....mmmmkkkkiiiissssooooffffssssrrrrcccc with ABST=filename.
  114.           If specified in both places, the command  line  version
  115.           is used.
  116.      ----AAAA _a_p_p_l_i_c_a_t_i_o_n__i_d
  117.           Specifies a text string that will be written  into  the
  118.           volume  header.   This  should describe the application
  119.           that will be on the disc.  There is space on  the  disc
  120.           for  128 characters of information.  This parameter can
  121.           also be set in the file ....mmmmkkkkiiiissssooooffffssssrrrrcccc  with  APPI=id.   If
  122.           specified  in  both places, the command line version is
  123.           used.
  124.      ----bbbbiiiibbbblllliiiioooo _F_I_L_E
  125.           Specifies the bibliographic file name.  This  parameter
  126.           can   also   be   set   in  the  file  ....mmmmkkkkiiiissssooooffffssssrrrrcccc  with
  127.           BIBLO=filename.  If specified in both places, the  com-
  128.           mand line version is used.
  129.      ----bbbb _e_l_t_o_r_i_t_o__b_o_o_t__i_m_a_g_e
  130.           Specifies the path and filename of the boot image to be
  131.           used  when making an "El Torito" bootable CD. The path-
  132.           name must be relative to the source path  specified  to
  133.           mmmmkkkkiiiissssooooffffssss.... This option is required to make an "El Torito"
  134.           bootable CD.  The boot image must be exactly  the  size
  135.           of  either  a  1.2,  1.44,  or  a  2.88 meg floppy, and
  136.           mmmmkkkkiiiissssooooffffssss will use this size  when  creating  the  output
  137.           iso9660  filesystem.  It  is assumed that the first 512
  138.           byte sector should be read from the boot image  (it  is
  139.           essentially  emulating  a  normal  floppy drive).  This
  140.           will work, for example, if the boot  image  is  a  LILO
  141.           based boot floppy.
  142. Version 1.12b5      Last change: 7. Jan 2000                    3
  143. MKISOFS(8)           Maintenance Procedures            MKISOFS(8)
  144.      ----BBBB _i_m_g__s_u_n_4,_i_m_g__s_u_n_4_c,_i_m_g__s_u_n_4_m,_i_m_g__s_u_n_4_d,_i_m_g__s_u_n_4_e
  145.           Specifies a comma separated list of  boot  images  that
  146.           are  needed  to  make  a bootable CD for sparc systems.
  147.           There may be empty fields in the comma separated  list.
  148.           This  option  is required to make a bootable CD for Sun
  149.           sparc systems.  If the ----BBBB or  ---- ssssppppaaaarrrrcccc----bbbbooooooootttt  option  has
  150.           been specified, the first sector of the resulting image
  151.           will contain a Sun disk label. This disk  label  speci-
  152.           fies  slice  0  for  the  iso9660 image and slice 1 ...
  153.           slice 7 for the boot images that  have  been  specified
  154.           with  this option. Byte offset 512 ... 8191 within each
  155.           of the additional boot images must  contain  a  primary
  156.           boot that works for the appropriate sparc architecture.
  157.           The rest of each of the images usually contains an  ufs
  158.           filesystem that is used primary kernel boot stage.
  159.           The implemented boot method is the  boot  method  found
  160.           with  SunOS  4.x  and  SunOS 5.x.  However, it does not
  161.           depend on SunOS internals but only on properties of the
  162.           Open  Boot  prom.  For this reason, it should be usable
  163.           for any OS that boots off a sparc system.
  164.      ----GGGG _g_e_n_e_r_i_c__b_o_o_t__i_m_a_g_e
  165.           Specifies the path and filename  of  the  generic  boot
  166.           image  to  be  used  when making a generic bootable CD.
  167.           The ggggeeeennnneeeerrrriiiicccc____bbbbooooooootttt____iiiimmmmaaaaggggeeee wil be placed on  the  first  16
  168.           sectors of the CD. The first 16 sectors are the sectors
  169.           that are located  before  the  iso9660  primary  volume
  170.           descriptor.  If this option is used together with the ----
  171.           ssssppppaaaarrrrcccc----bbbbooooooootttt option, the Sun disk label will overlay  the
  172.           first 512 bytes of the generic boot image.
  173.      ----hhhhaaaarrrrdddd----ddddiiiisssskkkk----bbbbooooooootttt
  174.           Specifies that the boot image used to create  "El  Tor-
  175.           ito"  bootable  CDs is a hard disk image. The hard disk
  176.           image must begin with a master boot  record  that  con-
  177.           tains a single partition.
  178.      ----nnnnoooo----eeeemmmmuuuullll----bbbbooooooootttt
  179.           Specifies that the boot image used to create  "El  Tor-
  180.           ito" bootable CDs is a 'no emulation' image. The system
  181.           will load and execute this image without performing any
  182.           disk emulation.
  183.      ----nnnnoooo----bbbbooooooootttt
  184.           Specifies that the created "El  Torito"  CD  should  be
  185.           marked as not bootable. The system will provide an emu-
  186.           lated drive for the image, but will boot off a standard
  187.           boot device.
  188.      ----bbbbooooooootttt----llllooooaaaadddd----sssseeeegggg _s_e_g_m_e_n_t__a_d_d_r_e_s_s
  189.           Specifies the load segment address of  the  boot  image
  190. Version 1.12b5      Last change: 7. Jan 2000                    4
  191. MKISOFS(8)           Maintenance Procedures            MKISOFS(8)
  192.           for no-emulation "El Torito" CDs.
  193.      ----bbbbooooooootttt----llllooooaaaadddd----ssssiiiizzzzeeee _l_o_a_d__s_e_c_t_o_r_s
  194.           Specifies the number of "virtual" (512-byte) sectors to
  195.           load  in no-emulation mode.  The default is to load the
  196.           entire boot file.  Some BIOSes  may  have  problems  if
  197.           this is not a multiple of 4.
  198.      ----bbbbooooooootttt----iiiinnnnffffoooo----ttttaaaabbbblllleeee
  199.           Specifies that a 56-byte table with information of  the
  200.           CD-ROM  layout  will  be  patched in at offset 8 in the
  201.           boot file.  If this option is given, the boot  file  is
  202.           modified in the source filesystem, so make sure to make
  203.           a copy if this file cannot be easily regenerated!   See
  204.           the   BBBBOOOOOOOOTTTT IIIINNNNFFFFOOOO TTTTAAAABBBBLLLLEEEE section for a description of this
  205.           table.
  206.      ----CCCC _l_a_s_t__s_e_s_s__s_t_a_r_t,_n_e_x_t__s_e_s_s__s_t_a_r_t
  207.           This option is needed when mmmmkkkkiiiissssooooffffssss is  used  to  create
  208.           the image of a second session or a higher level session
  209.           for a multi session disk.  The option ----CCCC takes  a  pair
  210.           of  two  numbers separated by a comma. The first number
  211.           is the sector number of the first sector  in  the  last
  212.           session  of  the  disk that should be appended to.  The
  213.           second number is the starting sector number of the  new
  214.           session.  The expected pair of numbers may be retrieved
  215.           by calling ccccddddrrrreeeeccccoooorrrrdddd ----mmmmssssiiiinnnnffffoooo ............ the ----CCCC option may  only
  216.           be uses in conjunction with the ----MMMM option.
  217.      ----cccc _b_o_o_t__c_a_t_a_l_o_g
  218.           Specifies the path and filename of the boot catalog  to
  219.           be  used  when  making  an "El Torito" bootable CD. The
  220.           pathname must be relative to the source path  specified
  221.           to  mmmmkkkkiiiissssooooffffssss.... This option is required to make a bootable
  222.           CD.  This file will be created by mmmmkkkkiiiissssooooffffssss in the source
  223.           filesystem,  so be sure the specified filename does not
  224.           conflict with an existing file, as it will  be  quietly
  225.           overwritten!  Usually  a  name  like  "boot.catalog" is
  226.           chosen.
  227.      ----ccccooooppppyyyyrrrriiiigggghhhhtttt _F_I_L_E
  228.           Specifies the Copyright file name.  This parameter  can
  229.           also  be set in the file ....mmmmkkkkiiiissssooooffffssssrrrrcccc with COPY=filename.
  230.           If specified in both places, the command  line  version
  231.           is used.
  232.      ----dddd    Omit trailing period from files that  do  not  have  a
  233.           period.   This  violates  the  ISO9660 standard, but it
  234.           happens to work on many systems.  Use with caution.
  235.      ----DDDD    Do not use deep directory relocation, and instead just
  236.           pack  them  in  the way we see them.  This violates the
  237. Version 1.12b5      Last change: 7. Jan 2000                    5
  238. MKISOFS(8)           Maintenance Procedures            MKISOFS(8)
  239.           ISO9660 standard, but it works on  many  systems.   Use
  240.           with caution.
  241.      ----ffff    Follow symbolic links when generating the  filesystem.
  242.           When  this option is not in use, symbolic links will be
  243.           entered using Rock Ridge if enabled, otherwise the file
  244.           will be ignored.
  245.      ----gggguuuuiiii  Switch the behaviour for a GUI. This  currently  makes
  246.           the  output  more verbose but may have other effects in
  247.           future.
  248.      ----hhhhiiiiddddeeee _g_l_o_b
  249.           Hide _g_l_o_b from being seen on the ISO9660 or Rock  Ridge
  250.           directory.   _g_l_o_b  is  a  shell wild-card-style pattern
  251.           that must match any part of the filename or path.  Mul-
  252.           tiple  globs  may  be  hidden  (up  to  1000).  If _g_l_o_b
  253.           matches a directory, then the contents of  that  direc-
  254.           tory  will  be hidden.  All the hidden files will still
  255.           be written to the output CD image file.  Should be used
  256.           with the ----hhhhiiiiddddeeee----jjjjoooolllliiiieeeetttt option.
  257.      ----hhhhiiiiddddeeee----lllliiiisssstttt _f_i_l_e
  258.           A file containing a list  of  _g_l_o_b_s  to  be  hidden  as
  259.           above.
  260.      ----hhhhiiiiddddeeee----jjjjoooolllliiiieeeetttt _g_l_o_b
  261.           Hide _g_l_o_b from being  seen  on  the  Joliet  directory.
  262.           _g_l_o_b is a shell wild-card-style pattern that must match
  263.           any part of the filename or path.  Multiple  globs  may
  264.           be  hidden  (up to 1000).  If _g_l_o_b matches a directory,
  265.           then the contents of that  directory  will  be  hidden.
  266.           All  the hidden files will still be written to the out-
  267.           put CD image file.  Should be  used  with  the   ---- hhhhiiiiddddeeee
  268.           option.
  269.      ----hhhhiiiiddddeeee----jjjjoooolllliiiieeeetttt----lllliiiisssstttt _f_i_l_e
  270.           A file containing a list  of  _g_l_o_b_s  to  be  hidden  as
  271.           above.
  272.      ----hhhhiiiiddddeeee----jjjjoooolllliiiieeeetttt----ttttrrrraaaannnnssss----ttttbbbbllll
  273.           Hide the TTTTRRRRAAAANNNNSSSS....TTTTBBBBLLLL files from the Joliet  tree.   These
  274.           files  usually  don't make sense in the Joliet World as
  275.           they list the real name and the ISO9660 name which  may
  276.           both be different from the Joliet name.
  277.      ----hhhhiiiiddddeeee----rrrrrrrr----mmmmoooovvvveeeedddd
  278.           Rename the directory RRRRRRRR____MMMMOOOOVVVVEEEEDDDD to ....rrrrrrrr____mmmmoooovvvveeeedddd in the  Rock
  279.           Ridge  tree.   It  seems to be impossible to completely
  280.           hide the RRRRRRRR____MMMMOOOOVVVVEEEEDDDD directory from the Rock  Ridge  tree.
  281.           This  option  only  makes  the  visible  tree better to
  282.           understand  for  people  who  don't  know   what   this
  283. Version 1.12b5      Last change: 7. Jan 2000                    6
  284. MKISOFS(8)           Maintenance Procedures            MKISOFS(8)
  285.           directory  is  for.   If  you  need to have no RRRRRRRR____MMMMOOOOVVVVEEEEDDDD
  286.           directory at all, you should use the ---- DDDD  option.  Note
  287.           that in case that the ----DDDD option has been specified, the
  288.           resulting filesystem is not ISO9660  level-1  compliant
  289.           and will not be readable on MS-DOS.
  290.      ----llll    Allow  full  30  character  filenames.   Normally  the
  291.           ISO9660 filename will be in an 8.3 format which is com-
  292.           patible with MS-DOS, even though the  ISO9660  standard
  293.           allows  filenames  of  up to 30 characters.  If you use
  294.           this option, the disc may be difficult to use on a  MS-
  295.           DOS  system, but this comes in handy on some other sys-
  296.           tems (such as the Amiga).  Use with caution.
  297.      ----JJJJ    Generate Joliet directory records in addition to regu-
  298.           lar  iso9660 file names.  This is primarily useful when
  299.           the discs are to be used on  Windows-NT  or  Windows-95
  300.           machines.    The  Joliet  filenames  are  specified  in
  301.           Unicode and each path component can be up to 64 Unicode
  302.           characters long.
  303.      ----LLLL    Allow ISO9660 filenames to begin with a period.   Usu-
  304.           ally,  a  leading dot is replaced with an underscore in
  305.           order to maintain MS-DOS compatibility.
  306.      ----lllloooogggg----ffffiiiilllleeee _l_o_g__f_i_l_e
  307.           Redirect all error, warning and informational  messages
  308.           to _l_o_g__f_i_l_e instead of the standard error.
  309.      ----mmmm _g_l_o_b
  310.           Exclude _g_l_o_b from being written to CDROM.   _g_l_o_b  is  a
  311.           shell  wild-card-style  pattern that must match part of
  312.           the filename (not the path as with option ----xxxx).  Techni-
  313.           cally _g_l_o_b is matched against the _d->_d__n_a_m_e part of the
  314.           directory entry.  Multiple globs may be excluded (up to
  315.           1000).  Example:
  316.           mkisofs -o rom -m '*.o' -m core -m foobar
  317.           would exclude all files ending in ".o",  called  "core"
  318.           or "foobar" to be copied to CDROM. Note that if you had
  319.           a directory called "foobar" it too (and of  course  all
  320.           its descendants) would be excluded.
  321.           NOTE: The -m and -x option description should  both  be
  322.           updated,  they  are wrong.  Both now work identical and
  323.           use filename globbing. A file is excluded if either the
  324.           last component matches or the whole path matches.
  325.      ----eeeexxxxcccclllluuuuddddeeee----lllliiiisssstttt _f_i_l_e
  326.           A file containing a list of  _g_l_o_b_s  to  be  exclude  as
  327.           above.
  328. Version 1.12b5      Last change: 7. Jan 2000                    7
  329. MKISOFS(8)           Maintenance Procedures            MKISOFS(8)
  330.      ----MMMM _p_a_t_h
  331.           or
  332.      ----MMMM _d_e_v_i_c_e
  333.           Specifies path to existing iso9660 image to be  merged.
  334.           The  alternate  form takes a SCSI device specifier that
  335.           uses the same syntax as the ddddeeeevvvv==== parameter of ccccddddrrrreeeeccccoooorrrrdddd....
  336.           The  output  of  mmmmkkkkiiiissssooooffffssss  will  be  a new session which
  337.           should get written to the end of the image specified in
  338.           -M.   Typically  this requires multi-session capability
  339.           for the recorder and cdrom drive that you are  attempt-
  340.           ing  to  write  this image to.  This option may only be
  341.           used in conjunction with the ----CCCC option.
  342.      ----NNNN    Omit version numbers from ISO9660  file  names.   This
  343.           may  violate  the  ISO9660  standard, but no one really
  344.           uses the version numbers anyway.  Use with caution.
  345.      ----nnnnoooobbbbaaaakkkk
  346.      ----nnnnoooo----bbbbaaaakkkk
  347.           Do not  include  backup  files  files  on  the  iso9660
  348.           filesystem.  If  the ----nnnnoooo----bbbbaaaakkkk option is specified, files
  349.           that contain the characters '~' or '#' or end in '.bak'
  350.           will  not be included (these are typically backup files
  351.           for editors under unix).
  352.      ----nnnnoooo----rrrrrrrr
  353.           Do not use the Rock Ridge attributes from previous ses-
  354.           sions.   This  may  help  to avoid getting into trouble
  355.           when mmmmkkkkiiiissssooooffffssss finds illegal Rock Ridge signatures on  an
  356.           old session.
  357.      ----nnnnoooo----sssspppplllliiiitttt----ssssyyyymmmmlllliiiinnnnkkkk----ccccoooommmmppppoooonnnneeeennnnttttssss
  358.           Don't split the SL components, but  begin  a  new  Con-
  359.           tinuation Area (CE) instead. This may waste some space,
  360.           but the SunOS 4.1.4 cdrom driver has a bug  in  reading
  361.           split SL components (link_size = component_size instead
  362.           of link_size += component_size).
  363.      ----nnnnoooo----sssspppplllliiiitttt----ssssyyyymmmmlllliiiinnnnkkkk----ffffiiiieeeellllddddssss
  364.           Don't split the SL fields, but begin a new Continuation
  365.           Area  (CE)  instead. This may waste some space, but the
  366.           SunOS 4.1.4 and Solaris 2.5.1 cdrom driver have  a  bug
  367.           in reading split SL fields (a `/' can be dropped).
  368.      ----oooo _f_i_l_e_n_a_m_e
  369.           is the name of the file to which the iso9660 filesystem
  370.           image  should  be  written.  This can be a disk file, a
  371.           tape drive, or it can correspond directly to the device
  372.           name  of  the  optical  disc writer.  If not specified,
  373.           stdout is used.  Note that the output  can  also  be  a
  374. Version 1.12b5      Last change: 7. Jan 2000                    8
  375. MKISOFS(8)           Maintenance Procedures            MKISOFS(8)
  376.           block special device for a regular disk drive, in which
  377.           case the disk partition can be mounted and examined  to
  378.           ensure that the premastering was done correctly.
  379.      ----ppppaaaatttthhhh----lllliiiisssstttt _f_i_l_e
  380.           A file containing a list of  _p_a_t_h_s_p_e_c  directories  and
  381.           filenames  to  be added to the ISO9660 filesystem. This
  382.           list of pathspecs are processed after any  that  appear
  383.           on  the  command  line.  If the argument is -, then the
  384.           list is read from the standard input. There must be  at
  385.           least one _p_a_t_h_s_p_e_c given on the command line as well.
  386.      ----PPPP _p_u_b_l_i_s_h_e_r__i_d
  387.           Specifies a text string that will be written  into  the
  388.           volume  header.   This should describe the publisher of
  389.           the CDROM, usually with a  mailing  address  and  phone
  390.           number.   There is space on the disc for 128 characters
  391.           of information.  This parameter can also be set in  the
  392.           file  ....mmmmkkkkiiiissssooooffffssssrrrrcccc  with  PUBL=.   If  specified  in both
  393.           places, the command line version is used.
  394.      ----pppp _p_r_e_p_a_r_e_r__i_d
  395.           Specifies a text string that will be written  into  the
  396.           volume  header.   This  should describe the preparer of
  397.           the CDROM, usually with a  mailing  address  and  phone
  398.           number.   There is space on the disc for 128 characters
  399.           of information.  This parameter can also be set in  the
  400.           file  ....mmmmkkkkiiiissssooooffffssssrrrrcccc  with  PREP=.   If  specified  in both
  401.           places, the command line version is used.
  402.      ----pppprrrriiiinnnntttt----ssssiiiizzzzeeee
  403.           Print estimated filesystem size and exit.  This  option
  404.           is  needed  for  Disk  At  Once mode and with some CD-R
  405.           drives when piping directly into ccccddddrrrreeeeccccoooorrrrdddd.... In this case
  406.           it  is needed to know the size of the filesystem before
  407.           the actual CD-creation is done.  The option -print-size
  408.           allows  to get this size from a "dry-run" before the CD
  409.           is actually written.
  410.      ----RRRR    Generate SUSP and RR records using the Rock Ridge pro-
  411.           tocol  to  further  describe  the  files on the iso9660
  412.           filesystem.
  413.      ----rrrr    This is like the -R option,  but  file  ownership  and
  414.           modes  are  set to more useful values.  The uid and gid
  415.           are set to zero, because they are usually  only  useful
  416.           on  the  author's system, and not useful to the client.
  417.           All the file read bits are set true, so that files  and
  418.           directories  are  globally  readable on the client.  If
  419.           any execute bit is set for a file, set all of the  exe-
  420.           cute  bits, so that executables are globally executable
  421.           on the  client.   If  any  search  bit  is  set  for  a
  422. Version 1.12b5      Last change: 7. Jan 2000                    9
  423. MKISOFS(8)           Maintenance Procedures            MKISOFS(8)
  424.           directory,  set  all of the search bits, so that direc-
  425.           tories are globally  searchable  on  the  client.   All
  426.           write  bits  are  cleared,  because  the CD-Rom will be
  427.           mounted read-only in any case.  If any of  the  special
  428.           mode  bits  are set, clear them, because file locks are
  429.           not useful on a read-only file system, and set-id  bits
  430.           are not desirable for uid 0 or gid 0.
  431.      ----ssssyyyyssssiiiidddd _I_D
  432.           Specifies the system ID.  This parameter  can  also  be
  433.           set  in  the  file  ....mmmmkkkkiiiissssooooffffssssrrrrcccc with SYSI=system_id.  If
  434.           specified in both places, the command line  version  is
  435.           used.
  436.      ----TTTT    Generate a file TRANS.TBL in  each  directory  on  the
  437.           CDROM, which can be used on non-Rock Ridge capable sys-
  438.           tems to help establish the correct file  names.   There
  439.           is  also information present in the file that indicates
  440.           the major and minor numbers  for  block  and  character
  441.           devices, and each symlink has the name of the link file
  442.           given.
  443.      ----ttttaaaabbbblllleeee----nnnnaaaammmmeeee _T_A_B_L_E__N_A_M_E
  444.           Alternative translation table file  name  (see  above).
  445.           Implies  the   ----TTTT option.  If you are creating a multi-
  446.           session image you must use the same name as in the pre-
  447.           vious session.
  448.      ----UUUU    Allows "Untranslated" filenames, completely  violating
  449.           the  iso9660  standards  described above. Forces on the
  450.           -d, -l, -L and -N flags, and also allows more than  one
  451.           '.'  character  in  the filename, as well as mixed case
  452.           filenames.  This is useful on HP-UX system,  where  the
  453.           built-in  CDFS filesystem does not recognize ANY exten-
  454.           sions. Use with extreme caution.
  455.      ----VVVV _v_o_l_i_d
  456.           Specifies the volume ID to be written into  the  master
  457.           block.   This  parameter  can  also  be set in the file
  458.           ....mmmmkkkkiiiissssooooffffssssrrrrcccc with VOLI=id.  If specified in both  places,
  459.           the  command  line  version  is used.  Note that if you
  460.           assign a volume ID, this is the name that will be  used
  461.           as  the  mount point used by the Solaris volume manage-
  462.           ment system and the name that is assigned to  the  disc
  463.           on a Windows or Mac platform.
  464.      ----vvvvoooollllsssseeeetttt _I_D
  465.           Specifies the volset ID.  This parameter  can  also  be
  466.           set  in  the  file  ....mmmmkkkkiiiissssooooffffssssrrrrcccc with VOLS=volset_id.  If
  467.           specified in both places, the command line  version  is
  468.           used.
  469. Version 1.12b5      Last change: 7. Jan 2000                   10
  470. MKISOFS(8)           Maintenance Procedures            MKISOFS(8)
  471.      ----vvvvoooollllsssseeeetttt----ssssiiiizzzzeeee #
  472.           Sets the volume set size to #. The volume set  size  is
  473.           the  number of CD's that are in a CD set.  The ----vvvvoooollllsssseeeetttt----
  474.           ssssiiiizzzzeeee option may be used to create CD's that are part of
  475.           e.g.  a Operation System installation set of CD's.  The
  476.           option ----vvvvoooollllsssseeeetttt----ssssiiiizzzzeeee must be specified before  ---- vvvvoooollllsssseeeetttt----
  477.           sssseeeeqqqqnnnnoooo on each command line.
  478.      ----vvvvoooollllsssseeeetttt----sssseeeeqqqqnnnnoooo #
  479.           Sets the volume set sequence number to  #.  The  volume
  480.           set  sequence number is the index number of the current
  481.           CD in a CD set.  The option ----vvvvoooollllsssseeeetttt----ssssiiiizzzzeeee must be speci-
  482.           fied before ----vvvvoooollllsssseeeetttt----sssseeeeqqqqnnnnoooo on each command line.
  483.      ----vvvv    Verbose execution.
  484.      ----xxxx _p_a_t_h
  485.           Exclude _p_a_t_h from being written to CDROM.  _p_a_t_h must be
  486.           the  complete  pathname that results from concatenating
  487.           the pathname given as command  line  argument  and  the
  488.           path relative to this directory.  Multiple paths may be
  489.           excluded (up to 1000).  Example:
  490.           mkisofs -o cd -x /local/dir1 -x /local/dir2 /local
  491.           NOTE: The -m and -x option description should  both  be
  492.           updated,  they  are wrong.  Both now work identical and
  493.           use filename globbing. A file is excluded if either the
  494.           last component matches or the whole path matches.
  495.       ---- zzzz    Generate  special  SUSP  records  for  transparently
  496.           compressed files.  This is only of use and interest for
  497.           hosts that support transparent decompression.  This  is
  498.           an experimental feature, and no hosts yet support this,
  499.           but there are ALPHA patches for Linux that can make use
  500.           of this feature.
  501. BBBBOOOOOOOOTTTT IIIINNNNFFFFOOOORRRRMMMMAAAATTTTIIIIOOOONNNN TTTTAAAABBBBLLLLEEEE
  502.      When the ----bbbbooooooootttt----iiiinnnnffffoooo----ttttaaaabbbblllleeee  option  is  given,  mmmmkkkkiiiissssooooffffssss  will
  503.      modify the boot file specified by the ----bbbb option by inserting
  504.      a 56-byte "boot information table" at offset 8 in the  file.
  505.      This  modification is done in the source filesystem, so make
  506.      sure you use a copy if this file is  not  easily  recreated!
  507.      This file contains pointers which may not be easily or reli-
  508.      ably obtained at boot time.
  509.      The format of this table is as follows; all integers are  in
  510.      section 7.3.1 ("little endian") format.
  511.        Offset    Name           Size      Meaning
  512.         8        bi_pvd         4 bytes   LBA of primary volume descriptor
  513.        12        bi_file        4 bytes   LBA of boot file
  514. Version 1.12b5      Last change: 7. Jan 2000                   11
  515. MKISOFS(8)           Maintenance Procedures            MKISOFS(8)
  516.        16        bi_length      4 bytes   Boot file length in bytes
  517.        20        bi_csum        4 bytes   32-bit checksum
  518.        24        bi_reserved    40 bytes  Reserved
  519.      The 32-bit checksum is the sum of all the  32-bit  words  in
  520.      the  boot file starting at byte offset 64.  All linear block
  521.      addresses (LBAs) are given  in  CD  sectors  (normally  2048
  522.      bytes).
  523. CCCCOOOONNNNFFFFIIIIGGGGUUUURRRRAAAATTTTIIIIOOOONNNN
  524.      mmmmkkkkiiiissssooooffffssss looks for the ....mmmmkkkkiiiissssooooffffssssrrrrcccc file, first in the  current
  525.      working  directory,  then  in the user's home directory, and
  526.      then in the directory in which the mmmmkkkkiiiissssooooffffssss binary is stored.
  527.      This  file  is  assumed  to contain a series of lines of the
  528.      form TTTTAAAAGGGG====_v_a_l_u_e, and in this  way  you  can  specify  certain
  529.      options.   The  case  of  the  tag is not significant.  Some
  530.      fields in the volume header are not settable on the  command
  531.      line,  but  can  be altered through this facility.  Comments
  532.      may be placed in this file, using lines which start  with  a
  533.      hash (#) character.
  534.      AAAAPPPPPPPPIIII The application identifier should describe the applica-
  535.           tion  that  will be on the disc.  There is space on the
  536.           disc for 128 characters of information.  May  be  over-
  537.           ridden using the ----AAAA command line option.
  538.      CCCCOOOOPPPPYYYY The copyright information, often the name of a file  on
  539.           the  disc  containing  the  copyright notice.  There is
  540.           space in the disc for  37  characters  of  information.
  541.           May  be  overridden  using  the ----ccccooooppppyyyyrrrriiiigggghhhhtttt command line
  542.           option.
  543.      AAAABBBBSSSSTTTT The abstract information, often the name of a  file  on
  544.           the disc containing an abstract.  There is space in the
  545.           disc for 37 characters of information.  May be overrid-
  546.           den using the ----aaaabbbbssssttttrrrraaaacccctttt command line option.
  547.      BBBBIIIIBBBBLLLL The bibliographic information, often the name of a file
  548.           on  the disc containing a bibliography.  There is space
  549.           in the disc for 37 characters of information.   May  be
  550.           overridden using the ----bbbbiiiilllliiiioooo command line option.
  551.      PPPPRRRREEEEPPPP This should describe the preparer of the CDROM, usually
  552.           with  a  mailing  address  and  phone number.  There is
  553.           space on the disc for 128  characters  of  information.
  554.           May be overridden using the ----pppp command line option.
  555.      PPPPUUUUBBBBLLLL This should describe the publisher of the  CDROM,  usu-
  556.           ally with a mailing address and phone number.  There is
  557.           space on the disc for 128  characters  of  information.
  558.           May be overridden using the ----PPPP command line option.
  559. Version 1.12b5      Last change: 7. Jan 2000                   12
  560. MKISOFS(8)           Maintenance Procedures            MKISOFS(8)
  561.      SSSSYYYYSSSSIIII The System Identifier.  There is space on the disc  for
  562.           32  characters of information.  May be overridden using
  563.           the ----ssssyyyyssssiiiidddd command line option.
  564.      VVVVOOOOLLLLIIII The Volume Identifier.  There is space on the disc  for
  565.           32  characters of information.  May be overridden using
  566.           the ----VVVV command line option.
  567.      VVVVOOOOLLLLSSSS The Volume Set Name.  There is space on  the  disc  for
  568.           128 characters of information.  May be overridden using
  569.           the ----vvvvoooollllsssseeeetttt command line option.
  570.      mmmmkkkkiiiissssooooffffssss can also be configured at compile time with defaults
  571.      for many of these fields.  See the file defaults.h.
  572. AAAAUUUUTTTTHHHHOOOORRRR
  573.      mmmmkkkkiiiissssooooffffssss is not based on the standard mk*fs tools  for  unix,
  574.      because  we  must  generate  a complete  copy of an existing
  575.      filesystem on a disk in the  iso9660 filesystem.   The  name
  576.      mkisofs  is  probably a bit of a misnomer, since it not only
  577.      creates the filesystem, but it also populates it as well.
  578.      Eric Youngdale <ericy@gnu.ai.mit.edu> or  <eric@andante.org>
  579.      wrote  both  the  Linux isofs9660 filesystem and the mkisofs
  580.      utility.  The copyright for the mkisofs utility is  held  by
  581.      Yggdrasil Computing, Incorporated.
  582. NNNNOOOOTTTTEEEESSSS
  583.      MMMMkkkkiiiissssooooffffssss may safely be  installed  suid  root.  This  may  be
  584.      needed  to  allow  mmmmkkkkiiiissssooooffffssss to read the previous session when
  585.      creating a multi session image.
  586. BBBBUUUUGGGGSSSS
  587.      +o     Any files that have hard links to  files  not  in  the
  588.           tree  being  copied to the iso9660 filesystem will have
  589.           an incorrect file reference count.
  590.      +o     Does not check for SUSP record(s) in "." entry of  the
  591.           root  directory  to  verify the existence of Rock Ridge
  592.           enhancements.
  593.           This problem is present when reading old sessions while
  594.           adding data in multi-session mode.
  595.       +o     Does  not  properly  read  relocated  directories  in
  596.           multi-session mode when adding data.
  597.           Any relocated deep directory is lost if the new session
  598.           does not include the deep directory.
  599.           Repeat by: create first  session  with  deep  directory
  600.           relocation  then add new session with a single dir that
  601. Version 1.12b5      Last change: 7. Jan 2000                   13
  602. MKISOFS(8)           Maintenance Procedures            MKISOFS(8)
  603.           differs from the old deep path.
  604.      +o     Does not re-use RR_MOVED when doing multi-session from
  605.           TRANS.TBL
  606.      +o     Does not  create  whole_name  entry  for  RR_MOVED  in
  607.           multi-session mode.
  608.      There may be some other ones.  Please, report  them  to  the
  609.      author.
  610. FFFFUUUUTTTTUUUURRRREEEE IIIIMMMMPPPPRRRROOOOVVVVEEEEMMMMEEEENNNNTTTTSSSS
  611.      Some sort of gui interface.
  612. AAAAVVVVAAAAIIIILLLLAAAABBBBIIIILLLLIIIITTTTYYYY
  613.      mmmmkkkkiiiissssooooffffssss is available for anonymous ftp  from  tsx-11.mit.edu
  614.      in /pub/linux/packages/mkisofs and many other mirror sites.
  615. MMMMAAAAIIIILLLLIIIINNNNGGGG LLLLIIIISSSSTTTTSSSS
  616.      If you want to actively take  part  on  the  development  of
  617.      mkisofs,  you may join the cdwriting mailing list by sending
  618.      mail to:
  619.                other-cdwrite-request@lists.debian.org
  620.      and include the  word  _s_u_b_s_c_r_i_b_e  in  the  body.   The  mail
  621.      address of the list is:
  622.                cdwrite@lists.debian.org
  623. MMMMAAAAIIIINNNNTTTTAAAAIIIINNNNEEEERRRR
  624.      Joerg Schilling
  625.      Seestr. 110
  626.      D-13353 Berlin
  627.      Germany
  628.      Mail bugs and suggestions to:
  629.      sssscccchhhhiiiilllllllliiiinnnngggg@@@@ffffooookkkkuuuussss....ggggmmmmdddd....ddddeeee     or     jjjjssss@@@@ccccssss....ttttuuuu----bbbbeeeerrrrlllliiiinnnn....ddddeeee      or
  630.      jjjjooooeeeerrrrgggg@@@@sssscccchhhhiiiillllyyyy....iiiissssddddnnnn....ccccssss....ttttuuuu----bbbbeeeerrrrlllliiiinnnn....ddddeeee
  631. Version 1.12b5      Last change: 7. Jan 2000                   14