|
| 1 | +.\" This is -*-nroff-*- |
| 2 | +.\" $Header: /cvsroot/pgsql/src/man/Attic/initlocation.1,v 1.1 1997/11/07 06:40:45 thomas Exp $ |
| 3 | +.TH INITDB UNIX 11/05/97 PostgreSQL |
| 4 | +.SH NAME |
| 5 | +initlocation\(em create a new Postgres storage area |
| 6 | +.SH SYNOPSIS |
| 7 | +.BR"initlocation" |
| 8 | +.IR"directory" |
| 9 | +.PP |
| 10 | +.BR"initlocation" |
| 11 | +.IR"$environment_variable" |
| 12 | + |
| 13 | +.SH DESCRIPTION |
| 14 | +.IR initlocation |
| 15 | +creates a new Postgres database storage area. A storage area contains |
| 16 | +distinct Postgres databases, with each database in a separate directory |
| 17 | +and managed by a single postmaster. |
| 18 | +.PP |
| 19 | +Creating a database storage area consists of creating the directories in which |
| 20 | +the database data will live. |
| 21 | +There are 2 types of arguments for |
| 22 | +.IR initlocation. |
| 23 | +First, you can specify an explicit |
| 24 | +absolute path to the top directory of the storage area. |
| 25 | +Second, you can specify an environment variable (e.g. $PGDATA2). |
| 26 | +This environment variable should be known to the backend for later use in |
| 27 | +.IR"create database". |
| 28 | +In either case Postgres will add /base/ |
| 29 | +to the specified path to create the storage area. |
| 30 | + |
| 31 | +.SH "SEE ALSO" |
| 32 | +create_database(l), |
| 33 | +initdb(1). |