ecpg

Nom

ecpg -- pr�processeur SQL C embarqu�

Synopsis

ecpg [option...] fichier...

Description

ecpg est le pr�processeurs embarqu� SQL pour les programmes C. Il convertit des programmes C avec des instructions SQL embarqu�es en du code C normal en rempla�ant les appels au SQL avec les appels sp�ciaux de fonctions. Les fichiers en sortie peuvent �tre trait�s avec tout ensemble d'outils de compilation C.

ecpg convertira chaque fichier donn� en entr�e sur la ligne de commande dans le fichier C correspondant. Les fichiers en entr�es auront de pr�f�rence l'extension .pgc, auquel cas l'extension sera remplac�e par .c pour d�terminer le nom de fichier en sortie. Si l'extension du fichier en entr�e n'est pas .pgc, alors le nom de fichier en sortie est calcul� en ajoutant .c au nom complet du fichier. Le nom de fichier en sortie peut aussi �tre surcharg� en utilisant l'option -o.

Cette page de r�f�rence ne d�crit pas le langage SQL embarqu�. Voir Chapitre 30 pour plus d'informations sur ce th�me.

Options

ecpg accepte les arguments suivants en ligne de commande :

-c

G�n�re automatiquement certain code C � partir de code SQL. Actuellement, ceci fonctionne pour EXEC SQL TYPE.

-C mode

Initialise un mode de compatibilit�. mode pourrait �tre soit INFORMIX soit INFORMIX_SE.

-D symbol

D�finit un symbole C pr�processeur.

-i

Analyse aussi les fichiers d'en-t�te du syst�me.

-I r�pertoire

Sp�cifie un chemin d'inclusion suppl�mentaire, utilis� pour trouver les fichiers inclus via EXEC SQL INCLUDE. Par d�faut, il s'agit de . (r�pertoire actuel), /usr/local/include, le r�pertoire d'en-t�te de PostgreSQL et qui a �t� d�fini au moment de la compilation (par d�faut : /usr/local/pgsql/include) puis /usr/include dans cet ordre.

-o filename

Sp�cifie que ecpg devrait �crire toute sa sortie dans le fichier sp�cifi�.

-r option

S�lectionne un comportement en ex�cution. En m�me temps, option peut seulement valoir no_indicator.

-t

Active la validation automatique (autocommit) des transactions. Dans ce mode, chaque commande SQL est valid�e automatiquement sauf s'il est � l'int�rieur d'un bloc de transaction explicite. Dans le mode par d�faut, les commandes sont valid�es seulement lorsque EXEC SQL COMMIT est ex�cut�e.

-v

Affiche des informations suppl�mentaires incluant la version et le chemin des en-t�tes.

--help

Affiche un bref r�sum� de l'utilisation de la commande mais saisissez exit.

--version

Affiche l'information sur la version puis quitte.

Notes

Lors de la compilation de fichiers de code C pr�trait�s, le compilateur a besoin d'�tre capable de trouver les fichiers d'en-t�te ECPG dans le r�pertoire des en-t�tes de PostgreSQL. Du coup, vous pourriez devoir utiliser l'option -I lors de l'appel du compilateur (c'est-�-dire -I/usr/local/pgsql/include).

Les programmes utilisant le code C avec du SQL embarqu� doivent �tre li� avec la biblioth�que libecpg, par exemple en utilisant les options de l'�diteur de liens -L/usr/local/pgsql/lib -lecpg.

La valeur d'un de ces r�pertoires, appropri�e parmi ces r�pertoires, ce qui est appropri�e si l'installation est trouvable en utilisant pg_config.

Exemples

si vous avez un fichier source en SQL C embarqu� nomm� prog1.pgc, vous pouvez cr�er un programme ex�cutable en utilisant la s�quence suivant de commandes :

ecpg prog1.pgc
cc -I/usr/local/pgsql/include -c prog1.c
cc -o prog1 prog1.o -L/usr/local/pgsql/lib -lecpg