Skip to content

Commit 6734e80

Browse files
committed
Align some terms in arch-dev.sgml to glossary
This mostly adds links to the glossary to the existing text, instead of using <firstterm>. Heikki left this out of 29ad659 out of stylistic concerns; these have since been addressed. Author: Jürgen Purtz <juergen@purtz.de> Discussion: https://postgr.es/m/67d7240f-8596-83fc-5e15-af06c128a0f5@purtz.de
1 parent a63dd8a commit 6734e80

File tree

1 file changed

+25
-21
lines changed

1 file changed

+25
-21
lines changed

doc/src/sgml/arch-dev.sgml

+25-21
Original file line numberDiff line numberDiff line change
@@ -27,7 +27,7 @@
2727
<title>The Path of a Query</title>
2828

2929
<para>
30-
Here we give a short overview of the stages a query has to pass
30+
Here we give a short overview of the stages a query has to pass
3131
to obtain a result.
3232
</para>
3333

@@ -114,21 +114,25 @@
114114
<title>How Connections Are Established</title>
115115

116116
<para>
117-
<productname>PostgreSQL</productname> is implemented using a
118-
simple <quote>process per user</quote> client/server model. In this model
119-
there is one <firstterm>client process</firstterm> connected to
120-
exactly one <firstterm>server process</firstterm>. As we do not
121-
know ahead of time how many connections will be made, we have to
122-
use a <firstterm>supervisor process</firstterm> (also
123-
<firstterm>master process</firstterm>) that spawns a new
124-
server process every time a connection is requested. This supervisor
125-
process is called <literal>postmaster</literal> and listens at a
126-
specified TCP/IP port for incoming connections. Whenever a request
127-
for a connection is detected the <literal>postmaster</literal>
128-
process spawns a new server process. The server processes
129-
communicate with each other using <firstterm>semaphores</firstterm> and
130-
<firstterm>shared memory</firstterm> to ensure data integrity
131-
throughout concurrent data access.
117+
<productname>PostgreSQL</productname> implements a
118+
<quote>process per user</quote> client/server model.
119+
In this model, every
120+
<glossterm linkend="glossary-client">client process</glossterm>
121+
connects to exactly one
122+
<glossterm linkend="glossary-backend">backend process</glossterm>.
123+
As we do not know ahead of time how many connections will be made,
124+
we have to use a <quote>supervisor process</quote> that spawns a new
125+
backend process every time a connection is requested. This supervisor
126+
process is called
127+
<glossterm linkend="glossary-postmaster">postmaster</glossterm>
128+
and listens at a specified TCP/IP port for incoming connections.
129+
Whenever it detects a request for a connection, it spawns a new
130+
backend process. Those backend processes communicate with each
131+
other and with other processes of the
132+
<glossterm linkend="glossary-instance">instance</glossterm>
133+
using <firstterm>semaphores</firstterm> and
134+
<glossterm linkend="glossary-shared-memory">shared memory</glossterm>
135+
to ensure data integrity throughout concurrent data access.
132136
</para>
133137

134138
<para>
@@ -141,11 +145,11 @@
141145
</para>
142146

143147
<para>
144-
Once a connection is established the client process can send a query
145-
to the <firstterm>backend</firstterm> (server). The query is transmitted using plain text,
146-
i.e., there is no parsing done in the <firstterm>frontend</firstterm> (client). The
147-
server parses the query, creates an <firstterm>execution plan</firstterm>,
148-
executes the plan and returns the retrieved rows to the client
148+
Once a connection is established, the client process can send a query
149+
to the backend process it's connected to. The query is transmitted using
150+
plain text, i.e., there is no parsing done in the client. The backend
151+
process parses the query, creates an <firstterm>execution plan</firstterm>,
152+
executes the plan, and returns the retrieved rows to the client
149153
by transmitting them over the established connection.
150154
</para>
151155
</sect1>

0 commit comments

Comments
 (0)