Remove check hooks for GUCs that contribute to MaxBackends.

Each of max_connections, max_worker_processes,
autovacuum_max_workers, and max_wal_senders has a GUC check hook
that verifies the sum of those GUCs does not exceed a hard-coded
limit (see the comment for MAX_BACKENDS in postmaster.h).  In
general, the hooks effectively guard against egregious
misconfigurations.

However, this approach has some problems.  Since these check hooks
are called as each GUC is assigned its user-specified value, only
one of the hooks will be called with all the relevant GUCs set.  If
one or more of the user-specified values are less than the initial
values of the GUCs' underlying variables, false positives can
occur.

Furthermore, the error message emitted when one of the check hooks
fails is not tremendously helpful.  For example, the command

	$ pg_ctl -D . start -o "-c max_connections=262100 -c max_wal_senders=10000"

fails with the following error:

	FATAL:  invalid value for parameter "max_wal_senders": 10000

Fortunately, there is an extra copy of this check in
InitializeMaxBackends() that we can rely on, so this commit removes
the aforementioned GUC check hooks in favor of that one.  It also
enhances the error message to clearly show the values of the
relevant GUCs and the hard-coded limit their sum may not exceed.
The downside of this change is that server startup progresses
further before failing due to such misconfigurations (thus taking
longer), but these failures are expected to be rare, so we don't
anticipate any real harm in practice.

Reviewed-by: Tom Lane
Discussion: https://postgr.es/m/ZnMr2k-Nk5vj7T7H%40nathan
This commit is contained in:
Nathan Bossart 2024-07-05 14:42:55 -05:00
parent ba8f00eef6
commit 0b1fe1413e
3 changed files with 11 additions and 60 deletions

View File

@ -580,57 +580,14 @@ InitializeMaxBackends(void)
MaxBackends = MaxConnections + autovacuum_max_workers + 1 + MaxBackends = MaxConnections + autovacuum_max_workers + 1 +
max_worker_processes + max_wal_senders; max_worker_processes + max_wal_senders;
/* internal error because the values were all checked previously */
if (MaxBackends > MAX_BACKENDS) if (MaxBackends > MAX_BACKENDS)
elog(ERROR, "too many backends configured"); ereport(ERROR,
} (errcode(ERRCODE_INVALID_PARAMETER_VALUE),
errmsg("too many server processes configured"),
/* errdetail("\"max_connections\" (%d) plus \"autovacuum_max_workers\" (%d) plus \"max_worker_processes\" (%d) plus \"max_wal_senders\" (%d) must be less than %d.",
* GUC check_hook for max_connections MaxConnections, autovacuum_max_workers,
*/ max_worker_processes, max_wal_senders,
bool MAX_BACKENDS)));
check_max_connections(int *newval, void **extra, GucSource source)
{
if (*newval + autovacuum_max_workers + 1 +
max_worker_processes + max_wal_senders > MAX_BACKENDS)
return false;
return true;
}
/*
* GUC check_hook for autovacuum_max_workers
*/
bool
check_autovacuum_max_workers(int *newval, void **extra, GucSource source)
{
if (MaxConnections + *newval + 1 +
max_worker_processes + max_wal_senders > MAX_BACKENDS)
return false;
return true;
}
/*
* GUC check_hook for max_worker_processes
*/
bool
check_max_worker_processes(int *newval, void **extra, GucSource source)
{
if (MaxConnections + autovacuum_max_workers + 1 +
*newval + max_wal_senders > MAX_BACKENDS)
return false;
return true;
}
/*
* GUC check_hook for max_wal_senders
*/
bool
check_max_wal_senders(int *newval, void **extra, GucSource source)
{
if (MaxConnections + autovacuum_max_workers + 1 +
max_worker_processes + *newval > MAX_BACKENDS)
return false;
return true;
} }
/* /*

View File

@ -2209,7 +2209,7 @@ struct config_int ConfigureNamesInt[] =
}, },
&MaxConnections, &MaxConnections,
100, 1, MAX_BACKENDS, 100, 1, MAX_BACKENDS,
check_max_connections, NULL, NULL NULL, NULL, NULL
}, },
{ {
@ -2925,7 +2925,7 @@ struct config_int ConfigureNamesInt[] =
}, },
&max_wal_senders, &max_wal_senders,
10, 0, MAX_BACKENDS, 10, 0, MAX_BACKENDS,
check_max_wal_senders, NULL, NULL NULL, NULL, NULL
}, },
{ {
@ -3155,7 +3155,7 @@ struct config_int ConfigureNamesInt[] =
}, },
&max_worker_processes, &max_worker_processes,
8, 0, MAX_BACKENDS, 8, 0, MAX_BACKENDS,
check_max_worker_processes, NULL, NULL NULL, NULL, NULL
}, },
{ {
@ -3389,7 +3389,7 @@ struct config_int ConfigureNamesInt[] =
}, },
&autovacuum_max_workers, &autovacuum_max_workers,
3, 1, MAX_BACKENDS, 3, 1, MAX_BACKENDS,
check_autovacuum_max_workers, NULL, NULL NULL, NULL, NULL
}, },
{ {

View File

@ -29,8 +29,6 @@ extern bool check_application_name(char **newval, void **extra,
GucSource source); GucSource source);
extern void assign_application_name(const char *newval, void *extra); extern void assign_application_name(const char *newval, void *extra);
extern const char *show_archive_command(void); extern const char *show_archive_command(void);
extern bool check_autovacuum_max_workers(int *newval, void **extra,
GucSource source);
extern bool check_autovacuum_work_mem(int *newval, void **extra, extern bool check_autovacuum_work_mem(int *newval, void **extra,
GucSource source); GucSource source);
extern bool check_vacuum_buffer_usage_limit(int *newval, void **extra, extern bool check_vacuum_buffer_usage_limit(int *newval, void **extra,
@ -84,13 +82,9 @@ extern const char *show_log_timezone(void);
extern bool check_maintenance_io_concurrency(int *newval, void **extra, extern bool check_maintenance_io_concurrency(int *newval, void **extra,
GucSource source); GucSource source);
extern void assign_maintenance_io_concurrency(int newval, void *extra); extern void assign_maintenance_io_concurrency(int newval, void *extra);
extern bool check_max_connections(int *newval, void **extra, GucSource source);
extern bool check_max_wal_senders(int *newval, void **extra, GucSource source);
extern bool check_max_slot_wal_keep_size(int *newval, void **extra, extern bool check_max_slot_wal_keep_size(int *newval, void **extra,
GucSource source); GucSource source);
extern void assign_max_wal_size(int newval, void *extra); extern void assign_max_wal_size(int newval, void *extra);
extern bool check_max_worker_processes(int *newval, void **extra,
GucSource source);
extern bool check_max_stack_depth(int *newval, void **extra, GucSource source); extern bool check_max_stack_depth(int *newval, void **extra, GucSource source);
extern void assign_max_stack_depth(int newval, void *extra); extern void assign_max_stack_depth(int newval, void *extra);
extern bool check_multixact_member_buffers(int *newval, void **extra, extern bool check_multixact_member_buffers(int *newval, void **extra,