NetWare Loadable Module Programming HOWTO
Versie 0.2, 04 augustus 2000In dit document wordt beschreven hoe Netware Loadable Modules met
behulp van GNU CC en nlmconv(1) uit de GNU binutils onder Linux te ontwikkelen.
Dit is geen officieel Novell document; ik schreef dit zonder enige hulp
of in samenwerking met
IntroductieNetWare Loadable Modules (NLMs) zijn programma's die onder een Novell NetWare
server draaien. NLM's maken onderdeel uit van het NetWare OS. Je kunt NLM's
laden en uit het geheugen verwijderen onderwijl de server draait."Officiële" compilers voor NLM's zijn: Watcom C/C++ Metrowerks Codewarrior voor NetWare (zie ) EPC C/C++ (zie ) Novell NLMLINK.EXE(Even terzijde, Netware 5 kan ook 32bit DLL's laden, welke kunnen worden
gebouwd met Microsoft Visual C++, Borland C++ en andere Windows compilers.
Zie voor meer informatie
)In dit document wordt beschreven hoe van start te gaan met NLM ontwikkeling
onder Linux (en mogelijk andere Unices). Dit project bevindt zich in een
zeer vroeg stadium van ontwikkeling, dus veel werkt wellicht niet zoals je
zou verwachten.Voor dit document wordt ervan uitgegaan dat je bekend bent met Novell NetWare,
en dat je op z'n minst beschikt over wat basiskennis in het schrijven van
NLM's. Zie de ontwikkelaarssite van Novell voor meer informatie over het
schrijven van NLM's. .
Er wordt ook van je verwacht dat je ervaring hebt met Unix en C/C++
programmeren met GNU CC. Je kunt heel veel informatie over dit onderwerp
vinden op .
C++ OntwikkelingZover ik weet, is C++ ontwikkeling met gcc thans onmogelijk, totdat
iemand op z'n minst de libstdc++ en libgcc library's uit het gcc package
port. Instellen van je Linux box en NetWare ServerJe moet het volgende installeren en configureren voor NLM ontwikkeling: Linux box met IPX en NCPFS geconfigureerd GNU C compiler (gcc) voor elf-i386
(het is in bijna alle i386 Linux Distributies opgenomen) GNU binutils met het nlmconv(1) programma Mijn nlm-kit package Novell Developer Kit - NDK (met de bestanden en documentatie) DOSemu (met rconsole) of X11 server voor het draaien van NetWare
Xconsole. ... en als laatste, NetWare server :-)Wellicht dat je ook het package met nlm-voorbeelden vanaf mijn FTP-site
wilt downloaden:
of
.
Novell NetWare ServerLaten we beginnen met de NetWare server.
Je kunt gebruik maken van NetWare versie 3.X, 4.X of 5.X.
De "demo" versie van NetWare 5 (of 5.1) voor drie gebruikers kan voor
een paar dollar worden besteld bij
Novell Inc.. Laat je niet in de war brengen door het woord "demo", het is een
volledige functionele NetWare, behalve dat het beperkt is tot drie gebruikers.
Tussen twee haakjes, deze licentie kan online, zonder kosten, tot vijf
gebruikers worden bijgewerkt. Je zou ook kunnen proberen je lokale Novell
partner om demo CD's te vragen (wellicht kosten deze niks). Eerste Stap: Hello worldZoals gewoonlijk zullen we beginnen met het befaamde "Hello world" programma.
De broncode voor hello.nlm is beschikbaar in het nlm-samples packages.
Je kunt het downloaden vanaf
.
hello.c - Bronbestand#define N_PLAT_NLM /* Definieer doelplatform */
#include <nwconio.h> /* ConsolePrintf */
int
main (int argc, char **argv)
{
int i;
ConsolePrintf ("\rHello world!\n\n"); /* geef weer op systeemconsole */
ConsolePrintf("Argumenten:\n"); /* alle argumenten */
for (i=0;i<argc;i++)
ConsolePrintf("argv[%u]=\"%s\"\n",i, argv[i]);
return 0; /* exit NLM */
} NLM Header bestandDe NLM header bevat informatie voor nlmconv(1). Op iedere regel
staat een optie of directive; alles achter een "#" is commentaar.
In dit hoofdstuk worden alle opties en directives beschreven.Sorry, maar dit hoofdstuk is nog niet af.
AUTOUNLOADSyntax:AUTOUNLOAD Message filesEen message file bevat (zoals je al dacht) tekstmeldingen gegenereerd door de
NLM. Je kunt het aanmaken met behulp van de DOS programma's MSGLIB.EXE en
MSGMAKE.EXE. Ik ken geen vergelijkbaar utility voor Unix. Sorry, je zult hier
dosemu of een DOS computer voor moeten gebruiken. :-(HelpbestandenHelpbestanden bevattten hulp voor gebruik met de NWSNUT gebruikersinterface library.
Er is geen Linux utility bekend voor het aanmaken van helpbestanden. Je moet
het DOS programma HELPLIB.EXE gebruiken, wat beschikbaar is vanaf
de Novell developer site.XDC Data FilesXDC bestanden worden door NetWare 5 (of SMP NetWare 4.x) gebruikt en hierin
wordt informatie over symmetrische multiprocessing (SMP) opgeslagen.
Je hebt deze waarschijnlijk niet nodig. Tenminste voor het moment. :-)
Nogmaals, er is geen Unix-utility voor het aanmaken van XDC-bestanden, je zal
het MPKXDC.EXE programma moeten gebruiken (ook beschikbaar op de Novell
developer site).Headerbestanden (.h)(nog te doen)Importbestanden (.imp)(nog te doen)
Met nlmimp(1) importbestanden genererenHet programma nlmimp(1) maakt onderdeel uit van mijn nlm-kit package. (te doen)