Movatterモバイル変換

[0]ホーム
URL:

Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

 Sign up
Appearance settings

Commitba63dbd

Browse files
committed
Upgrade documentation connected with shared_preload_libraries et al.
Noplace in the documentation actually defined what these variablescontain. Define them as lists of arguments for LOAD, and improvethat command's documentation a bit.Discussion:https://postgr.es/m/CAB-oJtxHVDc3H+Km3CjB9mY1VDzuyaVH_ZYSz7iXcRqCtb93Ew@mail.gmail.com
1 parentb710248 commitba63dbd

File tree

3 files changed

+26
-17
lines changed

3 files changed

+26
-17
lines changed

‎doc/src/sgml/config.sgml

Lines changed: 17 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -7003,12 +7003,6 @@ SET XML OPTION { DOCUMENT | CONTENT };
70037003
<literal>tcl</>, or <literal>python</>.
70047004
</para>
70057005

7006-
<para>
7007-
For each parameter, if more than one library is to be loaded, separate
7008-
their names with commas. All library names are converted to lower case
7009-
unless double-quoted.
7010-
</para>
7011-
70127006
<para>
70137007
Only shared libraries specifically intended to be used with PostgreSQL
70147008
can be loaded this way. Every PostgreSQL-supported library has
@@ -7037,6 +7031,10 @@ SET XML OPTION { DOCUMENT | CONTENT };
70377031
<para>
70387032
This variable specifies one or more shared libraries that are to be
70397033
preloaded at connection start.
7034+
It contains a comma-separated list of library names, where each name
7035+
is interpreted as for the <xref linkend="SQL-LOAD"> command.
7036+
Whitespace between entries is ignored; surround a library name with
7037+
double quotes if you need to include whitespace or commas in the name.
70407038
The parameter value only takes effect at the start of the connection.
70417039
Subsequent changes have no effect. If a specified library is not
70427040
found, the connection attempt will fail.
@@ -7083,10 +7081,15 @@ SET XML OPTION { DOCUMENT | CONTENT };
70837081
<listitem>
70847082
<para>
70857083
This variable specifies one or more shared libraries that are to be
7086-
preloaded at connection start. Only superusers can change this setting.
7084+
preloaded at connection start.
7085+
It contains a comma-separated list of library names, where each name
7086+
is interpreted as for the <xref linkend="SQL-LOAD"> command.
7087+
Whitespace between entries is ignored; surround a library name with
7088+
double quotes if you need to include whitespace or commas in the name.
70877089
The parameter value only takes effect at the start of the connection.
70887090
Subsequent changes have no effect. If a specified library is not
70897091
found, the connection attempt will fail.
7092+
Only superusers can change this setting.
70907093
</para>
70917094

70927095
<para>
@@ -7120,9 +7123,13 @@ SET XML OPTION { DOCUMENT | CONTENT };
71207123
<listitem>
71217124
<para>
71227125
This variable specifies one or more shared libraries to be preloaded at
7123-
server start. This parameter can only be set at server
7124-
start. If a specified library is not found, the server will fail to
7125-
start.
7126+
server start.
7127+
It contains a comma-separated list of library names, where each name
7128+
is interpreted as for the <xref linkend="SQL-LOAD"> command.
7129+
Whitespace between entries is ignored; surround a library name with
7130+
double quotes if you need to include whitespace or commas in the name.
7131+
This parameter can only be set at server start. If a specified
7132+
library is not found, the server will fail to start.
71267133
</para>
71277134

71287135
<para>

‎doc/src/sgml/ref/create_function.sgml

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -541,8 +541,9 @@ CREATE [ OR REPLACE ] FUNCTION
541541
dynamically loadable C language functions when the function name
542542
in the C language source code is not the same as the name of
543543
the SQL function. The string <replaceable
544-
class="parameter">obj_file</replaceable> is the name of the
545-
file containing the dynamically loadable object, and
544+
class="parameter">obj_file</replaceable> is the name of the shared
545+
library file containing the compiled C function, and is interpreted
546+
as for the <xref linkend="SQL-LOAD"> command. The string
546547
<replaceable class="parameter">link_symbol</replaceable> is the
547548
function's link symbol, that is, the name of the function in the C
548549
language source code. If the link symbol is omitted, it is assumed

‎doc/src/sgml/ref/load.sgml

Lines changed: 6 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -38,11 +38,12 @@ LOAD '<replaceable class="PARAMETER">filename</replaceable>'
3838
</para>
3939

4040
<para>
41-
The file name is specified in the same way as for shared library
42-
names in <xref linkend="sql-createfunction">; in particular, one
43-
can rely on a search path and automatic addition of the system's standard
44-
shared library file name extension. See <xref linkend="xfunc-c"> for
45-
more information on this topic.
41+
The library file name is typically given as just a bare file name,
42+
which is sought in the server's library search path (set
43+
by <xref linkend="guc-dynamic-library-path">). Alternatively it can be
44+
given as a full path name. In either case the platform's standard shared
45+
library file name extension may be omitted.
46+
See <xref linkend="xfunc-c-dynload"> for more information on this topic.
4647
</para>
4748

4849
<indexterm>

0 commit comments

Comments
 (0)
[8]ページ先頭
©2009-2025 Movatter.jp