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. Файл проекта NetWare makefile находится в папке 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 сначала необходимо смонтировать том Sys сервера NetWare в i:. Это связано с тем, что в файле проекта по умолчанию задаётся буквой диска 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: — это смонтированный диск на том сервера, где установлен 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, могут потребовать NetWare API для сборки на NetWare. Однако другие модули могут собираться без проблем или с незначительными изменениями в зависимости от типа модуля.

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

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

АВТОРЫ

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

ДАТА

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

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

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

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