File: ms_check_pgsql_db.html

package info (click to toggle)
autoconf-archive 20090426-1
  • links: PTS
  • area: main
  • in suites: squeeze
  • size: 5,692 kB
  • ctags: 12
  • sloc: sh: 619; makefile: 22
file content (141 lines) | stat: -rw-r--r-- 4,888 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01//EN"
"http://www.w3.org/TR/html4/strict.dtd">
<html lang="en">
 <head>
  <title>
   Autoconf Macro: ms_check_pgsql_db
  </title>
  <link rel="stylesheet" type="text/css" href="autoconf-archive.css">
  <meta http-equiv="Content-Type" content="text/html; charset=us-ascii">
 </head>
 <body>
  <table summary="web navigation" style="width:100%;">
   <tbody>
    <tr>
     <td style="width:33%;" align="center" valign="top">
      <a href="macros-by-category.html">Macros by Category</a>
     </td>
     <td style="width:33%;" align="center" valign="top">
      <a href=
      "http://git.cryp.to/autoconf-archive/history/master:/ms_check_pgsql_db.m4">
      Revision History</a>
     </td>
     <td style="width:33%;" align="center" valign="top">
      <form method="get" action="http://www.google.com/search">
       <div>
        <input name="sitesearch" value="autoconf-archive.cryp.to" type=
        "hidden">Search: <input name="q" maxlength="255" type="text">
       </div>
      </form>
     </td>
    </tr>
   </tbody>
  </table>
  <hr>
  <h1>
   ms_check_pgsql_db
  </h1>
  <h2>
   SYNOPSIS
  </h2>
  <p class="indent" style="white-space:nowrap;">
   <code>MS_CHECK_PGSQL_DB([DB], [USER], [HOST], [PASSWORD],
   [ACTION_IF_FAILED], [ACTION_IF_OK])</code>
  </p>
  <h2>
   DESCRIPTION
  </h2>
  <div class="indent">
   <p>
    This macro checks wether we can connect to a PostgreSQL server with the
    given data. The macro <a href="ms_prog_pgclient.html">MS_PROG_PGCLIENT</a>
    is required by this one. The variable $pgclient_call is set for later use
    in Makefiles, if you'd like to make use of this, you must do
   </p>
   <pre>
    AC_SUBST(pgclient_call)
</pre>
   <p>
    after having called MS_CHECK_PGSQL_DB. You can then do something like the
    following in your Makefile.am:
   </p>
   <pre>
    @pgclient_call@ -f file.sql
</pre>
   <p>
    If you want the user to set the data, you should support something like
    these configure options:
   </p>
   <pre>
    AC_ARG_WITH(pgsql-host,
            [  --with-pgsql-host=HOST               server is running on HOST @&lt;:@local socket@:&gt;@],
            [pg_host=$withval], [pg_host=])

    AC_ARG_WITH(pgsql-db,
            [  --with-pgsql-db=DATABASE             use DATABASE @&lt;:@tarantoola@:&gt;@],
            [pg_db=$withval], [pg_db=tarantoola])

    AC_ARG_WITH(pgsql-user,
            [  --with-pgsql-user=USER               use USER @&lt;:@postgres@:&gt;@],
            [pg_user=$withval], [pg_user=postgres])

    AC_ARG_WITH(pgsql-password,
            [  --with-pgsql-password=PASSWORD       use PASSWORD @&lt;:@none@:&gt;@],
            [pg_password=$withval], [pg_password=""])
</pre>
   <p>
    You can then call the macro like this:
   </p>
   <pre>
    MS_CHECK_PGSQL_DB([$pg_db], [$pg_user], [$pg_host], [$pg_password], [AC_MSG_ERROR([We need a database connection!])])
</pre>
  </div>
  <h2>
   SOURCE CODE
  </h2>
  <p class="indent">
   <a href=
   "http://autoconf-archive.cryp.to/ms_check_pgsql_db.m4">http://autoconf-archive.cryp.to/ms_check_pgsql_db.m4</a>
  </p>
  <h2>
   LICENSE
  </h2>
  <div class="indent">
   <p style="white-space:nowrap;">
    Copyright &copy; 2008 Moritz Sinn &lt;moritz@freesources.org&gt;
   </p>
   <p>
    This program is free software; you can redistribute it and/or modify it
    under the terms of the GNU General Public License as published by the Free
    Software Foundation; either version 2 of the License, or (at your option)
    any later version.
   </p>
   <p>
    This program is distributed in the hope that it will be useful, but WITHOUT
    ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
    FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
    more details.
   </p>
   <p>
    You should have received a copy of the GNU General Public License along
    with this program. If not, see &lt;<a href=
    "http://www.gnu.org/licenses/">http://www.gnu.org/licenses/</a>&gt;.
   </p>
   <p>
    As a special exception, the respective Autoconf Macro's copyright owner
    gives unlimited permission to copy, distribute and modify the configure
    scripts that are the output of Autoconf when processing the Macro. You need
    not follow the terms of the GNU General Public License when using or
    distributing such scripts, even though portions of the text of the Macro
    appear in them. The GNU General Public License (GPL) does govern all other
    use of the material that constitutes the Autoconf Macro.
   </p>
   <p>
    This special exception to the GPL applies to versions of the Autoconf Macro
    released by the Autoconf Archive. When you make and distribute a modified
    version of the Autoconf Macro, you may extend this special exception to the
    GPL to apply to your modified version as well.
   </p>
  </div>
 </body>
</html>