home *** CD-ROM | disk | FTP | other *** search
/ PC Online 1999 November / PCONLINE_11_99.ISO / filesbbs / OS2 / CDR18A24.ZIP / doc / mkisofs.man < prev    next >
Encoding:
Text File  |  1999-03-07  |  31.7 KB  |  661 lines

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