A la sortie du boulot ce soir, comme il n'y avait rien à la TV (malgré la première soirée de France Télévision sans Pub), j'ai passé ma soirée à réviser mes connaissances en compilation avec les autotools de GNU/Linux (autoconf, automake, aclocal etc....).
Faisant suite à un programme que j'avais commencé cet été, je l'ai donc repris et me suis mis à faire de la compilation séparée. Le programme est disponible à http://www.davidgis.fr/download/check_gis_db-1.0.tar.gz
Mise à jour du billet le 2009-01-12 J'ai ajouté le support pour le choix du port du serveur (=option pour le programme). Cette version estampillée 1.1 est disponible à http://www.davidgis.fr/download/check_gis_db-1.1.tar.gz
0.Téléchargement
Le téléchargement a lieu en faisant
wget http://www.davidgis.fr/download/check_gis_db-1.0.tar.gz
tar xvzf check_gis_db-1.0.tar.gz
Fichiers importants
En premier lieu le programme repose sur deux requêtes
- La première "SELECT datname FROM pg_database" se trouve dans
src/check_gis_db.c et permet de lister l'ensemble des bases.
- La seconde requête permet de savoir si le base contient la fonctionnalité postgis_full_version(). Elle se trouve dans
src/funcs.c au niveau de la fonction IsADbGIS. Je ne l'affiche pas ici car elle est assez longue.
En second lieu, il y a configure.ac dont le contenu est
# -*- Autoconf -*-
# Process this file with autoconf to produce a configure script.
AC_PREREQ(2.61)
AC_INIT(check_gis_db, 1.0, david.techer@davidgis.fr)
AC_CONFIG_SRCDIR([src/check_gis_db.c])
AC_CONFIG_HEADER([config.h])
AM_INIT_AUTOMAKE(1.6)
# Checks for programs.
AC_PROG_CC
AC_PROG_INSTALL
# Checks for libraries.
# Checks for header files.
AC_HEADER_STDC
AC_CHECK_HEADERS(stdlib.h getopt.h string.h)
# Checks for typedefs, structures, and compiler characteristics.
# Checks for library functions.
AC_SUBST(PGCONFIG)
if test -z "$PGCONFIG"; then
AC_PATH_PROG([PGCONFIG], [pg_config])
fi
if test -z "$PGCONFIG"; then
AC_MSG_ERROR([pg_config n'est pas present dans votre PATH]);
fi
AC_OUTPUT(Makefile src/Makefile)
On remarque que la ligne AC_CHECK_HEADERS(stdlib.h getopt.h string.h) est importante par rapport au début du fichier src/check_gis_db.c - début correspondant à -
#include <stdio.h>
#include <stdlib.h>
#include <getopt.h>
#include <string.h>
La ligne AC_OUTPUT(Makefile src/Makefile) est aussi à prendre en considération pour savoir quels makefile générés relativement à check_gis_db-1.0/Makefile.am et check_gis_db-1.0/src/Makefile.am
Pour la partie relative à pg_config, là je me suis basé sur le code du configure.in des sources de PostGIS.
Le contenu du fichier src/Makefile.am quant à lui est
bin_PROGRAMS = check_gis_db
check_gis_db_SOURCES = check_gis_db.c funcs.c funcs.h
AM_CFLAGS=-I`${PGCONFIG} --includedir`
AM_LDFLAGS=-L`${PGCONFIG} --libdir` -lpq
2.a Compilation sans pg_config dans le PATH
On modifie légèrement le PATH
root@olivia:~/check_gis_db-1.0# export PATH=/var/qmail/bin:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin:/usr/games
root@olivia:~/check_gis_db-1.0# ./configure
checking for a BSD-compatible install... /usr/bin/install -c
checking whether build environment is sane... yes
checking for gawk... gawk
checking whether make sets $(MAKE)... yes
checking for gcc... gcc
checking for C compiler default output file name... a.out
checking whether the C compiler works... yes
checking whether we are cross compiling... no
checking for suffix of executables...
checking for suffix of object files... o
checking whether we are using the GNU C compiler... yes
checking whether gcc accepts -g... yes
checking for gcc option to accept ISO C89... none needed
checking for style of include used by make... GNU
checking dependency style of gcc... gcc3
checking for a BSD-compatible install... /usr/bin/install -c
checking how to run the C preprocessor... gcc -E
checking for grep that handles long lines and -e... /bin/grep
checking for egrep... /bin/grep -E
checking for ANSI C header files... yes
checking for sys/types.h... yes
checking for sys/stat.h... yes
checking for stdlib.h... yes
checking for string.h... yes
checking for memory.h... yes
checking for strings.h... yes
checking for inttypes.h... yes
checking for stdint.h... yes
checking for unistd.h... yes
checking for stdlib.h... (cached) yes
checking getopt.h usability... yes
checking getopt.h presence... yes
checking for getopt.h... yes
checking for string.h... (cached) yes
checking for pg_config... no
configure: error: pg_config n'est pas present dans votre PATH
2.a Compilation avec pg_config dans le PATH
root@olivia:~/check_gis_db-1.0# export PATH=/usr/local/pgsql/bin/:/var/qmail/bin:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin:/usr/games
root@olivia:~/check_gis_db-1.0# ./configure
checking for a BSD-compatible install... /usr/bin/install -c
checking whether build environment is sane... yes
checking for gawk... gawk
checking whether make sets $(MAKE)... yes
checking for gcc... gcc
checking for C compiler default output file name... a.out
checking whether the C compiler works... yes
checking whether we are cross compiling... no
checking for suffix of executables...
checking for suffix of object files... o
checking whether we are using the GNU C compiler... yes
checking whether gcc accepts -g... yes
checking for gcc option to accept ISO C89... none needed
checking for style of include used by make... GNU
checking dependency style of gcc... gcc3
checking for a BSD-compatible install... /usr/bin/install -c
checking how to run the C preprocessor... gcc -E
checking for grep that handles long lines and -e... /bin/grep
checking for egrep... /bin/grep -E
checking for ANSI C header files... yes
checking for sys/types.h... yes
checking for sys/stat.h... yes
checking for stdlib.h... yes
checking for string.h... yes
checking for memory.h... yes
checking for strings.h... yes
checking for inttypes.h... yes
checking for stdint.h... yes
checking for unistd.h... yes
checking for stdlib.h... (cached) yes
checking getopt.h usability... yes
checking getopt.h presence... yes
checking for getopt.h... yes
checking for string.h... (cached) yes
checking for pg_config... /usr/local/pgsql/bin//pg_config
configure: creating ./config.status
config.status: creating Makefile
config.status: creating src/Makefile
config.status: creating config.h
config.status: config.h is unchanged
config.status: executing depfiles commands
root@olivia:~/check_gis_db-1.0# make
make all-recursive
make[1]: entrant dans le répertoire « /root/check_gis_db-1.0 »
Making all in src
make[2]: entrant dans le répertoire « /root/check_gis_db-1.0/src »
if gcc -DHAVE_CONFIG_H -I. -I. -I.. -I`/usr/local/pgsql/bin//pg_config --includedir` -g -O2 -MT check_gis_db.o -MD -MP -MF ".deps/check_gis_db.Tpo" -c -o check_gis_db.o check_gis_db.c; \
then mv -f ".deps/check_gis_db.Tpo" ".deps/check_gis_db.Po"; else rm -f ".deps/check_gis_db.Tpo"; exit 1; fi
if gcc -DHAVE_CONFIG_H -I. -I. -I.. -I`/usr/local/pgsql/bin//pg_config --includedir` -g -O2 -MT funcs.o -MD -MP -MF ".deps/funcs.Tpo" -c -o funcs.o funcs.c; \
then mv -f ".deps/funcs.Tpo" ".deps/funcs.Po"; else rm -f ".deps/funcs.Tpo"; exit 1; fi
gcc -I`/usr/local/pgsql/bin//pg_config --includedir` -g -O2 -L`/usr/local/pgsql/bin//pg_config --libdir` -lpq -o check_gis_db check_gis_db.o funcs.o
make[2]: quittant le répertoire « /root/check_gis_db-1.0/src »
make[2]: entrant dans le répertoire « /root/check_gis_db-1.0 »
make[2]: quittant le répertoire « /root/check_gis_db-1.0 »
make[1]: quittant le répertoire « /root/check_gis_db-1.0 »
3. Tests
Si on ne précise aucun paramètre
root@olivia:~/check_gis_db-1.0# ./src/check_gis_db
Usage: check_gis_db -h hôte -d basededonees -u utilisateur -p motdepasse
Avec des paramètres bidons
root@olivia:~/check_gis_db-1.0# ./src/check_gis_db -h toto -d template1 -u postgres -p amma
Tentative de la connexion..........................[ ECHEC ]
[ERREUR]............................................could not translate host name "toto" to address: Name or service not known
Connexion fermée.....................................[ OK ]
On fait un petit test en faisant
root@olivia:~/check_gis_db-1.0# ./src/check_gis_db -h localhost -d template1 -u postgres -p amma
Tentative de la connexion.............................[ OK ]
hote...............................................localhost
base...............................................template1
port....................................................5432
utilisateur.........................................postgres
mot de passe............................................amma
toto
testgis
osmgis
routing
routing_db
montpellier
routing_test
testrouting
Connexion fermée.....................................[ OK ]
Et on a donc la liste des base de données ayant les fonctionnalités de PostGIS. Le programme n'a pas été poussé dans toutes ses possibilités car je ne fais que tester la présence de la fonctionnalité postgis_full_version() alors qu'il faudrait faire des tests plus poussés.
4. Rappels
A chaque modification du fichier configure.ac, il est nécessaire de se retaper
aclocal
autoconf
automake
Pour la génération de la distrib, il y a la commande qui va générer le fichier check_gis_db-1.0.tar.gz en fonction du numéro de version fourni dans configure.ac (ici version=1.0)
make dist
4. sources pour la rédaction de ce billet
! Je pense à vous tous très fort et vous souhaite pleins de bonnes choses pour cette nouvelle année qui s'annonce bientôt...