← Back to branch summary

~ubuntu-branches/ubuntu/utopic/postgresql-9.4/utopic-security

« back to all changes in this revision

Viewing changes to doc/src/sgml/man7/ALTER_SYSTEM.7

  • Committer: Package Import Robot
  • Author(s): Martin Pitt, CVE-2014-8161
  • Date: 2015-02-06 12:31:46 UTC
  • mfrom: (1.1.5) (7.1.2 utopic-proposed)
  • Revision ID: package-import@ubuntu.com-20150206123146-vtmf30jbkm7w16p8
Tags: 9.4.1-0ubuntu0.14.10
https://launchpad.net/bugs/1418928
* New upstream security/bug fix release (LP: #1418928)
  - Fix buffer overruns in to_char() [CVE-2015-0241]
  - Fix buffer overruns in contrib/pgcrypto [CVE-2015-0243]
  - Fix possible loss of frontend/backend protocol synchronization after an
    error [CVE-2015-0244]
  - Fix information leak via constraint-violation error messages
    [CVE-2014-8161]
  - See release notes for details about other fixes:
    http://www.postgresql.org/about/news/1569/

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/src/sgml/man7/ALTER_SYSTEM.7
2
2
.\"     Title: ALTER SYSTEM
3
3
.\"    Author: The PostgreSQL Global Development Group
4
4
.\" Generator: DocBook XSL Stylesheets v1.76.1 <http://docbook.sf.net/>
5
 
.\"      Date: 2014
6
 
.\"    Manual: PostgreSQL 9.4beta3 Documentation
7
 
.\"    Source: PostgreSQL 9.4beta3
 
5
.\"      Date: 2015
 
6
.\"    Manual: PostgreSQL 9.4.1 Documentation
 
7
.\"    Source: PostgreSQL 9.4.1
8
8
.\"  Language: English
9
9
.\"
10
 
.TH "ALTER SYSTEM" "7" "2014" "PostgreSQL 9.4beta3" "PostgreSQL 9.4beta3 Documentation"
 
10
.TH "ALTER SYSTEM" "7" "2015" "PostgreSQL 9.4.1" "PostgreSQL 9.4.1 Documentation"
11
11
.\" -----------------------------------------------------------------
12
12
.\" * Define some portability stuff
13
13
.\" -----------------------------------------------------------------
41
41
.PP
42
42
 
43
43
\fBALTER SYSTEM\fR
44
 
writes the configuration parameter values to the
 
44
is used for changing server configuration parameters across the entire database cluster\&. It can be more convenient than the traditional method of manually editing the
 
45
postgresql\&.conf
 
46
file\&.
 
47
\fBALTER SYSTEM\fR
 
48
writes the given parameter setting to the
45
49
postgresql\&.auto\&.conf
46
 
file\&. Setting the parameter to
 
50
file, which is read in addition to
 
51
postgresql\&.conf\&. Setting a parameter to
47
52
DEFAULT, or using the
48
53
\fBRESET\fR
49
 
variant, removes the configuration entry from
 
54
variant, removes that configuration entry from the
50
55
postgresql\&.auto\&.conf
51
56
file\&. Use
52
57
RESET ALL
53
 
to clear all configuration entries\&. The values will be effective after reload of server configuration (SIGHUP) or in next server start based on the type of configuration parameter modified\&.
54
 
.PP
55
 
This command is not allowed inside transaction block or function\&.
56
 
.PP
57
 
See
58
 
Section 18.1, \(lqSetting Parameters\(rq, in the documentation
59
 
for other ways to set the parameters and how they become effective\&.
 
58
to remove all such configuration entries\&.
 
59
.PP
 
60
Values set with
 
61
\fBALTER SYSTEM\fR
 
62
will be effective after the next server configuration reload (SIGHUP
 
63
or
 
64
pg_ctl reload), or after the next server restart in the case of parameters that can only be changed at server start\&.
 
65
.PP
 
66
Only superusers can use
 
67
\fBALTER SYSTEM\fR\&. Also, since this command acts directly on the file system and cannot be rolled back, it is not allowed inside a transaction block or function\&.
60
68
.SH "PARAMETERS"
61
69
.PP
62
70
\fIconfiguration_parameter\fR
63
71
.RS 4
64
 
Name of a settable run\-time parameter\&. Available parameters are documented in
 
72
Name of a settable configuration parameter\&. Available parameters are documented in
65
73
Chapter 18, Server Configuration, in the documentation\&.
66
74
.RE
67
75
.PP
68
76
\fIvalue\fR
69
77
.RS 4
70
 
New value of parameter\&. Values can be specified as string constants, identifiers, numbers, or comma\-separated lists of these, as appropriate for the particular parameter\&.
 
78
New value of the parameter\&. Values can be specified as string constants, identifiers, numbers, or comma\-separated lists of these, as appropriate for the particular parameter\&.
71
79
DEFAULT
72
 
can be written to specify to remove the parameter and its value from
73
 
postgresql\&.auto\&.conf
 
80
can be written to specify removing the parameter and its value from
 
81
postgresql\&.auto\&.conf\&.
74
82
.RE
75
83
.SH "NOTES"
76
84
.PP
77
85
This command can\*(Aqt be used to set
78
 
data_directory
79
 
and any parameters (e\&.g\&.,
80
 
preset options) that are not allowed in
81
 
postgresql\&.conf\&.
 
86
data_directory, nor parameters that are not allowed in
 
87
postgresql\&.conf
 
88
(e\&.g\&.,
 
89
preset options)\&.
 
90
.PP
 
91
See
 
92
Section 18.1, \(lqSetting Parameters\(rq, in the documentation
 
93
for other ways to set the parameters\&.
82
94
.SH "EXAMPLES"
83
95
.PP
84
96
Set the
94
106
.RE
95
107
.\}
96
108
.PP
97
 
Set the
98
 
authentication_timeout:
 
109
Undo that, restoring whatever setting was effective in
 
110
postgresql\&.conf:
99
111
.sp
100
112
.if n \{\
101
113
.RS 4
102
114
.\}
103
115
.nf
104
 
ALTER SYSTEM SET authentication_timeout = 10;
 
116
ALTER SYSTEM RESET wal_level;
105
117
.fi
106
118
.if n \{\
107
119
.RE
108
120
.\}
 
121
.sp
109
122
.SH "COMPATIBILITY"
110
123
.PP
111
124
The