Les différentes commandes
Ce chapitre contient une description détaillée des
différentes commandes fournies avec le logiciel, avec leurs
options. Nous avons essayé de le rendre compréhensible
à tous, mais il est parfois difficile d'éviter le jargon
technique: si vous n'êtes pas un spécialiste en
informatique, sautez les explications qui vous paraissent difficiles.
- Démon GeneWeb: gwd
- Gedcom vers GeneWeb: ged2gwb
- GeneWeb vers Gedcom: gwb2ged
- Compilateur GeneWeb: gwc
- Décompilateur GeneWeb: gwu
- Précalcul de consanguinité: consang
Gwd est la commande principale de GeneWeb. Il reçoit
des requêtes et répond le résultat, via le
réseau internet et en suivant le protocole HTTP des serveurs
Web.
Gwd peut fonctionner en deux modes: le mode serveur et le mode CGI.
En mode serveur, il se comporte comme un serveur Web normal (sauf
qu'il ne sert que de la généalogie). Il n'a pas besoin
de serveur Web pour fonctionner et ne gène pas un serveur Web
éventuellement installé sur le même ordinateur.
Il passe le plus clair de son temps à attendre passivement des
connexions. Quand une connexion arrive, il la traite, répond le
résultat et se remet en attente. Sous Unix, il peut traiter
plusieurs connexions en même temps.
En mode CGI, il se comporte comme un programme CGI: il a besoin d'un serveur
Web pour fonctionner. Quand une requête le concerne, le serveur Web
le lance en lui transmettant la requête à traiter et attend
qu'il lui réponde le résultat.
Voici quelles sont les options de "gwd":
- -help
Affiche la liste des options (en anglais) et
s'arrête.
- -hd répertoire
Indique le répertoire où sont installés les
fichiers de GeneWeb. Par défaut, c'est le
répertoire courant. Il doit contenir un répertoire
"lang" et un répertoire "images".
- -bd répertoire
Indique le répertoire où sont installées les
bases de données. Par défaut, c'est le répertoire
courant. Il peut contenir aussi un répertoire "lang" et un
répertoire "images": gwd va d'abord consulter ce
répertoire pour ses fichiers, et s'il ne les trouve pas, va
chercher dans le répertoire spécifié par l'option
"-hd" ci-dessus.
- -cgi
Force le mode CGI. Cette option est en principe inutile, car gwd
détecte tout seul quand il est lancé par un serveur Web.
Cette option permet d'en être sûr (car il ne faut pas que
le serveur Web puisse lancer "gwd" en serveur par mégarde), et
permet de tester le résultat de gwd dans une fenêtre
intéractive, pour vérifier son bon fonctionnement.
- -p numéro
En mode serveur, sélectionne un numéro de port. Par
défaut, c'est 2317. N'importe quel autre nombre
supérieur à 1024 peut être choisi, à
condition qu'il ne soit pas déjà pris par un autre
service. Pour choisir un numéro inférieur à 1024,
il faut être root (sous Unix) ou Administrateur (sous
Windows). Note: en choisissant le port 80, qui est le port par
défaut des serveurs Web, on n'a pas besoin de spécifier
":numéro" dans l'adresse HTTP à utiliser.
- -wizard mot-de-passe
Donne un mot de passe "sorcier" par défaut. Le
sorcier a accès à toutes les informations et a
le droit de faire des modifications en ligne dans une base de
données. Cette option peut être masquée par la
présence d'un fichier "toto.cnf" pour la base "toto".
- -friend mot-de-passe
Donne un mot de passe "ami" par défaut. L'ami a
accès à toutes les dates et informations personnelles,
même pour les personnes nées avant un siècle. Il
n'a pas accès aux modifications en ligne. Cette option peut
être masquée par la présence d'un fichier
"toto.cnf" pour la base "toto".
- -lang id
Spécifie une langue par défaut. Par défaut de cette
option, c'est le français (fr). Cette option peut
être masquée par la présence d'un fichier
"toto.cnf" pour la base "toto".
- -only adresse
Spécifie une adresse internet qui sera la seule ayant le
droit d'accéder au site. L'adresse est celle qui est
affichée derrière "From:" dans les traces de gwd.
- -auth fichier
Spécifie une restriction d'accès au site par nom
d'utilisateur et mot de passe. Le fichier doit contenir une ou
plusieurs lignes de la forme "utilisateur:mot-de-passe".
- -log fichier
Redirige les traces de connexion dans ce fichier. Par défaut, elle
s'affichent dans la fenêtre intéractive.
- -nolock
Demande de ne pas verrouiller une base de données quand on
la modifie. Cela peut être dangereux, car si deux utilisateurs
la modifient exactement en même temps, la base peut être
abîmée. Néanmoins, cette option est utile quand on
est sous Unix et qu'on accède la base par NFS, car le
verrouillage ne fonctionne pas sous NFS et bloque la réponse de
gwd pendant quelques interminables secondes.
- -max_clients nombre
Cette option ne fonctionne que dans la version Unix (pas
Windows). Indique le nombre maximum de clients à traiter en
même temps (mode serveur uniquement). Le défaut est de ne
pas donner de limite. Il est fortement conseillé
d'utiliser cette option sous Unix si vous n'utilisez pas gwd
en local, car chaque connexion lance un nouveau processus et des
connexions à un rythme élevé (par un robot ou par
un taré qui fait cinquante "reload" à toute vitesse)
risque d'écrouler votre ordinateur.
- -robot_xcl cnt,sec
Cette option ne fonctionne que dans la version Unix (pas
Windows). Permet d'exclure les robots qui ne disent pas leur nom. En
principe, gwd indique aux robots qu'ils ne doivent pas parcourir le
site (car le nombre de requêtes possibles est quasiment infini).
Cependant, comme il est possible de lancer des robots qui ne
respectent pas cette injonction, cette option tente de les
détecter et exclut ceux qu'il réussit à
repérer. Si un client fait plus de cnt connexions en
sec secondes, on considère qu'il est un robot, et il
est définitivement rejeté (jusqu'à ce qu'on
relance gwd). En fait, cette option n'est pas complètement
satisfaisante, car il n'est pas facile de donner de "bonnes" valeurs
aux paramètres. Il est donc possible qu'elle change dans une
version future.
Pour transmettre des options, vous pouvez aussi fabriquer un fichier
que vous nommerez "gwd.arg" dans le même répertoire que
la commande "gwd". Ce fichier contient les options, mais en les
séparant par des lignes, au lieu d'espaces. Par exemple, si
vous voulez que "gwd" se lance ainsi:
gwd -bd bases -wizard "mon mot de passe" -p 8022
vous pouvez faire un fichier "gwd.arg" contenant:
-bd
bases
-wizard
mon mot de passe
-p
8022
et il vous suffira alors de ne taper que "gwd".
Sous Windows, vous pouvez simplement double-cliquer sur l'icône
de gwd. Cela ouvrira une fenêtre MSDOS où gwd sera
lancé. En tapant Control-C, gwd s'arrêtera et la
fenêtre MSDOS se fermera. Utilisez éventuellement la
technique du fichier "gwd.arg" ci-dessus pour transmettre des options.
Gedcom vers GeneWeb: ged2gwb
Convertit un fichier GEDCOM en base de données GeneWeb.
Les différentes options sont:
- -help
Affiche la liste des options (en anglais) et s'arrête.
- -o nom
Donne le nom de la base de données à
créer. Par défaut, c'est "a". Cela créera un
répertoire de nom "nom.gwb".
- -lf
Enregistre les prénoms en minuscule, en ne conservant que leur
première lettre en majuscule.
- -ls
Enregistre les noms de famille en minuscule, en ne conservant que leur
première lettre en majuscule. Essaie de conserver les minuscules pour
les particules.
- -efn
Au moment de créer une personne, si le prénom dans le
fichier GEDCOM comporte plusieurs noms, le premier de ces noms devient
le "prénom" de la personne et le prénom complet est mis
dans les "autres prénoms". À l'affichage, on ne verra
que le premier prénom en titre. Cette option est par
défaut. Pour la supprimer, utiliser "-no_efn".
- -no_efn
Annule l'option précédente.
- -epn
Au moment de créer une personne, si le prénom dans le
fichier GEDCOM ressemble à un nom public, c'est-à-dire
contient:
- un nombre en chiffres arabes ou romains, censé être
un numéro de titre de noblesse.
- un des mots suivants: "der", "die", "el", "le", "la", "the",
censé être le début d'un qualificatif.
alors le prénom du fichier GEDCOM est mis comme "nom public" et
le premier mot du prénom comme "prénom". Cette option
est par défaut. Pour l'annuler, utiliser "-no_epn".
- -no_epn
Annule l'option précédente.
- -tnd
Met des dates négatives (avant Jésus Christ) s'il y a
une incohérence (par exemple, naissance après
décès), ceci pour les fichiers GEDCOM de bases de
données ayant des dates négatives et construites
à partir de (mauvais) logiciels ne sachant pas traiter les
dates négatives.
- -ansel
Indique que le fichier GEDCOM contient un codage ANSEL, même
si ce n'est pas écrit explicitement dans la zone du fichier
GEDCOM prévue à cet effet.
- -no_ansel
Indique que le fichier GEDCOM ne contient pas de codage ANSEL, même
si la zone prévue à cet effet dans le fichier l'indique.
- -nd
Les personnes qui ont un champ "DEAT" vide sont enregistrées comme
non décédées. Par défaut, leur décès
est mis dans la catégorie "ne sais pas".
GeneWeb vers Gedcom: gwb2ged
Extrait une base de données GeneWeb en format GEDCOM.
Les différentes options sont:
- -help
Affiche la liste des options (en anglais) et s'arrête.
- -o fichier
Nom du fichier en sortie. Par défaut, c'est "a.ged".
- -a prénom [numéro] nom
Ne sélectionne que les ancêtres de la personne portant ce
prénom (on peut optionnellement préciser son
numéro si ce n'est pas 0) et ce nom. Mettre le prénom ou
le nom entre guillemets s'il contient des espaces.
- -d prénom [numéro] nom
Ne sélectionne que les descendants de la personne portant ce
prénom (on peut optionnellement préciser son
numéro si ce n'est pas 0) et ce nom. Mettre le prénom ou
le nom entre guillemets s'il contient des espaces.
- -mem
Fait l'opération en économisant l'espace mémoire.
La contrepartie est qu'elle est plus lente.
Si les options "-a" et "-d" sont utilisées, c'est
l'intersection des groupes qui est assumé (et non l'union). Si
on veut, par exemple ne garder que la (ou les) branches qui
mènent d'une personne à un de ses ancêtres, on
peut le faire en combinant les deux options.
Compilateur GeneWeb: gwc
On peut construire des bases de données GeneWeb
à partir de fichiers sources, dans le langage "gw". Ce language
n'est pas documenté, mais, en gros, il décrit des
familles: le père, la mère, les enfants.
Le compilateur "gwc" lit les fichiers sources en se chargeant de
relier les personnes. Il construit une base de données
GeneWeb.
L'opération inverse, c'est-à-dire création de fichiers
sources à partir d'une base de données GeneWeb peut
se faire par la commande "gwu" (voir plus loin).
Les fichiers ".gw" et les bases GeneWeb sont
équivalents. Quand on passe de fichiers ".gw" en bases
GeneWeb et vice-versa, on ne pert pas d'informations. Ce
n'est pas le cas, par contre de "ged2gwb" et "gwb2ged" qui peuvent
perdre des informations.
La commande "gwc" s'utilise avec des options et se termine par
zéro, un ou plusieurs fichiers ".gw" ou ".gwo".