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)