winebuild - Online nel cloud

PROGRAMMA:

NOME

winebuild - Generatore di dll del vino

SINOSSI

costruzione del vino [Opzioni] [file di input...]

DESCRIZIONE

costruzione del vino genera i file assembly necessari per creare una DLL Wine, che è
fondamentalmente una dll Win32 incapsulata all'interno di una libreria Unix.

costruzione del vino ha diverse modalità, a seconda del tipo di file che gli viene chiesto di generare. Il
la modalità è specificata da una delle opzioni di modalità specificate di seguito. Oltre alla modalità
opzione, possono essere specificate varie altre opzioni della riga di comando, come descritto in VERSIONI
.

MODE VERSIONI

Devi specificare esattamente una delle seguenti opzioni, a seconda di ciò che desideri
winebuild per generare.

--dll Crea un file assembly da un file .spec (vedi SPEC RISORSE SINTASSI per i dettagli), o
da un file .def standard di Windows. Il file .spec/.def viene specificato tramite -E
opzione. Il file risultante deve essere assemblato e collegato agli altri file oggetto
per creare una DLL Wine funzionante. In questa modalità, il ingresso file dovrebbe essere l'elenco di
tutti i file oggetto che verranno collegati nella dll finale, per consentire costruzione del vino ottenere
l'elenco di tutti i simboli non definiti che devono essere importati da altre dll.

--EXE Crea un file assembly per un eseguibile. Questo è fondamentalmente lo stesso del --dll
mode tranne che non richiede un file .spec/.def come input, poiché un eseguibile
non è necessario esportare le funzioni. Alcuni eseguibili tuttavia eseguono funzioni di esportazione e per
quelli un file .spec/.def possono essere specificati tramite il -E opzione. L'eseguibile si chiama
dal nome del file .spec/.def se presente, o esplicitamente tramite il -F opzione. Il
il file risultante deve essere assemblato e collegato agli altri file oggetto per creare un
eseguibile Wine funzionante e tutti gli altri file oggetto devono essere elencati come ingresso
File.

--def Crea un file .def da un file spec. Il file .spec è specificato tramite -E opzione.
Viene utilizzato durante la creazione di DLL con un compilatore PE (Win32).

--implicita
Crea una libreria di importazione PE da un file di specifiche. Il file .spec è specificato tramite -E
opzione.

--risorse
Genera un file .o contenente tutte le risorse di input. Questo è utile durante la costruzione
con un compilatore PE, poiché le binutils PE non possono gestire più file di risorse come
ingresso. Per una build Unix standard, i file di risorse sono inclusi automaticamente
durante la creazione del file spec, quindi non è necessario un file .o intermedio.

VERSIONI

--come-cmd=come-comando
Specificare il comando da utilizzare per compilare i file assembly; l'impostazione predefinita è as.

-B, --bersaglio=produttore di cpu[-Kernel]-os
Specificare la CPU e la piattaforma di destinazione su cui verrà costruito il codice generato. Il
la specifica di destinazione è nel formato autoconf standard come restituito da config.sub.

--cc-cmd=cc-comando
Specificare il compilatore C da utilizzare per compilare i file assembly; l'impostazione predefinita è invece
utilizzare l'assemblatore specificato con -come-cmd.

-D, --ritardo-lib=Nome
Imposta la modalità di importazione ritardata per la libreria specificata, che deve essere una delle
librerie importate con il -l opzione. La modalità ritardata significa che la libreria non sarà
caricato fino a quando non viene effettivamente chiamata una funzione importata da esso.

-D simbolo
Ignorato per compatibilità con il compilatore C.

-e, --voce=function
Specificare la funzione del punto di ingresso del modulo; se non specificato, il valore predefinito è DllMain
per dll, e principale per gli eseguibili (se lo standard C principale non è definito, WinMain
si usa invece). Questo è valido solo per i moduli Win32.

- Ehi, --esportazione=Nome del file
Specifica un file .spec (vedi SPEC RISORSE SINTASSI per i dettagli) o un file .def . standard di Windows
file che definisce le esportazioni della DLL o dell'eseguibile in costruzione.

--simboli-esterni
Consenti il ​​collegamento a simboli esterni direttamente dal file delle specifiche. Normalmente simboli
esportati da una dll devono essere definiti nella dll stessa; questa opzione lo rende
possibile usare simboli definiti in un'altra libreria Unix (per simboli definiti in
un'altra dll, a inoltrare deve essere utilizzata la specifica).

-f opzione
Specificare un'opzione di generazione del codice. Attualmente -fPIC ed -tabelle-svolgimento-fasincrono
sono supportati. Altre opzioni vengono ignorate per compatibilità con il compilatore C.

--modulo-falso
Crea un modulo PE falso per una dll o un exe, invece del normale assembly o oggetto
file. Il modulo PE contiene le risorse per il modulo, ma nessun codice eseguibile.

-F, --nomefile=Nome del file
Imposta il nome del file del modulo. L'impostazione predefinita è utilizzare il nome di base della specifica
file (senza alcuna estensione).

-H, --Aiuto
Visualizza un messaggio di utilizzo ed esci.

-H, --heap=Taglia
Specificare la dimensione dell'heap locale del modulo in byte (valido solo per i moduli Win16);
l'impostazione predefinita non è un heap locale.

-I elenco
Ignorato per compatibilità con il compilatore C.

-K, --uccidere
Rimuovere le decorazioni stdcall dai nomi dei simboli nel file .def generato.
Significativo solo in --def modalità.

-K bandiere
Ignorato per compatibilità con il compilatore C.

--consapevolezza di indirizzi grandi
Imposta un flag nell'eseguibile per notificare al caricatore che questa applicazione supporta
spazi di indirizzi superiori a 2 gigabyte.

--ld-cmd=ld-comando
Specificare il comando da utilizzare per collegare i file oggetto; l'impostazione predefinita è ld.

-L, --percorso-libreria=elenco
Aggiunge la directory specificata all'elenco delle directory cercate
librerie di importazione.

-l, --libreria=Nome
Importa la libreria specificata, cercando una corrispondente nomelib.def file nella
directory specificate con -L opzione.

-m16, -m32, -M64
Genera codice rispettivamente a 16 bit, 32 bit o 64 bit.

-M, --modulo-principale=modulo
Quando si crea una dll a 16 bit, impostare il nome della sua controparte a 32 bit su modulo. Questo
viene utilizzato per imporre che l'ordine di caricamento per la dll a 16 bit corrisponda a quello del
uno a 32 bit.

-N, --nome-dll=nomedll
Imposta il nome interno del modulo. Viene utilizzato solo nei moduli Win16. Il predefinito
consiste nell'utilizzare il nome di base del file spec (senza alcuna estensione). Questo è usato per
KERNEL, poiché risiede in KRNL386.EXE. Non dovrebbe essere necessario altrimenti.

--nm-cmd=nm-comando
Specificare il comando da utilizzare per ottenere l'elenco dei simboli non definiti; l'impostazione predefinita è nm.

--nxcompat=sì|no
Specificare se il modulo è compatibile con il supporto no-exec. L'impostazione predefinita è sì.

-oh, --uscita=filetto
Imposta il nome del file di output (l'impostazione predefinita è l'output standard). Se il file di output
name termina con .o, l'output di testo viene inviato a un file temporaneo che viene quindi assemblato
per produrre il file .o specificato.

-R, --res =rsrc.res
Carica le risorse dal file di risorse binario specificato. Il rsrc.res il file può essere
prodotto da un file di risorse sorgente con wrc(1) (o con una risorsa Windows
compilatore).
Questa opzione è necessaria solo per i file di risorse Win16, quelli Win32 possono semplicemente
elencato come ingresso file e sarà gestito automaticamente correttamente (sebbene il -r
funzionerà anche per i file Win32).

--salva-temps
Non eliminare i vari file temporanei che costruzione del vino genera.

--sottosistema=sottosistema[:maggiore[.minore]]
Impostare il sottosistema dell'eseguibile, che può essere uno dei seguenti:
consolle per un eseguibile da riga di comando,
finestre per un eseguibile grafico,
nativo per una dll in modalità nativa,
sussultare per una ce dll.
Il punto di ingresso di un eseguibile da riga di comando è un normale C principale funzione. UN principale
la funzione può essere utilizzata invece se è necessario che l'array di argomenti utilizzi le stringhe Unicode.
Un eseguibile grafico ha un WinMain punto d'entrata.
Facoltativamente, è possibile specificare anche una versione del sottosistema principale e secondaria; il predefinito
la versione del sottosistema è 4.0.

-tu, --non definito=simbolo
Aggiungi simbolo all'elenco dei simboli non definiti quando si invoca il linker. Questo lo rende
possibile forzare l'inclusione di un modulo specifico di una libreria statica quando
risoluzione delle importazioni.

-in, --verboso
Visualizza i vari sottocomandi invocati da costruzione del vino.

--versione
Visualizza la versione del programma ed esci.

-w, --avvertenze
Attiva gli avvisi.

SPEC RISORSE SINTASSI

Generale sintassi
Un file spec dovrebbe contenere un elenco di dichiarazioni ordinali. La sintassi generale è la
seguenti:

ordinale tipo di funzione [bandiere] nomeesportazione ( [argomenti...] ) [Handler]
ordinale variabile [bandiere] nomeesportazione ( [dati...] )
ordinale esterno [bandiere] nomeesportazione [nomesimbolo]
ordinale mozzicone [bandiere] nomeesportazione [ (argomenti...) ]
ordinale uguagliare [bandiere] nomeesportazione dati
# Commenti

Le dichiarazioni devono rientrare in una singola riga, eccetto se la fine della riga viene evitata utilizzando a
carattere barra rovesciata. Il # carattere ovunque in una riga fa sì che il resto della riga sia
ignorato come commento.

ordinale specifica il numero ordinale corrispondente al punto di ingresso, o '@' per
allocazione ordinale automatica (solo Win32).

bandiere è una serie di flag opzionali, preceduti da un carattere '-'. I flag supportati sono:

-norelè
Il punto di ingresso non viene visualizzato nelle tracce di debug dell'inoltro (solo Win32).

-senza nome
Il punto di ingresso verrà esportato per ordinale anziché per nome. Il nome è
ancora disponibile per l'importazione.

-ret16 La funzione restituisce un valore a 16 bit (solo Win16).

-ret64 La funzione restituisce un valore a 64 bit (solo Win32).

-registro
La funzione utilizza il registro della CPU per passare gli argomenti.

-privato
La funzione non può essere importata da altre dll, è possibile accedervi solo
tramite GetProcAddress.

-ordinale
Il punto di ingresso verrà importato per ordinale anziché per nome. Il nome è
ancora esportato.

-arco=cpu[,cpu]
Il punto di ingresso è disponibile solo sulle architetture CPU specificate. Il
nomi win32 ed win64 corrisponde a tutte le architetture CPU a 32 o 64 bit
rispettivamente. Nelle dll a 16 bit, specificando -arco=win32 provoca il punto di ingresso
da esportare dal modulo wrapper a 32 bit.

Funzione ordinali
Sintassi:
ordinale tipo di funzione [bandiere] nomeesportazione ( [argomenti...] ) [Handler]

Questa dichiarazione definisce un punto di ingresso della funzione. Il prototipo definito da
nomeesportazione ( [argomenti...] ) specifica il nome disponibile per il collegamento dinamico e il formato
degli argomenti. '@' può essere usato al posto di nomeesportazione per le esportazioni solo ordinali.

tipo di funzione dovrebbe essere uno tra:

stdcall
per una normale funzione Win32

pascal per una normale funzione Win16

cdecl per una funzione Win16 o Win32 utilizzando la convenzione di chiamata C

vararg
per una funzione Win16 o Win32 utilizzando la convenzione di chiamata C con una variabile
numero di argomenti

questa chiamata
per una funzione Win32 usando il questa chiamata convenzione di chiamata (primo parametro
nel registro %ecx su i386)

args dovrebbe essere uno o più di:

parola (valore senza segno a 16 bit)

spada (parola con segno a 16 bit)

lungo (valore intero delle dimensioni del puntatore)

int64 (valore intero a 64 bit)

int128 (valore intero a 128 bit)

galleggiante (valore in virgola mobile a 32 bit)

doppio (valore in virgola mobile a 64 bit)

PTR (puntatore lineare)

str (puntatore lineare a una stringa ASCII con terminazione null)

wstr (puntatore lineare a una stringa Unicode con terminazione null)

seg (puntatore segmentato)

segstr (puntatore segmentato a una stringa ASCII con terminazione null).

Nota: i tipi di puntatore a 16 bit e segmentato sono validi solo per le funzioni Win16.

Handler è il nome della funzione C effettiva che implementerà quel punto di ingresso in
Modalità a 32 bit. Il gestore può anche essere specificato come nomedll.function definire un inoltrato
funzione (una la cui implementazione è in un'altra dll). Se Handler non è specificato, è
presume essere identico a nomeesportazione.

Questo primo esempio definisce un punto di ingresso per la chiamata GetFocus() a 32 bit:

@stdcall GetFocus() GetFocus

Questo secondo esempio definisce un punto di ingresso per la chiamata CreateWindow() a 16 bit (l'ordinale
100 è solo un esempio); mostra anche per quanto tempo le righe possono essere divise usando una barra rovesciata:

100 pascal CreateWindow(ptr ptr long s_word s_word s_word \
s_word parola parola parola ptr) WIN_CreateWindow

Per dichiarare una funzione utilizzando un numero variabile di argomenti, specificare la funzione come
vararg e dichiararlo nel file C con un parametro '...' per una funzione Win32 o con
un argomento VA_LIST16 aggiuntivo per una funzione Win16. Vedi le funzioni wsprintf* in
user.exe.spec e user32.spec per un esempio.

Variabile ordinali
Sintassi:
ordinale variabile [bandiere] nomeesportazione ( [dati...] )

Questa dichiarazione definisce l'archiviazione dei dati come parole a 32 bit all'ordinale specificato.
nomeesportazione sarà il nome disponibile per il collegamento dinamico. dati può essere un numero decimale
o un numero esadecimale preceduto da "0x". L'esempio seguente definisce la variabile VariableA at
ordinale 2 e contenente 4 interi:

2 variabile VariabileA(-1 0xff 0 0)

Questa dichiarazione funziona solo nei file delle specifiche Win16. In Win32 dovresti usare esterno invece
(vedi sotto).

Esterno ordinali
Sintassi:
ordinale esterno [bandiere] nomeesportazione [nomesimbolo]

Questa dichiarazione definisce una voce che si associa semplicemente a un simbolo C (variabile o funzione).
Funziona solo nei file delle specifiche Win32. nomeesportazione indicherà il simbolo nomesimbolo che
deve essere definito nel codice C. In alternativa, può essere della forma nomedll.nomesimbolo a
definire un simbolo inoltrato (uno la cui implementazione è in un'altra dll). Se nomesimbolo is
non specificato, si presume che sia identico a nomeesportazione.

mozzicone ordinali
Sintassi:
ordinale mozzicone [bandiere] nomeesportazione [ (argomenti...) ]

Questa dichiarazione definisce una funzione stub. Rende disponibile il nome e l'ordinale per
collegamento dinamico, ma terminerà l'esecuzione con un messaggio di errore se la funzione è
mai chiamato.

Equare ordinali
Sintassi:
ordinale uguagliare [bandiere] nomeesportazione dati

Questa dichiarazione definisce un ordinale come un valore assoluto. nomeesportazione sarà il nome
disponibile per il collegamento dinamico. dati può essere un numero decimale o un numero esadecimale preceduto da
"0x".

AUTORI

costruzione del vino è stato lavorato da molte persone nel corso degli anni. Gli autori principali sono Robert J.
Amstadt, Alexandre Julliard, Martin von Loewis, Ulrich Weigand ed Eric Youngdale. Molti
altre persone hanno contribuito con nuove funzionalità e correzioni di bug. Per un elenco completo, vedere il git
log di commit.

Usa winebuild online utilizzando i servizi onworks.net