← Back to branch summary

~ubuntu-branches/ubuntu/oneiric/postgresql-9.1/oneiric-security

« back to all changes in this revision

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

  • Committer: Bazaar Package Importer
  • Author(s): Martin Pitt
  • Date: 2011-05-11 10:41:53 UTC
  • Revision ID: james.westby@ubuntu.com-20110511104153-psbh2o58553fv1m0
Tags: upstream-9.1~beta1
Import upstream version 9.1~beta1

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/src/sgml/man7/ALTER_USER_MAPPING.7
 
1
'\" t
 
2
.\"     Title: ALTER USER MAPPING
 
3
.\"    Author: The PostgreSQL Global Development Group
 
4
.\" Generator: DocBook XSL Stylesheets v1.75.1 <http://docbook.sf.net/>
 
5
.\"      Date: 2011-04-27
 
6
.\"    Manual: PostgreSQL 9.1beta1 Documentation
 
7
.\"    Source: PostgreSQL 9.1beta1
 
8
.\"  Language: English
 
9
.\"
 
10
.TH "ALTER USER MAPPING" "7" "2011-04-27" "PostgreSQL 9.1beta1" "PostgreSQL 9.1beta1 Documentation"
 
11
.\" -----------------------------------------------------------------
 
12
.\" * set default formatting
 
13
.\" -----------------------------------------------------------------
 
14
.\" disable hyphenation
 
15
.nh
 
16
.\" disable justification (adjust text to left margin only)
 
17
.ad l
 
18
.\" -----------------------------------------------------------------
 
19
.\" * MAIN CONTENT STARTS HERE *
 
20
.\" -----------------------------------------------------------------
 
21
.SH "NAME"
 
22
ALTER_USER_MAPPING \- change the definition of a user mapping
 
23
.\" ALTER USER MAPPING
 
24
.SH "SYNOPSIS"
 
25
.sp
 
26
.nf
 
27
ALTER USER MAPPING FOR { \fIuser_name\fR | USER | CURRENT_USER | PUBLIC }
 
28
    SERVER \fIserver_name\fR
 
29
    OPTIONS ( [ ADD | SET | DROP ] \fIoption\fR [\(aq\fIvalue\fR\(aq] [, \&.\&.\&. ] )
 
30
.fi
 
31
.SH "DESCRIPTION"
 
32
.PP
 
33
ALTER USER MAPPING
 
34
changes the definition of a user mapping\&.
 
35
.PP
 
36
The owner of a foreign server can alter user mappings for that server for any user\&. Also, a user can alter a user mapping for his own user name if
 
37
USAGE
 
38
privilege on the server has been granted to the user\&.
 
39
.SH "PARAMETERS"
 
40
.PP
 
41
\fIuser_name\fR
 
42
.RS 4
 
43
User name of the mapping\&.
 
44
CURRENT_USER
 
45
and
 
46
USER
 
47
match the name of the current user\&.
 
48
PUBLIC
 
49
is used to match all present and future user names in the system\&.
 
50
.RE
 
51
.PP
 
52
\fIserver_name\fR
 
53
.RS 4
 
54
Server name of the user mapping\&.
 
55
.RE
 
56
.PP
 
57
OPTIONS ( [ ADD | SET | DROP ] \fIoption\fR [\(aq\fIvalue\fR\(aq] [, \&.\&.\&. ] )
 
58
.RS 4
 
59
Change options for the user mapping\&. The new options override any previously specified options\&.
 
60
ADD,
 
61
SET, and
 
62
DROP
 
63
specify the action to be performed\&.
 
64
ADD
 
65
is assumed if no operation is explicitly specified\&. Option names must be unique; options are also validated by the server\(aqs foreign\-data wrapper\&.
 
66
.RE
 
67
.SH "EXAMPLES"
 
68
.PP
 
69
Change the password for user mapping
 
70
bob, serverfoo:
 
71
.sp
 
72
.if n \{\
 
73
.RS 4
 
74
.\}
 
75
.nf
 
76
ALTER USER MAPPING FOR bob SERVER foo OPTIONS (user \(aqbob\(aq, password \(aqpublic\(aq);
 
77
.fi
 
78
.if n \{\
 
79
.RE
 
80
.\}
 
81
.SH "COMPATIBILITY"
 
82
.PP
 
83
ALTER USER MAPPING
 
84
conforms to ISO/IEC 9075\-9 (SQL/MED)\&. There is a subtle syntax issue: The standard omits the
 
85
FOR
 
86
key word\&. Since both
 
87
CREATE USER MAPPING
 
88
and
 
89
DROP USER MAPPING
 
90
use
 
91
FOR
 
92
in analogous positions, and IBM DB2 (being the other major SQL/MED implementation) also requires it for
 
93
ALTER USER MAPPING, PostgreSQL diverges from the standard here in the interest of consistency and interoperability\&.
 
94
.SH "SEE ALSO"
 
95
CREATE USER MAPPING (\fBCREATE_USER_MAPPING\fR(7)), DROP USER MAPPING (\fBDROP_USER_MAPPING\fR(7))