Ubuntu Manpage: mkjigsnap - Create a snapshot tree on a jigdo server

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] <-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:

-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.

COPYRIGHT

       Copyright 2004 - 2011 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