Справка PE Builder v3

Формат файла модуля

1. Введение
2. Создание модуля
3. Раздел PEBuilder
4. Раздел WinntDirectories
5. Раздел SourceDisksFiles
6. Раздел SourceDisksFolders
7. Раздел Software.AddReg
8. Раздел Software.DelReg
9. Раздел SetupReg.AddReg
10. Раздел Default.AddReg
11. Раздел Default.DelReg
12. Раздел AddLine
13. Раздел DelLine
14. Раздел SetValue
15. Раздел Append
16. Раздел Execute
17. Переменные

Введение

Этот документ поможет Вам создать или изменить модули для PE Builder. Основным .inf файлом PE Builder является файл pebuilder.inf. Пожалуйста, не изменяйте этот файл! Если Вам требуется что-либо изменить, используйте файл модуля. Все модули находятся в каталоге plugin. Любой .inf файл в каталоге plugin (не имеет значения в какой папке) имеющий раздел "PEBuilder" считается модулем для PE Builder. Используйте кнопку Подключить/Откл... в окне Модулей для подключения или отключения модулей.

Создание модуля

Кодировка .inf файла модуля должна быть ASCII, а не Unicode. Строки, начинающиеся с ";" (точка с запятой) игнорируются (используются для комментариев).

Любой файл модуля должен начинаться со следующих строк, представленных ниже:

; PE Builder v3 plug-in INF file
; Created by Bart Lagerweij
; http://www.nu2.nu/pebuilder/
;
; Short description of what the plugin does...

[Version]
Signature= "$Windows NT$"

[PEBuilder]
Name="NiceNameOfPlugin"
Enable=0
Help="pluginhelp.htm"

Обратите внимание, что необходимо включить в файл раздел [Version] со строкой Signature= "$Windows NT$". В противном случае .inf файл не будет распознан функцией установки.

Используйте приведенные ниже сведения для добавления разделов для ваших модулей.

Раздел PEBuilder

При создании модуля Ваш .inf файл должен содержать раздел [PEBuilder]!

Раздел WinntDirectories

Раздел WinntDirectories имеет следующий формат:
directoryID=dirname[, attribute]

где...

Пример:

[WinntDirectories]
; Всегда создавать папку в корневом каталоге с именем "Bart"
a="Bart",3
; Создать папки в корневом каталоге "Project\Bart\Source"
b="Project\Bart\Source",3
; Создать папки в каталоге i386 с названием "extra\files"
c="extra\files",1

Список некоторых (наиболее часто используемых) идентификаторов каталогов:

PE Builder использует идентификаторы каталогов, начинающиеся с 30000. Идентификатор 30000 используется для обозначения корневого каталога назначения, 30001 и выше динамически используются PE Builder.

Раздел SourceDisksFiles

SourceDisksFiles[.build]

Этот раздел используется для копирования файлов. При добавлении номера сборки операционной системы после названия раздела, этот раздел будет использоваться только в том случае, если источник соответствует указанной сборке.

Раздел SourceDisksFiles имеет следующий формат:
filename=directoryID[, filenameRenamed][, attribute]

где...

Раздел SourceDisksFolders

SourceDisksFolders[.build]

Этот раздел используется для копирования папок с файлами. При добавлении номера сборки операционной системы после названия раздела, этот раздел будет использоваться только в том случае, если источник соответствует указанной сборке.

Раздел SourceDisksFolders имеет следующий формат:
sourcepath=directoryID

где...

Пример:

[WinntDirectories]
a="Programs\openoffice",2

[SourceDisksFolders]
; когда папка openoffice является каталогом модуля
openoffice=a

[SourceDisksFolders]
; когда папка openoffice находится в c:\
c:\openoffice=a

Раздел Software.AddReg

Software.AddReg[.build]

Добавление ключей реестра в HKEY_LOCAL_MACHINE\SOFTWARE.

Раздел имеет следующий формат:
regType, regKey, regValue, regData

где...

Пример:

0x1, "Microsoft\Windows NT\CurrentVersion\Fonts", "Tahoma (TrueType)","TAHOMA.TTF"
0x2, "Control Panel\desktop", "WallPaper", "%systemroot%\system32\nu2.bmp"
0x3, "ControlSet001\Control\TimeZoneInformation", "DaylightStart",\
	00,00,04,00,00,01,00,02,00,00,00,00,00,00,00,00
0x4, "ControlSet001\Control\GraphicsDrivers\DCI", "Timeout", 0x7
0x7, "ControlSet001\Services\VgaSave\Device0", "InstalledDisplayDrivers", "vga", "framebuf", "vga256", "vga64k"

Раздел SetupReg.AddReg

SetupReg.AddReg[.build]

Добавление ключей реестра в ветку реестра "SetupReg.hiv" .
Синтаксис соответствует разделу Software.AddReg

Раздел Default.AddReg

Default.AddReg[.build]

Добавление ключей реестра в HKEY_CURRENT_USER.
Синтаксис соответствует разделу Software.AddReg

Раздел Software.DelReg

Software.DelReg[.build]

Удаление ключей реестра из ветки реестра "Software".
Раздел имеет следующий формат:
regKey[, regValue]

где...

Раздел Default.DelReg

Default.DelReg[.build]

Удаление ключей реестра из ветки реестра "Default".
Синтаксис соответствует разделу Software.DelReg

Раздел AddLine

AddLine[.build]

Добавление строк в раздел.
Строки в разделе AddLine имеют следующий формат:
Filename,Section,StringToAdd

где...

Пример:
"netmscli.inf", "MSClient.DelReg", "HKLM, Software\Microsoft\Rpc\SecurityService, 9"

Раздел DelLine

DelLine[.build]

Удаление строк из файла.
Строки в разделе DelLine имеют следующий формат:
Filename,Section,StringToDel

где...

Пример:
"netmscli.inf", "MSClient.Browser.AddReg", "HKR, Parameters, MaintainServerList,"

Раздел SetValue

SetValue[.build]

Записывает значения в файл.
Строки в разделе SetValue имеют следующий формат:
Filename,Section,Key,Value

где...

Пример:
"netmscli.inf", "Alerter_Service_Inst", "StartType", "3"

Используйте Filename,Section,Key для удаления ключа
Используйте Filename,Section для удаления всего раздела

Раздел Append

Append[.build]

Добавляет файл к другому файлу.
Строки в разделе Append имеют следующий формат:
Filename,FilenameToAppend

где...

Пример:
nu2menu.xml, penero_nu2menu.xml

Раздел Execute

Семантика оформления секции [Execute]:

<исполняемый файл> , <параметры комстроки через пробел>
Отрабатывает в BartPE Builder 3.xx

Важные замечания:

• встроенные переменные BartPE(которые обрамляются в символы "@") не работают
• системные переменные окружения работают в параметрах командной строки
• абсолютное указание пути для исполняемого файла не сработает
• работают модификаторы относительных путей "." и ".." и все их комбинации
• при исполнении начальная текущая папка это папка самого BartPE Builder

Примеры вариантов использования:


[Execute]
FILES\my_script1.cmd,my_param1_1 my_param1_2 my_param1_3
FILES\my_script2.cmd,my_param2_1 my_param2_2 my_param2_3

Рабочие варианты
(примеры на базе моего плага "Z Base - optimize project"):

FILES\1_del_files.cmd
.\FILES\1_del_files.cmd
..\Z_OPTIMIZE_PROJECT\FILES\1_del_files.cmd

Примеры ошибочного использования:
C:\BARTPE\PLUGIN\Z_BASE\Z_OPTIMIZE_PROJECT\FILES\1_del_files.cmd
%SystemDrive%:\BARTPE\PLUGIN\Z_BASE\Z_OPTIMIZE_PROJECT\FILES\1_del_files.cmd

Порядок обработки метода Execute:

сразу после копирования файлов по I386\drvindex.inf и получения загрузочного сектора диска. Притом INF-файлы обрабатываются в заданной структорой плагинов очередности и по каждому из них последовательно отрабатываются сразу четыре секции в следующем порядке:

1. [DelLine]
2. [AddLine]
3. [SetValue]
4. [Execute]

То есть для двух расположенных в одной папке(чтобы задать порядок отработки) 1.inf и 2.inf, любая из этих четырех секций из файла 1.inf выполниться раньше любой из аналогичных секций из файла 2.inf. Это позволяет изменить содержимое либо самого 2.inf (за исключением модификации включен/выключен - это считывается вообще в самом начале построения проекта) либо модифицировать запускаемые в файле 2.inf через секцию [Execute] обработки.
Пример использования находится в моем конструкторе: связка
PLUGIN\1_BASE\Z_CUSTOM\owner_info.inf
("1 Base - Customize - names, owner and other info")
и PLUGIN\1_BASE\Z_CUSTOM\z_version.inf
("1 Base - Customize - version info")
через скрипт
PLUGIN\1_BASE\Z_CUSTOM\version.cmd
используется для автоматической установки даты сборки в нескольких местах сразу.

Полезняшка:

чтобы получить в тело скрипта имя рабочей папки проекта(она может быть совершенно различна и описывается в корневом файле проекта input.inf) рекомендую использовать такой CMD-скрипт:
=====начало кода=====

@ECHO OFF
SETLOCAL
IF NOT EXIST "%CD%\input.inf" (ECHO Не найден файл настройки PEBUILDER-а&EXIT 0)
FOR /F "USEBACKQ TOKENS=1* EOL=; DELIMS== " %%a IN (`TYPE "%CD%\input.inf"`) DO IF /I "%%a"=="FULLOUTDIR" SET "OUTDIR=%%b"
IF "%OUTDIR%"=="" (ECHO Не указана директория для сборки проекта&EXIT 0)
REM Отбрасывание хвостовых пробелов в переменной %OUTDIR%
REM (лидирующие не могут возникнуть в силу обработки FOR с двумя разделителями)
:MM1
SET "LAST_CHAR=%OUTDIR:~-1%"
IF "%LAST_CHAR%"==" " (SET "OUTDIR=%OUTDIR:~0,-1%") & GOTO MM1

REM <а здесь пойдет основное тело скрипта>

ENDLOCAL
EXIT 0
=====конец кода=====

Переменные

В большинстве строк файла модуля могут использоваться специальные переменные PE-Builder:
Синтаксис: @variable@
где...

Пример:
[SourceDisksFiles]
program.exe=2,,3
lang\@language@.lng=2,,3

Где lang\@language@.lng будет являться lang\german.lng (если выбран немецкий язык).

Содержание