perlnetware

СОДЕРЖАНИЕ

• НАЗВАНИЕ
• ОПИСАНИЕ
• СОБРАНИЕ
  • Инструменты и SDK
  • Установка
  • Сборка
  • Интерпретатор
  • Расширения
• УСТАНОВКА
• СОБРАНИЕ НОВЫХ РАСШИРЕНИЙ
• БЛАГОДАРНОСТИ
• АВТОРЫ
• ДАТА

НАЗВАНИЕ

perlnetware - Perl для NetWare

ОПИСАНИЕ

В этом файле приводятся инструкции по сборке Perl 5.7 и выше, а также модулей Perl для NetWare. Прежде чем начать, вы можете прочитать файл README, расположенный в корневой директории, в которую была извлечена дистрибуция исходного кода Perl. Убедитесь, что вы прочитали и поняли условия распространения программного обеспечения.

СОБРАНИЕ

Этот раздел описывает шаги, которые необходимо выполнить для сборки NLM Perl и других связанных NLM.

Инструменты и SDK

Для сборки требуется компилятор и компоновщик CodeWarrior. Кроме того, необходимы "NetWare SDK", "NLM & NetWare Libraries for C" и "NetWare Server Protocol Libraries for C", доступные по адресу http://developer.novell.com/wiki/index.php/Category:Novell_Developer_Kit, а также Microsoft Visual C++ версии 4.2 или выше.

Установка

Процесс сборки зависит от расположения NetWare SDK. После установки инструментов и SDK среда сборки должна быть настроена. Для настройки среды используются следующие файлы командных сценариев.

SetNWBld.bat

Выполнение этого файла требует 2 параметров в качестве входных данных. Первый — путь к NetWare SDK, второй — путь к компилятору и инструментам CodeWarrior. Выполнение этого файла задает эти пути, а также по умолчанию устанавливает тип сборки в Release.

Buildtype.bat

Используется для установки типа сборки в отладку или выпуск. Измените тип сборки только после выполнения SetNWBld.bat

Пример:

1. Ввод "buildtype d on" в командной строке устанавливает тип сборки в отладку с установленным флагом D2.

2. Ввод "buildtype d off" или "buildtype d" в командной строке устанавливает тип сборки в отладку с установленным флагом D1.

3. Ввод "buildtype r" в командной строке устанавливает его в выпускной тип сборки.

Сборка

Процесс сборки выполняется только в оболочке WinNT. Файл make для NetWare находится в папке NetWare. Он использует miniperl.exe для выполнения некоторых скриптов Perl. Чтобы создать miniperl.exe, сначала установите необходимые пути для компилятора Visual c++ (укажите расположение vcvars32) в командной строке. Затем выполните nmake из папки win32 через командную строку WinNT. Процесс сборки можно остановить после создания miniperl.exe. Затем выполните nmake из папки NetWare через командную строку WinNT.

В настоящее время на NetWare протестированы следующие два типа сборки:

• Определены USE_MULTI, USE_ITHREADS и USE_IMP_SYS

• Определены USE_MULTI и USE_IMP_SYS, а USE_ITHREADS не определен

Интерпретатор

После завершения создания miniperl.exe выполните nmake из папки NetWare. Это создаст Perl-интерпретатор для NetWare как perl.nlm. Он копируется в папку Release, если выполняется выпускная сборка, иначе копируется в папку Debug для отладочных сборок.

Расширения

Процесс сборки также создаёт Perl-расширения как <Extension.nlm>

УСТАНОВКА

Чтобы установить NetWare Perl на сервер NetWare, сначала отобразите системный том сервера NetWare в i:. Это связано с тем, что makefile по умолчанию устанавливает букву диска в i:. Введите nmake nwinstall из папки NetWare в командной строке WinNT. Это скопирует двоичные файлы и файлы модулей на сервер NetWare в папку sys:\Perl. Интерпретатор Perl, perl.nlm, копируется в папку sys:\perl\system. Скопируйте его в папку sys:\system.

Пример: Введите "nmake nwinstall" в командной строке. Это установит NetWare Perl на сервере NetWare. Аналогично, если вы введёте "nmake install", это приведет к установке двоичных файлов на локальную машину. (Обычно в папке c:\perl)

СОБРАНИЕ НОВЫХ РАСШИРЕНИЙ

Для сборки расширений, отличных от стандартных расширений, NetWare Perl должен быть установлен на Windows вместе с Windows Perl. Perl для Windows можно загрузить с сайта CPAN и собрать из исходного кода или загрузить двоичные файлы с сайта ActiveState. Установка может быть выполнена путём вызова nmake install из папки NetWare в командной строке WinNT после сборки NetWare Perl, следуя шагам, указанным выше. Это скопирует все файлы *.pm и другие необходимые файлы. Файлы документации не копируются. Таким образом, необходимо сначала установить Windows Perl, затем установить NetWare Perl.

После этого сделайте следующее, чтобы собрать любое расширение:

• Перейдите в каталог расширения, где находятся его исходные файлы.

• Выполните следующую команду в командной строке:

  perl -II<path to NetWare lib dir> -II<path to lib> Makefile.pl

  Пример:

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

  или

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

• nmake

• nmake install

  Установка скопирует файлы на компьютер Windows, где установлен NetWare Perl, и эти файлы, возможно, потребуется скопировать вручную на сервер NetWare. В качестве альтернативы, передайте INSTALLSITELIB=i:\perl\lib в качестве входных данных для makefile.pl выше. Здесь i: — отображенный диск для тома sys: сервера, где установлен Perl на NetWare. Теперь, набрав nmake install, вы скопируете файлы на сервер NetWare.

  Пример: Вы можете выполнить следующее в командной строке.

  perl -Ic:/perl/5.6.1/lib/NetWare-x86-multi-thread             \
                                -Ic:\perl\5.6.1\lib MakeFile.pl
  INSTALLSITELIB=i:\perl\lib

  или

  perl -Ic:/perl/5.8.0/lib/NetWare-x86-multi-thread             \
                                -Ic:\perl\5.8.0\lib MakeFile.pl
  INSTALLSITELIB=i:\perl\lib

• Примечание: некоторым модулям, загруженным с CPAN, может потребоваться API NetWare для сборки на NetWare. Однако другие модули могут собираться без проблем или с незначительными изменениями в зависимости от типа модуля.

БЛАГОДАРНОСТИ

Файл make для Win32 используется в качестве ссылки для создания файла make для NetWare. Кроме того, процесс сборки порта NetWare использует miniperl.exe для выполнения скриптов во время процесса сборки и установки.

АВТОРЫ

Ананты Кесари Х. Й. (hyanantha@novell.com) Адитья С. (caditya@novell.com)

ДАТА

• Создано - 18 января 2001 г.

• Изменено - 25 июня 2001 г.

• Изменено - 13 июля 2001 г.

• Изменено - 28 мая 2002 г.