diff --git a/doc/src/sgml/config.sgml b/doc/src/sgml/config.sgml index 5369026351..5081da060b 100644 --- a/doc/src/sgml/config.sgml +++ b/doc/src/sgml/config.sgml @@ -4394,30 +4394,6 @@ local0.* /var/log/postgresql - - cluster_name (string) - - cluster_name configuration parameter - - - - - Sets the cluster name that appears in the process title for all - processes in this cluster. The name can be any string of less than - NAMEDATALEN characters (64 characters in a standard - build). Only printable ASCII characters may be used in the - cluster_name value. Other characters will be - replaced with question marks (?). No name is shown - if this parameter is set to the empty string '' (which is - the default). This parameter can only be set at server start. - - - The process title is typically viewed using programs like - ps or, on Windows, Process Explorer. - - - - debug_print_parse (boolean) @@ -5010,9 +4986,61 @@ COPY postgres_log FROM '/full/path/to/logfile.csv' WITH csv; - - + + + Process Title + + + These settings control how the process title as seen + by ps is modified. See + for details. + + + + + cluster_name (string) + + cluster_name configuration parameter + + + + + Sets the cluster name that appears in the process title for all + processes in this cluster. The name can be any string of less than + NAMEDATALEN characters (64 characters in a standard + build). Only printable ASCII characters may be used in the + cluster_name value. Other characters will be + replaced with question marks (?). No name is shown + if this parameter is set to the empty string '' (which is + the default). This parameter can only be set at server start. + + + The process title is typically viewed using programs like + ps or, on Windows, Process Explorer. + + + + + + update_process_title (boolean) + + update_process_title configuration parameter + + + + + Enables updating of the process title every time a new SQL command + is received by the server. The process title is typically viewed + by the ps command, + or in Windows by using the Process Explorer. + Only superusers can change this setting. + + + + + + Run-time Statistics @@ -5130,23 +5158,6 @@ COPY postgres_log FROM '/full/path/to/logfile.csv' WITH csv; - - update_process_title (boolean) - - update_process_title configuration parameter - - - - - Enables updating of the process title every time a new SQL command - is received by the server. The process title is typically viewed - by the ps command, - or in Windows by using the Process Explorer. - Only superusers can change this setting. - - - - stats_temp_directory (string) diff --git a/src/backend/utils/misc/guc.c b/src/backend/utils/misc/guc.c index 7684bff79b..71090f2d4f 100644 --- a/src/backend/utils/misc/guc.c +++ b/src/backend/utils/misc/guc.c @@ -580,6 +580,8 @@ const char *const config_group_names[] = gettext_noop("Reporting and Logging / When to Log"), /* LOGGING_WHAT */ gettext_noop("Reporting and Logging / What to Log"), + /* PROCESS_TITLE */ + gettext_noop("Process Title"), /* STATS */ gettext_noop("Statistics"), /* STATS_MONITORING */ @@ -1180,7 +1182,7 @@ static struct config_bool ConfigureNamesBool[] = }, { - {"update_process_title", PGC_SUSET, STATS_COLLECTOR, + {"update_process_title", PGC_SUSET, PROCESS_TITLE, gettext_noop("Updates the process title to show the active SQL command."), gettext_noop("Enables updating of the process title every time a new SQL command is received by the server.") }, @@ -3395,7 +3397,7 @@ static struct config_string ConfigureNamesString[] = }, { - {"cluster_name", PGC_POSTMASTER, LOGGING_WHAT, + {"cluster_name", PGC_POSTMASTER, PROCESS_TITLE, gettext_noop("Sets the name of the cluster which is included in the process title."), NULL, GUC_IS_NAME diff --git a/src/backend/utils/misc/postgresql.conf.sample b/src/backend/utils/misc/postgresql.conf.sample index b2adda9595..dcf929f993 100644 --- a/src/backend/utils/misc/postgresql.conf.sample +++ b/src/backend/utils/misc/postgresql.conf.sample @@ -447,8 +447,13 @@ # than the specified size in kilobytes; # -1 disables, 0 logs all temp files #log_timezone = 'GMT' + + +# - Process Title - + #cluster_name = '' # added to process titles if nonempty # (change requires restart) +#update_process_title = on #------------------------------------------------------------------------------ @@ -462,7 +467,6 @@ #track_io_timing = off #track_functions = none # none, pl, all #track_activity_query_size = 1024 # (change requires restart) -#update_process_title = on #stats_temp_directory = 'pg_stat_tmp' diff --git a/src/include/utils/guc_tables.h b/src/include/utils/guc_tables.h index 7a58ddb10b..8da2e78a47 100644 --- a/src/include/utils/guc_tables.h +++ b/src/include/utils/guc_tables.h @@ -81,6 +81,7 @@ enum config_group LOGGING_WHERE, LOGGING_WHEN, LOGGING_WHAT, + PROCESS_TITLE, STATS, STATS_MONITORING, STATS_COLLECTOR,