i686-w64-mingw32-dlltool - Dalam Talian di Awan

JADUAL:

NAMA

dlltool - Buat fail yang diperlukan untuk membina dan menggunakan DLL.

SINOPSIS

dlltool [-d|--input-def def-nama-fail]
[-b|--base-file nama-fail asas]
[-e|--output-exp nama fail eksport]
[-z|--output-def def-nama-fail]
[-l|--output-lib nama fail perpustakaan]
[-y|--output-delaylib nama fail perpustakaan]
[--eksport-semua-simbol] [--tiada-eksport-semua-simbol]
[--kecualikan-simbol senarai]
[--no-default-excludes]
[-S|--sebagai laluan ke pemasang] [-f|--sebagai-bendera pilihan]
[-D|--dllname nama] [-m|--mesin mesin]
[-a|--tambah-tidak langsung]
[-U|--tambah-garis bawah] [--add-stdcall-underscore]
[-k|--bunuh-di] [-A|--add-stdcall-alias]
[-p|--ext-prefix-alias awalan]
[-x|--tiada-idata4] [-c|--tiada-idata5]
[--use-nul-prefixed-import-tables]
[-I|--mengenal pasti nama fail perpustakaan] [--mengenal pasti-ketat]
[-i|--kerjasama]
[-n|--nodelete] [-t|--prefix-temp awalan]
[-v|--verbose]
[-h|- membantu] [-V|--versi]
[--tidak-menterajui-garis bawah] [--memimpin-garis bawah]
[fail objek ...]

DESCRIPTION

dlltool membaca inputnya, yang boleh datang dari -d and -b pilihan serta objek
fail yang ditentukan pada baris arahan. Ia kemudian memproses input ini dan jika -e pilihan
telah ditentukan ia mencipta fail eksport. Sekiranya -l pilihan telah ditentukan itu
mencipta fail perpustakaan dan jika -z pilihan telah ditentukan ia mencipta fail def. mana-mana
atau semua -e, -l and -z pilihan boleh hadir dalam satu permohonan dlltool.

Apabila mencipta DLL, bersama-sama dengan sumber untuk DLL, adalah perlu untuk mempunyai tiga
fail lain. dlltool boleh membantu dengan penciptaan fail ini.

Fail pertama ialah a .def fail yang menentukan fungsi mana yang dieksport daripada DLL,
yang berfungsi import DLL, dan sebagainya. Ini ialah fail teks dan boleh dibuat oleh
tangan, atau dlltool boleh digunakan untuk menciptanya menggunakan -z pilihan. Dalam kes ini dlltool akan
imbas fail objek yang dinyatakan pada baris arahannya mencari fungsi yang ada
telah ditanda khas sebagai dieksport dan meletakkan entri untuk mereka dalam .def failkannya
mencipta.

Untuk menandakan fungsi sebagai dieksport daripada DLL, ia perlu mempunyai
-eksport: masuk dalam .directve bahagian fail objek. Ini boleh jadi
dilakukan dalam C dengan menggunakan asm() pengendali:

asm (".section .drectve");
asm (".ascii \"-export:my_func\"");

int my_func (kosong) { ... }

Fail kedua yang diperlukan untuk penciptaan DLL ialah fail eksport. Fail ini dipautkan dengan
fail objek yang membentuk badan DLL dan ia mengendalikan antara muka antara DLL
dan dunia luar. Ini adalah fail binari dan ia boleh dibuat dengan memberikan -e
pilihan untuk dlltool apabila ia mencipta atau membaca dalam a .def fail.

Fail ketiga yang diperlukan untuk penciptaan DLL ialah fail perpustakaan yang akan dipautkan oleh program
untuk mengakses fungsi dalam DLL (`perpustakaan import'). Fail ini boleh dibuat
dengan memberikan -l pilihan untuk dlltool apabila ia membuat atau membaca dalam a .def fail.

Jika -y pilihan ditentukan, dlltool menjana perpustakaan import kelewatan yang boleh digunakan
bukannya perpustakaan import biasa untuk membenarkan atur cara memaut ke dll hanya sebaik sahaja
fungsi yang diimport dipanggil buat kali pertama. Boleh laku yang terhasil perlu
dipautkan ke perpustakaan delayimp statik yang mengandungi __delayLoadHelper2(), yang seterusnya
akan mengimport LoadLibraryA dan GetProcAddress daripada kernel32.

dlltool membina fail perpustakaan dengan tangan, tetapi ia membina fail eksport dengan mencipta
fail sementara yang mengandungi pernyataan pemasang dan kemudian memasangnya. The -S arahan
pilihan baris boleh digunakan untuk menentukan laluan kepada pemasang yang akan digunakan oleh dlltool, dan
yang -f pilihan boleh digunakan untuk menghantar bendera tertentu kepada pemasang itu. The -n boleh digunakan untuk
menghalang dlltool daripada memadam fail pemasang sementara ini apabila ia selesai, dan jika -n
ditentukan dua kali maka ini akan menghalang dlltool daripada memadam fail objek sementara
ia digunakan untuk membina perpustakaan.

Berikut ialah contoh mencipta DLL daripada fail sumber dll.c dan juga membuat program
(daripada fail objek dipanggil program.o) yang menggunakan DLL itu:

gcc -c dll.c
dlltool -e exports.o -l dll.lib dll.o
gcc dll.o exports.o -o dll.dll
gcc program.o dll.lib -o program

dlltool juga boleh digunakan untuk menanyakan perpustakaan import sedia ada untuk menentukan nama
DLL yang dikaitkan dengannya. Lihat penerangan tentang -I or --mengenal pasti pilihan.

PILIHAN

Pilihan baris arahan mempunyai makna berikut:

-d nama fail
--input-def nama fail
Menentukan nama a .def fail untuk dibaca dan diproses.

-b nama fail
--base-file nama fail
Menentukan nama fail asas untuk dibaca dan diproses. Kandungan ini
fail akan ditambah ke bahagian penempatan semula dalam fail eksport yang dijana oleh dlltool.

-e nama fail
--output-exp nama fail
Menentukan nama fail eksport yang akan dibuat oleh dlltool.

-z nama fail
--output-def nama fail
Menentukan nama .def fail yang akan dibuat oleh dlltool.

-l nama fail
--output-lib nama fail
Menentukan nama fail perpustakaan yang akan dibuat oleh dlltool.

-y nama fail
--output-delaylib nama fail
Menentukan nama fail perpustakaan import-tunda yang akan dibuat oleh dlltool.

--eksport-semua-simbol
Anggap semua simbol takrif global dan lemah yang terdapat dalam fail objek input sebagai simbol
untuk dieksport. Terdapat senarai kecil simbol yang tidak dieksport secara lalai;
melihat --no-default-excludes pilihan. Anda boleh menambah senarai simbol kepada tidak
eksport dengan menggunakan --kecualikan-simbol pilihan.

--tiada-eksport-semua-simbol
Hanya simbol eksport yang disenaraikan secara eksplisit dalam input .def fail atau dalam .directve bahagian dalam
fail objek input. Ini ialah kelakuan lalai. The .directve bahagian adalah
dicipta oleh dllexport atribut dalam kod sumber.

--kecualikan-simbol senarai
Jangan eksport simbol masuk senarai. Ini ialah senarai nama simbol yang dipisahkan dengan koma
atau aksara kolon. Nama simbol tidak boleh mengandungi garis bawah utama. ini
hanya bermakna apabila --eksport-semua-simbol digunakan.

--no-default-excludes
Bila --eksport-semua-simbol digunakan, ia secara lalai akan mengelak daripada mengeksport khas tertentu
simbol. Senarai simbol semasa untuk mengelak daripada mengeksport ialah DllMain@12,
DllEntryPoint@0, najis_ptr. Anda boleh menggunakan --no-default-excludes pilihan untuk diteruskan
dan eksport simbol khas ini. Ini hanya bermakna apabila --eksport-semua-simbol
digunakan.

-S jalan
--sebagai jalan
Menentukan laluan, termasuk nama fail, pemasang yang akan digunakan untuk mencipta
fail eksport.

-f pilihan
--sebagai-bendera pilihan
Menentukan sebarang pilihan baris arahan khusus untuk dihantar kepada pemasang apabila
membina fail eksport. Pilihan ini akan berfungsi walaupun jika -S pilihan tidak digunakan.
Pilihan ini hanya mengambil satu hujah, dan jika ia berlaku lebih daripada sekali pada arahan
baris, maka kejadian kemudian akan mengatasi kejadian terdahulu. Jadi jika perlu
untuk menghantar berbilang pilihan kepada pemasang mereka harus disertakan dalam petikan berganda.

-D nama
--dll-nama nama
Menentukan nama untuk disimpan dalam .def fail sebagai nama DLL apabila fail -e
pilihan digunakan. Jika pilihan ini tidak ada, maka nama fail diberikan kepada -e
pilihan akan digunakan sebagai nama DLL.

-m mesin
-mesin mesin
Menentukan jenis mesin yang mana fail perpustakaan harus dibina. dlltool mempunyai
jenis lalai terbina dalam, bergantung pada cara ia dicipta, tetapi pilihan ini boleh jadi
digunakan untuk mengatasi itu. Ini biasanya hanya berguna apabila mencipta DLL untuk ARM
pemproses, apabila kandungan DLL sebenarnya dikodkan menggunakan arahan Thumb.

-a
--tambah-tidak langsung
Menentukan bahawa apabila dlltool sedang mencipta fail eksport ia harus menambah bahagian yang
membenarkan fungsi yang dieksport dirujuk tanpa menggunakan perpustakaan import.
Apa pun maksudnya!

-U
--tambah-garis bawah
Menentukan bahawa apabila dlltool sedang mencipta fail eksport yang harus disiapkan
menggariskan kepada nama-nama semua simbol yang dieksport.

--tidak-menterajui-garis bawah
--memimpin-garis bawah
Menentukan sama ada simbol standard harus dipaksa untuk diberi awalan atau tidak.

--add-stdcall-underscore
Menentukan bahawa apabila dlltool sedang mencipta fail eksport yang harus disiapkan
menggariskan kepada nama yang dieksport stdcall fungsi. Nama boleh ubah dan bukan stdcall
nama fungsi tidak diubah suai. Pilihan ini berguna apabila mencipta serasi GNU
import libs untuk DLL pihak ketiga yang dibina dengan alat MS-Windows.

-k
--bunuh-di
Menyatakan itu @ akhiran hendaklah diabaikan daripada nama stdcall
fungsi yang akan diimport daripada DLL. Ini berguna apabila membuat import
perpustakaan untuk DLL yang mengeksport fungsi stdcall tetapi tanpa yang biasa @
akhiran nama simbol.

Ini tidak mengubah penamaan simbol yang disediakan oleh perpustakaan import kepada program
dipautkan menentangnya, tetapi hanya entri dalam jadual import (iaitu bahagian .idata).

-A
--add-stdcall-alias
Menentukan bahawa apabila dlltool sedang mencipta fail eksport yang sepatutnya ditambah alias untuknya
simbol stdcall tanpa @ sebagai tambahan kepada simbol dengan @ .

-p
--ext-prefix-alias awalan
Punca dlltool untuk mencipta alias luaran untuk semua import DLL dengan yang ditentukan
awalan. Alias ​​dicipta untuk kedua-dua simbol luaran dan import tanpa pendahuluan
gariskan.

-x
--tiada-idata4
Menentukan bahawa apabila dlltool sedang mencipta fail eksport dan pustaka yang sepatutnya ditinggalkan
bahagian ".idata4". Ini adalah untuk keserasian dengan sistem pengendalian tertentu.

--use-nul-prefixed-import-tables
Menentukan bahawa apabila dlltool sedang mencipta eksport dan fail pustaka yang sepatutnya diawali
".idata4" dan ".idata5" dengan sifar elemen. Ini meniru perpustakaan import gnu lama
generasi "dlltool". Secara lalai pilihan ini dimatikan.

-c
--tiada-idata5
Menentukan bahawa apabila dlltool sedang mencipta fail eksport dan pustaka yang sepatutnya ditinggalkan
bahagian ".idata5". Ini adalah untuk keserasian dengan sistem pengendalian tertentu.

-I nama fail
--mengenal pasti nama fail
Menyatakan itu dlltool hendaklah memeriksa perpustakaan import yang ditunjukkan oleh nama fail and
laporkan, pada "stdout", nama DLL yang berkaitan. Ini boleh dilakukan dalam
tambahan kepada sebarang operasi lain yang ditunjukkan oleh pilihan dan hujah lain.
dlltool gagal jika perpustakaan import tidak wujud atau sebenarnya bukan import
perpustakaan. Lihat juga --mengenal pasti-ketat.

--mengenal pasti-ketat
Mengubah suai tingkah laku --mengenal pasti pilihan, supaya ralat dilaporkan jika
nama fail dikaitkan dengan lebih daripada satu DLL.

-i
--kerjasama
Menyatakan itu dlltool hendaklah menandakan objek dalam fail perpustakaan dan fail eksport
yang dihasilkannya sebagai saling bekerjasama antara ARM dan kod Thumb.

-n
--nodelete
Membuat dlltool simpan fail pemasang sementara yang digunakan untuk mencipta eksport
fail. Jika pilihan ini diulang maka dlltool juga akan mengekalkan objek sementara
fail yang digunakan untuk mencipta fail perpustakaan.

-t awalan
--prefix-temp awalan
Membuat dlltool penggunaan awalan apabila membina nama pemasang dan objek sementara
fail. Secara lalai, awalan fail temp dijana daripada pid.

-v
--verbose
Jadikan dlltool menerangkan apa yang dilakukannya.

-h
- membantu
Memaparkan senarai pilihan baris arahan dan kemudian keluar.

-V
--versi
Memaparkan nombor versi dlltool dan kemudian keluar.

@fail
Baca pilihan baris arahan daripada fail. Pilihan yang dibaca dimasukkan sebagai ganti
asal @fail pilihan. Jika fail tidak wujud, atau tidak boleh dibaca, maka pilihan
akan dilayan secara literal, dan tidak dikeluarkan.

Pilihan dalam fail dipisahkan oleh ruang putih. Aksara ruang putih mungkin disertakan
dalam pilihan dengan mengelilingi keseluruhan pilihan dalam petikan tunggal atau berganda. mana-mana
aksara (termasuk garis miring ke belakang) boleh disertakan dengan memberi awalan kepada aksara menjadi
disertakan dengan garis miring ke belakang. The fail mungkin sendiri mengandungi tambahan @fail pilihan; mana-mana
pilihan tersebut akan diproses secara rekursif.

Gunakan i686-w64-mingw32-dlltool dalam talian menggunakan perkhidmatan onworks.net