Commit 67cd018e authored by Bruce Momjian's avatar Bruce Momjian

Startup is actually start-up.

parent 883d1cc1
...@@ -232,8 +232,8 @@ Vacuumdb script now supports --all option (Peter E) ...@@ -232,8 +232,8 @@ Vacuumdb script now supports --all option (Peter E)
ecpg new portable FETCH syntax ecpg new portable FETCH syntax
Add ecpg EXEC SQL IFDEF, EXEC SQL IFNDEF, EXEC SQL ELSE, EXEC SQL ELIF Add ecpg EXEC SQL IFDEF, EXEC SQL IFNDEF, EXEC SQL ELSE, EXEC SQL ELIF
and EXEC SQL ENDIF directives and EXEC SQL ENDIF directives
Add pg_ctl script to control backend startup (Tatsuo) Add pg_ctl script to control backend start-up (Tatsuo)
Add postmaster.opts.default file to store startup flags (Tatsuo) Add postmaster.opts.default file to store start-up flags (Tatsuo)
Allow --with-mb=SQL_ASCII Allow --with-mb=SQL_ASCII
Increase maximum number of index keys to 16 (Bruce) Increase maximum number of index keys to 16 (Bruce)
Increase maximum number of function arguments to 16 (Bruce) Increase maximum number of function arguments to 16 (Bruce)
...@@ -764,7 +764,7 @@ Update contrib/pginterface/findoidjoins script(Tom) ...@@ -764,7 +764,7 @@ Update contrib/pginterface/findoidjoins script(Tom)
Major speedup in vacuum of deleted rows with indexes(Vadim) Major speedup in vacuum of deleted rows with indexes(Vadim)
Allow non-SQL functions to run different versions based on arguments(Tom) Allow non-SQL functions to run different versions based on arguments(Tom)
Add -E option that shows actual queries sent by \dt and friends(Masaaki Sakaida) Add -E option that shows actual queries sent by \dt and friends(Masaaki Sakaida)
Add version number in startup banners for psql(Masaaki Sakaida) Add version number in start-up banners for psql(Masaaki Sakaida)
New contrib/vacuumlo removes large objects not referenced(Peter) New contrib/vacuumlo removes large objects not referenced(Peter)
New initialization for table sizes so non-vacuumed tables perform better(Tom) New initialization for table sizes so non-vacuumed tables perform better(Tom)
Improve error messages when a connection is rejected(Tom) Improve error messages when a connection is rejected(Tom)
...@@ -1059,7 +1059,7 @@ New SERIAL data type, auto-creates sequence/index(Thomas) ...@@ -1059,7 +1059,7 @@ New SERIAL data type, auto-creates sequence/index(Thomas)
Enable assert checking without a recompile(Massimo) Enable assert checking without a recompile(Massimo)
User lock enhancements(Massimo) User lock enhancements(Massimo)
New setval() command to set sequence value(Massimo) New setval() command to set sequence value(Massimo)
Auto-remove unix socket file on startup if no postmaster running(Massimo) Auto-remove unix socket file on start-up if no postmaster running(Massimo)
Conditional trace package(Massimo) Conditional trace package(Massimo)
New UNLISTEN command(Massimo) New UNLISTEN command(Massimo)
Psql and libpq now compile under win32 using win32.mak(Magnus) Psql and libpq now compile under win32 using win32.mak(Magnus)
...@@ -1419,8 +1419,8 @@ New LOCK command and lock manual page describing deadlocks(Bruce) ...@@ -1419,8 +1419,8 @@ New LOCK command and lock manual page describing deadlocks(Bruce)
Add new psql \da, \dd, \df, \do, \dS, and \dT commands(Bruce) Add new psql \da, \dd, \df, \do, \dS, and \dT commands(Bruce)
Enhance psql \z to show sequences(Bruce) Enhance psql \z to show sequences(Bruce)
Show NOT NULL and DEFAULT in psql \d table(Bruce) Show NOT NULL and DEFAULT in psql \d table(Bruce)
New psql .psqlrc file startup(Andrew) New psql .psqlrc file start-up(Andrew)
Modify sample startup script in contrib/linux to show syslog(Thomas) Modify sample start-up script in contrib/linux to show syslog(Thomas)
New types for IP and MAC addresses in contrib/ip_and_mac(TomH) New types for IP and MAC addresses in contrib/ip_and_mac(TomH)
Unix system time conversions with date/time types in contrib/unixdate(Thomas) Unix system time conversions with date/time types in contrib/unixdate(Thomas)
Update of contrib stuff(Massimo) Update of contrib stuff(Massimo)
...@@ -1618,7 +1618,7 @@ Add routines for text trimming on both ends, substring, and string position(Thom ...@@ -1618,7 +1618,7 @@ Add routines for text trimming on both ends, substring, and string position(Thom
Added conversion routines circle(box) and poly(circle)(Thomas) Added conversion routines circle(box) and poly(circle)(Thomas)
Allow internal sorts to be stored in memory rather than in files(Bruce & Vadim) Allow internal sorts to be stored in memory rather than in files(Bruce & Vadim)
Allow functions and operators on internally-identical types to succeed(Bruce) Allow functions and operators on internally-identical types to succeed(Bruce)
Speed up backend startup after profiling analysis(Bruce) Speed up backend start-up after profiling analysis(Bruce)
Inline frequently called functions for performance(Bruce) Inline frequently called functions for performance(Bruce)
Reduce open() calls(Bruce) Reduce open() calls(Bruce)
psql: Add PAGER for \h and \?,\C fix psql: Add PAGER for \h and \?,\C fix
......
<!-- <!--
$Header: /cvsroot/pgsql/doc/src/sgml/datatype.sgml,v 1.34 2000/08/24 23:36:28 tgl Exp $ $Header: /cvsroot/pgsql/doc/src/sgml/datatype.sgml,v 1.35 2000/08/29 20:02:07 momjian Exp $
--> -->
<chapter id="datatype"> <chapter id="datatype">
...@@ -1219,13 +1219,13 @@ January 8 04:05:06 1999 PST ...@@ -1219,13 +1219,13 @@ January 8 04:05:06 1999 PST
<listitem> <listitem>
<para> <para>
The <envar>PGDATESTYLE</envar> environment variable used by the backend directly The <envar>PGDATESTYLE</envar> environment variable used by the backend directly
on postmaster startup. on postmaster start-up.
</para> </para>
</listitem> </listitem>
<listitem> <listitem>
<para> <para>
The <envar>PGDATESTYLE</envar> environment variable used by the frontend libpq The <envar>PGDATESTYLE</envar> environment variable used by the frontend libpq
on session startup. on session start-up.
</para> </para>
</listitem> </listitem>
<listitem> <listitem>
...@@ -1305,7 +1305,7 @@ January 8 04:05:06 1999 PST ...@@ -1305,7 +1305,7 @@ January 8 04:05:06 1999 PST
<listitem> <listitem>
<para> <para>
The TZ environment variable used by the backend directly The TZ environment variable used by the backend directly
on postmaster startup as the default time zone. on postmaster start-up as the default time zone.
</para> </para>
</listitem> </listitem>
<listitem> <listitem>
......
<!-- <!--
$Header: /cvsroot/pgsql/doc/src/sgml/history.sgml,v 1.8 2000/05/02 20:01:51 thomas Exp $ $Header: /cvsroot/pgsql/doc/src/sgml/history.sgml,v 1.9 2000/08/29 20:02:07 momjian Exp $
--> -->
<sect1> <sect1>
...@@ -246,7 +246,7 @@ $Header: /cvsroot/pgsql/doc/src/sgml/history.sgml,v 1.8 2000/05/02 20:01:51 thom ...@@ -246,7 +246,7 @@ $Header: /cvsroot/pgsql/doc/src/sgml/history.sgml,v 1.8 2000/05/02 20:01:51 thom
<listitem> <listitem>
<para> <para>
Overall backend code speed has been increased by approximately 20-40%, Overall backend code speed has been increased by approximately 20-40%,
and backend startup time has decreased 80% since v6.0 was released. and backend start-up time has decreased 80% since v6.0 was released.
</para> </para>
</listitem> </listitem>
</itemizedlist> </itemizedlist>
......
<!-- <!--
$Header: /cvsroot/pgsql/doc/src/sgml/Attic/indexcost.sgml,v 2.3 2000/03/31 17:18:26 tgl Exp $ $Header: /cvsroot/pgsql/doc/src/sgml/Attic/indexcost.sgml,v 2.4 2000/08/29 20:02:07 momjian Exp $
--> -->
<chapter> <chapter>
...@@ -111,7 +111,7 @@ amcostestimate (Query *root, ...@@ -111,7 +111,7 @@ amcostestimate (Query *root,
<term>*indexStartupCost</term> <term>*indexStartupCost</term>
<listitem> <listitem>
<para> <para>
Set to cost of index startup processing Set to cost of index start-up processing
</para> </para>
</listitem> </listitem>
</varlistentry> </varlistentry>
...@@ -160,9 +160,9 @@ amcostestimate (Query *root, ...@@ -160,9 +160,9 @@ amcostestimate (Query *root,
</para> </para>
<para> <para>
The "startup cost" is the part of the total scan cost that must be expended The "start-up cost" is the part of the total scan cost that must be expended
before we can begin to fetch the first tuple. For most indexes this can before we can begin to fetch the first tuple. For most indexes this can
be taken as zero, but an index type with a high startup cost might want be taken as zero, but an index type with a high start-up cost might want
to set it nonzero. to set it nonzero.
</para> </para>
......
<!-- $Header: /cvsroot/pgsql/doc/src/sgml/installation.sgml,v 1.15 2000/08/29 04:15:43 momjian Exp $ --> <!-- $Header: /cvsroot/pgsql/doc/src/sgml/installation.sgml,v 1.16 2000/08/29 20:02:07 momjian Exp $ -->
<chapter id="installation"> <chapter id="installation">
<title><![%flattext-install-include[<productname>PostgreSQL</> ]]>Installation Instructions</title> <title><![%flattext-install-include[<productname>PostgreSQL</> ]]>Installation Instructions</title>
...@@ -165,7 +165,7 @@ su - postgres ...@@ -165,7 +165,7 @@ su - postgres
<para> <para>
On systems which have <productname>PostgreSQL</> started at boot time, there is On systems which have <productname>PostgreSQL</> started at boot time, there is
probably a startup file that will accomplish the same thing. For probably a start-up file that will accomplish the same thing. For
example, on a Redhat Linux system one might find that example, on a Redhat Linux system one might find that
<programlisting> <programlisting>
/etc/rc.d/init.d/postgres.init stop /etc/rc.d/init.d/postgres.init stop
...@@ -777,7 +777,7 @@ setenv LD_LIBRARY_PATH /usr/local/pgsql/lib ...@@ -777,7 +777,7 @@ setenv LD_LIBRARY_PATH /usr/local/pgsql/lib
</programlisting> </programlisting>
Replace <literal>/usr/local/pgsql/lib</> with whatever you set Replace <literal>/usr/local/pgsql/lib</> with whatever you set
<option><literal>--libdir</></> to in <xref linkend="configure">. <option><literal>--libdir</></> to in <xref linkend="configure">.
You should put these commands into a shell startup file such as You should put these commands into a shell start-up file such as
<filename>/etc/profile</> or <filename>~/.bash_profile</>. <filename>/etc/profile</> or <filename>~/.bash_profile</>.
</para> </para>
...@@ -810,7 +810,7 @@ libpq.so.2.1: cannot open shared object file: No such file or directory ...@@ -810,7 +810,7 @@ libpq.so.2.1: cannot open shared object file: No such file or directory
add <filename>/usr/local/pgsql/bin</> (or what you set add <filename>/usr/local/pgsql/bin</> (or what you set
<option><literal>--bindir</></> to in <xref linkend="configure">) <option><literal>--bindir</></> to in <xref linkend="configure">)
into your <envar>PATH</>. To do this, add the following to your into your <envar>PATH</>. To do this, add the following to your
shell startup file, such as <filename>~/.bash_profile</> (or shell start-up file, such as <filename>~/.bash_profile</> (or
<filename>/etc/profile</>, if you want it to affect every user): <filename>/etc/profile</>, if you want it to affect every user):
<programlisting> <programlisting>
PATH=$PATH:/usr/local/pgsql/bin PATH=$PATH:/usr/local/pgsql/bin
...@@ -824,7 +824,7 @@ set path = ( /usr/local/pgsql/bin path ) ...@@ -824,7 +824,7 @@ set path = ( /usr/local/pgsql/bin path )
<para> <para>
To enable your system to find the <application>man</> To enable your system to find the <application>man</>
documentation, you need to add a line like the following to a documentation, you need to add a line like the following to a
shell startup file: shell start-up file:
<programlisting> <programlisting>
MANPATH=$MANPATH:/usr/local/pgsql/man MANPATH=$MANPATH:/usr/local/pgsql/man
</programlisting> </programlisting>
......
<!-- <!--
$Header: /cvsroot/pgsql/doc/src/sgml/Attic/jdbc.sgml,v 1.11 2000/08/23 05:59:02 thomas Exp $ $Header: /cvsroot/pgsql/doc/src/sgml/Attic/jdbc.sgml,v 1.12 2000/08/29 20:02:07 momjian Exp $
--> -->
<chapter id="jdbc"> <chapter id="jdbc">
...@@ -816,7 +816,7 @@ used. Also, only the function's required are entered into this table, ...@@ -816,7 +816,7 @@ used. Also, only the function's required are entered into this table,
keeping connection times as fast as possible. keeping connection times as fast as possible.
The postgresql.LargeObject class performs a query upon it's The postgresql.LargeObject class performs a query upon it's
startup, and passes the returned ResultSet to the addFunctions() start-up, and passes the returned ResultSet to the addFunctions()
method here. method here.
Once this has been done, the LargeObject api refers to the Once this has been done, the LargeObject api refers to the
......
<!-- <!--
$Header: /cvsroot/pgsql/doc/src/sgml/libpq.sgml,v 1.39 2000/08/29 04:15:43 momjian Exp $ $Header: /cvsroot/pgsql/doc/src/sgml/libpq.sgml,v 1.40 2000/08/29 20:02:07 momjian Exp $
--> -->
<chapter id="libpq-chapter"> <chapter id="libpq-chapter">
...@@ -337,7 +337,7 @@ PostgresPollingStatusType *PQconnectPoll(PQconn *conn) ...@@ -337,7 +337,7 @@ PostgresPollingStatusType *PQconnectPoll(PQconn *conn)
</listitem> </listitem>
<listitem> <listitem>
<para> <para>
CONNECTION_AUTH_OK: Received authentication; waiting for backend startup. CONNECTION_AUTH_OK: Received authentication; waiting for backend start-up.
</para> </para>
</listitem> </listitem>
<listitem> <listitem>
......
<!-- <!--
$Header: /cvsroot/pgsql/doc/src/sgml/manage-ag.sgml,v 2.9 2000/06/30 16:14:21 petere Exp $ $Header: /cvsroot/pgsql/doc/src/sgml/manage-ag.sgml,v 2.10 2000/08/29 20:02:07 momjian Exp $
--> -->
<chapter id="managing-databases"> <chapter id="managing-databases">
...@@ -134,8 +134,8 @@ setenv PGDATA2 /home/postgres/data ...@@ -134,8 +134,8 @@ setenv PGDATA2 /home/postgres/data
in csh or tcsh. You have to make sure that this environment in csh or tcsh. You have to make sure that this environment
variable is always defined in the server environment, otherwise variable is always defined in the server environment, otherwise
you won't be able to access that database. Therefore you probably you won't be able to access that database. Therefore you probably
want to set it in some sort of shell startup file or server want to set it in some sort of shell start-up file or server
startup script. start-up script.
</para> </para>
<para> <para>
......
<!-- <!--
$Header: /cvsroot/pgsql/doc/src/sgml/Attic/odbc.sgml,v 1.15 2000/05/02 20:01:52 thomas Exp $ $Header: /cvsroot/pgsql/doc/src/sgml/Attic/odbc.sgml,v 1.16 2000/08/29 20:02:07 momjian Exp $
--> -->
<chapter id="odbc"> <chapter id="odbc">
...@@ -1070,7 +1070,7 @@ can't load library 'libodbc.so'\n", 61) = -1 EIO (I/O error) ...@@ -1070,7 +1070,7 @@ can't load library 'libodbc.so'\n", 61) = -1 EIO (I/O error)
<para> <para>
You can add information about your You can add information about your
database login and password to the standard Applix startup database login and password to the standard Applix start-up
macro file. This is an example macro file. This is an example
<filename>~/axhome/macros/login.am</filename> file: <filename>~/axhome/macros/login.am</filename> file:
......
<!-- <!--
$Header: /cvsroot/pgsql/doc/src/sgml/Attic/plan.sgml,v 2.3 2000/03/31 17:45:00 tgl Exp $ $Header: /cvsroot/pgsql/doc/src/sgml/Attic/plan.sgml,v 2.4 2000/08/29 20:02:07 momjian Exp $
--> -->
<chapter> <chapter>
...@@ -40,7 +40,7 @@ $Header: /cvsroot/pgsql/doc/src/sgml/Attic/plan.sgml,v 2.3 2000/03/31 17:45:00 t ...@@ -40,7 +40,7 @@ $Header: /cvsroot/pgsql/doc/src/sgml/Attic/plan.sgml,v 2.3 2000/03/31 17:45:00 t
<itemizedlist> <itemizedlist>
<listitem> <listitem>
<para> <para>
Estimated startup cost (time expended before output scan can start, Estimated start-up cost (time expended before output scan can start,
eg, time to do the sorting in a SORT node). eg, time to do the sorting in a SORT node).
</para> </para>
</listitem> </listitem>
...@@ -241,7 +241,7 @@ Hash Join (cost=89.60..574.10 rows=100 width=296) ...@@ -241,7 +241,7 @@ Hash Join (cost=89.60..574.10 rows=100 width=296)
using ye same olde indexscan, stash them into an in-memory hash table, using ye same olde indexscan, stash them into an in-memory hash table,
and then do a sequential scan of tenk2, probing into the hash table and then do a sequential scan of tenk2, probing into the hash table
for possible matches of "t1.unique2 = t2.unique2" at each tenk2 tuple. for possible matches of "t1.unique2 = t2.unique2" at each tenk2 tuple.
The cost to read tenk1 and set up the hash table is entirely startup The cost to read tenk1 and set up the hash table is entirely start-up
cost for the hash join, since we won't get any tuples out until we can cost for the hash join, since we won't get any tuples out until we can
start reading tenk2. The total time estimate for the join also start reading tenk2. The total time estimate for the join also
includes a pretty hefty charge for CPU time to probe the hash table includes a pretty hefty charge for CPU time to probe the hash table
......
...@@ -114,7 +114,7 @@ ...@@ -114,7 +114,7 @@
<itemizedlist> <itemizedlist>
<listitem> <listitem>
<para> <para>
The exact sequence of steps <emphasis>from program startup</emphasis> The exact sequence of steps <emphasis>from program start-up</emphasis>
necessary to reproduce the problem. This should be self-contained; necessary to reproduce the problem. This should be self-contained;
it is not enough to send in a bare select statement without the it is not enough to send in a bare select statement without the
preceeding create table and insert statements, if the output should preceeding create table and insert statements, if the output should
...@@ -125,7 +125,7 @@ ...@@ -125,7 +125,7 @@
query-language related problems is a file that can be run through the query-language related problems is a file that can be run through the
<application>psql</application> frontend <application>psql</application> frontend
that shows the problem. (Be sure to not have anything in your that shows the problem. (Be sure to not have anything in your
<filename>~/.psqlrc</filename> startup file.) You are encouraged to <filename>~/.psqlrc</filename> start-up file.) You are encouraged to
minimize the size of your example, but this is not absolutely necessary. minimize the size of your example, but this is not absolutely necessary.
If the bug is reproduceable, we'll find it either way. If the bug is reproduceable, we'll find it either way.
</para> </para>
...@@ -176,7 +176,7 @@ ...@@ -176,7 +176,7 @@
<listitem> <listitem>
<para> <para>
Any command line options and other startup options, including concerned Any command line options and other start-up options, including concerned
environment variables or configuration files that you changed from the environment variables or configuration files that you changed from the
default. Again, be exact. If you are using a pre-packaged default. Again, be exact. If you are using a pre-packaged
distribution that starts the database server at boot time, you should try distribution that starts the database server at boot time, you should try
......
...@@ -47,7 +47,7 @@ have different roles but may be implemented by the same executable. ...@@ -47,7 +47,7 @@ have different roles but may be implemented by the same executable.
</para> </para>
<Para> <Para>
A frontend sends a startup packet to the postmaster. This includes the names A frontend sends a start-up packet to the postmaster. This includes the names
of the user and the database the user wants to connect to. The postmaster then of the user and the database the user wants to connect to. The postmaster then
uses this, and the information in the <filename>pg_hba.conf</filename> uses this, and the information in the <filename>pg_hba.conf</filename>
file file
...@@ -60,7 +60,7 @@ and responds to the frontend accordingly. ...@@ -60,7 +60,7 @@ and responds to the frontend accordingly.
The frontend then sends any required authentication information. Once the The frontend then sends any required authentication information. Once the
postmaster validates this it responds to the frontend that it is authenticated postmaster validates this it responds to the frontend that it is authenticated
and hands over the connection to a backend. The backend then sends a message and hands over the connection to a backend. The backend then sends a message
indicating successful startup (normal case) or failure (for example, an indicating successful start-up (normal case) or failure (for example, an
invalid database name). invalid database name).
</para> </para>
...@@ -91,17 +91,17 @@ itself. The difference is historical. ...@@ -91,17 +91,17 @@ itself. The difference is historical.
<Para> <Para>
This section describes the message flow. There are four different types of This section describes the message flow. There are four different types of
flows depending on the state of the connection: flows depending on the state of the connection:
startup, query, function call, and termination. start-up, query, function call, and termination.
There are also special provisions for notification responses and command There are also special provisions for notification responses and command
cancellation, which can occur at any time after the startup phase. cancellation, which can occur at any time after the start-up phase.
</para> </para>
<Sect2> <Sect2>
<Title>Startup</Title> <Title>Start-up</Title>
<Para> <Para>
Startup is divided into an authentication phase and a backend startup phase. Start-up is divided into an authentication phase and a backend start-up phase.
</para> </para>
<Para> <Para>
...@@ -197,8 +197,8 @@ postmaster, then it should immediately close the connection. ...@@ -197,8 +197,8 @@ postmaster, then it should immediately close the connection.
<Para> <Para>
After sending AuthenticationOk, the postmaster attempts to launch a backend After sending AuthenticationOk, the postmaster attempts to launch a backend
process. Since this might fail, or the backend might encounter a failure process. Since this might fail, or the backend might encounter a failure
during startup, the frontend must wait for the backend to acknowledge during start-up, the frontend must wait for the backend to acknowledge
successful startup. The frontend should send no messages at this point. successful start-up. The frontend should send no messages at this point.
The possible messages from the backend during this phase are: The possible messages from the backend during this phase are:
<VariableList> <VariableList>
...@@ -208,7 +208,7 @@ The possible messages from the backend during this phase are: ...@@ -208,7 +208,7 @@ The possible messages from the backend during this phase are:
</Term> </Term>
<ListItem> <ListItem>
<Para> <Para>
This message is issued after successful backend startup. This message is issued after successful backend start-up.
It provides secret-key data that the frontend must save It provides secret-key data that the frontend must save
if it wants to be able to issue cancel requests later. if it wants to be able to issue cancel requests later.
The frontend should not respond to this message, but should The frontend should not respond to this message, but should
...@@ -222,7 +222,7 @@ The possible messages from the backend during this phase are: ...@@ -222,7 +222,7 @@ The possible messages from the backend during this phase are:
</Term> </Term>
<ListItem> <ListItem>
<Para> <Para>
Backend startup is successful. The frontend may now issue Backend start-up is successful. The frontend may now issue
query or function call messages. query or function call messages.
</Para> </Para>
</ListItem> </ListItem>
...@@ -233,7 +233,7 @@ The possible messages from the backend during this phase are: ...@@ -233,7 +233,7 @@ The possible messages from the backend during this phase are:
</Term> </Term>
<ListItem> <ListItem>
<Para> <Para>
Backend startup failed. The connection is closed after Backend start-up failed. The connection is closed after
sending this message. sending this message.
</Para> </Para>
</ListItem> </ListItem>
...@@ -257,8 +257,8 @@ The possible messages from the backend during this phase are: ...@@ -257,8 +257,8 @@ The possible messages from the backend during this phase are:
The ReadyForQuery message is the same one that the backend will issue after The ReadyForQuery message is the same one that the backend will issue after
each query cycle. Depending on the coding needs of the frontend, it is each query cycle. Depending on the coding needs of the frontend, it is
reasonable to consider ReadyForQuery as starting a query cycle (and then reasonable to consider ReadyForQuery as starting a query cycle (and then
BackendKeyData indicates successful conclusion of the startup phase), BackendKeyData indicates successful conclusion of the start-up phase),
or to consider ReadyForQuery as ending the startup phase and each subsequent or to consider ReadyForQuery as ending the start-up phase and each subsequent
query cycle. query cycle.
</para> </para>
</sect2> </sect2>
...@@ -516,7 +516,7 @@ whenever a notify(l) command is executed for the same notification name. ...@@ -516,7 +516,7 @@ whenever a notify(l) command is executed for the same notification name.
<Para> <Para>
Notification responses are permitted at any point in the protocol (after Notification responses are permitted at any point in the protocol (after
startup), except within another backend message. Thus, the frontend start-up), except within another backend message. Thus, the frontend
must be prepared to recognize a NotificationResponse message whenever it is must be prepared to recognize a NotificationResponse message whenever it is
expecting any message. Indeed, it should be able to handle expecting any message. Indeed, it should be able to handle
NotificationResponse messages even when it is not engaged in a query. NotificationResponse messages even when it is not engaged in a query.
...@@ -568,7 +568,7 @@ reasons, no direct reply is made to the cancel request message. ...@@ -568,7 +568,7 @@ reasons, no direct reply is made to the cancel request message.
<Para> <Para>
A CancelRequest message will be ignored unless it contains the same key data A CancelRequest message will be ignored unless it contains the same key data
(PID and secret key) passed to the frontend during connection startup. If the (PID and secret key) passed to the frontend during connection start-up. If the
request matches the PID and secret key for a currently executing backend, the request matches the PID and secret key for a currently executing backend, the
postmaster signals the backend to abort processing of the current query. postmaster signals the backend to abort processing of the current query.
</para> </para>
......
<!-- <!--
$Header: /cvsroot/pgsql/doc/src/sgml/ref/explain.sgml,v 1.9 2000/02/15 23:37:49 tgl Exp $ $Header: /cvsroot/pgsql/doc/src/sgml/ref/explain.sgml,v 1.10 2000/08/29 20:02:09 momjian Exp $
Postgres documentation Postgres documentation
--> -->
...@@ -114,10 +114,10 @@ EXPLAIN ...@@ -114,10 +114,10 @@ EXPLAIN
The most critical part of the display is the estimated query execution The most critical part of the display is the estimated query execution
cost, which is the planner's guess at how long it will take to run the cost, which is the planner's guess at how long it will take to run the
query (measured in units of disk page fetches). Actually two numbers query (measured in units of disk page fetches). Actually two numbers
are shown: the startup time before the first tuple can be returned, and are shown: the start-up time before the first tuple can be returned, and
the total time to return all the tuples. For most queries the total time the total time to return all the tuples. For most queries the total time
is what matters, but in contexts such as an EXISTS sub-query the planner is what matters, but in contexts such as an EXISTS sub-query the planner
will choose the smallest startup time instead of the smallest total time will choose the smallest start-up time instead of the smallest total time
(since the executor will stop after getting one tuple, anyway). (since the executor will stop after getting one tuple, anyway).
Also, if you limit the number of tuples to return with a LIMIT clause, Also, if you limit the number of tuples to return with a LIMIT clause,
the planner makes an appropriate interpolation between the endpoint the planner makes an appropriate interpolation between the endpoint
......
<!-- <!--
$Header: /cvsroot/pgsql/doc/src/sgml/ref/Attic/pgctl-ref.sgml,v 1.6 2000/07/22 04:30:27 momjian Exp $ $Header: /cvsroot/pgsql/doc/src/sgml/ref/Attic/pgctl-ref.sgml,v 1.7 2000/08/29 20:02:09 momjian Exp $
Postgres documentation Postgres documentation
--> -->
...@@ -119,7 +119,7 @@ pg_ctl [-D <replaceable class="parameter">datadir</replaceable>] status ...@@ -119,7 +119,7 @@ pg_ctl [-D <replaceable class="parameter">datadir</replaceable>] status
<para> <para>
Immediate mode sends SIGUSR1 Immediate mode sends SIGUSR1
to the backends and lets them abort. In this case, database recovery to the backends and lets them abort. In this case, database recovery
will be necessary on the next startup. will be necessary on the next start-up.
</para> </para>
</listitem> </listitem>
</varlistentry> </varlistentry>
......
<!-- <!--
$Header: /cvsroot/pgsql/doc/src/sgml/ref/psql-ref.sgml,v 1.35 2000/07/22 04:45:09 momjian Exp $ $Header: /cvsroot/pgsql/doc/src/sgml/ref/psql-ref.sgml,v 1.36 2000/08/29 20:02:09 momjian Exp $
Postgres documentation Postgres documentation
--> -->
...@@ -1296,7 +1296,7 @@ Access permissions for database "test" ...@@ -1296,7 +1296,7 @@ Access permissions for database "test"
In general, both will do what you expect, but using <literal>-f</literal> In general, both will do what you expect, but using <literal>-f</literal>
enables some nice features such as error messages with line numbers. enables some nice features such as error messages with line numbers.
There is also a slight chance that using this option will reduce There is also a slight chance that using this option will reduce
the startup overhead. On the other hand, the variant using the shell's the start-up overhead. On the other hand, the variant using the shell's
input redirection is (in theory) guaranteed to yield exactly the same input redirection is (in theory) guaranteed to yield exactly the same
output that you would have gotten had you entered everything by hand. output that you would have gotten had you entered everything by hand.
</para> </para>
...@@ -1503,7 +1503,7 @@ Access permissions for database "test" ...@@ -1503,7 +1503,7 @@ Access permissions for database "test"
Performs a variable assignment, like the <command>\set</command> internal command. Performs a variable assignment, like the <command>\set</command> internal command.
Note that you must separate name and value, if any, by an equal sign on the command Note that you must separate name and value, if any, by an equal sign on the command
line. To unset a variable, leave off the equal sign. These assignments are done line. To unset a variable, leave off the equal sign. These assignments are done
during a very early state of startup, so variables reserved for internal purposes during a very early state of start-up, so variables reserved for internal purposes
might get overwritten later. might get overwritten later.
</para> </para>
</listitem> </listitem>
...@@ -1557,7 +1557,7 @@ Access permissions for database "test" ...@@ -1557,7 +1557,7 @@ Access permissions for database "test"
<term>-X, --no-psqlrc</term> <term>-X, --no-psqlrc</term>
<listitem> <listitem>
<para> <para>
Do not read the startup file <filename>~/.psqlrc</filename>. Do not read the start-up file <filename>~/.psqlrc</filename>.
</para> </para>
</listitem> </listitem>
</varlistentry> </varlistentry>
...@@ -1646,7 +1646,7 @@ bar ...@@ -1646,7 +1646,7 @@ bar
<listitem> <listitem>
<para> <para>
The name of the database you are currently connected to. This is set every time The name of the database you are currently connected to. This is set every time
you connect to a database (including program startup), but can be unset. you connect to a database (including program start-up), but can be unset.
</para> </para>
</listitem> </listitem>
</varlistentry> </varlistentry>
...@@ -1657,7 +1657,7 @@ bar ...@@ -1657,7 +1657,7 @@ bar
<para> <para>
If set to <quote><literal>all</literal></quote>, all lines entered or from a script If set to <quote><literal>all</literal></quote>, all lines entered or from a script
are written to the standard output before they are written to the standard output before they
are parsed or executed. To specify this on program startup, use the switch are parsed or executed. To specify this on program start-up, use the switch
<option>-a</option>. If set to <quote><literal>queries</literal></quote>, <option>-a</option>. If set to <quote><literal>queries</literal></quote>,
<application>psql</application> merely prints all queries as they are sent to the <application>psql</application> merely prints all queries as they are sent to the
backend. The option for this is <option>-e</option>. backend. The option for this is <option>-e</option>.
...@@ -1728,7 +1728,7 @@ bar ...@@ -1728,7 +1728,7 @@ bar
<listitem> <listitem>
<para> <para>
The database server host you are currently connected to. This is set every time The database server host you are currently connected to. This is set every time
you connect to a database (including program startup), but can be unset. you connect to a database (including program start-up), but can be unset.
</para> </para>
</listitem> </listitem>
</varlistentry> </varlistentry>
...@@ -1816,7 +1816,7 @@ bar ...@@ -1816,7 +1816,7 @@ bar
<listitem> <listitem>
<para> <para>
The database server port to which you are currently connected. This is set every time The database server port to which you are currently connected. This is set every time
you connect to a database (including program startup), but can be unset. you connect to a database (including program start-up), but can be unset.
</para> </para>
</listitem> </listitem>
</varlistentry> </varlistentry>
...@@ -1867,7 +1867,7 @@ bar ...@@ -1867,7 +1867,7 @@ bar
<listitem> <listitem>
<para> <para>
The database user you are currently connected as. This is set every time The database user you are currently connected as. This is set every time
you connect to a database (including program startup), but can be unset. you connect to a database (including program start-up), but can be unset.
</para> </para>
</listitem> </listitem>
</varlistentry> </varlistentry>
......
<!-- <!--
$Header: /cvsroot/pgsql/doc/src/sgml/ref/set.sgml,v 1.47 2000/08/07 00:51:18 tgl Exp $ $Header: /cvsroot/pgsql/doc/src/sgml/ref/set.sgml,v 1.48 2000/08/29 20:02:09 momjian Exp $
Postgres documentation Postgres documentation
--> -->
...@@ -165,7 +165,7 @@ SET TIME ZONE { '<replaceable class="PARAMETER">timezone</replaceable>' | LOCAL ...@@ -165,7 +165,7 @@ SET TIME ZONE { '<replaceable class="PARAMETER">timezone</replaceable>' | LOCAL
Setting the <envar>PGDATESTYLE</envar> environment variable. Setting the <envar>PGDATESTYLE</envar> environment variable.
If PGDATESTYLE is set in the frontend environment of a client If PGDATESTYLE is set in the frontend environment of a client
based on libpq, libpq will automatically set DATESTYLE to the based on libpq, libpq will automatically set DATESTYLE to the
value of PGDATESTYLE during connection startup. value of PGDATESTYLE during connection start-up.
</member> </member>
<member> <member>
Running postmaster using the option <option>-o -e</option> to Running postmaster using the option <option>-o -e</option> to
...@@ -288,7 +288,7 @@ SELECT setseed(<replaceable>value</replaceable>); ...@@ -288,7 +288,7 @@ SELECT setseed(<replaceable>value</replaceable>);
<para> <para>
If the PGTZ environment variable is set in the frontend If the PGTZ environment variable is set in the frontend
environment of a client based on libpq, libpq will automatically environment of a client based on libpq, libpq will automatically
set TIMEZONE to the value of PGTZ during connection startup. set TIMEZONE to the value of PGTZ during connection start-up.
</para> </para>
</listitem> </listitem>
</varlistentry> </varlistentry>
...@@ -341,7 +341,7 @@ SELECT setseed(<replaceable>value</replaceable>); ...@@ -341,7 +341,7 @@ SELECT setseed(<replaceable>value</replaceable>);
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><computeroutput>ERROR: <replaceable>name</replaceable> can only be set at startup</computeroutput></term> <term><computeroutput>ERROR: <replaceable>name</replaceable> can only be set at start-up</computeroutput></term>
<listitem> <listitem>
<para> <para>
Some parameters are fixed once the server is started. Some parameters are fixed once the server is started.
......
<!-- <!--
$Header: /cvsroot/pgsql/doc/src/sgml/release.sgml,v 1.57 2000/07/14 16:04:18 thomas Exp $ $Header: /cvsroot/pgsql/doc/src/sgml/release.sgml,v 1.58 2000/08/29 20:02:07 momjian Exp $
--> -->
<chapter id="release"> <chapter id="release">
...@@ -473,8 +473,8 @@ Vacuumdb script now supports --all option (Peter E) ...@@ -473,8 +473,8 @@ Vacuumdb script now supports --all option (Peter E)
ecpg new portable FETCH syntax ecpg new portable FETCH syntax
Add ecpg EXEC SQL IFDEF, EXEC SQL IFNDEF, EXEC SQL ELSE, EXEC SQL ELIF Add ecpg EXEC SQL IFDEF, EXEC SQL IFNDEF, EXEC SQL ELSE, EXEC SQL ELIF
and EXEC SQL ENDIF directives and EXEC SQL ENDIF directives
Add pg_ctl script to control backend startup (Tatsuo) Add pg_ctl script to control backend start-up (Tatsuo)
Add postmaster.opts.default file to store startup flags (Tatsuo) Add postmaster.opts.default file to store start-up flags (Tatsuo)
Allow --with-mb=SQL_ASCII Allow --with-mb=SQL_ASCII
Increase maximum number of index keys to 16 (Bruce) Increase maximum number of index keys to 16 (Bruce)
Increase maximum number of function arguments to 16 (Bruce) Increase maximum number of function arguments to 16 (Bruce)
...@@ -1191,7 +1191,7 @@ Update contrib/pginterface/findoidjoins script(Tom) ...@@ -1191,7 +1191,7 @@ Update contrib/pginterface/findoidjoins script(Tom)
Major speedup in vacuum of deleted rows with indexes(Vadim) Major speedup in vacuum of deleted rows with indexes(Vadim)
Allow non-SQL functions to run different versions based on arguments(Tom) Allow non-SQL functions to run different versions based on arguments(Tom)
Add -E option that shows actual queries sent by \dt and friends(Masaaki Sakaida) Add -E option that shows actual queries sent by \dt and friends(Masaaki Sakaida)
Add version number in startup banners for psql(Masaaki Sakaida) Add version number in start-up banners for psql(Masaaki Sakaida)
New contrib/vacuumlo removes large objects not referenced(Peter) New contrib/vacuumlo removes large objects not referenced(Peter)
New initialization for table sizes so non-vacuumed tables perform better(Tom) New initialization for table sizes so non-vacuumed tables perform better(Tom)
Improve error messages when a connection is rejected(Tom) Improve error messages when a connection is rejected(Tom)
...@@ -1598,7 +1598,7 @@ New SERIAL data type, auto-creates sequence/index(Thomas) ...@@ -1598,7 +1598,7 @@ New SERIAL data type, auto-creates sequence/index(Thomas)
Enable assert checking without a recompile(Massimo) Enable assert checking without a recompile(Massimo)
User lock enhancements(Massimo) User lock enhancements(Massimo)
New setval() command to set sequence value(Massimo) New setval() command to set sequence value(Massimo)
Auto-remove unix socket file on startup if no postmaster running(Massimo) Auto-remove unix socket file on start-up if no postmaster running(Massimo)
Conditional trace package(Massimo) Conditional trace package(Massimo)
New UNLISTEN command(Massimo) New UNLISTEN command(Massimo)
Psql and libpq now compile under win32 using win32.mak(Magnus) Psql and libpq now compile under win32 using win32.mak(Magnus)
...@@ -2088,8 +2088,8 @@ New LOCK command and lock manual page describing deadlocks(Bruce) ...@@ -2088,8 +2088,8 @@ New LOCK command and lock manual page describing deadlocks(Bruce)
Add new psql \da, \dd, \df, \do, \dS, and \dT commands(Bruce) Add new psql \da, \dd, \df, \do, \dS, and \dT commands(Bruce)
Enhance psql \z to show sequences(Bruce) Enhance psql \z to show sequences(Bruce)
Show NOT NULL and DEFAULT in psql \d table(Bruce) Show NOT NULL and DEFAULT in psql \d table(Bruce)
New psql .psqlrc file startup(Andrew) New psql .psqlrc file start-up(Andrew)
Modify sample startup script in contrib/linux to show syslog(Thomas) Modify sample start-up script in contrib/linux to show syslog(Thomas)
New types for IP and MAC addresses in contrib/ip_and_mac(TomH) New types for IP and MAC addresses in contrib/ip_and_mac(TomH)
Unix system time conversions with date/time types in contrib/unixdate(Thomas) Unix system time conversions with date/time types in contrib/unixdate(Thomas)
Update of contrib stuff(Massimo) Update of contrib stuff(Massimo)
...@@ -2354,7 +2354,7 @@ Add routines for text trimming on both ends, substring, and string position(Thom ...@@ -2354,7 +2354,7 @@ Add routines for text trimming on both ends, substring, and string position(Thom
Added conversion routines circle(box) and poly(circle)(Thomas) Added conversion routines circle(box) and poly(circle)(Thomas)
Allow internal sorts to be stored in memory rather than in files(Bruce & Vadim) Allow internal sorts to be stored in memory rather than in files(Bruce & Vadim)
Allow functions and operators on internally-identical types to succeed(Bruce) Allow functions and operators on internally-identical types to succeed(Bruce)
Speed up backend startup after profiling analysis(Bruce) Speed up backend start-up after profiling analysis(Bruce)
Inline frequently called functions for performance(Bruce) Inline frequently called functions for performance(Bruce)
Reduce open() calls(Bruce) Reduce open() calls(Bruce)
psql: Add PAGER for \h and \?,\C fix psql: Add PAGER for \h and \?,\C fix
......
<!-- <!--
$Header: /cvsroot/pgsql/doc/src/sgml/runtime.sgml,v 1.22 2000/08/29 04:15:43 momjian Exp $ $Header: /cvsroot/pgsql/doc/src/sgml/runtime.sgml,v 1.23 2000/08/29 20:02:07 momjian Exp $
--> -->
<Chapter Id="runtime"> <Chapter Id="runtime">
...@@ -234,7 +234,7 @@ su postgres -c "/usr/local/pgsql/bin/postmaster -D /usr/local/pgsql/data" ...@@ -234,7 +234,7 @@ su postgres -c "/usr/local/pgsql/bin/postmaster -D /usr/local/pgsql/data"
</para> </para>
<sect2 id="postmaster-start-failures"> <sect2 id="postmaster-start-failures">
<title>Server Startup Failures</title> <title>Server Start-up Failures</title>
<para> <para>
There are several common reasons for the postmaster to fail to There are several common reasons for the postmaster to fail to
...@@ -1697,7 +1697,7 @@ perl: warning: Falling back to the standard locale ("C"). ...@@ -1697,7 +1697,7 @@ perl: warning: Falling back to the standard locale ("C").
will cause the postmaster to send a SIGUSR1 to all backends and will cause the postmaster to send a SIGUSR1 to all backends and
exit immediately (without properly shutting down the database exit immediately (without properly shutting down the database
system). When WAL is implemented, this will lead to recovery on system). When WAL is implemented, this will lead to recovery on
startup. Right now it's not recommendable to use this option. start-up. Right now it's not recommendable to use this option.
</para> </para>
</listitem> </listitem>
</varlistentry> </varlistentry>
...@@ -1770,7 +1770,7 @@ perl: warning: Falling back to the standard locale ("C"). ...@@ -1770,7 +1770,7 @@ perl: warning: Falling back to the standard locale ("C").
Fill out the information the script asks for. Make sure to enter Fill out the information the script asks for. Make sure to enter
the local hostname as Common Name. The script will generate a key the local hostname as Common Name. The script will generate a key
which is passphrase protected. To remove the passphrase (required which is passphrase protected. To remove the passphrase (required
if you want automatic startup of the postmaster), run the command if you want automatic start-up of the postmaster), run the command
<programlisting> <programlisting>
openssl x509 -inform PEM -outform PEM -in newreq.pem -out newkey_no_passphrase.pem openssl x509 -inform PEM -outform PEM -in newreq.pem -out newkey_no_passphrase.pem
</programlisting> </programlisting>
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment