Suiv.: Remise à jour des sources Sup.: 10 Gestion sous UNIX Préc.: Mode d'emploi en développement Table des matières

10.3 Description des commandes

bb : gestion de la bibliothèque

UTILISATION : bb clé [bibliothèque] membre
DESCRIPTION : bb permet de gérer la bibliothèque Modulef (ou tout autre bibliothèque ayant une structure identique).
La clé est obligatoire et détermine une action à effectuer sur un membre de la bibliothèque. Elle peut être suivie d' un ou deux arguments :
(1.) bb clé membre
(2.) bb clé bibliothèque membre
En (1.), on recherche dans quelle bibliothèque de Modulef le membre est rangé.
En (2.), toutes les informations permettant de localiser le membre sont fournies.
EXEMPLE : pour visualiser le source du sous-programme readre, on peut taper :

	bb r readre
ou	bb r util readre

CLES de bb :
c	Copie le membre dans le répertoire courant (excepté si le membre existe déjà).
cf	Copie forcée du membre dans le répertoire courant
e	Copie le membre dans le répertoire courant et visualise la copie dans une fenêtre éditable.
elm	Effectue une édition de liens, avec Modulef, du membre indiqué.
	Exemple : B$ bb elm imagxx
	crée le fichier exécutable imagxx et le range dans le répertoire $MR/$MM/$MV/bin.
eso	Est équivalent à bb e suivi de bb so (pour corriger rapidement un membre).
ou	Indique seulement où se trouve le membre.
r	Visualise le membre dans une fenêtre accessible en lecture seulement. On peut ainsi visualiser rapidement un membre qui est protégé en écriture.
s	Met à jour le source lorsque le répertoire courant contient des données à ajouter ou à remplacer dans la bibliothèque.
so	Met à jour le source (comme précédemment), puis le compile avec la commande co1 (compilateur Fortran) et met à jour l'archive objet concerné.
d	Détruit le fichier source et l'objet.

Lorsque vous utilisez les options s so et d chacune de vos modifications est mémorisée dans le fichier $MR/$MM/$MV/etc/maj.fo.

bbg : gestion globale de la bibliothèque

UTILISATION : bbg clé membre
DESCRIPTION : bbg permet de gérer la bibliothèque Modulef (ou tout autre bibliothèque ayant une structure identique).
La clé est obligatoire, elle détermine une action à effectuer sur une ou plusieurs bibliothèques entières de Modulef. Elle est suivie d'au plus un argument :
(1.) bbg clé
(2.) bbg clé bibliothèque
En (1.), l'action est effectuée sur toutes les bibliothèques de Modulef.
En (2.), l'action est effectuée seulement sur la bibliothèque donnée.
EXEMPLE : pour recompiler toute la bibliothèque util, tapez :
bbg co util

CLES de bbg :
co	Compile tous les membres de la bibliothèque à l'aide du compilateur Fortran ou du compilateur C .
elm	Effectue une édition de liens avec tous les membres de la bibliothèque Modulef.
	Exemple : B$ bbg elm ppal
	crée tous les fichiers exécutables correspondants aux programmes principaux de la bibliothèque ppal.
t	Liste les noms des membres de la bibliothèque.

10.3.3 co1 : compilation

UTILISATION : co1 [options ... ] fichier
DESCRIPTION : co1 compilation de fichiers en Fortran ou C ; produit un fichier objet.

CLE de co1 :
-outdir nom	range le fichier objet produit dans le répertoire nom.

elm : édition de liens

UTILISATION : elm [options ... ] fichier ...
DESCRIPTION : elm est pratiquement identique à l'éditeur de liens standard UNIX ld. Cependant des extensions ont été apportées :

• Si le nom d'un fichier d'entrée ne se termine pas par .o, ce suffixe est automatiquement ajouté.
• Le nom du fichier de sortie est celui du premier fichier d'entrée, privé de son suffixe (sauf si l'option -o fichier est utilisée).
• Par défaut, l'édition de liens s'effectuera toujours avec la bibliothèque
  Modulef.

CLES de elm :
-f fichier	Indique quelles sont les bibliothèques à inclure lors de l'édition de liens. L'édition de liens s'effectuera soit avec une liste de librairies données par le fichier fichier, soit avec toute la bibliothèque Modulef lorsque fichier est une variable valant sta (nom de la version de Modulef).
-o nom	La commande produira un exécutable qui aura pour nom nom
-only	Lors de l'édition de liens la bibliothèque Modulef ne sera pas prise en compte.

EXEMPLES :

1. Soient trois fichiers ppal.f a.f b.f :
   

   program ppal	subroutine a	subroutine b
   call a	write(*,*) 'a'	write(*,*) 'b'
   call b	end	end
   end

   B$ co1 ppal.f ; co1 a.f ; co1 b.f
   crée trois fichiers ppal.o a.o b.o
   B$ elm -only ppal a b
   crée le fichier exécutable ppal à partir des trois fichiers précédents.

2. Pour créer le fichier exécutable ppal à partir des fichiers *.o du répertoire courant et des bibliothèques utsd util et util_apollo de Modulef, créer un fichier xx.ldo contenant :
   $MR/$MM/$MV/lib/libutsd.a
   $MR/$MM/$MV/lib/libutil.a
   $MR/$MM/$MV/lib/libutil_apollo.a
   et tapez,
   B$ elm -o ppal *.o -f xx.ldo
3. On peut taper aussi :
   B$ elm -o ppal *.o
   ou encore
   B$ elm -o ppal *.o -f $MV
   mais dans ce cas les recherches sont effectuées dans toutes les bibliothèques Modulef, d'où un temps d'exécution plus long.

10.3.5 voir : voir un fichier source

UTILISATION : voir [option] fichier
DESCRIPTION : voir visualise un fichier source dans une fenêtre éditable ou non, selon l'option qui peut être de la forme :

-r		lecture seulement
-*	(tiret non suivi de r)	édition
*	(pas de tiret en tête)	lecture seulement

L'avantage de cette commande est la prise en compte des variables du shell.
EXEMPLE : voir $mb/bb visualise le fichier $mb/bb.