From: Jarkko Hietaniemi Date: Mon, 27 May 2002 16:49:06 +0000 (+0000) Subject: More NetWare. X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=commitdiff_plain;h=0cf85a069f041d1204f656444e4214a7b5fd4276;p=p5sagit%2Fp5-mst-13.2.git More NetWare. p4raw-id: //depot/perl@16815 --- diff --git a/README.netware b/README.netware index 196e032..1e795f3 100644 --- a/README.netware +++ b/README.netware @@ -4,13 +4,15 @@ specifically designed to be readable as is. =head1 Name -Perl for NetWare5.x +Perl for NetWare =head1 Description -This file gives the instructions for building Perl5.6 and above for -NetWare5.x. Please read and understand the terms under which this -software is distributed. +This file gives instructions for building Perl 5.7 and above, and also +Perl modules for NetWare. Before you start, you may want to read the +README file found in the top level directory into which the Perl source +code distribution was extracted. Make sure you read and understand +the terms under which the software is being distributed. =head1 Build @@ -19,34 +21,50 @@ and other associated NLMs. =head2 Tools & SDK -The build requires Watcom 11.x compiler and linker. In addition, +The build requires CodeWarrior compiler and linker. In addition, the "NetWare SDK", "NLM & NetWare Libraries for C" and "NetWare Server Protocol Libraries for C", all available at L, are also required. Microsoft Visual C++ version 4.2 or later is also required. -Currently the interpreter builds only with Watcom and we do have plans of -making this work with CodeWarrior as well. - =head2 Setup The build process is dependent on the location of the NetWare SDK. -Once the required software is installed, the build environment has to +Once the Tools & SDK are installed, the build environment has to be setup. The following batch files setup the environment. +=item * + +If you want to build with Default settings you can follow the One step process given below +to create the default Build Environment. + +=item SetNWDef.bat + +The Execution of this file takes 2 parameters as input.The first being the NetWare SDK path, +Second being the path for CodeWarrior Compiler & other tools. Execution of this file +sets the Build type to Release(default) , the NetWare SDK path, path for Compiler & other tools. + +=back + +=item * Custom Build Environment + +If you want to change the default settings you could do so by following the steps listed +below. + =over 4 =item Buildtype.bat This sets the build type to release or debug. -=item SetNWBld.bat +=item * -This sets the NetWare SDK path, Compiler & other tools path & MPK SDK path. +Example: Typing "buildtype d on" at the command prompt causes the buildtype to be set to Debug type. + Typing "buildtype r" at the command prompt sets it to Release Build type. -=item MPKBuild.bat +=item SetNWBld.bat -This is required only it we are building multi-processor enabled NLMs. +This sets the NetWare SDK path, path to Compiler & other tools. These batch files are under NetWare\bat folder. These batch files call a couple of other batch files to setup the environment. Invoking @@ -59,10 +77,11 @@ or I gives the usage help. The make process runs only under WinNT shell. The NetWare makefile is located under the NetWare folder. -The makefile for NetWare makes use of miniperl.exe to run some of -the Perl scripts. To create miniperl.exe, run nmake from -win32 folder through WinNT command prompt. The build process -can be stopped after miniperl.exe is created. Then run nmake +This makes use of miniperl.exe to run some of +the Perl scripts. To create miniperl.exe, first set the required paths for +Visual c++ compilier (specify vcvars32 location) at the command prompt. +Then run nmake from win32 folder through WinNT command prompt. +The build process can be stopped after miniperl.exe is created. Then run nmake from NetWare folder through WinNT command prompt. Currently the following two build types are tested on NetWare @@ -88,8 +107,7 @@ a release build, else will be copied under I folder for debug builds. =head2 Extensions -The make process also creates the Perl extensions which are called -NLPs (NetWare Loadable Perl). +The make process also creates the Perl extensions as I<.nlm> =head1 Install @@ -97,28 +115,45 @@ To install NetWare Perl onto a NetWare server, first map the Sys volume of a NetWare server to I. This is because the makefile by default sets the drive letter to I. Type I from NetWare folder on a WinNT command prompt. This will copy the binaries and module files -onto the NetWare server. The Perl interpreter, I, is copied under -I folder. Copy I to I folder. +onto the NetWare server under I folder. The Perl interpreter, I, +is copied under I folder. Copy this to I folder. + +Example: At the command prompt Type "nmake nwinstall". + This will install NetWare Perl on the NetWare Server. + Similiarly if you type "nmake install", + This will cause the binaries to be installed on the local machine. + (Typically under the c:\perl folder) + =head1 Build new extensions To build extensions other than standard extensions, NetWare Perl has -to be installed on Windows as well. This can be done by invoking -I from the NetWare folder on a WinNT command prompt. +to be installed on Windows along with Windows Perl. The Perl for Windows can be +either downloaded from the CPAN site and built using the sources, or the binaries +can be directly downloaded from the ActiveState site. +Installation can be done by invoking I from the NetWare folder +on a WinNT command prompt after building NetWare Perl by following steps given above. This will copy all the *.pm files and other required files. -Documentation files are not copied. This has to be done after -installing Perl for Windows. Once this is done, do the following -to build any extension: +Documentation files are not copied.Thus one must first install Windows Perl, Then install +NetWare Perl. + +Once this is done, do the following to build any extension: =over 4 =item * -perl -II -II Makefile.pl +Change to the extension directory where its source files are present. + +=item * + +Run the following command at the command prompt: -For example: + perl -II -II Makefile.pl - perl -Ic:/perl/5.6.1/lib/NetWare-multi-thread -Ic:\perl\5.6.1\lib MakeFile.pl +Example: + + perl -Ic:/perl/5.7.2/lib/NetWare-x86-multi-thread -Ic:\perl\5.7.2\lib MakeFile.pl =item * @@ -129,43 +164,37 @@ nmake nmake install Install will copy the files into the Windows machine where NetWare -Perl is installed, these files have to be copied to the NetWare server -manually. Alternatively, pass I as an -input to makefile.pl above. Where I is the mapped drive to the -sys: volume of the server where Perl on NetWare is installed. Now -saying I, will copy the files to the server. - -=back - -=head1 Known Issues - -=over 4 +Perl is installed and these files may have to be copied to the NetWare server +manually. Alternatively, pass I as an +input to makefile.pl above. Here I is the mapped drive to the +sys: volume of the server where Perl on NetWare is installed. Now +typing I, will copy the files onto the NetWare server. -=item * +Example: You can execute the following on the command prompt. -With USE_ITHREADS not defined, backtick seems to be having some problems. + perl -Ic:/perl/5.7.2/lib/NetWare-x86-multi-thread -Ic:\perl\5.7.2\lib MakeFile.pl + INSTALLSITELIB=i:\perl\lib -=item * - -The utility scripts (pod2html.pl, pod2man.pl, perldoc.pl etc.) are not -yet ported to work on NetWare. +=back -=item * += item * -Also fork() is not currently implemented. +Note: Some modules downloaded from CPAN may require NetWare related API +in order to build on NetWare.Other modules may however build smoothly with or +without minor changes depending on the type of module. =back =head1 Acknowledgements The makefile for Win32 is used as a reference to create the makefile -for NetWare build. Also, the make process for NetWare port uses +for NetWare. Also, the make process for NetWare port uses miniperl.exe to run scripts during the make and installation process. =head1 Authors -Guruprasad S (sguruprasad@novell.com) Anantha Kesari H Y (hyanantha@novell.com) +Aditya C (caditya@novell.com) =head1 Date @@ -173,15 +202,18 @@ Anantha Kesari H Y (hyanantha@novell.com) =item * -Created - 18th Jan 2001 +Created - 18 Jan 2001 =item * -Modified - 25th June 2001 +Modified - 25 June 2001 =item * -Modified - 13 July 2001 +Modified - 13 July 2001 -=back +=item * +Modified - 8 May 2002 + +=back