|
1 | | -$Header: /cvsroot/pgsql/src/backend/catalog/README,v 1.2 2002/01/04 17:06:51 tgl Exp $ |
| 1 | +$Header: /cvsroot/pgsql/src/backend/catalog/README,v 1.3 2002/03/19 01:14:41 momjian Exp $ |
2 | 2 |
|
3 | 3 | This directory contains .c files that manipulate the system catalogs |
4 | 4 | as well as .h files that define the structure of the system catalogs. |
@@ -35,14 +35,22 @@ to a given tuple, then the OID may be set to the wildcard value 0 |
35 | 35 | If you need to find a valid OID for a set of tuples that refer to each |
36 | 36 | other, use the unused_oids script. It generates inclusive ranges of |
37 | 37 | *unused* OIDs (i.e., the line "45-900" means OIDs 45 through 900 have |
38 | | -not been allocated yet). However, you should not rely 100% on this |
39 | | -script, since it only looks at the .h files in the catalog/ directory. |
40 | | -Do a pg_grepsrc (recursive grep) of the source tree to insure that |
41 | | -there aren't any hidden crocks (i.e., explicit use of a numeric OID) |
42 | | -anywhere in the code. (tgl 1/2002: that advice is obsolete; there are |
43 | | -no hardcoded uses of OIDs in the C files anymore. All OIDs that are known |
44 | | -directly to C code should be referenced via #defines in the catalog .h files. |
45 | | -So unused_oids is sufficient for assigning new OIDs.) |
| 38 | +not been allocated yet). All OIDs that are known directly to C code |
| 39 | +should be referenced via #defines in the catalog .h files. So |
| 40 | +unused_oids is sufficient for assigning new OIDs.). The unused_oids |
| 41 | +script simply 'discovers' those which are free. |
| 42 | + |
| 43 | +- BOOTSTRAP tables must be at the start of the Makefile POSTGRES_BKI_SRCS |
| 44 | +variable, as these will not be created through standard function means, but |
| 45 | +will be written directly to disk. Thats how pg_class is created without |
| 46 | +depending on functions which depend on the existance of pg_class. The |
| 47 | +list of files this currently includes is: |
| 48 | +pg_proc.h pg_type.h pg_attribute.h pg_class.h |
| 49 | + |
| 50 | +Don't forget to add the entry to heap.c to function heap_create() which |
| 51 | +sets the OID of the relation when it's a bootstrapped system table. It's |
| 52 | +near the top of the function with the comment beginning in 'Real ugly stuff' |
| 53 | + |
46 | 54 |
|
47 | 55 | ----------------------------------------------------------------- |
48 | 56 |
|
|