Copyright Vincent Broman 1995 Vous pouvez effectuer et distribuer des copies selon les conditions de la GNU General Public License.
Cet HOWTO est archivé sur
ftp://archimedes.nosc.mil/pub/Mgr/MGR-HOWTO.sgml
, et
également sur
ftp://sunsite.unc.edu/pub/Linux/docs/HOWTO/MGR-HOWTO
.
Dans les répertoires adjacents peuvent apparaître des fichiers de
formats différents tels que MGR-HOWTO.txt
.
Les copies de la distribution MGR dues à Broman doivent être accompagnées des fichiers de signature PGP, signées "Vincent Broman <broman@nosc.mil>".
Bien que Vincent Broman ait été l'initiateur de cet HOWTO, la
plupart des informations et des textes furent obtenus à partir de
FAQs, READMEs, etc. écrits par Stephen Uhler, Michael Haardt, et
d'autres personnes ayant "l'esprit Réseau". Corrections et
suggestions par Email à broman@nosc.mil
.
Uhler fut l'architecte principal de MGR -- voir Remerciements plus loin.
MGR(ManaGeR) est un système de fenêtres graphiques. MGR fournit un gestionnaire intégré de fenêtres et un émulateur de terminal graphique sur des systèmes bitmaps couleurs et monochromes. MGR est contrôlable par des menus pop-up activés par souris, par action du clavier, et par des séquences d'échappement écrites par un client sur des pseudo-terminaux.
MGR fournit à chaque client une fenêtre avec : fonctions de contrôle terminal en style termcap, primitives graphiques telles que dessins de lignes et de cercles ; aménagements pour manipuler les bitmaps, fontes, icônes et menus pop-up ; commandes pour redessiner et repositionner les fenêtres ; et un système de passage de messages permettant aux programmes-client d'établir des rendez-vous et d'échanger des messages. Les programmes client peuvent demander à être informés lorsqu'un changement dans le système intervient, tel qu'une fenêtre redessinée, un clic de souris, ou un message envoyé à partir d'un autre programme client. Ces changements sont appelés événements. MGR notifie un événement à un programme client en envoyant une chaîne ASCII dans un format spécifié par le programme client. Des applications existantes peuvent être intégrées dans l'environnement sans être modifiées : MGR imite des actions sur le clavier en réponse à des sélections du menu utilisateur ou d'autres événements.
MGR tourne couramment sur Linux, FreeBSD, stations Sun 3/4 avec SunOS, et Coherent. Certaines versions anciennes de MGR tournent sur Macintosh, Atari ST MiNT, Xenix, 386-Minix, DEC 3100, et 3b1 Unix-pc. De nombreux petits systèmes industriels en temps réel sous OS9 et Lynx utilisent en Europe (une autre variante de) Mgr comme interface. L'interface de programmation est implémentée en C et Elisp, cependant des supports clients dans d'autres langages ne posent pas de difficultés.
MGR requiert beaucoup moins de ressources que X, ou même gcc. Bien sûr il n'a pas le répertoire de programmes, les bibliothèques de haut niveau de X ou MS-Windows, mais il est élégant et abordable.
On a dit que MGR est à X ce que Unix est à Multics.
MGR consiste en un serveur avec un gestionnaire de fenêtres et un émulateur de terminal, et des clients qui tournent dans cet émulateur en l'utilisant pour communiquer avec le serveur. Il n'y a pas de multiplexage de ressources.
X11 est constitué d'un serveur et de clients, qui sont habituellement connectés au serveur via un socket. Ce qui est visible à l'utilisateur tels qu'émulateurs de terminal, gestionnaires de fenêtres, etc., est réalisé en utilisant les clients.
8.5, le système de fenêtre Plan 9, est un multiplexeur de
ressources ; tout processus tournant dans une fenêtre peut
accéder à /dev/bitblt
, /dev/mouse
et
/dev/kbd
sous son propre nom. Ceux-ci sont multiplexés
à /dev/bitblt
, /dev/mouse
et
/dev/kbd
de 8.5. Cette approche permet de faire
fonctionner 8.5 dans une fenêtre 8.5, de conception très soignée.
De plus 8.5 dispose d'un gestionnaire de fenêtres intégré et un
émulateur de terminal.
On peut charger la dernière version sur
archimedesbugs.nosc.mil/pub/Mgr/69
et sous Mosaic
depuis http://archimedes.nosc.mil/Mgr/69
. On peut le
trouver aussi sur
ftp://sunsite.unc.edu/pub/Linux/apps/MGR
et ses
miroirs. Les versions anciennes de Haardt peuvent se trouver sur
tsx-11.mit.edu
et peut-être ailleurs. Des versions
Pre-Linux de MGR de Uhler et d'autres ont été trouvées sur
bellcore.com/pub/mgr
, mais je pense qu'elles n'y sont
plus. J'ai conservé une copie de tout ce que j'ai vu concernant MGR
sur l'Internet, et je n'ai pas connaissance qu'il n'y ait quoi que
ce soit d'important qui puisse manquer dans cette distribution
Linux/Sun. Il y a eu un tas de versions et de mises en circulation
de MGR, mais la version *Linux* actuelle est 0.69. Cette
version devrait passer à 1.0 quand un code VGA-256 stable pour
Linux apparaîtra (pour plusieurs types de cartes vidéo). Les
numéros de version RCS sont passés de Bellcore 4.3 jusqu'à 4.13 à
ce jour.
Pour construire cette distribution de MGR il faut m4 (GNU ou tout autre admettant l'option -D), make (GNU, ou tout autre admettant include) et *roff pour les docs. Et enfin sh, awk et install POSIX. Les distributions binaires n'ont pas toujours assemblées aussi faut-il un compilateur C ANSI, du style gcc.
Une installation sous Linux requiert au moins une version
0.99.10 ou ultérieure (1.2.13 est ce que j'utilise à l'heure
actuelle) , une carte graphique HGC, EGA, VGA ou SVGA et une souris
de type : serial Microsoft, serial MouseSystems 3 et 5 bytes,
serial MMSeries, serial Logitech, PS/2, ou une souris bus. Avec
Buckey (Meta) hot keys en service, même un système ne possédant pas
de souris peut effectuer pas mal de travail utile sous MGR. Le mode
graphique monochrome VGA 640x480 est supporté, tout comme le
640x350 et le 640x200. Pour tourner en 800x600, ou d'autres modes
que votre BIOS peut initialiser et qui n'ont pas besoin de
bank-switching, vous aurez besoin d'un petit programme
(src/vgamisc/regs.exe
) sous DOS pour lire les
registres VGA quand ce mode est installé puis d'écrire un fichier
header que vous placerez dans le répertoire
src/libbitblit/linux
, de telle sorte qu'il puisse être
appelé par le fichier vga.c. Des exemples sont fournis, mais créez
quand même le vôtre. Quelques cartes VGA peuvent utiliser des
fenêtres de 128k ; celles-ci peuvent tourner avec de plus
hautes résolutions.
Le code Linux-colorport peut aussi tourner dans le mode couleur standard VGA 320*200*256 sans difficultés, car il n'y a pas de bank-switching nécessaire. Si vous réfléchissez au peu que représentent 64000 pixels, vous comprendrez que ce mode couleur est tout à fait limité. Un code lent, mais simple, a été ajouté dans la version 0.65, et il travaille avec une carte Tseng ET4000 dans les modes 640x480x256 et 800x600x256. Le code S3 ne marche pas encore dans les résolutions super-VGA. Pour utiliser des nouvelles cartes super-VGA il faut écrire une fonction pour changer de bloc de mémoire et être sûr que le mode écran souhaité peut être initialisé à partir d'un vidage de registre, éventuellement en le peaufinant à la main. Les serveurs couleur sous Linux déforment généralement les fontes écrans, d'où la nécessité d'utiliser restorefont comme dans runx. Si quelqu'un pouvait récupérer le code d'initialisation VGA de X, cela ferait de MGR un système possédant plus de couleurs.
Suns avec SunOS 4.1.2+ et les tampons de trame
bwtwo
, cgthree
, ou cgsix
sont acceptés. Leurs vitesses de manipulation des couleurs sont
correctes. Les systèmes Coherent doivent se référer au fichier
README.Coh
de la distribution source. Porter le tout
dernier MGR sur un autre système analogue à POSIX qui
possède select
, des pty et un accès direct à un tampon
de trame bitmap devrait être immédiat, en implémentant simplement
la bibliothèque libbitblit
basée sur le code
sunmono
ou colorport
.
Si vous voulez tout installer, vous aurez besoin de 7 MB d'espace disque pour les binaires, les fonts, les explications, etc. Les sources font environ 4,5 MB plus les fichiers objets durant la compilation.
Normalement, /usr/mgr
doit être le répertoire ou
bien il doit être linké au répertoire où vous installerez les
accessoires MGR. Tapez
et éventuellementcd /usr/mgr; tar xvfz là_ou_vous_le_mettez/mgrusr-0.69.tgz
pour décompacter. Les sources peuvent être mises n'importe où, par exemple tapezcd /usr/mgr; tar xvfz la_ou_vous_voulez/morefonts-0.69.tgz
pour décompacter les sources à partir decd /usr/src/local/mgr; tar xvfz la_ou_vous_voulez/mgrsrc-0.69.tgz
archimedes.nosc.mil
.
L'arborescence source peut être compilée à partir d'un Makefile
principal qui fait appel lui-même à des Makefile secondaires,
chacun "incluant" un "Configfile"
au niveau supérieur.
Le Configfile
est créé à l'aide d'un script interactif
nommé Configure, qui vous pose un certain nombre de questions, puis
utilise m4 avec un fichier Configfile.m4
. Ensuite vous
tapez quelque chose comme ceci :
chdir /usr/src/local/mgr sh ./Configure make first make depend make install make clean
Il est prudent, avant de taper make, de jeter un coup d'oeil
dans le fichier Configfile
généré par le script
Configure
, pour vérifier s'il n'y a pas d'anomalie. Au
pire m4 s'interrompt, créant un fichier Configfile tout petit. Si
cela arrive, essayez une copie de Configfile.sun
ou
Configfile.lx
. Tout peut être effectué dans n'importe
quel répertoire avec un Makefile à partir du moment où les
bibliothèques ont été compilées et installées. Le serveur, les
bibliothèques et quelques clients sont implémentés avec
lint
, mais plusieurs clients utilisent le code C
K&R ce qui engendre beaucoup d'avertissements pendant la
compilation. Plusieurs flags dans MGRFLAGS peuvent être ajoutés ou
retranchés pour changer quelques options du serveur, à
savoir :
fichier utmp poubelle pour que "who" puisse travailler
code pour faire bouger le curseur sous vi avec la souris
permet la mise au point en sélectionnant l'option -d
XOR le temps d'accès de la souris
permet les commandes serveur par le clavier sans souris
pour planifier la priorité des fenêtres au lieu de fonctionner par requêtes circulaires ; la fenêtre active obtient une plus grande priorité.
pour faire du couper/coller entre fenêtres
force l'alignement des fenêtres pour un scrolling rapide(monochrome)
supprime les fenêtres en cas d'erreurs i/o sur un tty
pour utiliser seulement une partie de l'écran ($MGRSIZE dans les variables d'environnement)
interdit l'empilement d'événements
actionne le bip
lit les données mgr
à partir du clavier sun, au
lieu de stdin. Cela autorise la redirection des messages console
vers une fenêtre.
mouvement de caractère fractionnel pour fontes proportionnelles
menu étendu (expérimental)
extension pour faire un film qui enregistre toutes les opérations dans un fichier en vue de les rejouer plus tard (ne marche pas bien sous Linux).
Pour simuler le 3ème bouton d'une souris
-DBANKED
si vous voulez essayer le super VGA couleur.
Le code C pour les variables statiques du serveur contenant les icônes et les fontes est généré à l'aide d'un traducteur à partir des fichiers icônes et fontes.
Tous les clients ne sont pas compilés et installés par les
fichiers Makefile. Les fichiers clients trouvés dans
src/clients
qui ont des noms en majuscule ou bien non
compilés par les fichiers Makefile fournis, peuvent donner des
problèmes de compilation et/ou d'utilisation ; il peut être
intéressant de les examiner.
Plusieurs pilotes d'écran du répertoire libbitblit
ont plutôt un intérêt historique. Mieux vaut les faire
disparaître.
Vérifiez que votre fichier /etc/termcap
et/ou
terminfo
contient des entrées pour les terminaux
MGR, comme ceux que l'on trouve dans le répertoire
misc
. Si vos logiciels prennent en compte $TERMCAP
dans l'environnement, ceci n'est pas nécessaire, tant que vous
utilisez set_termcap
dans chaque fenêtre.
Il est préférable de travailler avec MGR avec setuid root, car il utilise ptys et write dans le fichier utmp. Cela permet au client gestionnaire d'icônes de mieux travailler et d'avoir une plus grande sûreté quant à l'enchaînement des événements. Sur Linux, les permissions root sont nécessaires pour faire fonctionner les systèmes écran. Autrement vous décidez de lui faire confiance.
Avec les versions aux alentours de 0.62 il y a des problèmes avec Sun quand on utilise csh comme shell par défaut : les programmes semblent tourner sur un processus différent que le processus de premier plan du pty de la fenêtre, en contradiction avec les pages de manuel et les spécifications posix. Rien de tel avec bash, sh, ou rc. Vous avez une idée ?
Le seul fichier indispensable sous MGR est le serveur lui-même. Il vous donnera les fenêtres émulateur de terminal avec les shells correspondants, mais pas de jolies horloges, de fontes superbes, de graphiques marrants, etc... Suivant les options, le serveur monochrome a besoin de 200K de RAM plus un espace dynamique pour les fenêtres, bitmaps, etc...
Si /usr/mgr/bin
est dans votre PATH, tapez
seulement "mgr
" pour démarrer. Après avoir profité de
l'écran de démarrage animé, frappez une touche quelconque. Quand le
fond hachuré apparaît avec un pointeur de souris, appuyez sur le
bouton gauche de la souris, allez sur "new window" dans le menu
puis relâchez. Faites promener la souris pour sélectionner
l'endroit où vous voulez qu'une fenêtre apparaisse. Celle-ci aura
votre shell par défaut. Maintenez le bouton gauche de la souris
enfoncé dans une fenêtre existante pour voir un autre menu qui vous
permettra de réaliser des choses dans cette fenêtre. Cliquer avec
le bouton gauche sur une fenêtre obscurcie l'amènera au premier
plan. Le menu que vous aviez vu sur l'arrière plan inclut la
commande `quit'. Pour ceux qui ont une souris avec deux boutons, il
suffit d'appuyer sur les deux boutons simultanément pour simuler le
troisième. Le sous-menu quit comprend l'option "really quit", une
option d'attente qui doit être utilisée seulement si vous utilisez
un shell offrant l'édition de la ligne de commande, et un
économiseur d'écran avec un verrouillage qui attend que vous tapiez
un mot de passe lorsque vous revenez sur votre machine.
En essayant MGR, si vous :
soyez sûr d'avoir une entrée /dev pour votre vidéo, par ex. sur
Sun /dev/bwtwo0
. Si ce n'est pas le cas, en tant que
root allez dans /dev
, et tapez "MAKEDEV bwttwo0".
Sinon, vous devez faire -S/dev/bwtwo0
ou (sous Linux)
-S640x480
comme option de commande en démarrant
mgr
. Sous Linux, soyez également sûrs que
/usr/mgr/bin/mgr a été installé suid root.
assurez-vous que /dev/mouse
existe, habituellement
lié symboliquement au nom réel de votre souris. Si vous n'avez pas
la permission d'écrire dans /dev
, quelque chose comme
-m/dev/cua0
peut être donné comme option en démarrant
mgr
. Soyez également sûrs d'avoir mis le bon protocole
souris en configurant mgr
. La souris peut s'appeler
Microsoft, même si ce n'est pas son vrai nom.
assurez-vous que tous les /dev/[tp]ty[pq]?
sont
propriété de root, mode 666, que tous les programmes référencés
avec l'option "shell" dans le fichier .mgrc
(si il y
en a) existent et sont exécutables.
assurez-vous que MGR cherche bien au bon endroit pour les
fontes. Vérifiez le fichier Configfile
dans les
sources, ou bien regardez si une option comme
-f/usr/mgr/font
résoud le problème.
logez vous sur votre machine à partir d'un autre terminal et
tuez le processus mgr
. Un ctrl-Q fera quitter
MGR si le clavier fonctionne encore.
Toute application orientée tty peut tourner sous une fenêtre MGR
sans problèmes. Les applications orientées écran utilisant termcap
ou curses peuvent obtenir le nombre exact de lignes et de colonnes
en utilisant shape(1)
pour redimensionner la fenêtre
ou en utilisant set_termcap(1)
pour obtenir le termcap
adéquat.
convertit des fontes BDF en fontes MGR
un browser d'icônes
enterre la fenêtre
pour regarder les erreurs de compilation sous C à l'aide de vi
horloge digitale
horloge analogique
ferme la fenêtre et l'iconifie
pour les couleurs d'arrière et d'avant-plan du texte dans la fenêtre
change l'aspect du curseur texte
couper/coller du texte de la fenêtre vers une mémoire tampon
affiche une séquence d'icônes
prévisualisateur ditroff à l'état brut
fait passer d'une scène à une autre dans un film
passe à une autre fonte dans la fenêtre
un pilote groff PBM utilisant les fontes Hershey
émulateur de terminal hp 2621
anime un isocaèdre ou un autre polyèdre
annonce l'arrivée de courrier
annonce l'arrivée d'un message
iconifie et désiconifie les fenêtres
charge une fonte à partir du système de fichiers
jeu de labyrinthe
horloge comique
crée ou choisit un menu pop-up
Gestionnaire de fenêtres et serveur Bellcore
jeu boulder-dash
surveille la boîte aux lettres et annonce le courrier
graphique indiquant la charge du système
verrouille la console
contrôleur graphique de login
loupe sur une partie de l'écran, avec option de sauvegarde
annonce l'arrivée de courrier
ajuste ou annule les modes de fenêtre
annonce l'arrivée de messages
filtre graphique Unix "plot"
sablier
parcourt les fontes mgr
programme de schémas et dessins
visualise des images bitmap
démarre less/more dans une fenêtre séparée, avec un menu pour less wtag/mnew/démarrer n'importe quel programme dans une fenêtre séparée indépendante.
démarre vi dans une fenêtre séparée, avec souris
ferme une fenêtre (ancien)
annonce l'arrivée de courrier (ancien)
convertit des bitmats PBM,PGM,PPM brutes en format bitmap mgr
fractionne une séquence de bitmaps
impression à partir de PBM
un patch ghostscript et interface, un visualisateur PS
balaye des bitmaps et visualise des images
fait le ménage dans une fenêtre si le client se plante
rotation d'un bitmap de 90 degrés.
sauvegarde un écran graphique dans un fichier bitmap
redirige les messages console vers une fenêtre
ajuste une valeur TERMCAP appropriée
nomme une fenêtre, pour les messages et pour l'iconifier
redimensionne une fenêtre
transforme une fenêtre en carré
compresse un bitmap mgr
fournit un fichier de démarrage pour la disposition de la fenêtre courante
pour prévisualiser un fichier TeX dvi
conversion entre formats fonte mgr et un texte dump
pour décompresser un bitmap mgr
conversion de format de fontes mgr et VGA
imprime l'image d'une fenêtre
éditeur d'icônes
démos graphiques
calculatrice
interface pour /usr/games/chess
éditeur avec souris lisp/term/mgr.el
et aide
menu
traceur de données scientifiques universel
création et conception de fontes
éditeur de dossier
conversions et manipulations de format portable bitmap
traceur de données scientifiques superbe
Le manuel des programmeurs MGR, l'interface des applications langage C, se trouvent dans le répertoire doc sous forme de fichier exploitable par troff/nroff. Il traite de concepts généraux, des appels fonction/macro contrôlant le serveur, d'un exemple d'application, avec index et glossaire. Porter le code client utilisé avec les anciennes versions de MGR demande le remplacement de
par#include <mgr/mgr.h>
et des clients utilisant les vieux B_XOR, B_CLEAR, etc. au lieu de BIT_XOR, BIT_CLR et autres peuvent être adaptés en écrivant :#include <term.h> #include <dump.h>
#define OLDMGRBITOPS #include <mgr/mgr.h>
Compiler le code client demande en général des options telles que :
Vous pouvez obtenir un aperçu de l'interactivité des fonctions serveur MGR en lisant et essayant le pilote de terminal-I/usr/mgr/include -L/usr/mgr/lib -lmgr
mgr.el
pour GNU Emacs, qui met en oeuvre la
bibliothèque interface MGR en Elisp. L'habitude qui consiste
à s'enquérir de l'état du serveur a pour risque de se casser la
figure si le client attend en même temps un grand volume de
notification d'événements. Ce problème arrive lorsque une
notification d'événement (asynchrone) survient quand une réponse à
une demande (synchrone) était attendue. Si cela arrive dans la
pratique (non habituel) alors les fonctions de demande d'état
MGR doivent être intégrées avec votre boucle de manipulation
d'événement.
La seule fonction manquante pour les dessins dans le protocole
MGR est celle de remplissage de surfaces autres que les
rectangles. Il y a un nouveau code pour manipuler la carte des
couleurs globale, et aussi pour l'allocation et la délivrance des
indices de couleur appartenant à chaque fenêtre. Si vous voulez
fouiller dans les progammes serveurs, vous trouverez le pilote de
souris dans mouse.*
et mouse_get
, les
abominables choses concernant l'interface clavier dans
kbd.c
, et l'interface vidéo dans les répertoires
src/libbitblit/*
. La procédure principale, plutôt
l'initialisation, et la boucle d'entrée de niveau supérieur sont
dans mgr.c
, enfin l'interprétation des séquences
d'échappement dans put_window.c
.
Le manuel du programmeur est indispensable pour les idées
générales. La plupart des clients sont fournis avec une
documentation man installée dans /usr/mgr/man/man1
ou
/man6
.
D'autres documentations utiles sont bitblit.3
,
font.5
, et bitmap.5
. Il y a une ambiguïté
dans les documentations pour distinguer le format des bitmaps
internes trouvés dans votre tampon de trame et le format des
bitmaps externes trouvés dans des fichiers, par exemple les
icônes.
La documentation mgr.1
traite des options de
commande en ligne, des commandes dans le fichier
.mgrc
, de la souris et des interactions du menu avec
le serveur, et enfin des raccourcis clavier disponibles sur sur les
systèmes qui en possèdent. Beaucoup de fontes de
/usr/mgr/font/*
sont décrites dans les fichiers
/usr/mgr/font/*.txt
, par exemple
/usr/mgr/font/FONTDIR.txt
donne la description des
fontes de style X pour celles obtenues dans le format .bdf. La fin
des noms de fontes (WxH
) s'interprète comme
suit : W
est la largeur du caractère en décimal
H
est la hauteur en pixels.
Stephen Uhler, avec d'autres travaillant chez Bellcore, fut le concepteur initial de MGR, dès lors Bellcore a des droits d'auteur sur la plupart des codes et des documentations de MGR, dans les conditions suivantes :
Vous avez la permission de copier et d'utiliser ce programme, MAIS * vous ne pouvez le vendre * cette note concernant les droits de copie doit accompagner les copies * mentionner Bellcore quand c'est necessaireUne vue de la notice de copyright apparaît dans le titre de démarrage.
Autres remerciements :