1 # generic netboot image specfile
2 # used to build a network bootable image
4 # The subarch can be any of the supported catalyst subarches (like athlon-xp).
5 # Refer to the catalyst reference manual for suppurted subarches.
6 # http://www.gentoo.org/proj/en/releng/catalyst/
11 # The version stamp is an identifier for the build. It can be anything you wish# it to be, but it is usually a date.
13 # version_stamp: 2006.1
16 # The target specifies what target we want catalyst to do. For building a
17 # netboot image, we use the netboot target.
22 # The rel_type defines what kind of build we are doing. This is merely another
23 # identifier, but it useful for allowing multiple concurrent builds. Usually,
24 # default will suffice.
29 # This is the system profile to be used by catalyst to build this target. It is# specified as a relative path from /usr/portage/profiles.
31 # profile: default-linux/x86/2006.1
34 # This specifies which snapshot to use for building this target.
39 # This specifies where the seed stage comes from for this target, The path is
40 # relative to $clst_sharedir/builds. The rel_type is also used as a path prefix# for the seed.
42 # default/stage3-x86-2006.1
45 # These are the hosts used as distcc slaves when distcc is enabled in your
46 # catalyst.conf. It follows the same syntax as distcc-config --set-hosts and
47 # is entirely optional.
49 # distcc_hosts: 127.0.0.1 192.168.0.1
52 # This is an optional directory containing portage configuration files. It
53 # follows the same syntax as /etc/portage and should be consistent across all
54 # targets to minimize problems.
56 # portage_confdir: /etc/portage
59 # This option specifies the location to a portage overlay that you would like to
60 # have used when building this target.
62 # portage_overlay: /usr/local/portage
65 # This allows the optional directory containing the output packages for
66 # catalyst. Mainly used as a way for different spec files to access the same
67 # cache directory. Default behavior is for this location to be autogenerated
68 # by catalyst based on the spec file.
70 # pkgcache_path: /tmp/packages
73 # This allows the optional directory containing the output packages for kernel
74 # builds. Mainly used as a way for different spec files to access the same
75 # cache directory. Default behavior is for this location to be autogenerated
76 # by catalyst based on the spec file.
78 # kerncache_path: /tmp/kernel
81 # This option tells catalyst which kernel sources to merge for building this
82 # image. This can use normal portage atoms to specify a specific version.
84 # netboot/kernel/sources: gentoo-sources
85 netboot/kernel/sources:
87 # This option is the full path and filename to a kernel .config file that is
88 # used by genkernel to compile the kernel for this image.
90 # netboot/kernel/config: /tmp/2.6.11-netboot.config
91 netboot/kernel/config:
93 # This option sets the USE flags used to build the kernel. These USE flags are
94 # additive from the default USE for the specified profile.
96 # netboot/kernel/use: ultra1
99 # This option sets the USE flags with which the optional packages below are
100 # built. Like the kernel USE, they are additive.
105 # The netboot target builds busybox for its root filesystem. This option is
106 # where you specify the full path and filename to your busybox configuration.
108 # netboot/busybox_config: /tmp/busybox.config
109 netboot/busybox_config:
111 # This is the full path and filename to the tarball to use as the base for the
114 # netboot/base_tarball: /usr/lib/catalyst/netboot/netboot-base.tar.bz2
115 netboot/base_tarball:
117 # These are the packages that will be built for your netboot image using the USE
118 # flags set in netboot/use. These package names are also labels used later when
119 # determining what files to copy into your netboot image.
121 # netboot/packages: raidtools xfsprogs e2fsprogs reiserfsprogs
123 # This is where you tell catalyst which files from each package to copy into the
126 # netboot/packages/raidtools/files: /sbin/raidstart /sbin/mkraid /sbin/detect_multipath /sbin/raidreconf /sbin/raidstop /sbin/raidhotadd /sbin/raidhotremove /sbin/raidsetfaulty /sbin/raid0run
127 netboot/packages/raidtools/files:
129 # Here is the same thing for xfsprogs.
131 # netboot/packages/xfsprogs/files: /sbin/mkfs.xfs /sbin/xfs_repair /bin/xfs_check
132 netboot/packages/xfsprogs/files:
134 # Here is the same thing for e2fsprogs.
136 # netboot/packages/e2fsprogs/files: /sbin/mke2fs
137 netboot/packages/e2fsprogs/files:
139 # Here is the same thing for reiserfsprogs.
141 # netboot/packages/reiserfsprogs/files: /sbin/mkreiserfs
142 netboot/packages/reiserfsprogs/files:
144 # This is a list of any other files, not belonging to the above packages, that
145 # you would wish to have copied into your netboot image.
147 # netboot/extra_files: /lib/libresolv.so.2 /lib/libnss_compat.so.2 /lib/libnss_dns.so.2 /lib/libnss_files.so.2 /sbin/consoletype