]> granicus.if.org Git - postgresql/blob - src/backend/libpq/pg_ident.conf.sample
Improve comments in pg_ident.conf.sample.
[postgresql] / src / backend / libpq / pg_ident.conf.sample
1 # PostgreSQL User Name Maps
2 # =========================
3 #
4 # Refer to the PostgreSQL Administrator's Guide, chapter "Client
5 # Authentication" for a complete description.  A short synopsis follows.
6 #
7 # This file controls PostgreSQL username mapping. It maps
8 # external user names to their corresponding
9 # PostgreSQL user names.  Records are of the form:
10 #
11 # MAPNAME  SYSTEM-USERNAME  PG-USERNAME
12 #
13 # (The uppercase quantities must be replaced by actual values.)
14 #
15 # MAPNAME is the (otherwise freely chosen) map name that was used in
16 # pg_hba.conf.  SYSTEM-USERNAME is the detected user name of the
17 # client.  PG-USERNAME is the requested PostgreSQL user name.  The
18 # existence of a record specifies that SYSTEM-USERNAME may connect as
19 # PG-USERNAME.
20 #
21 # If SYSTEM-USERNAME starts with a slash (/), it will be treated as
22 # a regular expression.  Optionally this can contain a capture (a
23 # parenthesized subexpression).  The substring matching the capture
24 # will be substituted for \1 (backslash-one) if present in PG-USERNAME.
25 #
26 # Multiple maps may be specified in this file and used by pg_hba.conf.
27 #
28 # No map names are defined in the default configuration.  If all system
29 # user names and PostgreSQL user names are the same, you don't need
30 # anything in this file.
31 #
32 # This file is read on server startup and when the postmaster receives
33 # a SIGHUP signal.  If you edit the file on a running system, you have
34 # to SIGHUP the postmaster for the changes to take effect.  You can use
35 # "pg_ctl reload" to do that.
36
37 # Put your actual configuration here
38 # ----------------------------------
39
40 # MAPNAME     SYSTEM-USERNAME    PG-USERNAME