← Back to branch summary

~ubuntu-branches/ubuntu/lucid/postgresql-8.4/lucid-proposed

« back to all changes in this revision

Viewing changes to src/backend/utils/misc/postgresql.conf.sample

  • Committer: Bazaar Package Importer
  • Author(s): Martin Pitt
  • Date: 2009-03-20 12:00:13 UTC
  • Revision ID: james.westby@ubuntu.com-20090320120013-hogj7egc5mjncc5g
Tags: upstream-8.4~0cvs20090328
Import upstream version 8.4~0cvs20090328

Show diffs side-by-side

added added

removed removed

Lines of Context:
src/backend/utils/misc/postgresql.conf.sample
 
1
# -----------------------------
 
2
# PostgreSQL configuration file
 
3
# -----------------------------
 
4
#
 
5
# This file consists of lines of the form:
 
6
#
 
7
#   name = value
 
8
#
 
9
# (The "=" is optional.)  Whitespace may be used.  Comments are introduced with
 
10
# "#" anywhere on a line.  The complete list of parameter names and allowed
 
11
# values can be found in the PostgreSQL documentation.
 
12
#
 
13
# The commented-out settings shown in this file represent the default values.
 
14
# Re-commenting a setting is NOT sufficient to revert it to the default value;
 
15
# you need to reload the server.
 
16
#
 
17
# This file is read on server startup and when the server receives a SIGHUP
 
18
# signal.  If you edit the file on a running system, you have to SIGHUP the
 
19
# server for the changes to take effect, or use "pg_ctl reload".  Some
 
20
# parameters, which are marked below, require a server shutdown and restart to
 
21
# take effect.
 
22
#
 
23
# Any parameter can also be given as a command-line option to the server, e.g.,
 
24
# "postgres -c log_connections=on".  Some parameters can be changed at run time
 
25
# with the "SET" SQL command.
 
26
#
 
27
# Memory units:  kB = kilobytes MB = megabytes GB = gigabytes
 
28
# Time units:    ms = milliseconds s = seconds min = minutes h = hours d = days
 
29
 
 
30
 
 
31
#------------------------------------------------------------------------------
 
32
# FILE LOCATIONS
 
33
#------------------------------------------------------------------------------
 
34
 
 
35
# The default values of these variables are driven from the -D command-line
 
36
# option or PGDATA environment variable, represented here as ConfigDir.
 
37
 
 
38
#data_directory = 'ConfigDir'           # use data in another directory
 
39
                                        # (change requires restart)
 
40
#hba_file = 'ConfigDir/pg_hba.conf'     # host-based authentication file
 
41
                                        # (change requires restart)
 
42
#ident_file = 'ConfigDir/pg_ident.conf' # ident configuration file
 
43
                                        # (change requires restart)
 
44
 
 
45
# If external_pid_file is not explicitly set, no extra PID file is written.
 
46
#external_pid_file = '(none)'           # write an extra PID file
 
47
                                        # (change requires restart)
 
48
 
 
49
 
 
50
#------------------------------------------------------------------------------
 
51
# CONNECTIONS AND AUTHENTICATION
 
52
#------------------------------------------------------------------------------
 
53
 
 
54
# - Connection Settings -
 
55
 
 
56
#listen_addresses = 'localhost'         # what IP address(es) to listen on;
 
57
                                        # comma-separated list of addresses;
 
58
                                        # defaults to 'localhost', '*' = all
 
59
                                        # (change requires restart)
 
60
#port = 5432                            # (change requires restart)
 
61
#max_connections = 100                  # (change requires restart)
 
62
# Note:  Increasing max_connections costs ~400 bytes of shared memory per 
 
63
# connection slot, plus lock space (see max_locks_per_transaction).
 
64
#superuser_reserved_connections = 3     # (change requires restart)
 
65
#unix_socket_directory = ''             # (change requires restart)
 
66
#unix_socket_group = ''                 # (change requires restart)
 
67
#unix_socket_permissions = 0777         # begin with 0 to use octal notation
 
68
                                        # (change requires restart)
 
69
#bonjour_name = ''                      # defaults to the computer name
 
70
                                        # (change requires restart)
 
71
 
 
72
# - Security and Authentication -
 
73
 
 
74
#authentication_timeout = 1min          # 1s-600s
 
75
#ssl = off                              # (change requires restart)
 
76
#ssl_ciphers = 'ALL:!ADH:!LOW:!EXP:!MD5:@STRENGTH'      # allowed SSL ciphers
 
77
                                        # (change requires restart)
 
78
#password_encryption = on
 
79
#db_user_namespace = off
 
80
 
 
81
# Kerberos and GSSAPI
 
82
#krb_server_keyfile = ''
 
83
#krb_srvname = 'postgres'               # (Kerberos only)
 
84
#krb_caseins_users = off
 
85
 
 
86
# - TCP Keepalives -
 
87
# see "man 7 tcp" for details
 
88
 
 
89
#tcp_keepalives_idle = 0                # TCP_KEEPIDLE, in seconds;
 
90
                                        # 0 selects the system default
 
91
#tcp_keepalives_interval = 0            # TCP_KEEPINTVL, in seconds;
 
92
                                        # 0 selects the system default
 
93
#tcp_keepalives_count = 0               # TCP_KEEPCNT;
 
94
                                        # 0 selects the system default
 
95
 
 
96
 
 
97
#------------------------------------------------------------------------------
 
98
# RESOURCE USAGE (except WAL)
 
99
#------------------------------------------------------------------------------
 
100
 
 
101
# - Memory -
 
102
 
 
103
#shared_buffers = 32MB                  # min 128kB
 
104
                                        # (change requires restart)
 
105
#temp_buffers = 8MB                     # min 800kB
 
106
#max_prepared_transactions = 5          # can be 0 or more
 
107
                                        # (change requires restart)
 
108
# Note:  Increasing max_prepared_transactions costs ~600 bytes of shared memory
 
109
# per transaction slot, plus lock space (see max_locks_per_transaction).
 
110
#work_mem = 1MB                         # min 64kB
 
111
#maintenance_work_mem = 16MB            # min 1MB
 
112
#max_stack_depth = 2MB                  # min 100kB
 
113
 
 
114
# - Kernel Resource Usage -
 
115
 
 
116
#max_files_per_process = 1000           # min 25
 
117
                                        # (change requires restart)
 
118
#shared_preload_libraries = ''          # (change requires restart)
 
119
 
 
120
# - Cost-Based Vacuum Delay -
 
121
 
 
122
#vacuum_cost_delay = 0                  # 0-100 milliseconds
 
123
#vacuum_cost_page_hit = 1               # 0-10000 credits
 
124
#vacuum_cost_page_miss = 10             # 0-10000 credits
 
125
#vacuum_cost_page_dirty = 20            # 0-10000 credits
 
126
#vacuum_cost_limit = 200                # 1-10000 credits
 
127
 
 
128
# - Background Writer -
 
129
 
 
130
#bgwriter_delay = 200ms                 # 10-10000ms between rounds
 
131
#bgwriter_lru_maxpages = 100            # 0-1000 max buffers written/round
 
132
#bgwriter_lru_multiplier = 2.0          # 0-10.0 multipler on buffers scanned/round
 
133
 
 
134
# - Asynchronous Behavior -
 
135
 
 
136
#effective_io_concurrency = 1           # 1-1000, or 0 to disable prefetching
 
137
 
 
138
 
 
139
#------------------------------------------------------------------------------
 
140
# WRITE AHEAD LOG
 
141
#------------------------------------------------------------------------------
 
142
 
 
143
# - Settings -
 
144
 
 
145
#fsync = on                             # turns forced synchronization on or off
 
146
#synchronous_commit = on                # immediate fsync at commit
 
147
#wal_sync_method = fsync                # the default is the first option 
 
148
                                        # supported by the operating system:
 
149
                                        #   open_datasync
 
150
                                        #   fdatasync
 
151
                                        #   fsync
 
152
                                        #   fsync_writethrough
 
153
                                        #   open_sync
 
154
#full_page_writes = on                  # recover from partial page writes
 
155
#wal_buffers = 64kB                     # min 32kB
 
156
                                        # (change requires restart)
 
157
#wal_writer_delay = 200ms               # 1-10000 milliseconds
 
158
 
 
159
#commit_delay = 0                       # range 0-100000, in microseconds
 
160
#commit_siblings = 5                    # range 1-1000
 
161
 
 
162
# - Checkpoints -
 
163
 
 
164
#checkpoint_segments = 3                # in logfile segments, min 1, 16MB each
 
165
#checkpoint_timeout = 5min              # range 30s-1h
 
166
#checkpoint_completion_target = 0.5     # checkpoint target duration, 0.0 - 1.0
 
167
#checkpoint_warning = 30s               # 0 is off
 
168
 
 
169
# - Archiving -
 
170
 
 
171
#archive_mode = off             # allows archiving to be done
 
172
                                # (change requires restart)
 
173
#archive_command = ''           # command to use to archive a logfile segment
 
174
#archive_timeout = 0            # force a logfile segment switch after this
 
175
                                # time; 0 is off
 
176
 
 
177
 
 
178
#------------------------------------------------------------------------------
 
179
# QUERY TUNING
 
180
#------------------------------------------------------------------------------
 
181
 
 
182
# - Planner Method Configuration -
 
183
 
 
184
#enable_bitmapscan = on
 
185
#enable_hashagg = on
 
186
#enable_hashjoin = on
 
187
#enable_indexscan = on
 
188
#enable_mergejoin = on
 
189
#enable_nestloop = on
 
190
#enable_seqscan = on
 
191
#enable_sort = on
 
192
#enable_tidscan = on
 
193
 
 
194
# - Planner Cost Constants -
 
195
 
 
196
#seq_page_cost = 1.0                    # measured on an arbitrary scale
 
197
#random_page_cost = 4.0                 # same scale as above
 
198
#cpu_tuple_cost = 0.01                  # same scale as above
 
199
#cpu_index_tuple_cost = 0.005           # same scale as above
 
200
#cpu_operator_cost = 0.0025             # same scale as above
 
201
#effective_cache_size = 128MB
 
202
 
 
203
# - Genetic Query Optimizer -
 
204
 
 
205
#geqo = on
 
206
#geqo_threshold = 12
 
207
#geqo_effort = 5                        # range 1-10
 
208
#geqo_pool_size = 0                     # selects default based on effort
 
209
#geqo_generations = 0                   # selects default based on effort
 
210
#geqo_selection_bias = 2.0              # range 1.5-2.0
 
211
 
 
212
# - Other Planner Options -
 
213
 
 
214
#default_statistics_target = 100        # range 1-10000
 
215
#constraint_exclusion = partition       # on, off, or partition
 
216
#cursor_tuple_fraction = 0.1            # range 0.0-1.0
 
217
#from_collapse_limit = 8
 
218
#join_collapse_limit = 8                # 1 disables collapsing of explicit 
 
219
                                        # JOIN clauses
 
220
 
 
221
 
 
222
#------------------------------------------------------------------------------
 
223
# ERROR REPORTING AND LOGGING
 
224
#------------------------------------------------------------------------------
 
225
 
 
226
# - Where to Log -
 
227
 
 
228
#log_destination = 'stderr'             # Valid values are combinations of
 
229
                                        # stderr, csvlog, syslog and eventlog,
 
230
                                        # depending on platform.  csvlog
 
231
                                        # requires logging_collector to be on.
 
232
 
 
233
# This is used when logging to stderr:
 
234
#logging_collector = off                # Enable capturing of stderr and csvlog
 
235
                                        # into log files. Required to be on for
 
236
                                        # csvlogs.
 
237
                                        # (change requires restart)
 
238
 
 
239
# These are only used if logging_collector is on:
 
240
#log_directory = 'pg_log'               # directory where log files are written,
 
241
                                        # can be absolute or relative to PGDATA
 
242
#log_filename = 'postgresql-%Y-%m-%d_%H%M%S.log'        # log file name pattern,
 
243
                                        # can include strftime() escapes
 
244
#log_truncate_on_rotation = off         # If on, an existing log file of the
 
245
                                        # same name as the new log file will be
 
246
                                        # truncated rather than appended to.
 
247
                                        # But such truncation only occurs on
 
248
                                        # time-driven rotation, not on restarts
 
249
                                        # or size-driven rotation.  Default is
 
250
                                        # off, meaning append to existing files
 
251
                                        # in all cases.
 
252
#log_rotation_age = 1d                  # Automatic rotation of logfiles will
 
253
                                        # happen after that time.  0 to disable.
 
254
#log_rotation_size = 10MB               # Automatic rotation of logfiles will 
 
255
                                        # happen after that much log output.
 
256
                                        # 0 to disable.
 
257
 
 
258
# These are relevant when logging to syslog:
 
259
#syslog_facility = 'LOCAL0'
 
260
#syslog_ident = 'postgres'
 
261
 
 
262
 
 
263
# - When to Log -
 
264
 
 
265
#client_min_messages = notice           # values in order of decreasing detail:
 
266
                                        #   debug5
 
267
                                        #   debug4
 
268
                                        #   debug3
 
269
                                        #   debug2
 
270
                                        #   debug1
 
271
                                        #   log
 
272
                                        #   notice
 
273
                                        #   warning
 
274
                                        #   error
 
275
 
 
276
#log_min_messages = warning             # values in order of decreasing detail:
 
277
                                        #   debug5
 
278
                                        #   debug4
 
279
                                        #   debug3
 
280
                                        #   debug2
 
281
                                        #   debug1
 
282
                                        #   info
 
283
                                        #   notice
 
284
                                        #   warning
 
285
                                        #   error
 
286
                                        #   log
 
287
                                        #   fatal
 
288
                                        #   panic
 
289
 
 
290
#log_error_verbosity = default          # terse, default, or verbose messages
 
291
 
 
292
#log_min_error_statement = error        # values in order of decreasing detail:
 
293
                                        #   debug5
 
294
                                        #   debug4
 
295
                                        #   debug3
 
296
                                        #   debug2
 
297
                                        #   debug1
 
298
                                        #   info
 
299
                                        #   notice
 
300
                                        #   warning
 
301
                                        #   error
 
302
                                        #   log
 
303
                                        #   fatal
 
304
                                        #   panic (effectively off)
 
305
 
 
306
#log_min_duration_statement = -1        # -1 is disabled, 0 logs all statements
 
307
                                        # and their durations, > 0 logs only
 
308
                                        # statements running at least this time.
 
309
 
 
310
#silent_mode = off                      # DO NOT USE without syslog or
 
311
                                        # logging_collector
 
312
                                        # (change requires restart)
 
313
 
 
314
# - What to Log -
 
315
 
 
316
#debug_print_parse = off
 
317
#debug_print_rewritten = off
 
318
#debug_print_plan = off
 
319
#debug_pretty_print = on
 
320
#log_checkpoints = off
 
321
#log_connections = off
 
322
#log_disconnections = off
 
323
#log_duration = off
 
324
#log_hostname = off
 
325
#log_line_prefix = ''                   # special values:
 
326
                                        #   %u = user name
 
327
                                        #   %d = database name
 
328
                                        #   %r = remote host and port
 
329
                                        #   %h = remote host
 
330
                                        #   %p = process ID
 
331
                                        #   %t = timestamp without milliseconds
 
332
                                        #   %m = timestamp with milliseconds
 
333
                                        #   %i = command tag
 
334
                                        #   %c = session ID
 
335
                                        #   %l = session line number
 
336
                                        #   %s = session start timestamp
 
337
                                        #   %v = virtual transaction ID
 
338
                                        #   %x = transaction ID (0 if none)
 
339
                                        #   %q = stop here in non-session
 
340
                                        #        processes
 
341
                                        #   %% = '%'
 
342
                                        # e.g. '<%u%%%d> '
 
343
#log_lock_waits = off                   # log lock waits >= deadlock_timeout
 
344
#log_statement = 'none'                 # none, ddl, mod, all
 
345
#log_temp_files = -1                    # log temporary files equal or larger
 
346
                                        # than specified size;
 
347
                                        # -1 disables, 0 logs all temp files
 
348
#log_timezone = unknown                 # actually, defaults to TZ environment
 
349
                                        # setting
 
350
 
 
351
 
 
352
#------------------------------------------------------------------------------
 
353
# RUNTIME STATISTICS
 
354
#------------------------------------------------------------------------------
 
355
 
 
356
# - Query/Index Statistics Collector -
 
357
 
 
358
#track_activities = on
 
359
#track_counts = on
 
360
#track_functions = none                 # none, pl, all
 
361
#track_activity_query_size = 1024
 
362
#update_process_title = on
 
363
#stats_temp_directory = 'pg_stat_tmp'
 
364
 
 
365
 
 
366
# - Statistics Monitoring -
 
367
 
 
368
#log_parser_stats = off
 
369
#log_planner_stats = off
 
370
#log_executor_stats = off
 
371
#log_statement_stats = off
 
372
 
 
373
 
 
374
#------------------------------------------------------------------------------
 
375
# AUTOVACUUM PARAMETERS
 
376
#------------------------------------------------------------------------------
 
377
 
 
378
#autovacuum = on                        # Enable autovacuum subprocess?  'on' 
 
379
                                        # requires track_counts to also be on.
 
380
#log_autovacuum_min_duration = -1       # -1 disables, 0 logs all actions and
 
381
                                        # their durations, > 0 logs only
 
382
                                        # actions running at least that time.
 
383
#autovacuum_max_workers = 3             # max number of autovacuum subprocesses
 
384
#autovacuum_naptime = 1min              # time between autovacuum runs
 
385
#autovacuum_vacuum_threshold = 50       # min number of row updates before
 
386
                                        # vacuum
 
387
#autovacuum_analyze_threshold = 50      # min number of row updates before 
 
388
                                        # analyze
 
389
#autovacuum_vacuum_scale_factor = 0.2   # fraction of table size before vacuum
 
390
#autovacuum_analyze_scale_factor = 0.1  # fraction of table size before analyze
 
391
#autovacuum_freeze_max_age = 200000000  # maximum XID age before forced vacuum
 
392
                                        # (change requires restart)
 
393
#autovacuum_vacuum_cost_delay = 20      # default vacuum cost delay for
 
394
                                        # autovacuum, -1 means use
 
395
                                        # vacuum_cost_delay
 
396
#autovacuum_vacuum_cost_limit = -1      # default vacuum cost limit for
 
397
                                        # autovacuum, -1 means use
 
398
                                        # vacuum_cost_limit
 
399
 
 
400
 
 
401
#------------------------------------------------------------------------------
 
402
# CLIENT CONNECTION DEFAULTS
 
403
#------------------------------------------------------------------------------
 
404
 
 
405
# - Statement Behavior -
 
406
 
 
407
#search_path = '"$user",public'         # schema names
 
408
#default_tablespace = ''                # a tablespace name, '' uses the default
 
409
#temp_tablespaces = ''                  # a list of tablespace names, '' uses
 
410
                                        # only default tablespace
 
411
#check_function_bodies = on
 
412
#default_transaction_isolation = 'read committed'
 
413
#default_transaction_read_only = off
 
414
#session_replication_role = 'origin'
 
415
#statement_timeout = 0                  # 0 is disabled
 
416
#vacuum_freeze_min_age = 50000000
 
417
#vacuum_freeze_table_age = 150000000
 
418
#xmlbinary = 'base64'
 
419
#xmloption = 'content'
 
420
 
 
421
# - Locale and Formatting -
 
422
 
 
423
#datestyle = 'iso, mdy'
 
424
#intervalstyle = 'postgres'
 
425
#timezone = unknown                     # actually, defaults to TZ environment
 
426
                                        # setting
 
427
#timezone_abbreviations = 'Default'     # Select the set of available time zone
 
428
                                        # abbreviations.  Currently, there are
 
429
                                        #   Default
 
430
                                        #   Australia
 
431
                                        #   India
 
432
                                        # You can create your own file in
 
433
                                        # share/timezonesets/.
 
434
#extra_float_digits = 0                 # min -15, max 2
 
435
#client_encoding = sql_ascii            # actually, defaults to database
 
436
                                        # encoding
 
437
 
 
438
# These settings are initialized by initdb, but they can be changed.
 
439
#lc_messages = 'C'                      # locale for system error message
 
440
                                        # strings
 
441
#lc_monetary = 'C'                      # locale for monetary formatting
 
442
#lc_numeric = 'C'                       # locale for number formatting
 
443
#lc_time = 'C'                          # locale for time formatting
 
444
 
 
445
# default configuration for text search
 
446
#default_text_search_config = 'pg_catalog.simple'
 
447
 
 
448
# - Other Defaults -
 
449
 
 
450
#dynamic_library_path = '$libdir'
 
451
#local_preload_libraries = ''
 
452
 
 
453
 
 
454
#------------------------------------------------------------------------------
 
455
# LOCK MANAGEMENT
 
456
#------------------------------------------------------------------------------
 
457
 
 
458
#deadlock_timeout = 1s
 
459
#max_locks_per_transaction = 64         # min 10
 
460
                                        # (change requires restart)
 
461
# Note:  Each lock table slot uses ~270 bytes of shared memory, and there are
 
462
# max_locks_per_transaction * (max_connections + max_prepared_transactions)
 
463
# lock table slots.
 
464
 
 
465
 
 
466
#------------------------------------------------------------------------------
 
467
# VERSION/PLATFORM COMPATIBILITY
 
468
#------------------------------------------------------------------------------
 
469
 
 
470
# - Previous PostgreSQL Versions -
 
471
 
 
472
#add_missing_from = off
 
473
#array_nulls = on
 
474
#backslash_quote = safe_encoding        # on, off, or safe_encoding
 
475
#default_with_oids = off
 
476
#escape_string_warning = on
 
477
#regex_flavor = advanced                # advanced, extended, or basic
 
478
#sql_inheritance = on
 
479
#standard_conforming_strings = off
 
480
#synchronize_seqscans = on
 
481
 
 
482
# - Other Platforms and Clients -
 
483
 
 
484
#transform_null_equals = off
 
485
 
 
486
 
 
487
#------------------------------------------------------------------------------
 
488
# CUSTOMIZED OPTIONS
 
489
#------------------------------------------------------------------------------
 
490
 
 
491
#custom_variable_classes = ''           # list of custom variable class names