Provided by: jigit_1.20-2ubuntu1_i386 bug

NAME

       mkjigsnap - Create a snapshot tree on a jigdo server

SYNOPSIS

       mkjigsnap  [OPTIONS] <-d snapshot_dir> <-j jigdo_file> <-k keyword> <-m
       mirror> <-n CD_name> <-o output_directory> <-t template_file>
       mkjigsnap [OPTIONS] <-b backref_file> <-d snapshot_dir> <-m mirror> <-J
       jigdo_list> <-j jigdo_file> <-k keyword>

DESCRIPTION

       mkjigsnap creates snapshot directories for use by other jigdo tools. It
       can be run in two distinct modes:

   Jigit / single-jigdo mode
       To build a jigit .conf file for a  single  jigdo  file:  add  the  "-n"
       option  with  a  CD  name on the command line and only specify a single
       jigdo to work with using "-j".

       Required arguments for this mode:

       -d snapshot_dir
              Specify the output directory name to be used  for  the  snapshot
              tree  (e.g.  20041011,  rc1).  In single-jigdo mode this will be
              relative to the output directory.

       -j jigdo_file
              Specify the location of the jigdo file to be used.

       -m mirror
              Specify the location of the  mirror  containing  all  the  files
              needed.  This  must  be  on  the  same  filesystem as the output
              directory, as hard links will be used  to  create  the  snapshot
              efficiently.

       -n CD_name
              Specify  the output name of the CD for jigit (e.g. warty, sarge-
              i386-1).

       -o output_directory
              Specify the output location for the jigdo,  template,  conf  and
              snapshot.  This must be on the same filesystem as the mirror, as
              hard links will be used to create the snapshot efficiently.

       -t template_file
              Specify the location of the template file to be used.

   Multi-jigdo mode
       To build a snapshot tree for (potentially multiple) jigdo files: do not
       specify  the  "-n"  option,  and  list  as many jigdo files as desired,
       either on the command line  using  multiple  "-j  <jigdo>"  options  or
       (better) via a file listing them with the "-J" option.

       Required arguments for this mode:

       -d snapshot_dir
              Specify  the  output  directory name to be used for the snapshot
              tree (e.g. 20041011, rc1).

       -J jigdo_list
              Specify the location of a file listing the  jigdo  files  to  be
              used.  May be repeated multiple times for multiple list files if
              desired.

       -j jigdo_file
              Specify the location of the  jigdo  file  to  be  used.  May  be
              repeated  multiple  times  for  multiple  jigdo  files, but it's
              better to use the "-J" option to point at a  file  containing  a
              list of jigdo files instead.

       -k keyword
              Specify  the  "keywords" which are used in the jigdo files (e.g.
              Debian, Non-US, Ubuntu).

       -m mirror
              Specify the location of the  mirror  containing  all  the  files
              needed.  This  must  be  on  the same filesystem as the snapshot
              directory, as hard links will be used  to  create  the  snapshot
              efficiently.

   Options
       Optional arguments for both modes:

       -b backref_file
              If  using  a  fail_log,  also  keep  track  of which jigdo files
              correspond to each missing file, and output the details  in  the
              backref_file.

       -f fail_log
              If  any  files  are required by the specific jigdo files but are
              not available in the  mirror,  list  them  in  the  output  file
              fail_log for reference.

       -i ignore_list
              If  any  files  are required by the specific jigdo files but are
              not available in the mirror, list them in the  ignore_list  file
              to supress errors about them.

EXAMPLES

       mkjigsnap -o /tmp/mjs-test -n mjs-test -m /tmp/mirror -j
              ~/jigdo/update/debian-update-3.0r2.01-i386.jigdo              -t
              ~/jigdo/update/debian-update-3.0r2.01-i386.template -k Debian -k
              Non-US -d 20041017

              This command is an example of single-jigdo mode, used for Ubuntu
              jigit generation. It creates a single jigit conf file using  the
              supplied  jigdo/template file pair, looking for jigdo references
              to files in the "Debian" and "Non-US" areas.  Output  the  files
              into  /tmp/mjs-test  and  call them "mjs-test.<ext>", creating a
              snapshot  of  the  needed  files  in  /tmp/mjs-test/20041017  by
              linking files from /tmp/mirror as needed.

       mkjigsnap -m /org/ftp/debian -J ~/jigdo.list -k Debian
              -d  /org/jigdo-area/snapshot/Debian -f ~/mkjigsnap-failed.log -i
              ~/mkjigsnap-ignore.list

              This command is an example of multi-jigdo mode, as run  to  keep
              http://us.cdimage.debian.org/cdimage/snapshot/  up to date. This
              reads in all the jigdo files listed in ~/jigdo.list, building  a
              list  of  all the files referenced in the "Debian" area. It will
              then attempt to build a snapshot tree of all those  files  under
              /org/jigdo-area/snapshot/Debian by linking from /org/ftp/debian.
              Any files that are  missing  will  be  listed  into  the  output
              "missing" file ~/mkjigsnap-failed.log for later checking, UNLESS
              they are  already  listed  in  the  "ignore"  file  ~/mkjigsnap-
              ignore.list.

SEE ALSO

       jigdo-file(1), jigit(1), jigdump(1) and mkimage(1).

COPYRIGHT

       Copyright 2004 - 2014 Steve McIntyre (steve@einval.com)

       mkjigsnap  may be copied under the terms and conditions of version 2 of
       the GNU General Public License,  as  published  by  the  Free  Software
       Foundation (Cambridge, MA, USA).

AUTHOR

       Written by Steve McIntyre (steve@einval.com)