in the future.
- Cluster all databases.
+ Cluster all databases.
- Specifies the name of the database to be clustered.
- If this is not specified and (or
- ) is not used, the database name is read
- from the environment variable PGDATABASE. If
- that is not set, the user name specified for the connection is
- used.
+ Specifies the name of the database to be clustered.
+ If this is not specified and (or
+ ) is not used, the database name is read
+ from the environment variable PGDATABASE. If
+ that is not set, the user name specified for the connection is
+ used.
Echo the commands that
clusterdb generates
- and sends to the server.
+ and sends to the server.
- Cluster table only.
+ Cluster table only.
- Specifies the host name of the machine on which the server is
- running. If the value begins with a slash, it is used as the
- directory for the Unix domain socket.
+ Specifies the host name of the machine on which the server is
+ running. If the value begins with a slash, it is used as the
+ directory for the Unix domain socket.
- Specifies the TCP port or local Unix domain socket file
- extension on which the server
- is listening for connections.
+ Specifies the TCP port or local Unix domain socket file
+ extension on which the server
+ is listening for connections.
dbname
- Specifies the name of the database to be removed.
+ Specifies the name of the database to be removed.
Echo the commands that
dropdb generates
- and sends to the server.
+ and sends to the server.
- Specifies the host name of the machine on which the
- server
- is running. If the value begins with a slash, it is used
- as the directory for the Unix domain socket.
+ Specifies the host name of the machine on which the
+ server
+ is running. If the value begins with a slash, it is used
+ as the directory for the Unix domain socket.
- Specifies the TCP port or local Unix domain socket file
- extension on which the server
- is listening for connections.
+ Specifies the TCP port or local Unix domain socket file
+ extension on which the server
+ is listening for connections.
langname
- Specifies the name of the backend programming language to be removed.
+ Specifies the name of the backend programming language to be removed.
- Specifies from which database the language should be removed.
+ Specifies from which database the language should be removed.
The default is to use the database with the same name as the
current system user.
- Specifies the host name of the machine on which the
- server
- is running. If host begins with a slash, it is used
- as the directory for the Unix domain socket.
+ Specifies the host name of the machine on which the
+ server
+ is running. If host begins with a slash, it is used
+ as the directory for the Unix domain socket.
- Specifies the Internet TCP/IP port or local Unix domain socket file
- extension on which the server
- is listening for connections.
+ Specifies the Internet TCP/IP port or local Unix domain socket file
+ extension on which the server
+ is listening for connections.
- Print debugging output from the bootstrap backend and a few other
+ Print debugging output from the bootstrap backend and a few other
messages of lesser interest for the general public.
- The bootstrap backend is the program initdb
- uses to create the catalog tables. This option generates a tremendous
- amount of extremely boring output.
+ The bootstrap backend is the program initdb
+ uses to create the catalog tables. This option generates a tremendous
+ amount of extremely boring output.
- By default, when initdb
- determines that an error prevented it from completely creating the database
- cluster, it removes any files it might have created before discovering
- that it cannot finish the job. This option inhibits tidying-up and is
- thus useful for debugging.
+ By default, when initdb
+ determines that an error prevented it from completely creating the database
+ cluster, it removes any files it might have created before discovering
+ that it cannot finish the job. This option inhibits tidying-up and is
+ thus useful for debugging.
- Specifies the file system location of the database files. If
- this is omitted, the environment variable
- PGDATA is used.
+ Specifies the file system location of the database files. If
+ this is omitted, the environment variable
+ PGDATA is used.
- Specifies the shutdown mode. mode
- can be smart, fast, or
- immediate, or the first letter of one of
- these three.
+ Specifies the shutdown mode. mode
+ can be smart, fast, or
+ immediate, or the first letter of one of
+ these three.
postgres command.
- The options are usually surrounded by single or double
- quotes to ensure that they are passed through as a group.
+ The options are usually surrounded by single or double
+ quotes to ensure that they are passed through as a group.
- Specifies the location of the postgres
- executable. By default the postgres executable is taken from the same
- directory as pg_ctl, or failing that, the hard-wired
- installation directory. It is not necessary to use this
- option unless you are doing something unusual and get errors
- that the postgres executable was not found.
+ Specifies the location of the postgres
+ executable. By default the postgres executable is taken from the same
+ directory as pg_ctl, or failing that, the hard-wired
+ installation directory. It is not necessary to use this
+ option unless you are doing something unusual and get errors
+ that the postgres executable was not found.
Attempt to allow server crashes to produce core files, on platforms
where this available, by lifting any soft resource limit placed on
- them.
- This is useful in debugging or diagnosing problems by allowing a
- stack trace to be obtained from a failed server process.
+ them.
+ This is useful in debugging or diagnosing problems by allowing a
+ stack trace to be obtained from a failed server process.
- Wait for the start or shutdown to complete. Times out after
- 60 seconds. This is the default for shutdowns. A successful
+ Wait for the start or shutdown to complete. Times out after
+ 60 seconds. This is the default for shutdowns. A successful
shutdown is indicated by removal of the
PID
file. For starting up, a successful psql -l
indicates success. pg_ctl will attempt to
PostgreSQL was compiled with
(5432 by default). When waiting, pg_ctl will
return an accurate exit code based on the success of the startup
- or shutdown.
+ or shutdown.
-
+
-
+
-l dbname
--database=dbname
- Specifies the name of the database to connect to. This is
- equivalent to specifying
- class="parameter">dbname as the first non-option
- argument on the command line.
+ Specifies the name of the database to connect to. This is
+ equivalent to specifying
+ class="parameter">dbname as the first non-option
+ argument on the command line.
+
+ If this parameter contains an = sign, it it treated as a
+
conninfo string. See
for more information.
- If this parameter contains an = sign, it it treated as a
-
conninfo string. See
for more information.
-
passwords. See for more information.
- An alternative way to specify connection parameters is in a
-
conninfo string, which is used instead of a
- database name. This mechanism give you very wide control over the
- connection. For example:
+ An alternative way to specify connection parameters is in a
+
conninfo string, which is used instead of a
+ database name. This mechanism give you very wide control over the
+ connection. For example:
$ psql "service=myservice sslmode=require"
- See for more information on all the
- available connection options.
-
+ See for more information on all the
+ available connection options.
+
If the connection could not be made for any reason (e.g., insufficient
- Reindex all databases.
+ Reindex all databases.
- Reindex database's system catalogs.
+ Reindex database's system catalogs.
- Reindex table only.
+ Reindex table only.
- Recreate index only.
+ Recreate index only.
- Specifies the name of the database to be reindexed.
- If this is not specified and (or
- ) is not used, the database name is read
- from the environment variable PGDATABASE. If
- that is not set, the user name specified for the connection is
- used.
+ Specifies the name of the database to be reindexed.
+ If this is not specified and (or
+ ) is not used, the database name is read
+ from the environment variable PGDATABASE. If
+ that is not set, the user name specified for the connection is
+ used.
Echo the commands that
reindexdb generates
- and sends to the server.
+ and sends to the server.
- Specifies the host name of the machine on which the server is
- running. If the value begins with a slash, it is used as the
- directory for the Unix domain socket.
+ Specifies the host name of the machine on which the server is
+ running. If the value begins with a slash, it is used as the
+ directory for the Unix domain socket.
- Specifies the TCP port or local Unix domain socket file
- extension on which the server
- is listening for connections.
+ Specifies the TCP port or local Unix domain socket file
+ extension on which the server
+ is listening for connections.