~ubuntu-branches/ubuntu/saucy/postfix/saucy

« back to all changes in this revision

Viewing changes to src/global/dict_pgsql.c

  • Committer: Bazaar Package Importer
  • Author(s): LaMont Jones
  • Date: 2011-02-22 11:20:43 UTC
  • mfrom: (1.1.27 upstream)
  • Revision ID: james.westby@ubuntu.com-20110222112043-c34ht219w3ybrilr
Tags: 2.8.0-2
* a little more lintian cleanup
* Fix missing format strings in smtp-sink.c

Show diffs side-by-side

added added

removed removed

Lines of Context:
32
32
/*      obtain main.cf configuration parameters for this search.
33
33
/*
34
34
/*      In the first case, the configuration parameters below are
35
 
/*      specified in the file as \fIname\fR=\fBvalue\fR pairs.
 
35
/*      specified in the file as \fIname\fR=\fIvalue\fR pairs.
36
36
/*
37
37
/*      In the second case, the configuration parameters are
38
38
/*      prefixed with the value of \fIname\fR and an underscore,
48
48
/*
49
49
/* .PP
50
50
/*      Configuration parameters:
51
 
/*
52
 
/*      The parameters encode a number of pieces of information:
53
 
/*      username, password, databasename, table, select_field,
54
 
/*      where_field, and hosts:
55
 
/* .IP \fIuser\fR
 
51
/* .IP user
56
52
/*      Username for connecting to the database.
57
 
/* .IP \fIpassword\fR
 
53
/* .IP password
58
54
/*      Password for the above.
59
 
/* .IP \fIdbname\fR
 
55
/* .IP dbname
60
56
/*      Name of the database.
61
 
/* .IP \fIquery\fR
 
57
/* .IP query
62
58
/*      Query template. If not defined a default query template is constructed
63
59
/*      from the legacy \fIselect_function\fR or failing that the \fItable\fR,
64
60
/*      \fIselect_field\fR, \fIwhere_field\fR, and \fIadditional_conditions\fR
65
61
/*      parameters. Before the query is issues, variable substitutions are
66
62
/*      performed. See pgsql_table(5).
67
 
/* .IP \fIdomain\fR
 
63
/* .IP domain
68
64
/*      List of domains the queries should be restricted to.  If
69
65
/*      specified, only FQDN addresses whose domain parts matching this
70
66
/*      list will be queried against the SQL database.  Lookups for
71
67
/*      partial addresses are also supressed.  This can significantly
72
68
/*      reduce the query load on the server.
73
 
/* .IP \fIresult_format\fR
 
69
/* .IP result_format
74
70
/*      The format used to expand results from queries.  Substitutions
75
71
/*      are performed as described in pgsql_table(5). Defaults to returning
76
72
/*      the lookup result unchanged.
79
75
/*      exceed the limit fail with dict_errno=DICT_ERR_RETRY. Note that each
80
76
/*      non-empty (and non-NULL) column of a multi-column result row counts as
81
77
/*      one result.
82
 
/* .IP \fIselect_function\fR
 
78
/* .IP select_function
83
79
/*      When \fIquery\fR is not defined, the function to be used instead of
84
80
/*      the default query based on the legacy \fItable\fR, \fIselect_field\fR,
85
81
/*      \fIwhere_field\fR, and \fIadditional_conditions\fR parameters.
86
 
/* .IP \fItable\fR
 
82
/* .IP table
87
83
/*      When \fIquery\fR and \fIselect_function\fR are not defined, the name of the
88
84
/*      FROM table used to construct the default query template, see pgsql_table(5).
89
 
/* .IP \fIselect_field\fR
 
85
/* .IP select_field
90
86
/*      When \fIquery\fR and \fIselect_function\fR are not defined, the name of the
91
87
/*      SELECT field used to construct the default query template, see pgsql_table(5).
92
 
/* .IP \fIwhere_field\fR
 
88
/* .IP where_field
93
89
/*      When \fIquery\fR and \fIselect_function\fR are not defined, the name of the
94
90
/*      WHERE field used to construct the default query template, see pgsql_table(5).
95
 
/* .IP \fIadditional_conditions\fR
 
91
/* .IP additional_conditions
96
92
/*      When \fIquery\fR and \fIselect_function\fR are not defined, the name of the
97
93
/*      additional text to add to the WHERE field in the default query template (this
98
94
/*      usually begins with "and") see pgsql_table(5).
99
 
/* .IP \fIhosts\fR
 
95
/* .IP hosts
100
96
/*      List of hosts to connect to.
101
97
/* .PP
102
98
/*      For example, if you want the map to reference databases of
107
103
/*      "postfix" and password "passwd" then the configuration file
108
104
/*      should read:
109
105
/* .PP
110
 
/*      \fIuser\fR = \fBpostfix\fR
111
 
/* .br
112
 
/*      \fIpassword\fR = \fBpasswd\fR
113
 
/* .br
114
 
/*      \fIdbname\fR = \fBpostfix_info\fR
115
 
/* .br
116
 
/*      \fItable\fR = \fBaliases\fR
117
 
/* .br
118
 
/*      \fIselect_field\fR = \fBforw_addr\fR
119
 
/* .br
120
 
/*      \fIwhere_field\fR = \fBalias\fR
121
 
/* .br
122
 
/*      \fIhosts\fR = \fBhost1.some.domain\fR \fBhost2.some.domain\fR
 
106
/*      user = postfix
 
107
/* .br
 
108
/*      password = passwd
 
109
/* .br
 
110
/*      dbname = postfix_info
 
111
/* .br
 
112
/*      table = aliases
 
113
/* .br
 
114
/*      select_field = forw_addr
 
115
/* .br
 
116
/*      where_field = alias
 
117
/* .br
 
118
/*      hosts = host1.some.domain\fR \fBhost2.some.domain
123
119
/* .PP
124
120
/* SEE ALSO
125
121
/*      dict(3) generic dictionary manager