winebuild - Online w chmurze

PROGRAM:

IMIĘ

winebuild - Konstruktor biblioteki dll Wine

STRESZCZENIE

budowanie wina [Opcje] [plik wejściowy...]

OPIS

budowanie wina generuje pliki zestawu, które są niezbędne do zbudowania biblioteki dll Wine, która jest
w zasadzie biblioteka Win32 dll zamknięta w bibliotece uniksowej.

budowanie wina ma różne tryby, w zależności od rodzaju pliku, który ma wygenerować. ten
tryb jest określony przez jedną z opcji trybu określonych poniżej. Oprócz trybu
opcja, można określić różne inne opcje wiersza poleceń, jak opisano w OPCJE

TRYB OPCJE

Musisz określić dokładnie jedną z poniższych opcji, w zależności od tego, czego chcesz
winebuild do generowania.

--dll Zbuduj plik zespołu z pliku .spec (zobacz SPEC FILE SKŁADNIA szczegóły) lub
ze standardowego pliku .def systemu Windows. Plik .spec/.def jest określony przez -E
opcja. Wynikowy plik musi być złożony i połączony z innymi plikami obiektowymi
zbudować działającą bibliotekę Wine. W tym trybie wkład pliki powinna być lista
wszystkie pliki obiektowe, które zostaną połączone z ostateczną biblioteką dll, aby umożliwić budowanie wina dostać
lista wszystkich niezdefiniowanych symboli, które należy zaimportować z innych bibliotek dll.

--exe Zbuduj plik zespołu dla pliku wykonywalnego. To w zasadzie to samo, co --dll
z wyjątkiem tego, że nie wymaga pliku .spec/.def jako danych wejściowych, ponieważ plik wykonywalny
nie trzeba eksportować funkcji. Niektóre pliki wykonywalne jednak eksportują funkcje, a dla
te pliki .spec/.def można określić za pomocą -E opcja. Plik wykonywalny nosi nazwę
z nazwy pliku .spec/.def, jeśli jest obecny, lub jawnie przez -F opcja.
plik wynikowy musi być złożony i połączony z innymi plikami obiektowymi, aby zbudować a
działający plik wykonywalny Wine, a wszystkie inne pliki obiektowe muszą być wymienione jako wkład
akta.

--pok Zbuduj plik .def z pliku spec. Plik .spec jest określony przez -E opcja.
Jest to używane podczas budowania bibliotek dll za pomocą kompilatora PE (Win32).

--implib
Zbuduj bibliotekę importu PE z pliku spec. Plik .spec jest określony przez -E
opcja.

--Surowce
Wygeneruj plik .o zawierający wszystkie zasoby wejściowe. Jest to przydatne podczas budowania
z kompilatorem PE, ponieważ binutils PE nie mogą obsługiwać wielu plików zasobów, ponieważ
Wejście. W przypadku standardowej wersji Uniksa pliki zasobów są dołączane automatycznie
podczas budowania pliku spec, więc nie ma potrzeby tworzenia pośredniego pliku .o.

OPCJE

--jako-cmd=jako-polecenie
Określ polecenie, które ma być używane do kompilowania plików zestawu; domyślnie as.

-B, --cel=producent procesora[-jądro]-os
Określ docelowy procesor i platformę, na której zostanie zbudowany wygenerowany kod. ten
specyfikacja celu jest w standardowym formacie autoconf zwróconym przez config.sub.

--cc-cmd=polecenie-cc
Określ kompilator C, który ma być używany do kompilowania plików zestawu; domyślnie zamiast tego
użyj asemblera określonego za pomocą --jako-cmd.

-D, --opóźnienie-lib=Nazwa
Ustaw tryb opóźnionego importu dla określonej biblioteki, która musi być jedną z
biblioteki importowane z -l opcja. Tryb opóźniony oznacza, że ​​biblioteka nie będzie
ładowane, dopóki importowana z niego funkcja nie zostanie wywołana.

-D symbol
Ignorowane ze względu na zgodność z kompilatorem C.

-mi, --wpis=funkcjonować
Określ funkcję punktu wejścia modułu; jeśli nie określono, domyślnie jest DllMain
dla bibliotek dll i główny dla plików wykonywalnych (jeśli standardowe C główny nie jest zdefiniowany, WinMain
jest używany zamiast tego). Dotyczy to tylko modułów Win32.

-MI, --eksport=filename
Określ plik .spec (zobacz SPEC FILE SKŁADNIA aby uzyskać szczegółowe informacje) lub standardowy plik .def . systemu Windows
plik, który definiuje eksporty kompilowanej biblioteki DLL lub pliku wykonywalnego.

--symbole-zewnętrzne
Zezwalaj na linkowanie do zewnętrznych symboli bezpośrednio z pliku specyfikacji. Normalnie symbole
eksportowane przez dll muszą być zdefiniowane w samej dll; ta opcja sprawia, że
można używać symboli zdefiniowanych w innej bibliotece Unix (dla symboli zdefiniowanych w
inny plik DLL, a Naprzód zamiast tego należy użyć specyfikacji).

-f opcja
Określ opcję generowania kodu. Obecnie -fPIC i -fasynchroniczne-rozwijające-tabele
są obsługiwane. Inne opcje są ignorowane ze względu na zgodność z kompilatorem C.

--fałszywy-moduł
Utwórz fałszywy moduł PE dla dll lub exe, zamiast normalnego zestawu lub obiektu
plik. Moduł PE zawiera zasoby modułu, ale nie zawiera kodu wykonywalnego.

-F, --nazwa_pliku=filename
Ustaw nazwę pliku modułu. Domyślnie używana jest nazwa podstawowa specyfikacji
plik (bez rozszerzenia).

-H, --help
Wyświetl komunikat o użyciu i wyjdź.

-H, --sterta=rozmiar
Określ rozmiar lokalnej sterty modułu w bajtach (dotyczy tylko modułów Win16);
domyślnie nie ma lokalnej sterty.

-I katalog
Ignorowane ze względu na zgodność z kompilatorem C.

-k, --zabij-at
Usuń dekoracje stdcall z nazw symboli w wygenerowanym pliku .def.
Tylko znaczące w --pok tryb.

-K Flagi
Ignorowane ze względu na zgodność z kompilatorem C.

--duży adres-świadomy
Ustaw flagę w pliku wykonywalnym, aby powiadomić program ładujący, że ta aplikacja obsługuje
przestrzenie adresowe większe niż 2 gigabajty.

--ld-cmd=ld-polecenie
Określ polecenie, które ma zostać użyte do połączenia plików obiektów; domyślnie ld.

-L, --ścieżka-biblioteki=katalog
Dołącz określony katalog do listy wyszukiwanych katalogów
importuj biblioteki.

-ja, --biblioteka=Nazwa
Zaimportuj określoną bibliotekę, szukając odpowiadającej nazwa_biblioteki.def Plik w
katalogi określone za pomocą -L opcja.

-m16, -m32, -m64
Wygeneruj odpowiednio 16-bitowy, 32-bitowy lub 64-bitowy kod.

-M, --moduł-główny=moduł
Tworząc 16-bitową bibliotekę dll, ustaw nazwę jej 32-bitowego odpowiednika na moduł, To
służy do wymuszenia, że ​​kolejność ładowania 16-bitowej biblioteki dll jest zgodna z
32-bitowy.

-N, --nazwa-dll=nazwa dll
Ustaw wewnętrzną nazwę modułu. Jest używany tylko w modułach Win16. Domyślny
jest użycie podstawowej nazwy pliku spec (bez rozszerzenia). Służy do
KERNEL, ponieważ mieszka w KRNL386.EXE. W przeciwnym razie nie powinno być potrzebne.

--nm-cmd=polecenie nm
Określ polecenie, którego chcesz użyć, aby uzyskać listę niezdefiniowanych symboli; domyślnie nm.

--nxkompatybilność=tak|Nie
Określ, czy moduł jest zgodny z obsługą no-exec. Wartość domyślna to tak.

-o, --wyjście=filet
Ustaw nazwę pliku wyjściowego (domyślnie jest to standardowe wyjście). Jeśli plik wyjściowy
nazwa kończy się na .o, wynik tekstowy jest wysyłany do pliku tymczasowego, który jest następnie składany
do wytworzenia określonego pliku .o.

-R, --res=rsrc.res
Załaduj zasoby z określonego binarnego pliku zasobów. ten rsrc.res plik może być
tworzony z pliku zasobów źródłowych z wrc(1) (lub z zasobem Windows
kompilator).
Ta opcja jest wymagana tylko dla plików zasobów Win16, te Win32 mogą po prostu
Wymienione jako wkład pliki i będą automatycznie obsługiwane poprawnie (chociaż -r
opcja zadziała również dla plików Win32).

--zapisz-temps
Nie usuwaj różnych plików tymczasowych, które budowanie wina generuje.

--podsystem=podsystem[:poważny[.moll]]
Ustaw podsystem pliku wykonywalnego, który może być jednym z następujących:
konsola dla pliku wykonywalnego wiersza poleceń,
okna dla graficznego pliku wykonywalnego,
rodzimy dla biblioteki dll w trybie natywnym,
grymas twarzy dla ce dll.
Punktem wejścia pliku wykonywalnego wiersza poleceń jest normalne C główny funkcjonować. A główna
Zamiast tego można użyć funkcji, jeśli potrzebujesz tablicy argumentów do używania ciągów Unicode.
Graficzny plik wykonywalny ma WinMain Punkt wejścia.
Opcjonalnie można również określić główną i pomocniczą wersję podsystemu; domyślny
wersja podsystemu to 4.0.

-ty, --niezdefiniowany=symbol
Dodaj symbol do listy niezdefiniowanych symboli podczas wywoływania linkera. To sprawia, że
możliwe wymuszenie dołączenia określonego modułu biblioteki statycznej, gdy
rozwiązywanie importów.

-v, --gadatliwy
Wyświetl różne podkomendy wywoływane przez budowanie wina.

--wersja
Wyświetl wersję programu i wyjdź.

-w, --ostrzeżenia
Włącz ostrzeżenia.

SPEC FILE SKŁADNIA

Ogólne składnia
Plik spec powinien zawierać listę deklaracji porządkowych. Ogólna składnia to
Następujące:

porządkowy typ funkcji [Flagi] eksportowa nazwa ( [argumenty...] ) [treser]
porządkowy zmienna [Flagi] eksportowa nazwa ( [dane...] )
porządkowy zewnętrzny [Flagi] eksportowa nazwa [nazwa symbolu]
porządkowy stub [Flagi] eksportowa nazwa [ (argumenty...) ]
porządkowy zrównać [Flagi] eksportowa nazwa dane
# komentarze

Deklaracje muszą mieścić się w jednym wierszu, z wyjątkiem sytuacji, gdy koniec wiersza jest zmieniany za pomocą a
znak ukośnika odwrotnego. ten # znak w dowolnym miejscu wiersza powoduje, że reszta wiersza będzie
ignorowane jako komentarz.

porządkowy określa liczbę porządkową odpowiadającą punktowi wejścia lub „@” dla
automatyczna alokacja porządkowa (tylko Win32).

Flagi to seria opcjonalnych flag, poprzedzonych znakiem „-”. Obsługiwane flagi to:

-norlay
Punkt wejścia nie jest wyświetlany w śladach debugowania przekaźnika (tylko Win32).

-bez nazwy
Punkt wejścia zostanie wyeksportowany według liczby porządkowej zamiast według nazwy. Imię to
nadal dostępne do importu.

-ret16 Funkcja zwraca wartość 16-bitową (tylko Win16).

-ret64 Funkcja zwraca wartość 64-bitową (tylko Win32).

-zarejestrować
Funkcja używa rejestru procesora do przekazywania argumentów.

-prywatny
Funkcja nie może być importowana z innych bibliotek dll, jest dostępna tylko
poprzez GetProcAddress.

-porządkowy
Punkt wejścia zostanie zaimportowany według liczby porządkowej zamiast według nazwy. Imię to
nadal eksportowane.

-łuk=cpu[,cpu]
Punkt wejścia jest dostępny tylko w określonej architekturze procesora. ten
Nazwy win32 i win64 pasuje do wszystkich 32-bitowych lub 64-bitowych architektur procesorów
odpowiednio. W 16-bitowych bibliotekach dll, określanie -arch=win32 powoduje punkt wejścia
do wyeksportowania z 32-bitowego modułu opakowującego.

Funkcjonować liczby porządkowe
Składnia:
porządkowy typ funkcji [Flagi] eksportowa nazwa ( [argumenty...] ) [treser]

Ta deklaracja definiuje punkt wejścia funkcji. Prototyp zdefiniowany przez
eksportowa nazwa ( [argumenty...] ) określa nazwę dostępną do dynamicznego łączenia i format
argumentów. „@” może być użyty zamiast eksportowa nazwa dla eksportu tylko porządkowego.

typ funkcji powinien być jednym z:

standardowe wywołanie
dla normalnej funkcji Win32

Pascal dla normalnej funkcji Win16

cdekl dla funkcji Win16 lub Win32 przy użyciu konwencji wywoływania C

varargs
dla funkcji Win16 lub Win32 przy użyciu konwencji wywoływania C ze zmienną
liczba argumentów

ta rozmowa
dla funkcji Win32 przy użyciu ta rozmowa konwencja wywoływania (pierwszy parametr
w rejestrze %ecx na i386)

args powinno być jednym lub kilkoma z:

słowo (16-bitowa wartość bez znaku)

miecz (16-bitowe słowo ze znakiem)

długie (wartość całkowita wielkości wskaźnika)

intxnumx (64-bitowa wartość całkowita)

intxnumx (128-bitowa wartość całkowita)

unosić się (32-bitowa wartość zmiennoprzecinkowa)

Podwójna (64-bitowa wartość zmiennoprzecinkowa)

PTR (wskaźnik liniowy)

str (liniowy wskaźnik do łańcucha ASCII zakończonego znakiem NULL)

wstr (liniowy wskaźnik do łańcucha Unicode zakończonego znakiem NULL)

segpt (wskaźnik segmentowy)

segstr (segmentowy wskaźnik do łańcucha ASCII zakończonego znakiem NULL).

Uwaga: 16-bitowe i segmentowane typy wskaźników są poprawne tylko dla funkcji Win16.

treser to nazwa rzeczywistej funkcji C, która zaimplementuje ten punkt wejścia w
Tryb 32-bitowy. Program obsługi można również określić jako nazwa dll.funkcjonować zdefiniować przekazane
funkcja (taka, której implementacja znajduje się w innej bibliotece dll). Gdyby treser nie jest określony, to jest
zakłada się, że jest identyczny z nazwa eksportu.

Ten pierwszy przykład definiuje punkt wejścia dla 32-bitowego wywołania GetFocus():

@ stdcall GetFocus() GetFocus

Ten drugi przykład definiuje punkt wejścia dla 16-bitowego wywołania CreateWindow() (liczba porządkowa
100 to tylko przykład); pokazuje również, jak długie linie można podzielić za pomocą odwrotnego ukośnika:

100 paskali CreateWindow(ptr ptr long s_word s_word s_word \
s_word słowo słowo słowo ptr) WIN_CreateWindow

Aby zadeklarować funkcję przy użyciu zmiennej liczby argumentów, określ funkcję jako
varargs i zadeklaruj go w pliku C z parametrem „...” dla funkcji Win32 lub z
dodatkowy argument VA_LIST16 dla funkcji Win16. Zobacz funkcje wsprintf* w
user.exe.spec i user32.spec dla przykładu.

Zmienna liczby porządkowe
Składnia:
porządkowy zmienna [Flagi] eksportowa nazwa ( [dane...] )

Ta deklaracja definiuje przechowywanie danych jako słowa 32-bitowe o określonej liczbie porządkowej.
eksportowa nazwa będzie nazwą dostępną do dynamicznego łączenia. dane może być liczbą dziesiętną
lub numer szesnastkowy poprzedzony „0x”. Poniższy przykład definiuje zmienną VariableA at
liczba porządkowa 2 i zawierająca 4 jednostki:

2 zmienne ZmiennaA(-1 0xff 0 0)

Ta deklaracja działa tylko w plikach specyfikacji Win16. W Win32 powinieneś użyć zewnętrzny zamiast
(Patrz niżej).

Zewnętrzny liczby porządkowe
Składnia:
porządkowy zewnętrzny [Flagi] eksportowa nazwa [nazwa symbolu]

Ta deklaracja definiuje wpis, który po prostu odwzorowuje symbol C (zmienna lub funkcja).
Działa tylko w plikach specyfikacji Win32. eksportowa nazwa wskaże na symbol nazwa symbolu że
musi być zdefiniowany w kodzie C. Alternatywnie może mieć formę nazwa dll.nazwa symbolu do
zdefiniuj przekazany symbol (ten, którego implementacja znajduje się w innej bibliotece dll). Gdyby nazwa symbolu is
nie określono, zakłada się, że jest identyczny z nazwa eksportu.

Kikut liczby porządkowe
Składnia:
porządkowy stub [Flagi] eksportowa nazwa [ (argumenty...) ]

Ta deklaracja definiuje funkcję skrótową. To sprawia, że ​​nazwa i liczba porządkowa są dostępne dla
dynamiczne łączenie, ale zakończy wykonywanie z komunikatem o błędzie, jeśli funkcja jest
kiedykolwiek zadzwonił.

Zrównać liczby porządkowe
Składnia:
porządkowy zrównać [Flagi] eksportowa nazwa dane

Ta deklaracja definiuje liczbę porządkową jako wartość bezwzględną. eksportowa nazwa będzie imię
dostępne do dynamicznego łączenia. dane może być liczbą dziesiętną lub liczbą szesnastkową poprzedzoną przez
„0x”.

AUTORSKI

budowanie wina nad którą pracowało wiele osób na przestrzeni lat. Głównymi autorami są Robert J.
Amstadt, Alexandre Julliard, Martin von Loewis, Ulrich Weigand i Eric Youngdale. Wiele
inni ludzie wnieśli nowe funkcje i poprawki błędów. Aby zobaczyć pełną listę, zobacz git
popełnić dzienniki.

Korzystaj z winebuild online za pomocą usług onworks.net