postgresql/doc/man/template.5
1996-08-18 22:14:33 +00:00

66 lines
2.1 KiB
Groff

.\" This is -*-nroff-*-
.\" XXX standard disclaimer belongs here....
.\" $Header: /cvsroot/pgsql/doc/man/Attic/template.5,v 1.1.1.1 1996/08/18 22:14:28 scrappy Exp $
.TH TEMPLATE FILES 01/23/93 Postgres95 Postgres95
.SH Template
.SH NAME
\&.../data/files/global1.bki \(em global database template
.br
\&.../data/files/local1_XXX.bki \(em local database template
.br
\&.../data/files/template1/* \(em default database template
.SH DESCRIPTION
These files contain scripts which direct the construction of
databases. Note that the \*(lqglobal1.bki\*(rq and
\*(lqtemplate1_local.bki\*(rq files are installed automatically when
the Postgres super-user runs
.IR initdb .
These files are copied from
.nf
\&.../src/backend/obj/{dbdb,local}.bki
.fi
The databases which are generated by the template scripts are normal
databases. Consequently, you can use the terminal monitor or some
other frontend on a template database to simplify the customization
task. That is, there is no need to express everything about your
desired initial database state using a BKI template script, because
the database state can be tuned interactively.
.PP
The system catalogs consist of classes of two types: global and local.
There is one copy of each global class that is shared among all
databases at a site. Local classes, on the other hand, are not
accessible except from their own database.
.PP
The file
.nf
\&.../data/files/global1.bki
.fi
specifies the process used in the creation of global (shared) classes
by
.IR createdb .
Similarly, the
.nf
\&.../files/local1_XXX.bki
.fi
files specify the process used in the creation of local (unshared)
catalog classes for the \*(lqXXX\*(rq template database.
\*(lqXXX\*(rq may be any string of 16 or fewer printable characters.
If no template is specified in a
.IR createdb
command,
then the template in
.nf
\&.../files/local1_template1.bki
.fi
is used.
.PP
The .bki files are generated from C source code by an inscrutable set
of AWK scripts.
.SH BUGS
Postgres Version \*(PV does not permit users to have separate template
databases.
.SH "SEE ALSO"
bki(files),
initdb(1),
createdb(1).