/[debburn]/nonameyet/trunk/mkisofs/mkisofs.8
ViewVC logotype

Diff of /nonameyet/trunk/mkisofs/mkisofs.8

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

revision 38 by blade, Wed Aug 23 12:34:49 2006 UTC revision 39 by blade, Wed Aug 23 12:39:11 2006 UTC
# Line 825  Outdated option reserved by POSIX.1-2001 Line 825  Outdated option reserved by POSIX.1-2001
825  instead.  instead.
826  This option will get POSIX.1-2001 semantics with mkisofs-2.02.  This option will get POSIX.1-2001 semantics with mkisofs-2.02.
827  .TP  .TP
828    .BI \-jigdo\-jigdo " jigdo_file
829    Produce a jigdo .jigdo file as well as the .iso. See the
830    .B JIGDO NOTES
831    section below for more information.
832    .TP
833    .BI \-jigdo\-template " template_file
834    Produce a jigdo .template file as well as the .iso. See the
835    .B JIGDO NOTES
836    section below for more information.
837    .TP
838    .BI \-jigdo\-min\-file\-size " size
839    Specify the minimum size for a file to be listed in the .jigdo
840    file. Default (and minimum allowed) is 1KB. See the
841    .B JIGDO NOTES
842    section below for more information.
843    .TP
844    .BI \-jigdo\-force\-md5 " path
845    Specify a file pattern where files MUST be contained in the
846    externally-suplied MD5 list as supplied by \-md5\-list. See the
847    .B JIGDO NOTES
848    section below for more information.
849    .TP
850    .BI \-jigdo\-exclude " path
851    Specify a file pattern where files will not be listed in the .jigdo
852    file. See the
853    .B JIGDO NOTES
854    section below for more information.
855    .TP
856    .BI \-jigdo\-map " path
857    Specify a pattern mapping for the jigdo file
858    (e.g. Debian=/mirror/debian). See the
859    .B JIGDO NOTES
860    section below for more information.
861    .TP
862    .BI \-md5\-list " md5_file
863    Specify a file containing the MD5sums, sizes and pathnames of the
864    files to be included in the .jigdo file. See the
865    .B JIGDO NOTES
866    section below for more information.
867    .TP
868  .BI \-log\-file " log_file  .BI \-log\-file " log_file
869  Redirect all error, warning and informational messages to  Redirect all error, warning and informational messages to
870  .I log_file  .I log_file
# Line 2458  kernel, and the choice of which one to u Line 2498  kernel, and the choice of which one to u
2498  firmware. Optionally, a ramdisk can be used for the root filesystem  firmware. Optionally, a ramdisk can be used for the root filesystem
2499  using  using
2500  .B \-hppa\-cmdline.  .B \-hppa\-cmdline.
2501    .SH "JIGDO NOTES"
2502    Jigdo is a useful tool to help in the distribution of large files like CD and
2503    DVD images. See Richard Atterer's site for more details. Debian CDs and DVD ISO
2504    images are published on the web in jigdo format to allow end users to download
2505    them more efficiently.
2506    .PP
2507    To create jigdo and template files alongside the ISO image from
2508    mkisofs, you must first generate a list of the files that will be
2509    used, in the following format:
2510    .sp
2511    .RS +.2i
2512    .ta 2.0i 2.0i 5.0i
2513    .nf
2514    MD5sum   File size  Path
2515    32 chars 12 chars   to end of line
2516    .fi
2517    .RE
2518    .sp
2519    The MD5sum should be written in jigdo's pseudo-base64 format. The file
2520    size should be in decimal, and the path to the file must be absolute.
2521    .PP
2522    Once you have this file, call mkisofs with all of your normal command
2523    line parameters. Specify the output filenames for the jigdo and
2524    template files using \-jigdo\-jigdo and \-jigdo\-template, and pass in
2525    the location of your MD5 list with the \-md5\-list option.
2526    .PP
2527    If there are files that you do NOT want to be added into the jigdo
2528    file (e.g. if they are likely to change often), specify them using
2529    \-jigdo\-ignore. If you want to verify some of the files as they are
2530    written into the image, specify them using \-jigdo\-force\-md5. If any
2531    files don't match, mkisofs will then abort. Both of these options take
2532    regular expressions as input. It is possible to restrict the set of
2533    files that will be used further based on size - use the
2534    \-jigdo\-min\-file\-size option.
2535    .PP
2536    Finally, the jigdo code needs to know how to map the files it is given
2537    onto a mirror-style configuration. Specify how to map paths using the
2538    \-jigdo\-map option. Using "Debian=/mirror/debian" will cause all
2539    paths starting with "/mirror/debian" to be mapped to "Debian:<file>"
2540    in the output jigdo file.
2541  .SH CONFIGURATION  .SH CONFIGURATION
2542  .B mkisofs  .B mkisofs
2543  looks for the  looks for the
Legend:
Removed from v.38  
changed lines
  Added in v.39
  ViewVC Help
Powered by ViewVC 1.1.5