winebuild - онлайн у хмарі

ПРОГРАМА:

ІМ'Я

winebuild - конструктор Wine dll

СИНТАКСИС

winebuild [опції] [вхідний файл...]

ОПИС

winebuild генерує файли збірки, необхідні для створення dll Wine, тобто
в основному це Win32 dll, інкапсульована всередині бібліотеки Unix.

winebuild має різні режими, залежно від того, який файл потрібно створити. The
режим визначається одним із параметрів режиму, зазначених нижче. Крім режиму
параметр, можна вказати різні інші параметри командного рядка, як описано в ВАРІАНТИ
.

РЕЖИМ ВАРІАНТИ

Ви повинні вказати саме один з наступних варіантів, залежно від того, що ви хочете
winebuild для створення.

--dll Створіть файл збірки з файлу .spec (див SPEC Фото СИНТАКС для деталей), або
зі стандартного файлу Windows .def. Файл .spec/.def вказується через файл -E
варіант. Отриманий файл необхідно зібрати та зв’язати з іншими об’єктними файлами
для створення робочої dll Wine. У цьому режимі вхід файли має бути список
всі об’єктні файли, які будуть пов’язані з остаточною DLL, дозволити winebuild , Щоб отримати
список усіх невизначених символів, які потрібно імпортувати з інших dll.

--exe Створіть файл збірки для виконуваного файлу. Це в основному те саме, що --dll
режиму, за винятком того, що він не потребує файлу .spec/.def як вхідних даних, оскільки виконуваний файл
не потрібно експортувати функції. Однак деякі виконувані файли виконують функції експорту та для
файл .spec/.def можна вказати за допомогою файлу -E варіант. Іменується виконуваний файл
з імені файлу .spec/.def, якщо воно є, або явно через файл -F варіант.
отриманий файл необхідно зібрати та зв’язати з іншими об’єктними файлами для створення a
робочий виконуваний файл Wine, а всі інші об’єктні файли мають бути вказані як вхід
файли.

--зах Створіть файл .def з файлу специфікації. Файл .spec вказується за допомогою файлу -E варіант.
Це використовується під час створення DLL за допомогою компілятора PE (Win32).

--implib
Створіть бібліотеку імпорту PE з файлу специфікації. Файл .spec вказується через файл -E
варіант.

-- ресурси
Створіть файл .o, що містить усі вхідні ресурси. Це корисно при будівництві
за допомогою компілятора PE, оскільки PE binutils не може обробляти декілька файлів ресурсів як
введення. Для стандартної збірки Unix файли ресурсів додаються автоматично
під час створення файлу специфікації, тому немає потреби у проміжному файлі .o.

ВАРІАНТИ

--як-cmd=як команда
Вкажіть команду для компіляції файлів збірки; за замовчуванням as.

-б, --ціль=виробник процесора[-ядро]-os
Вкажіть цільовий процесор і платформу, на якій буде створено згенерований код. The
цільова специфікація містить стандартний формат autoconf, який повертає config.sub.

--cc-cmd=cc-команда
Вкажіть компілятор C для компіляції файлів збірки; за замовчуванням натомість
використовуйте асемблер, зазначений у --як-cmd.

-d, --delay-lib=ім'я
Встановіть режим відкладеного імпорту для вказаної бібліотеки, яка має бути одним із
бібліотеки, імпортовані з -l варіант. Відкладений режим означає, що бібліотека не буде
завантажується до тих пір, поки функція, імпортована з нього, насправді не буде викликана.

-D символ
Ігнорується через сумісність із компілятором C.

-е, --вхід=функція
Вкажіть функцію точки входу модуля; якщо не вказано, за замовчуванням є DllMain
для dll і основний для виконуваних файлів (якщо стандартний C основний не визначено, WinMain
замість нього використовується). Це справедливо лише для модулів Win32.

-Е, --експорт=ім'я файлу
Вкажіть файл .spec (див SPEC Фото СИНТАКС для деталей) або стандартний Windows .def
файл, який визначає експорт DLL або виконуваного файлу, який створюється.

--зовнішні символи
Дозволити посилання на зовнішні символи безпосередньо з файлу специфікації. Зазвичай символи
експортовані dll мають бути визначені в самій dll; ця опція робить це
можна використовувати символи, визначені в іншій бібліотеці Unix (для символів, визначених у
інша dll, a вперед замість цього слід використовувати специфікацію).

-f варіант
Вкажіть параметр генерації коду. Наразі -fPIC та -fasynchronous-wind-tables
підтримуються. Інші параметри ігноруються для сумісності з компілятором C.

--підробка-модуль
Створіть підроблений модуль PE для dll або exe замість звичайної збірки чи об’єкта
файл. Модуль PE містить ресурси для модуля, але не виконує виконуваний код.

-F, --ім'я файлу=ім'я файлу
Встановіть назву файлу модуля. За замовчуванням використовується базова назва специфікації
файл (без розширення).

-h, --допомога
Відобразити повідомлення про використання та вийти.

-Н, --куча=розмір
Вкажіть розмір локальної купи модуля в байтах (дійсно лише для модулів Win16);
за замовчуванням немає локальної купи.

-I каталог
Ігнорується через сумісність із компілятором C.

-к, --убити
Видаліть прикраси stdcall з імен символів у згенерованому файлі .def.
Лише змістовний в --зах Режим.

-K прапори
Ігнорується через сумісність із компілятором C.

--з урахуванням великих адрес
Встановіть прапор у виконуваному файлі, щоб сповістити завантажувача, що ця програма підтримує
адресні простори розміром понад 2 гігабайти.

--ld-cmd=ld-команда
Вкажіть команду, яка буде використовуватися для зв’язування об’єктних файлів; за замовчуванням ld.

-Л, --бібліотека-шлях=каталог
Додати вказаний каталог до списку каталогів, які шукають
імпортувати бібліотеки.

-л, --бібліотека=ім'я
Імпортуйте вказану бібліотеку, шукаючи відповідну libname.def файл у файлі
каталоги, зазначені з -L варіант.

-m16, -m32, -м64
Згенеруйте відповідно 16-розрядний, 32-розрядний або 64-розрядний код.

-М, --main-module=Модулі
Під час створення 16-розрядної DLL встановіть назву її 32-розрядної копії Модулі, це
використовується для забезпечення того, щоб порядок завантаження для 16-розрядної dll відповідав порядку завантаження
32-розрядний.

-N, --dll-name=dllname
Встановіть внутрішню назву модуля. Він використовується тільки в модулях Win16. За замовчуванням
полягає у використанні базового імені файлу специфікації (без будь-якого розширення). Це використовується для
ЯДРО, оскільки воно живе в KRNL386.EXE. Інакше це не повинно бути потрібно.

--nm-cmd=nm-команда
Вкажіть команду, яку потрібно використовувати для отримання списку невизначених символів; за замовчуванням nm.

--nxcompat=так|немає
Укажіть, чи сумісний модуль з підтримкою no-exec. За замовчуванням – так.

-о, --вихід=файл
Встановіть назву вихідного файлу (за замовчуванням стандартний вихід). Якщо вихідний файл
Ім'я закінчується на .o, текстовий вихідний текст надсилається до тимчасового файлу, який потім збирається
щоб створити вказаний файл .o.

-р, --res=rsrc.res
Завантажте ресурси із зазначеного файлу бінарних ресурсів. The rsrc.res файл може бути
створено з вихідного файлу ресурсу з ВКР(1) (або за допомогою ресурсу Windows
компілятор).
Цей параметр необхідний лише для файлів ресурсів Win16, Win32 — просто
вказані як вхід файли і автоматично оброблятиметься правильно (хоча -r
Опція також працюватиме для файлів Win32).

--save-temps
Не видаляйте різні тимчасові файли, які winebuild породжує.

--підсистема=підсистема[:основний[.незначний]]
Встановіть підсистему виконуваного файлу, яка може бути однією з наступних:
втішити для виконуваного файлу командного рядка,
windows для графічного виконуваного файлу,
рідний для DLL в рідному режимі,
скривитися для CE dll.
Точкою входу виконуваного файлу командного рядка є звичайний C основний функція. А wmain
замість цього можна використовувати функцію, якщо вам потрібен масив аргументів для використання рядків Unicode.
Графічний виконуваний файл має a WinMain точка входу.
За бажанням також можна вказати основну та додаткову версію підсистеми; за замовчуванням
версія підсистеми 4.0.

-у, --невизначено=символ
додавати символ до списку невизначених символів під час виклику компоновщика. Це робить це
можливо примусово включити певний модуль статичної бібліотеки, коли
вирішення імпорту.

-v, -багатослівний
Відобразити різні підкоманди, які викликаються winebuild.

-- версія
Відобразити версію програми та вийти.

-w, --попередження
Увімкніть попередження.

SPEC Фото СИНТАКС

Загальне синтаксис
Файл специфікації повинен містити список порядкових декларацій. Загальним синтаксисом є
наступні:

порядковий тип функції [прапори] ім'я експорту ( [аргументи...] ) [обробник]
порядковий змінна [прапори] ім'я експорту ( [дані ...] )
порядковий зовнішній [прапори] ім'я експорту [назва символу]
порядковий заглушки [прапори] ім'я експорту [ (аргументи...) ]
порядковий прирівняти [прапори] ім'я експорту дані
# коментарі

Оголошення повинні розміщуватися в одному рядку, за винятком випадків, коли кінець рядка екранується за допомогою a
символ зворотної косої риски. The # символ у будь-якому місці рядка викликає решту рядка
проігноровано як коментар.

порядковий визначає порядковий номер, що відповідає точці входу, або '@' для
автоматичне розміщення порядкових номерів (тільки для Win32).

прапори це ряд необов’язкових прапорів, перед якими стоїть символ «-». Підтримувані прапори:

-ноестафета
Точка входу не відображається в трасах налагодження реле (тільки для Win32).

-без назви
Точка входу буде експортована за порядковим номером замість імені. Ім'я є
ще доступні для імпорту.

-ret16 Функція повертає 16-бітове значення (тільки для Win16).

-ret64 Функція повертає 64-бітове значення (тільки для Win32).

-реєстр
Функція використовує регістр ЦП для передачі аргументів.

-приват
Функцію не можна імпортувати з інших dll, до неї можна лише отримати доступ
через GetProcAddress.

-порядковий
Точка входу буде імпортована за порядковим номером замість імені. Ім'я є
все ще експортується.

-арх=центральний процесор[,центральний процесор]
Точка входу доступна лише на вказаній архітектурі(ях) ЦП. The
Імена win32 та win64 відповідати всім 32-розрядним або 64-розрядним архітектурам ЦП
відповідно. У 16-розрядних dll, вказавши -arch=win32 викликає точку входу
для експорту з 32-розрядного модуля обгортки.

функція порядкові
Синтаксис:
порядковий тип функції [прапори] ім'я експорту ( [аргументи...] ) [обробник]

Ця декларація визначає точку входу функції. Прототип визначається за
ім'я експорту ( [аргументи...] ) вказує ім’я, доступне для динамічного зв’язування, і формат
аргументів. "@" можна використовувати замість ім'я експорту тільки для звичайного експорту.

тип функції має бути одним із:

stdcall
для нормальної функції Win32

Паскаль для нормальної функції Win16

cdecl для функції Win16 або Win32 з використанням конвенції про виклики C

варарги
для функції Win16 або Win32, використовуючи конвенцію про виклик C зі змінною
кількість аргументів

цей дзвінок
для функції Win32 за допомогою цей дзвінок умова виклику (перший параметр
в %ecx зареєструвати на i386)

аргументи має бути одним або декількома з:

слово (16-бітове значення без знака)

s_word (16-розрядне знакове слово)

довго (ціле значення розміром з покажчиком)

int64 (64-розрядне ціле значення)

int128 (128-розрядне ціле значення)

плавати (32-бітове значення з плаваючою комою)

подвійний (64-бітове значення з плаваючою комою)

ptr (лінійний покажчик)

вул (лінійний вказівник на рядок ASCII із завершенням нуля)

wstr (лінійний покажчик на рядок Unicode, закінчений нулем)

segptr (сегментований вказівник)

segstr (сегментований вказівник на рядок ASCII із завершенням нуля).

Примітка. Типи 16-розрядних і сегментованих покажчиків дійсні лише для функцій Win16.

обробник це назва фактичної функції C, яка реалізує цю точку входу
32-розрядний режим. Обробник також можна вказати як dllname.функція щоб визначити перенаправлення
функція (та, реалізація якої знаходиться в іншій dll). Якщо обробник не вказано, є
вважається ідентичним ім'я експорту.

Цей перший приклад визначає точку входу для 32-розрядного виклику GetFocus():

@ stdcall GetFocus() GetFocus

Цей другий приклад визначає точку входу для 16-бітового виклику CreateWindow() (порядковий номер
100 – це лише приклад); він також показує, як довгі рядки можна розділити за допомогою зворотної косої риски:

100 паскалей CreateWindow(ptr ptr long s_word s_word s_word \
s_word слово слово слово ptr) WIN_CreateWindow

Щоб оголосити функцію за допомогою змінної кількості аргументів, вкажіть функцію як
варарги і оголосити його у файлі C за допомогою параметра '...' для функції Win32 або з
додатковий аргумент VA_LIST16 для функції Win16. Дивіться функції wsprintf* в
user.exe.spec і user32.spec для прикладу.

Змінна порядкові
Синтаксис:
порядковий змінна [прапори] ім'я експорту ( [дані ...] )

Ця декларація визначає зберігання даних як 32-бітові слова із зазначеним порядковим номером.
ім'я експорту буде ім’я, доступне для динамічного зв’язування. дані може бути десятковим числом
або шістнадцятковий номер перед "0x". У наступному прикладі визначається змінна VariableA at
порядковий номер 2 і містить 4 цілі:

2 змінна змінна A(-1 0xff 0 0)

Ця декларація працює лише у файлах специфікації Win16. У Win32 ви повинні використовувати зовнішній замість
(Дивіться нижче).

Зовнішній порядкові
Синтаксис:
порядковий зовнішній [прапори] ім'я експорту [назва символу]

Ця декларація визначає запис, який просто відображається на символі C (змінна або функція).
Він працює лише у файлах специфікації Win32. ім'я експорту вказуватиме на символ назва символу Що
повинні бути визначені в коді C. Як варіант, він може бути у формі dllname.назва символу до
визначити перенаправлений символ (той, чия реалізація знаходиться в іншій dll). Якщо назва символу is
не вказано, вважається, що він ідентичний ім'я експорту.

Пень порядкові
Синтаксис:
порядковий заглушки [прапори] ім'я експорту [ (аргументи...) ]

Ця декларація визначає функцію-заглушку. Це робить ім’я та порядковий номер доступними для
динамічне зв’язування, але завершить виконання з повідомленням про помилку, якщо функція є
коли-небудь дзвонив.

Зрівняти порядкові
Синтаксис:
порядковий прирівняти [прапори] ім'я експорту дані

Ця декларація визначає порядковий номер як абсолютне значення. ім'я експорту буде назва
доступні для динамічного зв’язування. дані може бути десятковим чи шістнадцятковим числом, якому передує
"0x".

AUTHORS

winebuild над ним працювало багато людей протягом багатьох років. Основні автори Роберт Дж.
Амштадт, Олександр Джульяр, Мартін фон Льюїс, Ульріх Вейганд і Ерік Янгдейл. Багато
інші люди внесли нові функції та виправили помилки. Повний список див. у git
журнали фіксації.

Використовуйте winebuild онлайн за допомогою служб onworks.net