<listitem>

<para>

This variable specifies one or more shared libraries that are to be

preloaded at connection start. This parameter cannot be changed after

the start of a particular session. If a specified library is not

preloaded at connection start.

The parameter value only takes effect at the start of the connection.

Subsequent changes have no effect. If a specified library is not

found, the connection attempt will fail.

</para>

</para>

<para>

Unless a module is specifically designed to be used in this way by

The intent of this feature is to allow unprivileged users to load

debugging or performance-measurement libraries into specific sessions

without requiring an explicit <command>LOAD</> command. To that end,

it would be typical to set this parameter using

the <envar>PGOPTIONS</envar> environment variable on the client or by

using

<command>ALTER ROLE SET</>.

</para>

<para>

However, unless a module is specifically designed to be used in this way by

non-superusers, this is usually not the right setting to use. Look

at <xref linkend="guc-session-preload-libraries"> instead.

</para>

},

{

{"local_preload_libraries",PGC_BACKEND,CLIENT_CONN_PRELOAD,

{"local_preload_libraries",PGC_USERSET,CLIENT_CONN_PRELOAD,

gettext_noop("Lists unprivileged shared libraries to preload into each backend."),

NULL,

GUC_LIST_INPUT |GUC_LIST_QUOTE