Ces fichiers contiennent tout ce qui est nécessaire à un module pour pouvoir générer ses fichiers de configuration. Notez qu'un même fichier type peut faire appel à plusieurs fichiers de définition. Sans cela, vous ne pourriez pas créer de configurations clients.

Toutes les lignes vides et les commentaires (lignes commençant par un #) sont ignorés. Le fichier est divisé en sections, et chaque section commence par la séquence =>. Selon la complexité du module, vous pouvez trouver une ou plusieurs sections parmi les quatre sections suivantes :

ExeProg

Cette section contient une suite de commandes shell nécessaires à la génération des fichiers de configuration. Notez que ces commandes seront exécutées localement sur le serveur Pitux.

Vous disposez de la variable shell SUDO_USER qui contient votre nom d'utilisateur. Ainsi, vous pouvez référencer votre répertoire personnel par /home/$SUDO_USER.

Vous pouvez par exemple utiliser cette section pour entrer des commandes qui génèrent des fichiers de configuration dynamiquement. Le module qmail-tbs, par exemple, utilise cette section pour générer les certificats TLS.

Exemple :

=>ExeProg

vos commandes shell ici

ConfList

Cette section contient une liste des fichiers de configuration affectés par ce module. Chaque ligne de cette section a la forme :

fichier user grp mode [options]

• no-m4 indique au système Pitux que le fichier ne doit pas être touché par m4 ;
• no-null indique au système Pitux que le fichier en question ne doit pas être vide.

Exemple :

=>ConfList

/etc/resolv.conf root wheel 444 no-m4
/etc/rc.d/init.d/mon_truc.sh root wheel 500 no-m4 no-null
/etc/rndc.conf root wheel 400

ParamList

Cette section contient des références à des fichiers de paramètre, situés dans m4params, par leur nom et sans le chemin. Il arrive qu'un module ne prenne pas de paramètres (ssh en est un exemple).

RPM

Cette section contient une liste des RPM à installer pour faire fonctionner le module correctement. Seul le nom du paquetage doit être mentionné, pas le nom du RPM complet. Vous pouvez obtenir le nom du paquetage de la façon suivante :

$ rpm -qp --queryformat "%{name}\n" iptraf-2.5.0-2mdk.i586.rpm                        
iptraf

=>RPM

iptraf