diff options
Diffstat (limited to 'Master/tlpkg/tlperl/lib/pods/perlnetware.pod')
-rw-r--r-- | Master/tlpkg/tlperl/lib/pods/perlnetware.pod | 225 |
1 files changed, 0 insertions, 225 deletions
diff --git a/Master/tlpkg/tlperl/lib/pods/perlnetware.pod b/Master/tlpkg/tlperl/lib/pods/perlnetware.pod deleted file mode 100644 index 6720a58212a..00000000000 --- a/Master/tlpkg/tlperl/lib/pods/perlnetware.pod +++ /dev/null @@ -1,225 +0,0 @@ -If you read this file _as_is_, just ignore the funny characters you -see. It is written in the POD format (see pod/perlpod.pod) which is -specifically designed to be readable as is. - -=head1 NAME - -perlnetware - Perl for NetWare - -=head1 DESCRIPTION - -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 - -This section describes the steps to be performed to build a Perl NLM -and other associated NLMs. - -=head2 Tools & SDK - -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<http://developer.novell.com/wiki/index.php/Category:Novell_Developer_Kit>, -are required. Microsoft Visual C++ version 4.2 or later is also -required. - -=head2 Setup - -The build process is dependent on the location of the NetWare SDK. -Once the Tools & SDK are installed, the build environment has to -be setup. The following batch files setup the environment. - -=over 4 - -=item SetNWBld.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 & tools. Execution of this file sets these paths and also -sets the build type to Release by default. - -=item Buildtype.bat - -This is used to set the build type to debug or release. Change the -build type only after executing SetNWBld.bat - -Example: - -=over - -=item 1. - -Typing "buildtype d on" at the command prompt causes the buildtype -to be set to Debug type with D2 flag set. - -=item 2. - -Typing "buildtype d off" or "buildtype d" at the command prompt causes -the buildtype to be set to Debug type with D1 flag set. - -=item 3. - -Typing "buildtype r" at the command prompt sets it to Release Build type. - -=back - -=back - -=head2 Make - -The make process runs only under WinNT shell. The NetWare makefile is -located under the NetWare folder. 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++ compiler (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: - -=over 4 - -=item * - -USE_MULTI, USE_ITHREADS & USE_IMP_SYS defined - -=item * - -USE_MULTI & USE_IMP_SYS defined and USE_ITHREADS not defined - -=back - -=head2 Interpreter - -Once miniperl.exe creation is over, run nmake from the NetWare folder. -This will build the Perl interpreter for NetWare as I<perl.nlm>. -This is copied under the I<Release> folder if you are doing -a release build, else will be copied under I<Debug> folder for debug builds. - -=head2 Extensions - -The make process also creates the Perl extensions as I<<Extension>.nlm> - -=head1 INSTALL - -To install NetWare Perl onto a NetWare server, first map the Sys -volume of a NetWare server to I<i:>. This is because the makefile by -default sets the drive letter to I<i:>. Type I<nmake nwinstall> from -NetWare folder on a WinNT command prompt. This will copy the binaries -and module files onto the NetWare server under I<sys:\Perl> -folder. The Perl interpreter, I<perl.nlm>, is copied under -I<sys:\perl\system> folder. Copy this to I<sys:\system> folder. - -Example: At the command prompt Type "nmake nwinstall". - This will install NetWare Perl on the NetWare Server. - Similarly, 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 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<nmake -install> 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. 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 * - -Change to the extension directory where its source files are present. - -=item * - -Run the following command at the command prompt: - - perl -II<path to NetWare lib dir> -II<path to lib> Makefile.pl - -Example: - - perl -Ic:/perl/5.6.1/lib/NetWare-x86-multi-thread -Ic:\perl\5.6.1\lib MakeFile.pl - -or - - perl -Ic:/perl/5.8.0/lib/NetWare-x86-multi-thread -Ic:\perl\5.8.0\lib MakeFile.pl - -=item * - -nmake - -=item * - -nmake install - -Install will copy the files into the Windows machine where NetWare -Perl is installed and these files may have to be copied to the NetWare -server manually. Alternatively, pass I<INSTALLSITELIB=i:\perl\lib> as -an input to makefile.pl above. Here I<i:> is the mapped drive to the -sys: volume of the server where Perl on NetWare is installed. Now -typing I<nmake install>, will copy the files onto the NetWare server. - -Example: You can execute the following on the command prompt. - - perl -Ic:/perl/5.6.1/lib/NetWare-x86-multi-thread -Ic:\perl\5.6.1\lib MakeFile.pl - INSTALLSITELIB=i:\perl\lib - -or - - perl -Ic:/perl/5.8.0/lib/NetWare-x86-multi-thread -Ic:\perl\5.8.0\lib MakeFile.pl - INSTALLSITELIB=i:\perl\lib - -=item * - -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. Also, the make process for NetWare port uses -miniperl.exe to run scripts during the make and installation process. - -=head1 AUTHORS - -Anantha Kesari H Y (hyanantha@novell.com) -Aditya C (caditya@novell.com) - -=head1 DATE - -=over 4 - -=item * - -Created - 18 Jan 2001 - -=item * - -Modified - 25 June 2001 - -=item * - -Modified - 13 July 2001 - -=item * - -Modified - 28 May 2002 - -=back |