winebuild-development - Dalam talian di Awan

JADUAL:

NAMA

winebuild - pembina dll wain

SINOPSIS

winebuild [pilihan] [fail input...]

DESCRIPTION

winebuild menjana fail pemasangan yang diperlukan untuk membina dll Wine, iaitu
pada asasnya Win32 dll terkandung di dalam perpustakaan Unix.

winebuild mempunyai mod yang berbeza, bergantung pada jenis fail yang diminta untuk dijana. The
mod ditentukan oleh salah satu daripada pilihan mod yang dinyatakan di bawah. Sebagai tambahan kepada mod
pilihan, pelbagai pilihan baris perintah lain boleh ditentukan, seperti yang diterangkan dalam PILIHAN
bawah seksyen ini.

MODE PILIHAN

Anda perlu menentukan betul-betul salah satu daripada pilihan berikut, bergantung pada perkara yang anda mahukan
winebuild untuk menjana.

--dll Bina fail pemasangan daripada fail .spec (lihat SPEC FAIL SISTEM untuk butiran), atau
daripada fail .def Windows standard. Fail .spec/.def ditentukan melalui -E
pilihan. Fail yang dihasilkan mesti dipasang dan dipautkan ke fail objek lain
untuk membina dll Wine yang berfungsi. Dalam mod ini, input fail sepatutnya menjadi senarai
semua fail objek yang akan dipautkan ke dll akhir, untuk membenarkan winebuild untuk mendapatkan
senarai semua simbol yang tidak ditentukan yang perlu diimport daripada dll lain.

--exe Bina fail pemasangan untuk boleh laku. Ini pada asasnya sama dengan --dll
mod kecuali ia tidak memerlukan fail .spec/.def sebagai input, kerana boleh laku
tidak memerlukan fungsi eksport. Sesetengah boleh laku walau bagaimanapun melakukan fungsi eksport, dan untuk
fail .spec/.def tersebut boleh ditentukan melalui -E pilihan. Yang boleh laku dinamakan
daripada nama fail .spec/.def jika ada, atau secara eksplisit melalui -F pilihan. The
fail yang terhasil mesti dipasang dan dipautkan ke fail objek lain untuk membina a
working Wine boleh laku, dan semua fail objek lain mesti disenaraikan sebagai input
fail.

--def Bina fail .def daripada fail spec. Fail .spec ditentukan melalui -E pilihan.
Ini digunakan apabila membina dll dengan pengkompil PE (Win32).

--implib
Bina perpustakaan import PE daripada fail spec. Fail .spec ditentukan melalui -E
pilihan.

--sumber
Hasilkan fail .o yang mengandungi semua sumber input. Ini berguna semasa membina
dengan pengkompil PE, kerana binutil PE tidak boleh mengendalikan berbilang fail sumber sebagai
input. Untuk binaan Unix standard, fail sumber disertakan secara automatik
apabila membina fail spec, jadi tidak ada keperluan untuk fail .o perantaraan.

PILIHAN

--sebagai-cmd=sebagai-perintah
Tentukan arahan untuk digunakan untuk menyusun fail pemasangan; lalainya ialah as.

-b, --sasaran=pengilang cpu[-kernel]-os
Tentukan CPU dan platform sasaran yang kod yang dihasilkan akan dibina. The
spesifikasi sasaran adalah dalam format autoconf standard seperti yang dikembalikan oleh config.sub.

--cc-cmd=cc-perintah
Tentukan pengkompil C untuk digunakan untuk menyusun fail pemasangan; lalainya ialah sebaliknya
gunakan pemasang yang ditentukan dengan --sebagai-cmd.

-d, --delay-lib=nama
Tetapkan mod import tertunda untuk pustaka yang ditentukan, yang mestilah salah satu daripada
perpustakaan yang diimport dengan -l pilihan. Mod tertunda bermakna perpustakaan tidak akan menjadi
dimuatkan sehingga fungsi yang diimport daripadanya sebenarnya dipanggil.

-D lambang
Diabaikan kerana keserasian dengan pengkompil C.

-e, --masuk=fungsi
Nyatakan fungsi titik masuk modul; jika tidak dinyatakan, lalainya ialah DllMain
untuk dll, dan utama untuk boleh laku (jika standard C utama tidak ditakrifkan, WinMain
digunakan sebaliknya). Ini hanya sah untuk modul Win32.

-E, --eksport=nama fail
Tentukan fail .spec (lihat SPEC FAIL SISTEM untuk butiran), atau Windows standard .def
fail yang mentakrifkan eksport DLL atau boleh laku yang sedang dibina.

--simbol-luaran
Benarkan pemautan kepada simbol luaran terus daripada fail spesifikasi. Biasanya simbol
yang dieksport oleh dll perlu ditakrifkan dalam dll itu sendiri; pilihan ini menjadikannya
mungkin untuk menggunakan simbol yang ditakrifkan dalam perpustakaan Unix lain (untuk simbol yang ditakrifkan dalam
dll lain, a ke hadapan spesifikasi mesti digunakan sebaliknya).

-f pilihan
Tentukan pilihan penjanaan kod. Pada masa ini -fPIC and -fasynchronous-unwind-tables
disokong. Pilihan lain diabaikan untuk keserasian dengan pengkompil C.

--modul-palsu
Cipta modul PE palsu untuk dll atau exe, bukannya pemasangan atau objek biasa
fail. Modul PE mengandungi sumber untuk modul, tetapi tiada kod boleh laku.

-F, --nama fail=nama fail
Tetapkan nama fail modul. Lalai ialah menggunakan nama asas spec
fail (tanpa sambungan).

-h, - membantu
Paparkan mesej penggunaan dan keluar.

-H, --timbunan=saiz
Nyatakan saiz timbunan tempatan modul dalam bait (hanya sah untuk modul Win16);
lalai ialah tiada timbunan tempatan.

-I direktori
Diabaikan kerana keserasian dengan pengkompil C.

-k, --bunuh-di
Alih keluar hiasan stdcall daripada nama simbol dalam fail .def yang dijana.
Hanya bermakna dalam --def mod.

-K bendera
Diabaikan kerana keserasian dengan pengkompil C.

--alamat-besar-sedar
Tetapkan bendera dalam boleh laku untuk memberitahu pemuat bahawa aplikasi ini menyokong
alamat ruang yang lebih besar daripada 2 gigabait.

--ld-cmd=ld-command
Tentukan arahan untuk digunakan untuk memautkan fail objek; lalainya ialah ld.

-L, --library-path=direktori
Tambahkan direktori yang ditentukan pada senarai direktori yang dicari
import perpustakaan.

-l, --perpustakaan=nama
Import perpustakaan yang ditentukan, cari yang sepadan libname.def fail dalam
direktori yang ditentukan dengan -L pilihan.

-m16, -m32, -m64
Hasilkan kod 16-bit, 32-bit atau 64-bit masing-masing.

-marm, -ibu jari, -march=pilihan, -mcpu=pilihan
Tetapkan pilihan penjanaan kod untuk pemasang.

-M, --modul-utama=modul
Apabila membina dll 16-bit, tetapkan nama rakan 32-bitnya kepada modul. ini
digunakan untuk menguatkuasakan bahawa susunan muat untuk dll 16-bit sepadan dengan pesanan
32-bit satu.

-N, --dll-name=nama dll
Tetapkan nama dalaman modul. Ia hanya digunakan dalam modul Win16. lalai
ialah menggunakan nama asas fail spec (tanpa sambungan). Ini digunakan untuk
KERNEL, kerana ia tinggal di KRNL386.EXE. Ia tidak sepatutnya diperlukan sebaliknya.

--nm-cmd=arahan nm
Tentukan arahan untuk digunakan untuk mendapatkan senarai simbol yang tidak ditentukan; lalainya ialah nm.

--nxcompat=yes|tidak
Tentukan sama ada modul itu serasi dengan sokongan tanpa eksekutif. Lalainya ialah ya.

-o, --output=fail
Tetapkan nama fail output (lalai ialah output standard). Jika fail output
nama berakhir dengan .o, output teks dihantar ke fail sementara yang kemudiannya dipasang
untuk menghasilkan fail .o yang ditentukan.

-r, --res=rsrc.res
Muatkan sumber daripada fail sumber binari yang ditentukan. The rsrc.res fail boleh
dihasilkan daripada fail sumber sumber dengan wrc(1) (atau dengan sumber Windows
penyusun).
Pilihan ini hanya diperlukan untuk fail sumber Win16, yang Win32 boleh
disenaraikan sebagai input fail dan secara automatik akan dikendalikan dengan betul (walaupun -r
pilihan juga akan berfungsi untuk fail Win32).

--jimat-temps
Jangan padamkan pelbagai fail sementara yang winebuild menjana.

--subsistem=subsistem[:utama[.kecil]]
Tetapkan subsistem boleh laku, yang boleh menjadi salah satu daripada yang berikut:
konsul untuk baris arahan boleh laku,
tingkap untuk boleh laksana grafik,
asli untuk dll mod asli,
tersentak untuk ce dll.
Titik masuk baris perintah boleh laku ialah C biasa utama fungsi. A wmain
fungsi boleh digunakan sebaliknya jika anda memerlukan tatasusunan hujah untuk menggunakan rentetan Unicode.
Boleh laku grafik mempunyai a WinMain jalan masuk.
Secara pilihan, versi subsistem utama dan kecil juga boleh ditentukan; lalai
versi subsistem ialah 4.0.

-u, --undefined=lambang
Tambah lambang kepada senarai simbol yang tidak ditentukan apabila menggunakan pemaut. Ini menjadikannya
mungkin untuk memaksa modul tertentu perpustakaan statik dimasukkan apabila
menyelesaikan import.

-v, --verbose
Paparkan pelbagai subperintah yang digunakan oleh winebuild.

--versi
Paparkan versi program dan keluar.

-w, --amaran
Hidupkan amaran.

SPEC FAIL SISTEM

Umum sintaks
Fail spec harus mengandungi senarai pengisytiharan ordinal. Sintaks umum ialah
Berikut:

ordinal functype [bendera] nama eksport ( [args...] ) [pengendali]
ordinal berubah-ubah [bendera] nama eksport ( [data ...] )
ordinal luar [bendera] nama eksport [nama simbol]
ordinal puntung [bendera] nama eksport [ (args...) ]
ordinal sama [bendera] nama eksport data
# comments

Pengisytiharan mesti dimuatkan pada satu baris, kecuali jika hujung baris terlepas menggunakan a
watak sengkang terbalik. The # aksara di mana-mana dalam satu baris menyebabkan seluruh baris itu menjadi
diabaikan sebagai komen.

ordinal menentukan nombor ordinal yang sepadan dengan titik masuk, atau '@' untuk
peruntukan ordinal automatik (Win32 sahaja).

bendera ialah satu siri bendera pilihan, didahului oleh aksara '-'. Bendera yang disokong ialah:

-norelay
Titik masuk tidak dipaparkan dalam jejak debugging geganti (Win32 sahaja).

-tiada nama
Titik masuk akan dieksport melalui ordinal dan bukannya dengan nama. Namanya ialah
masih ada untuk diimport.

-ret16 Fungsi ini mengembalikan nilai 16-bit (Win16 sahaja).

-ret64 Fungsi ini mengembalikan nilai 64-bit (Win32 sahaja).

-daftar
Fungsi ini menggunakan daftar CPU untuk menghantar hujah.

-peribadi
Fungsi ini tidak boleh diimport dari dll lain, ia hanya boleh diakses
melalui GetProcAddress.

-ordinal
Titik masuk akan diimport melalui ordinal dan bukannya dengan nama. Namanya ialah
masih dieksport.

-lengkungan=cpu[,cpu]
Titik masuk hanya tersedia pada seni bina CPU yang ditentukan. The
nama win32 and win64 sepadan dengan semua seni bina CPU 32-bit atau 64-bit
masing-masing. Dalam dll 16-bit, menentukan -arch=win32 menyebabkan titik masuk
untuk dieksport daripada modul pembalut 32-bit.

fungsi ordinal
sintaks:
ordinal functype [bendera] nama eksport ( [args...] ) [pengendali]

Pengisytiharan ini mentakrifkan titik masuk fungsi. Prototaip yang ditakrifkan oleh
nama eksport ( [args...] ) menentukan nama yang tersedia untuk pemautan dinamik dan format
daripada hujah-hujah tersebut. '@' boleh digunakan sebagai ganti nama eksport untuk eksport ordinal sahaja.

functype hendaklah salah satu daripada:

stdcall
untuk fungsi Win32 biasa

paschal untuk fungsi Win16 biasa

cdecl untuk fungsi Win16 atau Win32 menggunakan konvensyen panggilan C

varargs
untuk fungsi Win16 atau Win32 menggunakan konvensyen panggilan C dengan pembolehubah
bilangan hujah

panggilan ini
untuk fungsi Win32 menggunakan panggilan ini konvensyen panggilan (parameter pertama
dalam %ecx daftar pada i386)

args hendaklah satu atau beberapa daripada:

perkataan (16-bit nilai tidak ditandatangani)

s_word (perkataan bertandatangan 16-bit)

lama (nilai integer bersaiz penunjuk)

int64 (nilai integer 64-bit)

int128 (nilai integer 128-bit)

terapung (nilai titik terapung 32-bit)

dua kali ganda (nilai titik terapung 64-bit)

ptr (penunjuk linear)

str (penunjuk linear kepada rentetan ASCII yang ditamatkan nol)

wstr (penunjuk linear kepada rentetan Unicode yang ditamatkan batal)

segptr (penunjuk bersegmen)

segstr (penuding terbahagi kepada rentetan ASCII yang ditamatkan nol).

Nota: Jenis penunjuk 16-bit dan bersegmen hanya sah untuk fungsi Win16.

pengendali ialah nama fungsi C sebenar yang akan melaksanakan titik masuk itu
Mod 32-bit. Pengendali juga boleh dinyatakan sebagai nama dll.fungsi untuk mentakrifkan yang dimajukan
fungsi (satu yang pelaksanaannya dalam dll lain). Jika pengendali tidak dinyatakan, ia adalah
diandaikan sama dengan nama eksport.

Contoh pertama ini mentakrifkan titik masuk untuk panggilan GetFocus() 32-bit:

@ stdcall GetFocus() GetFocus

Contoh kedua ini mentakrifkan titik masuk untuk panggilan CreateWindow() 16-bit (ordinal
100 hanyalah satu contoh); ia juga menunjukkan berapa panjang garisan boleh dipisahkan menggunakan garis miring ke belakang:

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

Untuk mengisytiharkan fungsi menggunakan bilangan argumen yang berubah-ubah, nyatakan fungsi sebagai
varargs dan isytiharkannya dalam fail C dengan parameter '...' untuk fungsi Win32, atau dengan
hujah VA_LIST16 tambahan untuk fungsi Win16. Lihat fungsi wsprintf* dalam
user.exe.spec dan user32.spec sebagai contoh.

Pembolehubah ordinal
sintaks:
ordinal berubah-ubah [bendera] nama eksport ( [data ...] )

Pengisytiharan ini mentakrifkan storan data sebagai perkataan 32-bit pada ordinal yang ditentukan.
nama eksport akan menjadi nama yang tersedia untuk pemautan dinamik. data boleh menjadi nombor perpuluhan
atau nombor heks yang didahului dengan "0x". Contoh berikut mentakrifkan pembolehubah VariableA at
ordinal 2 dan mengandungi 4 int:

2 pembolehubah PembolehubahA(-1 0xff 0 0)

Pengisytiharan ini hanya berfungsi dalam fail spec Win16. Dalam Win32 anda harus gunakan luar sebaliknya
(lihat di bawah).

luar ordinal
sintaks:
ordinal luar [bendera] nama eksport [nama simbol]

Pengisytiharan ini mentakrifkan entri yang hanya memetakan kepada simbol C (pembolehubah atau fungsi).
Ia hanya berfungsi dalam fail spec Win32. nama eksport akan menunjuk kepada simbol nama simbol Bahawa
mesti ditakrifkan dalam kod C. Sebagai alternatif, ia boleh dalam bentuk nama dll.nama simbol kepada
tentukan simbol yang dimajukan (satu yang pelaksanaannya dalam dll lain). Jika nama simbol is
tidak dinyatakan, ia diandaikan sama dengan nama eksport.

puntung ordinal
sintaks:
ordinal puntung [bendera] nama eksport [ (args...) ]

Pengisytiharan ini mentakrifkan fungsi rintisan. Ia menjadikan nama dan ordinal tersedia untuk
pemautan dinamik, tetapi akan menamatkan pelaksanaan dengan mesej ralat jika fungsi itu
pernah menelefon.

Menyamakan ordinal
sintaks:
ordinal sama [bendera] nama eksport data

Pengisytiharan ini mentakrifkan ordinal sebagai nilai mutlak. nama eksport akan menjadi nama
tersedia untuk pautan dinamik. data boleh menjadi nombor perpuluhan atau nombor heks yang didahului oleh
"0x".

PENGARANG

winebuild telah diusahakan oleh ramai orang selama ini. Penulis utama ialah Robert J.
Amstadt, Alexandre Julliard, Martin von Loewis, Ulrich Weigand dan Eric Youngdale. banyak
orang lain telah menyumbangkan ciri baharu dan pembetulan pepijat. Untuk senarai lengkap, lihat git
melakukan log.

Gunakan winebuild-development dalam talian menggunakan perkhidmatan onworks.net