The coll.conf file
The current way that we use depot involves a script which generates the depot.pref file based on various configuration files.
The primary configuration file is /usr/local/depot/depot.pref.global. This file is common among all machines of a given architecture and contains directives that apply to all those machines. The file /usr/local/depot/depot.pref.local is different on each host and contains depot directives that only apply to that host.
In addition to those, there is also a configuration file in each misc collection named /afs/cs.cmu.edu/local/collection/common/conf/coll.conf
The directory that this file is in is supposed to be writable by the collection maintainer. If your collection's coll.conf is not writable by you, please send mail to firstname.lastname@example.org and we will fix this.
The syntax of the coll.conf file is very simple. At the top of the file there should be a line of the form
systypes list_of_systypesThis says which kinds of machines the collection should be valid on. A typical collection which is valid for all of the currently-supported architectures would have:
systypesThe rest of the lines in the "coll.conf" file should be "contents" lines, which describe what lines should be added to the depot.pref file in order to find all the pieces of this collection. The format of these lines is
on systype contents release list_of_subdirsThe "on systype" part is optional. If present, it causes the line to only apply to the specified systype. If absent, the line applies to all valid systypes (as listed in the "systypes" line.
If the release part is "all", then the line describes the contents of all releases. The tokens "@sys" and "@release" are expanded into the systype and release-level that each host is depoting that collection at, respectively.
The list of subdirs is used to tell depot what depot-collections should be created from this misc-collection. The primary reason why there would be more than one depot-collection per misc-collection is to add in a common area. The generated depot-collections are named "collection/n", where n is just the zero-indexed location of that subdir in the list.
systypes i386_fc5 sun4x_59 contents all @sys/omegaThis means that for Redhat FC5, the collection is found in /afs/cs.cmu.edu/local/collection-name/i386_fc5/omega, and for Solaris 9 it's in /afs/cs.cmu.edu/local/collection-name/sun4x_59/omega, for all releases of the collection. This is approximately what most volunteer misc maintainers should be using, unless they are going to populate the alpha and beta releases(of course you can add additional common areas with "common/omega" or such as detailed further on).
systypes i386_fc5 sun4x_59 contents all @sys/@release all_mach/@releaseThis means that there are two "depot collections" generated for this misc collection. For a beta-release Redhat FC5 host, these are: /afs/cs.cmu.edu/local/collection-name/i386_fc5/beta and /afs/cs.cmu.edu/local/collection-name/all_mach/beta. For an omega-release Solaris 9 host, these are: /afs/cs.cmu.edu/local/collection-name/sun4x_59/omega and /afs/cs.cmu.edu/local/collection-name/all_mach/omega. And so on for alpha release on both systypes.
systypes i386_fc5 sun4x_59 contents all @sys/omega on sun4x_59 contents alpha @sys/@release common/@releaseThis means that the collection is valid on Redhat FC5 and Solaris 9 The contents of the collection will be /afs/cs.cmu.edu/local/collection-name/@sys/omega on everything except alpha-release Solaris 9, for which the contents will be /afs/cs.cmu.edu/local/collection-name/sun4x_59/alpha and /afs/cs.cmu.edu/local/collection-name/common/alpha.