man pages section 1: User Commands

Exit Print View

Updated: July 2014

perlnetware (1)


perlnetware - Perl for NetWare


Please see following description for synopsis


Perl Programmers Reference Guide                   PERLNETWARE(1)

     perlnetware - Perl for NetWare

     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.

     This section describes the steps to be performed to build a
     Perl NLM and other associated NLMs.

  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
     are required. Microsoft Visual C++ version 4.2 or later is
     also required.

     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.

         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.

         This is used to set the build type to debug or release.
         Change the build type only after executing SetNWBld.bat

     *   Example:
           1. Typing "buildtype d on" at the command prompt
         causes the buildtype
              to be set to Debug type with D2 flag set.
           2. Typing "buildtype d off" or "buildtype d" at the
         command prompt causes
              the buildtype to be set to Debug type with D1 flag
           2. Typing "buildtype r" at the command prompt sets it
         to Release Build type.

perl v5.12.5         Last change: 2012-11-03                    1

Perl Programmers Reference Guide                   PERLNETWARE(1)

     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++ 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


     o   USE_MULTI & USE_IMP_SYS defined and USE_ITHREADS not

     Once miniperl.exe creation is over, run nmake from the
     NetWare folder.  This will build the Perl interpreter for
     NetWare as perl.nlm.  This is copied under the Release
     folder if you are doing a release build, else will be copied
     under Debug folder for debug builds.

     The make process also creates the Perl extensions as

     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 nmake
     nwinstall from NetWare folder on a WinNT command prompt.
     This will copy the binaries and module files onto the
     NetWare server under sys:\Perl folder. The Perl interpreter,
     perl.nlm, is copied under sys:\perl\system folder.  Copy
     this to sys:\system folder.

     Example: At the command prompt Type "nmake nwinstall".
               This will install NetWare Perl on the NetWare
               Similiarly if you type "nmake install",
               This will cause the binaries to be installed on
     the local machine.
               (Typically under the c:\perl folder)

     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

perl v5.12.5         Last change: 2012-11-03                    2

Perl Programmers Reference Guide                   PERLNETWARE(1)

     site and built using the sources, or the binaries can be
     directly downloaded from the ActiveState site.  Installation
     can be done by invoking 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:

     o   Change to the extension directory where its source files
         are present.

     o   Run the following command at the command prompt:

             perl -II<path to NetWare lib dir> -II<path to lib>


             perl -Ic:/perl/5.6.1/lib/NetWare-x86-multi-thread -Ic:\perl\5.6.1\lib


             perl -Ic:/perl/5.8.0/lib/NetWare-x86-multi-thread -Ic:\perl\5.8.0\lib

     o   nmake

     o   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 INSTALLSITELIB=i:\perl\lib as an
         input to above. Here i: is the mapped drive
         to the sys: volume of the server where Perl on NetWare
         is installed. Now typing nmake install, will copy the
         files onto the NetWare server.

         Example: You can execute the following on the command

                   perl -Ic:/perl/5.6.1/lib/NetWare-x86-multi-thread -Ic:\perl\5.6.1\lib


                   perl -Ic:/perl/5.8.0/lib/NetWare-x86-multi-thread -Ic:\perl\5.8.0\lib

     o   Note: Some modules downloaded from CPAN may require
         NetWare related API in order to build on NetWare.  Other

perl v5.12.5         Last change: 2012-11-03                    3

Perl Programmers Reference Guide                   PERLNETWARE(1)

         modules may however build smoothly with or without minor
         changes depending on the type of module.

     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.

     Anantha Kesari H Y ( Aditya C

     o   Created - 18 Jan 2001

     o   Modified - 25 June 2001

     o   Modified - 13 July 2001

     o   Modified - 28 May 2002

     See attributes(5) for descriptions of the following

     |Availability   | runtime/perl-512 |
     |Stability      | Uncommitted      |
     This software was built from source available at  The original
     community source was downloaded from

     Further information about this software can be found on the
     open source community website at

perl v5.12.5         Last change: 2012-11-03                    4