winebuild-ontwikkeling - Online in de Cloud

PROGRAMMA:

NAAM

winebuild - Wine dll-bouwer

KORTE INHOUD

wijnbouw [opties] [Invoer bestand​

PRODUCTBESCHRIJVING

wijnbouw genereert de assemblagebestanden die nodig zijn om een ​​Wine-dll te bouwen, dat wil zeggen
eigenlijk een Win32-dll ingekapseld in een Unix-bibliotheek.

wijnbouw heeft verschillende modi, afhankelijk van het soort bestand dat moet worden gegenereerd. De
modus wordt gespecificeerd door een van de hieronder gespecificeerde modusopties. Naast de modus
optie kunnen diverse andere opdrachtregelopties worden opgegeven, zoals beschreven in de OPTIES
pagina.

MODE OPTIES

U moet precies één van de volgende opties opgeven, afhankelijk van wat u wilt
wijnbouw om te genereren.

--dll Bouw een assemblagebestand van een .spec-bestand (zie SPEC FILE SYNTAXIS voor meer informatie), of
vanuit een standaard Windows .def-bestand. Het .spec/.def-bestand wordt opgegeven via de -E
keuze. Het resulterende bestand moet worden samengesteld en gekoppeld aan de andere objectbestanden
om een ​​werkende Wine-dll te bouwen. In deze modus wordt de invoer bestanden zou de lijst moeten zijn
alle objectbestanden die aan de uiteindelijke dll worden gekoppeld, toestaan wijnbouw te krijgen
de lijst met alle ongedefinieerde symbolen die uit andere dll's moeten worden geïmporteerd.

--exe Bouw een assemblagebestand voor een uitvoerbaar bestand. Dit is in principe hetzelfde als de --dll
modus, behalve dat er geen .spec/.def-bestand als invoer nodig is, omdat het een uitvoerbaar bestand is
hoeft geen functies te exporteren. Sommige uitvoerbare bestanden exporteren echter functies, en voor
die een .spec/.def-bestand kunnen worden opgegeven via de -E keuze. Het uitvoerbare bestand heeft een naam
van de bestandsnaam .spec/.def, indien aanwezig, of expliciet via de -F optie. De
Het resulterende bestand moet worden samengesteld en aan de andere objectbestanden worden gekoppeld om een
werkend uitvoerbaar Wine-bestand en alle andere objectbestanden moeten worden vermeld als invoer
bestanden.

--def Bouw een .def-bestand op basis van een spec-bestand. Het .spec-bestand wordt opgegeven via de -E optie.
Dit wordt gebruikt bij het bouwen van dll's met een PE (Win32)-compiler.

--impliceren
Bouw een PE-importbibliotheek op basis van een spec-bestand. Het .spec-bestand wordt opgegeven via de -E
optie.

--bronnen
Genereer een .o-bestand met alle invoerbronnen. Dit is handig bij het bouwen
met een PE-compiler, aangezien de PE binutils niet meerdere bronbestanden kunnen verwerken zoals
invoer. Voor een standaard Unix-build worden de bronbestanden automatisch opgenomen
bij het bouwen van het spec-bestand, dus er is geen tussenproduct nodig.

OPTIES

--as-cmd=als opdracht
Geef de opdracht op die moet worden gebruikt om assemblagebestanden te compileren; de standaardwaarde is as.

-B, --doel=cpu-fabrikant[-pit]-os
Specificeer de doel-CPU en het platform waarop de gegenereerde code zal worden gebouwd. De
doelspecificatie is in het standaard autoconf-formaat zoals geretourneerd door config.sub.

--cc-cmd=cc-opdracht
Geef de C-compiler op die moet worden gebruikt om assemblagebestanden te compileren; de standaardinstelling is in plaats daarvan
gebruik de assembler die is opgegeven bij --als-cmd.

-NS, --vertraging-lib=naam
Stel de vertraagde importmodus in voor de opgegeven bibliotheek, die een van de
bibliotheken geïmporteerd met de -l keuze. Vertraagde modus betekent dat de bibliotheek dat niet zal zijn
geladen totdat een daaruit geïmporteerde functie daadwerkelijk wordt aangeroepen.

-D symbool
Genegeerd vanwege compatibiliteit met de C-compiler.

-e, --invoer=functie
Specificeer de module-ingangspuntfunctie; indien niet gespecificeerd, is dit de standaardwaarde DllHoofd
voor dll's, en hoofd- voor uitvoerbare bestanden (als de standaard C hoofd- is niet gedefinieerd, WinMain
wordt in plaats daarvan gebruikt). Dit geldt alleen voor Win32-modules.

-IS, --exporteren=bestandsnaam
Geef een .spec-bestand op (zie SPEC FILE SYNTAXIS voor details), of een standaard Windows .def
bestand dat de export definieert van de DLL of het uitvoerbare bestand dat wordt gebouwd.

--externe-symbolen
Sta koppeling naar externe symbolen rechtstreeks vanuit het specificatiebestand toe. Normaal gesproken symbolen
geëxporteerd door een dll moeten in de dll zelf worden gedefinieerd; deze optie maakt het
mogelijk om symbolen te gebruiken die zijn gedefinieerd in een andere Unix-bibliotheek (voor symbolen die zijn gedefinieerd in
nog een dll, een vooruit specificatie moet in plaats daarvan worden gebruikt).

-f optie
Geef een optie voor het genereren van code op. Momenteel -fPIC en -fasynchrone-afwikkel-tabellen
worden ondersteund. Andere opties worden genegeerd vanwege compatibiliteit met de C-compiler.

--fake-module
Maak een nep-PE-module voor een dll of exe, in plaats van de normale assembly of object
bestand. De PE-module bevat de bronnen voor de module, maar geen uitvoerbare code.

-F, --bestandsnaam=bestandsnaam
Stel de bestandsnaam van de module in. Standaard wordt de basisnaam van de specificatie gebruikt
bestand (zonder enige extensie).

-H, --help
Geef een gebruiksbericht weer en sluit af.

-H, --hoop=grootte
Geef de grootte van de lokale heap van de module op in bytes (alleen geldig voor Win16-modules);
standaard is geen lokale heap.

-I directory
Genegeerd vanwege compatibiliteit met de C-compiler.

-k, --doden-bij
Verwijder de stdcall-versieringen uit de symboolnamen in het gegenereerde .def-bestand.
Alleen zinvol in --def modus.

-K vlaggen
Genegeerd vanwege compatibiliteit met de C-compiler.

--groot adres bewust
Stel een vlag in het uitvoerbare bestand in om de lader te informeren dat deze applicatie ondersteunt
adresruimten groter dan 2 gigabyte.

--ld-cmd=ld-opdracht
Geef de opdracht op die moet worden gebruikt om de objectbestanden te koppelen; de standaardwaarde is ld.

-L, --bibliotheek-pad=directory
Voeg de opgegeven map toe aan de lijst met mappen waarnaar wordt gezocht
bibliotheken importeren.

-ik, --bibliotheek=naam
Importeer de opgegeven bibliotheek en zoek naar een overeenkomstige bibliotheek libnaam.def bestand in de
mappen opgegeven met de -L optie.

-m16, -m32, -m64
Genereer respectievelijk 16-bit, 32-bit of 64-bit code.

-marme, -mduim, -maart=optie, -mcpu=optie
Stel opties voor het genereren van code in voor de assembler.

-M, --hoofdmodule=module
Wanneer u een 16-bits dll bouwt, stelt u de naam van de 32-bits tegenhanger in op module. Deze
wordt gebruikt om af te dwingen dat de laadvolgorde voor de 16-bits dll overeenkomt met die van de
32-bits één.

-N, --dll-naam=dllnaam
Stel de interne naam van de module in. Het wordt alleen gebruikt in Win16-modules. De standaard
is om de basisnaam van het spec-bestand te gebruiken (zonder enige extensie). Hiervoor wordt gebruikt
KERNEL, omdat het zich in KRNL386.EXE bevindt. Anders zou het niet nodig moeten zijn.

--nm-cmd=nm-opdracht
Geef de opdracht op die moet worden gebruikt om de lijst met ongedefinieerde symbolen op te halen; de standaardwaarde is nm.

--nxcompat=ja|geen
Geef op of de module compatibel is met no-exec-ondersteuning. De standaardinstelling is ja.

-O, --uitvoer=filet
Stel de naam van het uitvoerbestand in (standaard is standaarduitvoer). Als het uitvoerbestand
naam eindigt op .o, de tekstuitvoer wordt naar een tijdelijk bestand gestuurd dat vervolgens wordt samengesteld
om het opgegeven .o-bestand te produceren.

-R, --res=rsrc.res
Laad bronnen uit het opgegeven binaire bronbestand. De rsrc.res bestand kan zijn
geproduceerd vanuit een bronbronbestand met wrc(1) (of met een Windows-bron
compiler).
Deze optie is alleen nodig voor Win16-bronbestanden, de Win32-bronbestanden kunnen dat eenvoudigweg
Vermeld als invoer bestanden en wordt automatisch correct afgehandeld (hoewel de -r
optie werkt ook voor Win32-bestanden).

--save-temps
Verwijder niet de verschillende tijdelijke bestanden die wijnbouw genereert.

--subsysteem=subsysteem[:groot[.minder]]
Stel het subsysteem van het uitvoerbare bestand in, wat een van de volgende kan zijn:
console voor een uitvoerbaar opdrachtregelbestand,
ruiten voor een grafisch uitvoerbaar bestand,
inheemse voor een native-modus dll,
huiveren voor een ce-dll.
Het beginpunt van een uitvoerbaar opdrachtregelbestand is een normale C hoofd- functie. EEN wmain
functie kan in plaats daarvan worden gebruikt als u de argumentarray nodig heeft om Unicode-tekenreeksen te gebruiken.
Een grafisch uitvoerbaar bestand heeft een WinMain ingangspunt.
Optioneel kan ook een major- en minor-subsysteemversie worden gespecificeerd; de standaard
subsysteemversie is 4.0.

-u, --ongedefinieerd=symbool
Toevoegen symbool naar de lijst met ongedefinieerde symbolen bij het aanroepen van de linker. Dit maakt het
mogelijk om te forceren dat een specifieke module van een statische bibliotheek wordt opgenomen wanneer
import op te lossen.

-in, --uitgebreid
Geef de verschillende subopdrachten weer die worden aangeroepen wijnbouw.

--versie
Geef de programmaversie weer en sluit af.

-w, --waarschuwingen
Schakel waarschuwingen in.

SPEC FILE SYNTAXIS

Algemeen syntaxis
Een spec-bestand moet een lijst met ordinale declaraties bevatten. De algemene syntaxis is de
volgende:

rangtelwoord functietype [vlaggen] exportnaam ( [argumenten...] ) [handler]
rangtelwoord variabele [vlaggen] exportnaam ( [gegevens...] )
rangtelwoord extern [vlaggen] exportnaam [symboolnaam]
rangtelwoord stomp [vlaggen] exportnaam [ (argumenten...) ]
rangtelwoord gelijkstellen [vlaggen] exportnaam gegevens
# opmerkingen

Declaraties moeten op één regel passen, behalve als het einde van de regel wordt geëscaped met behulp van a
backslash-karakter. De # teken ergens op een regel zorgt ervoor dat de rest van de regel hetzelfde is
genegeerd als commentaar.

rangtelwoord specificeert het volgnummer dat overeenkomt met het toegangspunt, of '@' voor
automatische ordinale toewijzing (alleen Win32).

vlaggen is een reeks optionele vlaggen, voorafgegaan door een '-' teken. De ondersteunde vlaggen zijn:

-norelais
Het ingangspunt wordt niet weergegeven in relay-foutopsporingssporen (alleen Win32).

-geen naam
Het toegangspunt wordt geëxporteerd op ordinaalnummer in plaats van op naam. De naam is
nog steeds beschikbaar voor import.

-ret16 De functie retourneert een 16-bits waarde (alleen Win16).

-ret64 De functie retourneert een 64-bits waarde (alleen Win32).

-register
De functie gebruikt het CPU-register om argumenten door te geven.

-privaat
De functie kan niet uit andere dll's worden geïmporteerd, maar is alleen toegankelijk
via GetProcAddress.

-ordinaal
Het toegangspunt wordt geïmporteerd op rangtelwoord in plaats van op naam. De naam is
nog steeds geëxporteerd.

-boog=cpu[,cpu]
Het toegangspunt is alleen beschikbaar op de opgegeven CPU-architectuur(en). De
namen win32 en win64 overeenkomen met alle 32-bits of 64-bits CPU-architecturen
respectievelijk. In 16-bits dll's, specificeer -boog=win32 veroorzaakt het toegangspunt
te exporteren vanuit de 32-bits wrappermodule.

Functie rangtelwoorden
Syntax:
rangtelwoord functietype [vlaggen] exportnaam ( [argumenten...] ) [handler]

Deze declaratie definieert een functie-ingangspunt. Het prototype gedefinieerd door
exportnaam ( [argumenten...] ) specificeert de naam die beschikbaar is voor dynamisch koppelen en het formaat
van de argumenten. '@' kan worden gebruikt in plaats van exportnaam voor alleen ordinale exporten.

functietype moet een van zijn:

STDCALL
voor een normale Win32-functie

pascal voor een normale Win16-functie

cdcl voor een Win16- of Win32-functie met behulp van de C-aanroepconventie

Varargs
voor een Win16- of Win32-functie met behulp van de C-aanroepconventie met een variabele
aantal argumenten

deze oproep
voor een Win32-functie met behulp van de deze oproep aanroepconventie (eerste parameter
in %ecx registreren op i386)

betoogt moet een of meerdere zijn van:

woord (16-bits waarde zonder teken)

zwaard (16-bits ondertekend woord)

lang (geheel getal ter grootte van een aanwijzer)

int64 (64-bits gehele waarde)

int128 (128-bits gehele waarde)

drijven (32-bits drijvende-kommawaarde)

verdubbelen (64-bits drijvende-kommawaarde)

ptr (lineaire wijzer)

str (lineaire verwijzing naar een op nul eindigende ASCII-reeks)

wstr (lineaire verwijzing naar een op nul eindigende Unicode-reeks)

septr (gesegmenteerde aanwijzer)

gescheiden (gesegmenteerde verwijzing naar een op null eindigende ASCII-reeks).

Opmerking: de 16-bits en gesegmenteerde pointertypen zijn alleen geldig voor Win16-functies.

handler is de naam van de daadwerkelijke C-functie die dat toegangspunt zal implementeren
32-bits modus. De handler kan ook worden opgegeven als dllnaam.functie om een ​​doorgestuurde te definiëren
functie (een waarvan de implementatie zich in een andere dll bevindt). Als handler is niet gespecificeerd, het is
verondersteld identiek te zijn exportnaam.

Dit eerste voorbeeld definieert een toegangspunt voor de 32-bits GetFocus()-aanroep:

@ stdcall GetFocus() GetFocus

Dit tweede voorbeeld definieert een ingangspunt voor de 16-bits CreateWindow()-aanroep (de rangtelwoord
100 is slechts een voorbeeld); het laat ook zien hoe lange lijnen kunnen worden gesplitst met behulp van een backslash:

100 pascal CreateWindow(ptr ptr lang s_woord s_woord s_woord \
s_word woord woord woord ptr) WIN_CreateWindow

Om een ​​functie te declareren met een variabel aantal argumenten, specificeert u de functie als
Varargs en declareer het in het C-bestand met een parameter '...' voor een Win32-functie, of met
een extra VA_LIST16-argument voor een Win16-functie. Zie de wsprintf*-functies in
user.exe.spec en user32.spec voor een voorbeeld.

Veranderlijk rangtelwoorden
Syntax:
rangtelwoord variabele [vlaggen] exportnaam ( [gegevens...] )

Deze declaratie definieert gegevensopslag als 32-bits woorden op de opgegeven rangtelwoord.
exportnaam is de naam die beschikbaar is voor dynamisch koppelen. gegevens kan een decimaal getal zijn
of een hex-nummer voorafgegaan door "0x". In het volgende voorbeeld wordt de variabele VariabeleA gedefinieerd op
rangtelwoord 2 en bevat 4 ints:

2 variabele VariabeleA(-1 0xff 0 0)

Deze declaratie werkt alleen in Win16-specificatiebestanden. In Win32 zou je moeten gebruiken extern verkrijgen in plaats daarvan
(zie hieronder).

Extern rangtelwoorden
Syntax:
rangtelwoord extern [vlaggen] exportnaam [symboolnaam]

Deze declaratie definieert een item dat eenvoudigweg wordt toegewezen aan een C-symbool (variabele of functie).
Het werkt alleen in Win32-specificatiebestanden. exportnaam zal naar het symbool wijzen symboolnaam dat
moet worden gedefinieerd in de C-code. Als alternatief kan het de vorm hebben dllnaam.symboolnaam naar
definieer een doorgestuurd symbool (waarvan de implementatie zich in een andere dll bevindt). Als symboolnaam is
niet gespecificeerd, wordt aangenomen dat het identiek is aan exportnaam.

Stomp rangtelwoorden
Syntax:
rangtelwoord stomp [vlaggen] exportnaam [ (argumenten...) ]

Deze declaratie definieert een stub-functie. Het maakt de naam en rangtelwoord beschikbaar voor
dynamisch koppelen, maar zal de uitvoering beëindigen met een foutmelding als de functie dat is
ooit gebeld.

Gelijk rangtelwoorden
Syntax:
rangtelwoord gelijkstellen [vlaggen] exportnaam gegevens

Deze verklaring definieert een rangtelwoord als een absolute waarde. exportnaam zal de naam zijn
beschikbaar voor dynamische koppeling. gegevens kan een decimaal getal zijn of een hexadecimaal getal voorafgegaan door
"0x".

AUTEURS

wijnbouw waar in de loop der jaren door veel mensen aan is gewerkt. De belangrijkste auteurs zijn Robert J.
Amstadt, Alexandre Julliard, Martin von Loewis, Ulrich Weigand en Eric Youngdale. Veel
andere mensen hebben nieuwe functies en bugfixes bijgedragen. Voor een volledige lijst, zie de git
commit-logboeken.

Gebruik online winebuild-ontwikkeling met behulp van onworks.net-services