configvers.h revision 211326
1/*- 2 * This file is in the public domain 3 * 4 * $FreeBSD: head/usr.sbin/config/configvers.h 211326 2010-08-15 08:49:07Z imp $ 5 */ 6 7/* 8 * 6 digits of version. The most significant are branch indicators at the 9 * time when the last incompatible change was made (which is why it is 10 * presently 6 on 7-current). The least significant digits are incremented 11 * as described below. The format is similar to the __FreeBSD_version, but 12 * not tied to it. 13 * 14 * DO NOT CASUALLY BUMP THIS NUMBER! The rules are not the same as shared 15 * libs or param.h/osreldate. 16 * 17 * It is the version number of the protocol between config(8) and the 18 * sys/conf/ Makefiles (the kernel build system). 19 * 20 * It is now also used to trap certain problems that the syntax parser cannot 21 * detect. 22 * 23 * Unfortunately, there is no version number for user supplied config files. 24 * 25 * Once, config(8) used to silently report errors and continue anyway. This 26 * was a huge problem for 'make buildkernel' which was run with the installed 27 * /usr/sbin/config, not a cross built one. We started bumping the version 28 * number as a way to trap cases where the previous installworld was not 29 * compatable with the new buildkernel. The buildtools phase and much more 30 * comprehensive error code returns solved this original problem. 31 * 32 * Most end-users will use buildkernel and the build tools from buildworld. 33 * The people that are inconvenienced by gratuitous bumps are developers 34 * who run config by hand. However, developers shouldn't gratuitously be 35 * inconvenienced. 36 * 37 * One should bump the CONFIGVERS in the following ways: 38 * 39 * (1) If you change config such that it won't read old config files, 40 * then bump the major number. You shouldn't be doing this unless 41 * you are overhauling config. Do not casually bump this number 42 * and by implication do not make changes that would force a bump 43 * of this number casually. You should limit major bumps to once 44 * per branch. 45 * (2) For each new feature added, bump the minor version of this file. 46 * When a new feature is actually used by the build system, update the 47 * %VERSREQ field in the Makefile.$ARCH of all the affected makefiles 48 * (typically all of them). 49 * 50 * $FreeBSD: head/usr.sbin/config/configvers.h 211326 2010-08-15 08:49:07Z imp $ 51 */ 52#define CONFIGVERS 600011 53#define MAJOR_VERS(x) ((x) / 100000) 54