i686-linux-gnu-ld - Dalam Talian di Awan

JADUAL:

NAMA

ld - Penyambung GNU

SINOPSIS

ld [pilihan] objfile ...

DESCRIPTION

ld menggabungkan beberapa objek dan fail arkib, menempatkan semula data mereka
dan mengikat rujukan simbol. Biasanya langkah terakhir dalam menyusun a
program adalah untuk dijalankan ld.

ld menerima fail Bahasa Perintah Penghubung yang ditulis dalam superset daripada
Sintaks Bahasa Perintah Editor Pautan AT&T, untuk menyediakan eksplisit dan
kawalan penuh ke atas proses penghubung.

Halaman manusia ini tidak menerangkan bahasa arahan; lihat ld kemasukan
dalam "info" untuk butiran penuh tentang bahasa arahan dan aspek lain
daripada penyambung GNU.

Versi ld menggunakan perpustakaan BFD tujuan umum untuk beroperasi
fail objek. Ini membenarkan ld untuk membaca, menggabungkan dan menulis fail objek
dalam pelbagai format---contohnya, COFF atau "a.out". Berbeza
format boleh dipautkan bersama untuk menghasilkan apa-apa jenis objek yang tersedia
fail.

Selain daripada fleksibilitinya, penyambung GNU lebih membantu daripada yang lain
penghubung dalam menyediakan maklumat diagnostik. Ramai penghubung yang meninggalkan
pelaksanaan serta-merta apabila menghadapi ralat; bila-bila boleh, ld
terus melaksanakan, membolehkan anda mengenal pasti ralat lain (atau, dalam beberapa
kes, untuk mendapatkan fail output walaupun terdapat ralat).

Penyambung GNU ld bertujuan untuk meliputi pelbagai situasi, dan untuk
serasi mungkin dengan penyambung lain. Akibatnya, anda telah
banyak pilihan untuk mengawal tingkah lakunya.

PILIHAN

Penyambung menyokong banyak pilihan baris arahan, tetapi sebenarnya
mengamalkan beberapa daripadanya digunakan dalam mana-mana konteks tertentu. Sebagai contoh,
penggunaan yang kerap ld adalah untuk memautkan fail objek Unix standard pada a
standard, sistem Unix yang disokong. Pada sistem sedemikian, untuk memautkan fail
"hello.o":

ld -o /lib/crt0.o hello.o -lc

Ini memberitahu ld untuk menghasilkan fail yang dipanggil output sebagai hasil daripada menghubungkan
fail "/lib/crt0.o" dengan "hello.o" dan pustaka "libc.a", yang
akan datang daripada direktori carian standard. (Lihat perbincangan tentang
yang -l pilihan di bawah.)

Beberapa pilihan baris arahan untuk ld boleh dinyatakan pada bila-bila masa
baris arahan. Walau bagaimanapun, pilihan yang merujuk kepada fail, seperti -l or
-T, menyebabkan fail dibaca pada titik di mana pilihan muncul
dalam baris arahan, berbanding dengan fail objek dan fail lain
pilihan. Mengulangi pilihan bukan fail dengan hujah yang berbeza akan
sama ada tidak mempunyai kesan selanjutnya, atau mengatasi kejadian sebelumnya (yang
lebih jauh ke kiri pada baris arahan) pilihan itu. Pilihan yang
boleh dinyatakan secara bermakna lebih daripada sekali dicatatkan dalam
penerangan di bawah.

Argumen bukan pilihan ialah fail objek atau arkib yang akan
dihubungkan bersama. Mereka mungkin mengikuti, mendahului, atau bercampur dengan
pilihan baris arahan, kecuali argumen fail objek mungkin tidak
diletakkan di antara pilihan dan hujahnya.

Biasanya penyambung dipanggil dengan sekurang-kurangnya satu fail objek, tetapi anda
boleh menentukan bentuk lain fail input binari menggunakan -l, -R, Dan
bahasa arahan skrip. Jika tidak fail input binari sama sekali adalah
ditentukan, penghubung tidak menghasilkan sebarang output, dan mengeluarkan
mesej Tidak input fail.

Jika pemaut tidak dapat mengenali format fail objek, ia akan
menganggap bahawa ia adalah skrip penghubung. Skrip dinyatakan dengan cara ini
menambah skrip pemaut utama yang digunakan untuk pautan (sama ada fail lalai
skrip penghubung atau yang ditentukan dengan menggunakan -T). Ciri ini membenarkan
penyambung untuk memaut dengan fail yang kelihatan seperti objek atau
arkib, tetapi sebenarnya hanya mentakrifkan beberapa nilai simbol, atau kegunaan
"INPUT" atau "GROUP" untuk memuatkan objek lain. Menentukan skrip dalam ini
cara hanya menambah skrip penghubung utama, dengan arahan tambahan
diletakkan selepas skrip utama; menggunakan -T pilihan untuk menggantikan lalai
skrip pemaut sepenuhnya, tetapi perhatikan kesan arahan "INSERT".

Untuk pilihan yang namanya satu huruf, hujah pilihan mesti
sama ada ikut huruf pilihan tanpa campur tangan ruang putih, atau jadi
diberikan sebagai hujah berasingan serta-merta berikutan pilihan itu
memerlukan mereka.

Untuk pilihan yang namanya berbilang huruf, sama ada satu sempang atau dua
boleh mendahului nama pilihan; sebagai contoh, -simbol-simbol and
--simbol-simbol adalah setara. Perhatikan --- terdapat satu pengecualian untuk ini
peraturan. Pilihan berbilang huruf yang bermula dengan huruf kecil 'o' boleh
hanya didahului oleh dua sengkang. Ini adalah untuk mengurangkan kekeliruan dengan
-o pilihan. Jadi sebagai contoh -omagic menetapkan nama fail output kepada sihir
sedangkan --omagic menetapkan bendera NMAGIC pada output.

Hujah kepada pilihan berbilang huruf mesti sama ada dipisahkan daripada
nama pilihan dengan tanda sama, atau diberikan sebagai hujah yang berasingan
serta-merta mengikut pilihan yang memerlukannya. Sebagai contoh,
--simbol-simbol foo and --trace-symbol=foo adalah setara. Unik
singkatan nama pilihan berbilang huruf diterima.

Nota---jika pemaut sedang dipanggil secara tidak langsung, melalui pemacu pengkompil
(contohnya gcc) maka semua pilihan baris arahan pemaut harus diawali
by -Wl, (atau apa sahaja yang sesuai untuk pemacu pengkompil tertentu)
seperti ini:

gcc -Wl,--start-group foo.o bar.o -Wl,--end-group

Ini penting, kerana jika tidak, program pemacu pengkompil mungkin
lepaskan pilihan pemaut secara senyap, mengakibatkan pautan yang buruk. Kekeliruan
mungkin juga timbul apabila lulus pilihan yang memerlukan nilai melalui a
pemandu, kerana penggunaan ruang antara pilihan dan hujah bertindak sebagai a
pemisah, dan menyebabkan pemandu hanya memberikan pilihan kepada pemaut
dan hujah kepada penyusun. Dalam kes ini, ia adalah paling mudah untuk digunakan
bentuk gabungan kedua-dua pilihan satu dan berbilang huruf, seperti:

gcc foo.o bar.o -Wl,-eENTRY -Wl,-Map=a.map

Berikut ialah jadual suis baris arahan generik yang diterima oleh
Penyambung GNU:

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

Pilihan dalam fail dipisahkan oleh ruang putih. Ruang putih
watak boleh dimasukkan dalam pilihan dengan mengelilingi keseluruhannya
pilihan sama ada dalam petikan tunggal atau berganda. Mana-mana watak (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; sebarang pilihan sedemikian akan diproses secara rekursif.

-a kata kunci
Pilihan ini disokong untuk keserasian HP/UX. The kata kunci
hujah mesti menjadi salah satu rentetan arkib, dikongsi, Atau lalai.
-arkib berfungsi sama dengan -Bstatik, dan dua yang lain
kata kunci secara fungsinya setara dengan -Bdinamik. Pilihan ini mungkin
digunakan beberapa kali.

--audit AUDITLIB
Tambah AUDITLIB ke entri "DT_AUDIT" bahagian dinamik.
AUDITLIB tidak disemak untuk kewujudan, ia juga tidak akan menggunakan
DT_SONAME dinyatakan dalam pustaka. Jika dinyatakan beberapa kali
"DT_AUDIT" akan mengandungi senarai antara muka audit yang diasingkan bertindih
untuk menggunakan. Jika pemaut menjumpai objek dengan entri audit sambil
mencari perpustakaan kongsi, ia akan menambah yang sepadan
Entri "DT_DEPAUDIT" dalam fail output. Pilihan ini hanya
bermakna pada platform ELF yang menyokong antara muka rtld-audit.

-A seni bina
--seni bina=seni bina
Dalam keluaran semasa ld, pilihan ini hanya berguna untuk
Keluarga seni bina Intel 960. Dalam itu ld konfigurasi, yang
seni bina hujah mengenal pasti seni bina tertentu dalam
960, membolehkan beberapa perlindungan dan mengubah suai arkib-
laluan carian perpustakaan.

Keluaran masa depan bagi ld mungkin menyokong fungsi yang serupa untuk yang lain
keluarga seni bina.

-b format input
--format=format input
ld boleh dikonfigurasikan untuk menyokong lebih daripada satu jenis fail objek.
Jika anda ld dikonfigurasikan dengan cara ini, anda boleh menggunakan -b pilihan untuk
tentukan format binari untuk fail objek input yang mengikuti ini
pilihan pada baris arahan. Walaupun ketika ld dikonfigurasikan untuk menyokong
format objek alternatif, anda biasanya tidak perlu menentukan ini,
as ld harus dikonfigurasikan untuk mengharapkan sebagai format input lalai
format yang paling biasa pada setiap mesin. format input ialah rentetan teks,
nama format tertentu yang disokong oleh perpustakaan BFD.
(Anda boleh menyenaraikan format binari yang tersedia dengan objdump -i.)

Anda mungkin mahu menggunakan pilihan ini jika anda memautkan fail dengan fail
format binari yang luar biasa. Anda juga boleh menggunakan -b untuk menukar format
secara eksplisit (apabila memautkan fail objek daripada format yang berbeza), oleh
termasuk -b format input sebelum setiap kumpulan fail objek dalam a
format tertentu.

Format lalai diambil daripada pembolehubah persekitaran
"GNUTARGET".

Anda juga boleh menentukan format input daripada skrip, menggunakan
arahan "SASARAN";

-c Fail arahan MRI
--mri-skrip=Fail arahan MRI
Untuk keserasian dengan penghubung yang dihasilkan oleh MRI, ld menerima skrip
fail yang ditulis dalam bahasa arahan alternatif yang terhad,
diterangkan dalam bahagian Fail Skrip Serasi MRI GNU ld
dokumentasi. Memperkenalkan fail skrip MRI dengan pilihan -c; menggunakan
yang -T pilihan untuk menjalankan skrip penghubung yang ditulis dalam tujuan umum
ld bahasa skrip. Jika MRI-cmdfile tidak wujud, ld mencari
ia dalam direktori yang ditentukan oleh mana-mana -L pilihan.

-d
-dc
-dp Tiga pilihan ini adalah setara; berbilang borang disokong
untuk keserasian dengan penghubung lain. Mereka memberikan ruang kepada umum
simbol walaupun jika fail output yang boleh dipindahkan ditentukan (dengan -r).
Arahan skrip "FORCE_COMMON_ALLOCATION" mempunyai kesan yang sama.

--depaudit AUDITLIB
-P AUDITLIB
Tambah AUDITLIB ke entri "DT_DEPAUDIT" bahagian dinamik.
AUDITLIB tidak disemak untuk kewujudan, ia juga tidak akan menggunakan
DT_SONAME dinyatakan dalam pustaka. Jika dinyatakan beberapa kali
"DT_DEPAUDIT" akan mengandungi senarai audit yang diasingkan bertindih
antara muka untuk digunakan. Pilihan ini hanya bermakna pada platform ELF
menyokong antara muka rtld-audit. Pilihan -P disediakan untuk
Keserasian Solaris.

-e kemasukan
--masuk=kemasukan
Penggunaan kemasukan sebagai simbol eksplisit untuk memulakan pelaksanaan anda
program, bukannya titik masuk lalai. Jika tiada
simbol bernama kemasukan, pemaut akan cuba menghuraikan kemasukan sebagai nombor,
dan gunakan itu sebagai alamat kemasukan (nombor itu akan ditafsirkan
dalam asas 10; anda boleh menggunakan peneraju 0x untuk asas 16, atau peneraju 0
untuk asas 8).

--exclude-libs lib,lib, ...
Menentukan senarai pustaka arkib daripada simbol yang tidak sepatutnya
dieksport secara automatik. Nama perpustakaan mungkin dihadkan oleh
koma atau titik bertindih. Menentukan "--exclude-libs ALL" tidak termasuk simbol
dalam semua perpustakaan arkib daripada eksport automatik. Pilihan ini adalah
tersedia hanya untuk port sasaran i386 PE bagi pemaut dan untuk
Pelabuhan sasaran ELF. Untuk i386 PE, simbol disenaraikan secara eksplisit dalam a
Fail .def masih dieksport, tanpa mengira pilihan ini. Untuk ELF
port yang disasarkan, simbol yang terjejas oleh pilihan ini akan dianggap sebagai
tersembunyi.

--exclude-modules-for-implib modul,modul, ...
Menentukan senarai fail objek atau ahli arkib, dari mana
simbol tidak seharusnya dieksport secara automatik, tetapi yang sepatutnya
disalin secara borong ke dalam perpustakaan import yang dijana semasa
pautan. Nama modul mungkin dibataskan dengan koma atau titik bertindih, dan
mesti sepadan dengan betul-betul nama fail yang digunakan oleh ld untuk membuka fail; untuk
ahli arkib, ini hanyalah nama ahli, tetapi untuk objek
fail nama yang disenaraikan mesti termasuk dan sepadan dengan tepat mana-mana laluan
digunakan untuk menentukan fail input pada baris arahan pemaut. ini
pilihan tersedia hanya untuk port sasaran i386 PE bagi
penghubung. Simbol yang disenaraikan secara eksplisit dalam fail .def masih ada
dieksport, tanpa mengira pilihan ini.

-E
--eksport-dinamik
--tiada-eksport-dinamik
Apabila mencipta boleh laku yang dipautkan secara dinamik, menggunakan -E pilihan
atau --eksport-dinamik pilihan menyebabkan pemaut menambah semua simbol
ke jadual simbol dinamik. Jadual simbol dinamik ialah set
simbol yang boleh dilihat daripada objek dinamik pada masa larian.

Jika anda tidak menggunakan salah satu daripada pilihan ini (atau gunakan
--tiada-eksport-dinamik pilihan untuk memulihkan tingkah laku lalai), the
jadual simbol dinamik biasanya hanya mengandungi simbol-simbol yang
dirujuk oleh beberapa objek dinamik yang disebut dalam pautan.

Jika anda menggunakan "dlopen" untuk memuatkan objek dinamik yang perlu dirujuk
kembali kepada simbol yang ditakrifkan oleh atur cara, bukannya simbol lain
objek dinamik, maka anda mungkin perlu menggunakan pilihan ini apabila
menghubungkan program itu sendiri.

Anda juga boleh menggunakan senarai dinamik untuk mengawal simbol yang sepatutnya
ditambahkan pada jadual simbol dinamik jika format output menyokongnya.
Lihat penerangan tentang --senarai-dinamik.

Ambil perhatian bahawa pilihan ini khusus untuk port disasarkan ELF. PE
sasaran menyokong fungsi yang serupa untuk mengeksport semua simbol daripada DLL
atau EXE; lihat penerangan tentang --eksport-semua-simbol di bawah.

-EB Pautkan objek besar-endian. Ini menjejaskan format output lalai.

-THE Pautkan objek little-endian. Ini menjejaskan output lalai
format.

-f nama
--bantu =nama
Apabila mencipta objek kongsi ELF, tetapkan DT_AUXILIARY dalaman
medan kepada nama yang ditentukan. Ini memberitahu pemaut dinamik itu
jadual simbol objek kongsi hendaklah digunakan sebagai
penapis tambahan pada jadual simbol objek kongsi nama.

Jika anda kemudiannya memautkan atur cara terhadap objek penapis ini, maka, bila
anda menjalankan program, pemaut dinamik akan melihat DT_AUXILIARY
padang. Jika pemaut dinamik menyelesaikan sebarang simbol daripada penapis
objek, ia akan terlebih dahulu menyemak sama ada terdapat definisi dalam
objek kongsi nama. Jika ada, ia akan digunakan sebagai ganti
definisi dalam objek penapis. Objek yang dikongsi nama perlu
tidak wujud. Oleh itu objek yang dikongsi nama boleh digunakan untuk menyediakan
pelaksanaan alternatif fungsi tertentu, mungkin untuk
penyahpepijatan atau untuk prestasi khusus mesin.

Pilihan ini boleh ditentukan lebih daripada sekali. DT_AUXILIARY
entri akan dibuat mengikut tertib yang ia muncul pada
baris perintah.

-F nama
--penapis=nama
Apabila mencipta objek kongsi ELF, tetapkan DT_FILTER dalaman
medan kepada nama yang ditentukan. Ini memberitahu pemaut dinamik itu
jadual simbol objek kongsi yang sedang dibuat harus
digunakan sebagai penapis pada jadual simbol objek kongsi nama.

Jika anda kemudiannya memautkan atur cara terhadap objek penapis ini, maka, bila
anda menjalankan program, pemaut dinamik akan melihat DT_FILTER
padang. Penyambung dinamik akan menyelesaikan simbol mengikut
jadual simbol objek penapis seperti biasa, tetapi sebenarnya
pautan kepada definisi yang terdapat dalam objek kongsi nama. Oleh itu,
objek penapis boleh digunakan untuk memilih subset simbol
disediakan oleh objek nama.

Beberapa pemaut lama menggunakan -F pilihan sepanjang kompilasi
rantai alat untuk menentukan format fail objek untuk kedua-dua input dan
fail objek output. Penyambung GNU menggunakan mekanisme lain untuk ini
tujuan: yang -b, --format, --oformat pilihan, arahan "SASARAN".
dalam skrip pemaut, dan pembolehubah persekitaran "GNUTARGET". The
Penyambung GNU akan mengabaikan -F pilihan apabila tidak mencipta ELF
objek kongsi.

-fini=nama
Apabila mencipta objek boleh laku atau kongsi ELF, panggil NAME apabila
objek boleh laku atau kongsi dipunggah, dengan menetapkan DT_FINI kepada
alamat fungsi. Secara lalai, pemaut menggunakan "_fini"
sebagai fungsi untuk memanggil.

-g tidak diendahkan. Disediakan untuk keserasian dengan alat lain.

-G nilai
--gpsize=nilai
Tetapkan saiz maksimum objek untuk dioptimumkan menggunakan GP
daftar ke saiz. Ini hanya bermakna untuk format fail objek
seperti MIPS ELF yang menyokong meletakkan objek besar dan kecil ke dalam
bahagian yang berbeza. Ini diabaikan untuk format fail objek lain.

-h nama
-sonname=nama
Apabila mencipta objek kongsi ELF, tetapkan DT_SONAME dalaman
medan kepada nama yang ditentukan. Apabila boleh laku dipautkan dengan a
objek kongsi yang mempunyai medan DT_SONAME, kemudian apabila boleh laku
sedang dijalankan, pemaut dinamik akan cuba memuatkan objek kongsi
ditentukan oleh medan DT_SONAME dan bukannya menggunakan fail
nama yang diberikan kepada penghubung.

-i Lakukan pautan tambahan (sama seperti pilihan -r).

-init=nama
Apabila mencipta objek boleh laku atau kongsi ELF, panggil NAME apabila
objek boleh laku atau dikongsi dimuatkan, dengan menetapkan DT_INIT kepada
alamat fungsi. Secara lalai, pemaut menggunakan "_init"
sebagai fungsi untuk memanggil.

-l spesifikasi nama
--perpustakaan=spesifikasi nama
Tambahkan arkib atau fail objek yang ditentukan oleh spesifikasi nama kepada senarai
fail untuk dipautkan. Pilihan ini boleh digunakan beberapa kali. Jika
spesifikasi nama adalah dalam bentuk :nama fail, ld akan mencari laluan perpustakaan
untuk fail yang dipanggil nama fail, jika tidak ia akan mencari perpustakaan
laluan untuk fail yang dipanggil libnamespec.a.

Pada sistem yang menyokong perpustakaan kongsi, ld juga boleh mencari
fail selain daripada libnamespec.a. Khususnya, pada ELF dan SunOS
sistem, ld akan mencari direktori untuk perpustakaan yang dipanggil
libnamespec.so sebelum mencari yang dipanggil libnamespec.a. (Oleh
konvensyen, sambungan ".so" menunjukkan perpustakaan kongsi.) Nota
bahawa tingkah laku ini tidak terpakai :nama fail, yang selalu
menentukan fail yang dipanggil nama fail.

Pemaut akan mencari arkib sekali sahaja, di lokasi di mana
ia dinyatakan pada baris arahan. Jika arkib mentakrifkan a
simbol yang tidak ditentukan dalam beberapa objek yang muncul sebelum
arkib pada baris arahan, pemaut akan menyertakan
fail yang sesuai daripada arkib. Walau bagaimanapun, simbol yang tidak ditentukan
dalam objek yang muncul kemudian pada baris arahan tidak akan menyebabkan
pemaut untuk mencari semula arkib.

Melihat -( pilihan untuk cara memaksa pemaut mencari arkib
berkali-kali.

Anda boleh menyenaraikan arkib yang sama beberapa kali pada baris arahan.

Jenis carian arkib ini adalah standard untuk pemaut Unix.
Walau bagaimanapun, jika anda menggunakannya ld pada AIX, ambil perhatian bahawa ia berbeza daripada
tingkah laku penyambung AIX.

-L searchdir
--library-path=searchdir
Tambah laluan searchdir kepada senarai laluan yang ld akan mencari
arkib perpustakaan dan ld skrip kawalan. Anda boleh menggunakan pilihan ini
berapa kali pun. Direktori dicari mengikut susunan dalam
yang dinyatakan pada baris arahan. Direktori
yang ditentukan pada baris arahan dicari sebelum lalai
direktori. Semua -L pilihan terpakai kepada semua -l pilihan, tanpa mengira
susunan pilihan muncul. -L pilihan tidak menjejaskan
bagaimana ld mencari skrip pemaut melainkan -T pilihan ditentukan.

If searchdir bermula dengan "=", kemudian "=" akan digantikan dengan
sysroot awalan, dikendalikan oleh --sysroot pilihan, atau ditentukan
apabila pemaut dikonfigurasikan.

Set lalai laluan yang dicari (tanpa dinyatakan dengan -L)
bergantung pada mod emulasi yang mana ld sedang menggunakan, dan dalam beberapa kes juga
tentang cara ia dikonfigurasikan.

Laluan juga boleh ditentukan dalam skrip pautan dengan
Perintah "SEARCH_DIR". Direktori yang dinyatakan dengan cara ini dicari
pada titik di mana skrip pemaut muncul dalam arahan
line.

-m emulasi
Mencontohi emulasi penghubung. Anda boleh menyenaraikan yang ada
emulasi dengan --verbose or -V pilihan.

Jika -m pilihan tidak digunakan, emulasi diambil daripada
Pembolehubah persekitaran "LDEMULASI", jika itu ditakrifkan.

Jika tidak, emulasi lalai bergantung pada cara pemaut itu
dikonfigurasikan.

-M
--cetak-peta
Cetak peta pautan ke output standard. Peta pautan menyediakan
maklumat tentang pautan, termasuk yang berikut:

· Di mana fail objek dipetakan ke dalam ingatan.

· Bagaimana simbol biasa diperuntukkan.

· Semua ahli arkib disertakan dalam pautan, dengan sebutan tentang
simbol yang menyebabkan ahli arkib dibawa masuk.

· Nilai yang diberikan kepada simbol.

Nota - simbol yang nilainya dikira dengan ungkapan yang
melibatkan rujukan kepada nilai sebelumnya bagi simbol yang sama boleh
tidak mempunyai hasil yang betul dipaparkan dalam peta pautan. Ini adalah
kerana penghubung membuang hasil perantaraan dan sahaja
mengekalkan nilai akhir ungkapan. Di bawah sebegitu
keadaan pemaut akan memaparkan nilai akhir yang disertakan
dengan kurungan segi empat sama. Oleh itu sebagai contoh skrip penghubung
mengandungi:

foo = 1
foo = foo * 4
foo = foo + 8

akan menghasilkan output berikut dalam peta pautan jika -M
pilihan digunakan:

0x00000001 foo = 0x1
[0x0000000c] foo = (foo * 0x4)
[0x0000000c] foo = (foo + 0x8)

Lihat Ungkapan untuk maklumat lanjut tentang ungkapan dalam
skrip penghubung.

-n
--nmagik
Matikan penjajaran halaman bahagian dan lumpuhkan pemautan terhadap
perpustakaan kongsi. Jika format output menyokong sihir gaya Unix
nombor, tandakan output sebagai "NMAGIC".

-N
--omagic
Tetapkan bahagian teks dan data supaya boleh dibaca dan ditulis. Juga,
jangan selaraskan halaman segmen data dan lumpuhkan pemautan terhadapnya
perpustakaan kongsi. Jika format output menyokong sihir gaya Unix
nombor, tandakan output sebagai "OMAGIC". Nota: Walaupun boleh ditulis
bahagian teks dibenarkan untuk sasaran PE-COFF, ia tidak mematuhi
spesifikasi format yang diterbitkan oleh Microsoft.

--no-omagic
Pilihan ini menafikan kebanyakan kesan daripada -N pilihan. Ia menetapkan
bahagian teks menjadi baca sahaja dan memaksa segmen data menjadi
sejajar halaman. Nota - pilihan ini tidak mendayakan pemautan terhadap
perpustakaan kongsi. guna -Bdinamik untuk ini.

-o output
--output=output
Penggunaan output sebagai nama program yang dihasilkan oleh ld; jika ini
pilihan tidak dinyatakan, nama a. keluar digunakan secara lalai. The
arahan skrip "OUTPUT" juga boleh menentukan nama fail output.

-O tahap
If tahap ialah nilai berangka yang lebih besar daripada sifar ld mengoptimumkan
pengeluaran. Ini mungkin mengambil masa yang lebih lama dan oleh itu
mungkin hanya perlu didayakan untuk binari akhir. Dekat
seketika pilihan ini hanya menjejaskan penjanaan perpustakaan kongsi ELF.
Keluaran masa depan pemaut boleh menggunakan lebih banyak pilihan ini.
Juga pada masa ini tiada perbezaan dalam tingkah laku penghubung untuk
nilai bukan sifar yang berbeza bagi pilihan ini. Sekali lagi ini mungkin berubah
dengan keluaran akan datang.

--keadaan tolak
. --keadaan tolak membolehkan untuk mengekalkan keadaan semasa bendera
yang mengawal pengendalian fail input supaya mereka semua boleh
dipulihkan dengan satu yang sepadan --pop-state pilihan.

Pilihan yang dilindungi adalah: -Bdinamik, -Bstatik, -dn, -dy,
-call_shared, -non_shared, -statik, -N, -n, --keseluruhan-arkib,
--tiada-keseluruhan-arkib, -r, -Ur, --copy-dt-needed-entry,
--no-copy-dt-needed-entry, --seperti yang diperlukan, --tidak-seperti-perlu, dan -a.

Satu sasaran untuk pilihan ini ialah spesifikasi untuk pkg-konfigurasi. Apabila
digunakan dengan --libs pilihan semua perpustakaan yang mungkin diperlukan adalah
disenaraikan dan kemudian mungkin dipautkan dengan sepanjang masa. Adalah lebih baik untuk
kembalikan sesuatu seperti berikut:

-Wl,--tekan-keadaan,--sebagaimana-diperlukan -libone -libtwo -Wl,--pop-keadaan

Membuat asal kesan --push-state, memulihkan nilai sebelumnya bagi
bendera yang mengawal pengendalian fail input.

-q
--memancarkan-relok
Tinggalkan bahagian penempatan semula dan kandungan dalam boleh laku yang dipautkan sepenuhnya.
Alat analisis pautan dan pengoptimuman siaran mungkin memerlukan maklumat ini
untuk melakukan pengubahsuaian yang betul bagi boleh laku. ini
menghasilkan laksana yang lebih besar.

Pilihan ini pada masa ini hanya disokong pada platform ELF.

--daya-dinamik
Paksa fail output mempunyai bahagian dinamik. Pilihan ini adalah
khusus untuk sasaran VxWorks.

-r
--boleh dipindahkan
Hasilkan keluaran yang boleh dipindahkan---iaitu, hasilkan fail output yang
boleh pula berfungsi sebagai input kepada ld. Ini sering dipanggil separa
menghubungkan. Sebagai kesan sampingan, dalam persekitaran yang menyokong standard
Nombor ajaib Unix, pilihan ini juga menetapkan keajaiban fail output
nombor kepada "OMAGIC". Jika pilihan ini tidak dinyatakan, pilihan mutlak
fail dihasilkan. Apabila memautkan program C++, pilihan ini akan tidak
menyelesaikan rujukan kepada pembina; untuk melakukan itu, gunakan -Ur.

Apabila fail input tidak mempunyai format yang sama dengan output
fail, pemautan separa hanya disokong jika fail input itu tidak
mengandungi sebarang penempatan semula. Format output yang berbeza boleh mempunyai lebih lanjut
sekatan; contohnya beberapa format berasaskan "a.out" tidak menyokong
memaut separa dengan fail input dalam format lain sama sekali.

Pilihan ini melakukan perkara yang sama seperti -i.

-R nama fail
--just-simbol=nama fail
Baca nama simbol dan alamatnya dari nama fail, tetapi jangan
letak semula atau masukkannya dalam output. Ini membolehkan output anda
fail untuk merujuk secara simbolik kepada lokasi mutlak memori yang ditakrifkan
dalam program lain. Anda boleh menggunakan pilihan ini lebih daripada sekali.

Untuk keserasian dengan penyambung ELF lain, jika -R pilihan adalah
diikuti dengan nama direktori, bukannya nama fail, ia adalah
diperlakukan sebagai -rath pilihan.

-s
--strip-semua
Abaikan semua maklumat simbol daripada fail output.

-S
--strip-debug
Abaikan maklumat simbol penyahpepijat (tetapi bukan semua simbol) daripada
fail keluaran.

-t
--jejak
Cetak nama fail input sebagai ld memproses mereka.

-T fail skrip
--skrip=fail skrip
Penggunaan fail skrip sebagai skrip penghubung. Skrip ini menggantikan ld's
skrip pemaut lalai (bukan menambah padanya), jadi fail perintah
mesti menentukan semua yang diperlukan untuk menerangkan fail output.
If fail skrip tidak wujud dalam direktori semasa, "ld" kelihatan
untuknya dalam direktori yang ditentukan oleh mana-mana sebelumnya -L pilihan.
Pelbagai -T pilihan terkumpul.

-dT fail skrip
--default-script=fail skrip
Penggunaan fail skrip sebagai skrip pemaut lalai.

Pilihan ini serupa dengan --skrip pilihan kecuali itu
pemprosesan skrip ditangguhkan sehingga selepas selebihnya
baris arahan telah diproses. Ini membolehkan pilihan diletakkan selepas
yang --default-script pilihan pada baris arahan untuk mempengaruhi
tingkah laku skrip pemaut, yang boleh menjadi penting apabila
baris arahan penghubung tidak boleh dikawal secara langsung oleh pengguna. (cth
kerana baris arahan sedang dibina oleh alat lain, seperti
as gcc).

-u lambang
--undefined=lambang
Memaksa lambang untuk dimasukkan ke dalam fail output sebagai undefined
simbol. Melakukan ini boleh, sebagai contoh, mencetuskan pemautan tambahan
modul daripada perpustakaan standard. -u boleh diulang dengan berbeza
argumen pilihan untuk memasukkan simbol tambahan yang tidak ditentukan. ini
pilihan adalah bersamaan dengan arahan skrip pemaut "EXTERN".

Jika pilihan ini digunakan untuk memaksa modul tambahan menjadi
ditarik ke dalam pautan, dan jika ia adalah ralat untuk simbol itu
kekal tidak ditentukan, maka pilihan --require-defined sepatutnya digunakan
sebaliknya.

--require-defined=lambang
Memerlukan itu lambang ditakrifkan dalam fail output. Pilihan ini adalah
sama seperti pilihan --tidak ditentukan kecuali jika lambang tidak ditakrifkan
dalam fail output maka penghubung akan mengeluarkan ralat dan keluar.
Kesan yang sama boleh dicapai dalam skrip penghubung dengan menggunakan
"EXTERN", "ASSERT" dan "DEFINED" bersama-sama. Pilihan ini boleh digunakan
beberapa kali untuk memerlukan simbol tambahan.

-Ur Untuk apa-apa selain program C++, pilihan ini bersamaan dengan
-r: ia menjana output boleh dipindahkan---iaitu, fail output yang boleh
seterusnya berfungsi sebagai input kepada ld. Apabila memautkan program C++, -Ur tidak
menyelesaikan rujukan kepada pembina, tidak seperti -r. Ia tidak berfungsi untuk
penggunaan -Ur pada fail yang dipautkan sendiri -Ur; sekali
jadual pembina telah dibina, ia tidak boleh ditambah. guna -Ur
hanya untuk pautan separa terakhir, dan -r untuk yang lain.

--pengendalian anak yatim=MODE
Kawal cara bahagian anak yatim dikendalikan. Bahagian anak yatim adalah satu
tidak disebut secara khusus dalam skrip penghubung.

MODE boleh mempunyai mana-mana nilai berikut:

"tempat"
Bahagian anak yatim diletakkan ke bahagian keluaran yang sesuai
mengikut strategi yang diterangkan dalam Anak yatim seksyen. Yang
pilihan --unik juga mempengaruhi cara bahagian diletakkan.

"buang"
Semua bahagian anak yatim dibuang, dengan meletakkannya di dalam
/BUANG/ bawah seksyen ini.

"beri amaran"
Penghubung akan meletakkan bahagian yatim seperti untuk "tempat" dan
juga mengeluarkan amaran.

"kesilapan"
Penyambung akan keluar dengan ralat jika ada bahagian yatim
dijumpai.

Lalai jika --pengendalian anak yatim tidak diberikan adalah "tempat".

--unik[=BAHAGIAN]
Mencipta bahagian output yang berasingan untuk setiap pemadanan bahagian input
BAHAGIAN, atau jika kad bebas pilihan BAHAGIAN hujah hilang,
untuk setiap bahagian input anak yatim. Bahagian anak yatim adalah yang tidak
dinyatakan secara khusus dalam skrip penghubung. Anda boleh menggunakan pilihan ini
beberapa kali pada baris arahan; Ia menghalang penggabungan biasa
bahagian input dengan nama yang sama, mengatasi bahagian output
tugasan dalam skrip penghubung.

-v
--versi
-V Paparkan nombor versi untuk ld. Yang -V pilihan juga menyenaraikan
emulasi yang disokong.

-x
--buang-semua
Padam semua simbol tempatan.

-X
--buang-orang tempatan
Padamkan semua simbol tempatan sementara. (Simbol ini bermula dengan
awalan label tempatan khusus sistem, biasanya .L untuk sistem ELF
or L untuk sistem a.out tradisional.)

-y lambang
--simbol-simbol=lambang
Cetak nama setiap fail yang dipautkan lambang muncul. ini
pilihan boleh diberikan beberapa kali. Pada banyak sistem ia adalah
perlu untuk menyediakan garis bawah.

Pilihan ini berguna apabila anda mempunyai simbol yang tidak ditentukan dalam anda
pautan tetapi tidak tahu dari mana rujukan itu datang.

-Y jalan
Tambah jalan ke laluan carian perpustakaan lalai. Pilihan ini wujud
untuk keserasian Solaris.

-z kata kunci
Kata kunci yang diiktiraf ialah:

combreloc
Menggabungkan berbilang bahagian reloc dan mengisihnya untuk menjadikannya dinamik
simbol carian caching mungkin.

kekurangan
Tidak membenarkan simbol yang tidak ditentukan dalam fail objek. Simbol yang tidak ditentukan
di perpustakaan kongsi masih dibenarkan.

execstack
Menandai objek sebagai memerlukan tindanan boleh laku.

global
Pilihan ini hanya bermakna apabila membina objek kongsi.
Ia menjadikan simbol yang ditakrifkan oleh objek kongsi ini tersedia
untuk resolusi simbol perpustakaan yang dimuatkan kemudiannya.

initfirst
Pilihan ini hanya bermakna apabila membina objek kongsi.
Ia menandakan objek supaya permulaan masa jalannya akan
berlaku sebelum permulaan masa jalan mana-mana objek lain
dibawa ke dalam proses pada masa yang sama. Begitu juga dengan
pemuktamadkan masa jalan objek akan berlaku selepas masa jalan
memuktamadkan mana-mana objek lain.

interpose
Menandai objek yang jadual simbolnya bersilang sebelum semua
simbol tetapi boleh laku utama.

malas
Apabila menjana pustaka boleh laku atau kongsi, tandainya kepada
beritahu pemaut dinamik untuk menangguhkan resolusi panggilan fungsi
titik apabila fungsi dipanggil (lazy binding), sebaliknya
daripada pada masa muat. Lazy binding adalah lalai.

loadfltr
Menandai objek yang penapisnya diproses serta-merta
masa berjalan.

muldef
Membolehkan pelbagai definisi.

nocombreloc
Melumpuhkan gabungan berbilang bahagian reloc.

nocopyreloc
Lumpuhkan pembolehubah .dynbss yang dijana pemaut yang digunakan sebagai ganti
pembolehubah yang ditakrifkan dalam perpustakaan kongsi. Boleh mengakibatkan dinamik
penempatan semula teks.

nodefaultlib
Menandai objek yang mencari kebergantungan ini
objek akan mengabaikan mana-mana laluan carian perpustakaan lalai.

nodelete
Menandai objek tidak boleh dipunggah pada masa jalan.

nodlopen
Menandai objek tidak tersedia untuk "dlopen".

nodump
Menandai objek tidak boleh dibuang oleh "dldump".

noexecstack
Menandai objek sebagai tidak memerlukan tindanan boleh laku.

teks
Anggap DT_TEXTREL dalam objek kongsi sebagai ralat.

notext
Jangan anggap DT_TEXTREL dalam objek kongsi sebagai ralat.

textoff
Jangan anggap DT_TEXTREL dalam objek kongsi sebagai ralat.

norelro
Jangan buat pengepala segmen "PT_GNU_RELRO" ELF dalam
objek.

kini Apabila menjana pustaka boleh laku atau kongsi, tandainya kepada
beritahu pemaut dinamik untuk menyelesaikan semua simbol apabila atur cara
dimulakan, atau apabila pustaka kongsi dipautkan kepada penggunaan
dlopen, bukannya menangguhkan resolusi panggilan fungsi ke
titik apabila fungsi pertama kali dipanggil.

asal
Menandakan objek mungkin mengandungi $ORIGIN.

relro
Buat pengepala segmen "PT_GNU_RELRO" ELF dalam objek.

maks-saiz-halaman=nilai
Tetapkan saiz halaman maksimum emulasi kepada nilai.

saiz-halaman biasa=nilai
Tetapkan saiz halaman biasa emulasi kepada nilai.

saiz tindanan=nilai
Tentukan saiz tindanan untuk dalam segmen "PT_GNU_STACK" ELF.
Menentukan sifar akan mengatasi mana-mana saiz lalai bukan sifar
Penciptaan segmen "PT_GNU_STACK".

bndplt
Sentiasa jana awalan BND dalam entri PLT. Disokong untuk
Linux/x86_64.

noextern-protected-data
Jangan anggap simbol data yang dilindungi sebagai luaran semasa membina
perpustakaan kongsi. Pilihan ini mengatasi lalai hujung belakang pemaut.
Ia boleh digunakan untuk menyelesaikan penempatan semula yang salah terhadap
simbol data dilindungi yang dihasilkan oleh pengkompil. Kemas kini pada
simbol data yang dilindungi oleh modul lain tidak kelihatan kepada
perpustakaan kongsi yang terhasil. Disokong untuk i386 dan x86-64.

call-nop=prefix-addr
call-nop=prefix-nop
panggil-nop=akhiran-nop
call-nop=prefix-bait
call-nop=akhiran-bait
Tentukan pelapik "NOP" 1-bait apabila menukar secara tidak langsung
panggil ke fungsi yang ditakrifkan secara tempatan, foo, melalui slot GOTnya.
call-nop=prefix-addr menjana "0x67 call foo".
call-nop=prefix-nop menjana "0x90 call foo".
panggil-nop=akhiran-nop menjana "panggilan foo 0x90".
call-nop=prefix-bait menjana "bait memanggil foo".
call-nop=akhiran-bait menjana "panggilan foo bait". Disokong untuk
i386 dan x86_64.

Kata kunci lain diabaikan untuk keserasian Solaris.

-( arkib -)
- memulakan kumpulan arkib - kumpulan akhir
. arkib mestilah senarai fail arkib. Mereka mungkin sama ada
nama fail eksplisit, atau -l pilihan.

Arkib yang ditentukan dicari berulang kali sehingga tiada yang baharu
rujukan yang tidak ditentukan dibuat. Biasanya, arkib dicari
hanya sekali dalam susunan yang dinyatakan pada baris arahan.
Jika simbol dalam arkib itu diperlukan untuk menyelesaikan masalah yang tidak ditentukan
simbol yang dirujuk oleh objek dalam arkib yang muncul kemudian
baris arahan, pemaut tidak akan dapat menyelesaikannya
rujukan. Dengan mengumpulkan arkib, semuanya akan dicari
berulang kali sehingga semua rujukan yang mungkin diselesaikan.

Menggunakan pilihan ini mempunyai kos prestasi yang ketara. Memang terbaik
untuk menggunakannya hanya apabila terdapat rujukan pekeliling yang tidak dapat dielakkan
antara dua atau lebih arkib.

--accept-unknown-input-arch
--no-accept-unknown-input-arch
Memberitahu pemaut untuk menerima fail input yang seni binanya tidak boleh
dikenali. Andaian adalah bahawa pengguna tahu apa yang mereka
melakukan dan sengaja mahu memautkan fail input yang tidak diketahui ini.
Ini ialah tingkah laku lalai pemaut, sebelum keluaran 2.14.
Tingkah laku lalai dari keluaran 2.14 dan seterusnya ialah menolak sedemikian
fail input, dan sebagainya --accept-unknown-input-arch pilihan telah
ditambah untuk memulihkan tingkah laku lama.

--seperti yang diperlukan
--tidak-seperti-perlu
Pilihan ini mempengaruhi teg ELF DT_NEEDED untuk perpustakaan dinamik
disebut pada baris arahan selepas --seperti yang diperlukan pilihan.
Biasanya penyambung akan menambah teg DT_NEEDED untuk setiap dinamik
perpustakaan yang disebut pada baris arahan, tidak kira sama ada
perpustakaan sebenarnya diperlukan atau tidak. --seperti yang diperlukan menyebabkan DT_NEEDED
tag untuk hanya dipancarkan untuk perpustakaan yang at Bahawa titik in yang pautan
memenuhi rujukan simbol tidak ditakrifkan bukan lemah daripada biasa
fail objek atau, jika perpustakaan tidak ditemui dalam senarai DT_NEEDED
daripada perpustakaan lain yang diperlukan, rujukan simbol tidak ditakrifkan yang tidak lemah
daripada perpustakaan dinamik lain yang diperlukan. Fail objek atau perpustakaan
muncul pada baris arahan selepas perpustakaan berkenaan tidak
mempengaruhi sama ada perpustakaan dilihat sebagai diperlukan. Ini serupa dengan
peraturan untuk pengekstrakan fail objek daripada arkib.
--tidak-seperti-perlu memulihkan kelakuan lalai.

--tambah-diperlukan
--tidak-tambah-diperlukan
Kedua-dua pilihan ini telah ditamatkan kerana persamaan
nama mereka kepada --seperti yang diperlukan and --tidak-seperti-perlu pilihan. mereka
telah digantikan oleh --copy-dt-needed-entry and
--no-copy-dt-needed-entry.

-tegaskan kata kunci
Pilihan ini diabaikan untuk keserasian SunOS.

-Bdinamik
-dy
-call_shared
Pautan terhadap perpustakaan dinamik. Ini hanya bermakna pada
platform yang mana perpustakaan kongsi disokong. Pilihan ini adalah
biasanya lalai pada platform tersebut. Varian yang berbeza daripada
pilihan ini adalah untuk keserasian dengan pelbagai sistem. Anda boleh
gunakan pilihan ini beberapa kali pada baris arahan: ia mempengaruhi
perpustakaan mencari -l pilihan yang mengikutinya.

-Bgroup
Tetapkan bendera "DF_1_GROUP" dalam entri "DT_FLAGS_1" dalam dinamik
bahagian. Ini menyebabkan pemaut masa jalan mengendalikan carian dalam perkara ini
objek dan kebergantungannya untuk dilakukan hanya di dalam kumpulan.
--unresolved-symbols=laporkan-semua tersirat. Pilihan ini hanya
bermakna pada platform ELF yang menyokong perpustakaan kongsi.

-Bstatik
-dn
-non_shared
-statik
Jangan paut ke perpustakaan kongsi. Ini hanya bermakna pada
platform yang mana perpustakaan kongsi disokong. Perbezaan
varian pilihan ini adalah untuk keserasian dengan pelbagai sistem.
Anda boleh menggunakan pilihan ini beberapa kali pada baris arahan: ia
menjejaskan pencarian perpustakaan -l pilihan yang mengikutinya. ini
pilihan juga membayangkan --unresolved-symbols=laporkan-semua. Pilihan ini
boleh digunakan dengan -berkongsi. Melakukannya bermakna perpustakaan kongsi adalah
dicipta tetapi semua rujukan luar perpustakaan
mesti diselesaikan dengan menarik masuk daripada perpustakaan statik.

-Simbolik
Apabila membuat perpustakaan kongsi, ikat rujukan kepada simbol global
kepada definisi dalam perpustakaan kongsi, jika ada. Biasanya, ia
adalah mungkin untuk program yang dipautkan dengan perpustakaan kongsi ke
mengatasi definisi dalam pustaka kongsi. Pilihan ini boleh
juga digunakan dengan --eksport-dinamik pilihan, apabila mencipta a
kedudukan bebas boleh laku, untuk mengikat rujukan kepada global
simbol kepada definisi dalam boleh laku. Pilihan ini adalah
hanya bermakna pada platform ELF yang menyokong perpustakaan kongsi dan
kedudukan boleh laku bebas.

-Fungsi simbolik
Apabila membuat perpustakaan kongsi, ikat rujukan kepada fungsi global
simbol kepada definisi dalam perpustakaan kongsi, jika ada. ini
pilihan juga boleh digunakan dengan --eksport-dinamik pilihan, bila
mewujudkan kedudukan boleh laku bebas, untuk mengikat rujukan kepada
simbol fungsi global kepada definisi dalam boleh laku.
Pilihan ini hanya bermakna pada platform ELF yang menyokong
perpustakaan kongsi dan letakkan executable bebas.

--dynamic-list=fail senarai dinamik
Tentukan nama fail senarai dinamik kepada pemaut. Ini adalah
biasanya digunakan semasa membuat perpustakaan kongsi untuk menentukan senarai
simbol global yang rujukannya tidak harus terikat pada
definisi dalam pustaka kongsi, atau mencipta secara dinamik
boleh laku dipautkan untuk menentukan senarai simbol yang sepatutnya
ditambahkan pada jadual simbol dalam boleh laku. Pilihan ini hanya
bermakna pada platform ELF yang menyokong perpustakaan kongsi.

Format senarai dinamik adalah sama dengan nod versi
tanpa skop dan nama nod. Lihat VERSION untuk maklumat lanjut.

--dynamic-list-data
Sertakan semua simbol data global ke senarai dinamik.

--dynamic-list-cpp-new
Sediakan senarai dinamik terbina dalam untuk operator C++ baharu dan padam.
Ia amat berguna untuk membina libstdc++ yang dikongsi.

--dynamic-list-cpp-typeinfo
Sediakan senarai dinamik terbina dalam untuk jenis masa jalan C++
pengenalan.

--semak-bahagian
--tiada-semak-bahagian
Tanya penghubung tidak untuk menyemak alamat bahagian selepas mereka telah
ditugaskan untuk melihat jika terdapat sebarang pertindihan. Biasanya penghubung
akan melakukan semakan ini, dan jika ia mendapati sebarang pertindihan ia akan melakukannya
menghasilkan mesej ralat yang sesuai. Penghubung memang tahu tentang, dan
memang membuat elaun untuk bahagian dalam tindanan. lalai
tingkah laku boleh dipulihkan dengan menggunakan suis baris arahan
--semak-bahagian. Pertindihan bahagian biasanya tidak diperiksa
pautan yang boleh dipindahkan. Anda boleh menyemak paksa dalam kes itu dengan menggunakan
yang --semak-bahagian pilihan.

--copy-dt-needed-entry
--no-copy-dt-needed-entry
Pilihan ini memberi kesan kepada rawatan perpustakaan dinamik yang dirujuk
oleh DT_NEEDED tag di dalam Perpustakaan dinamik ELF disebutkan pada
baris arahan. Biasanya penyambung tidak akan menambah teg DT_NEEDED pada
binari keluaran untuk setiap perpustakaan yang disebut dalam teg DT_NEEDED dalam
input perpustakaan dinamik. Dengan --copy-dt-needed-entry dinyatakan pada
baris arahan walau bagaimanapun mana-mana perpustakaan dinamik yang mengikutinya akan
tambahkan entri DT_NEEDED mereka. Tingkah laku lalai boleh
dipulihkan dengan --no-copy-dt-needed-entry.

Pilihan ini juga mempunyai kesan pada resolusi simbol dalam
perpustakaan dinamik. Dengan --copy-dt-needed-entry perpustakaan dinamik
yang disebut pada baris arahan akan dicari secara rekursif,
mengikuti teg DT_NEEDED mereka ke perpustakaan lain, untuk
menyelesaikan simbol yang diperlukan oleh binari output. Dengan lalai
tetapan bagaimanapun mencari perpustakaan dinamik yang mengikutinya
akan berhenti dengan perpustakaan dinamik itu sendiri. Tiada pautan DT_NEEDED akan
dilalui untuk menyelesaikan simbol.

--cref
Keluarkan jadual rujukan silang. Jika fail peta pemaut sedang
dijana, jadual rujukan silang dicetak ke fail peta.
Jika tidak, ia dicetak pada output standard.

Format jadual sengaja mudah, supaya ia mungkin
mudah diproses oleh skrip jika perlu. Simbol dicetak
keluar, diisih mengikut nama. Untuk setiap simbol, senarai nama fail adalah
diberi. Jika simbol ditakrifkan, fail pertama yang disenaraikan ialah
lokasi definisi. Jika simbol itu ditakrifkan sebagai biasa
nilai maka mana-mana fail di mana ini berlaku akan muncul seterusnya. Akhirnya ada
fail yang merujuk simbol disenaraikan.

--no-define-common
Pilihan ini menghalang penyerahan alamat kepada simbol biasa.
Arahan skrip "INHIBIT_COMMON_ALLOCATION" mempunyai kesan yang sama.

. --no-define-common pilihan membolehkan penyahgandingan keputusan untuk
berikan alamat kepada simbol Biasa daripada pilihan output
jenis fail; sebaliknya jenis keluaran yang tidak boleh dipindahkan memaksa menetapkan
alamat kepada simbol biasa. menggunakan --no-define-common membolehkan
Simbol biasa yang dirujuk daripada pustaka kongsi menjadi
alamat yang diberikan hanya dalam program utama. Ini menghapuskan
ruang pendua yang tidak digunakan dalam perpustakaan kongsi, dan juga menghalang sebarang
kemungkinan kekeliruan untuk menyelesaikan kepada pendua yang salah apabila ada
adalah banyak modul dinamik dengan laluan carian khusus untuk masa jalan
resolusi simbol.

--defsym=lambang=ungkapan
Cipta simbol global dalam fail output, yang mengandungi nilai mutlak
alamat yang diberikan oleh ungkapan. Anda boleh menggunakan pilihan ini seberapa banyak kali
yang diperlukan untuk menentukan berbilang simbol dalam baris arahan. A
bentuk aritmetik terhad disokong untuk ungkapan dalam hal ini
konteks: anda boleh memberikan pemalar heksadesimal atau nama an
simbol sedia ada, atau gunakan "+" dan "-" untuk menambah atau menolak perenambelasan
pemalar atau simbol. Jika anda memerlukan ungkapan yang lebih terperinci,
pertimbangkan untuk menggunakan bahasa arahan penghubung daripada skrip. Catatan:
tidak sepatutnya ada ruang kosong di antara lambang, tanda sama
("="), dan ungkapan.

--demangle[=gaya]
--tiada-demangle
Pilihan ini mengawal sama ada untuk menyahkan nama simbol dalam kesilapan
mesej dan output lain. Apabila penghubung disuruh demangle, ia
cuba mempersembahkan nama simbol dengan cara yang boleh dibaca: ia meleraikan
garis bawah terkemuka jika ia digunakan oleh format fail objek, dan
menukarkan nama simbol yang hancur C++ menjadi nama yang boleh dibaca pengguna.
Penyusun yang berbeza mempunyai gaya yang berbeza. Pilihan
hujah gaya demangling boleh digunakan untuk memilih yang sesuai
gaya demangling untuk pengkompil anda. Penghubung akan demangle oleh
lalai melainkan pembolehubah persekitaran COLLECT_NO_DEMANGLE ditetapkan.
Pilihan ini boleh digunakan untuk mengatasi lalai.

-Ifail
--dynamic-linker=fail
Tetapkan nama pemaut dinamik. Ini hanya bermakna apabila
menjana boleh laku ELF yang dipautkan secara dinamik. Dinamik lalai
penghubung biasanya betul; jangan gunakan ini melainkan anda tahu apa yang anda
sedang melakukan.

--tiada-dinamik-penyambung
Apabila menghasilkan fail boleh laku, tinggalkan permintaan untuk dinamik
penghubung untuk digunakan pada masa muat. Ini hanya bermakna untuk ELF
boleh laku yang mengandungi penempatan semula dinamik, dan biasanya memerlukan
kod titik masuk yang mampu memproses penempatan semula ini.

--amaran maut
--tiada-amaran-maut
Anggap semua amaran sebagai ralat. Tingkah laku lalai boleh
dipulihkan dengan pilihan --tiada-amaran-maut.

--force-exe-akhiran
Pastikan bahawa fail output mempunyai akhiran .exe.

Jika fail output terpaut penuh yang berjaya dibina tidak mempunyai a
Akhiran ".exe" atau ".dll", pilihan ini memaksa pemaut untuk menyalin
output fail kepada salah satu nama yang sama dengan akhiran ".exe". ini
pilihan berguna apabila menggunakan makefiles Unix yang tidak diubah suai pada a
Hos Microsoft Windows, kerana sesetengah versi Windows tidak akan menjalankan
imej melainkan ia berakhir dengan akhiran ".exe".

--gc-bahagian
--tiada-gc-bahagian
Dayakan pengumpulan sampah bahagian input yang tidak digunakan. Ia tidak diendahkan
pada sasaran yang tidak menyokong pilihan ini. Tingkah laku lalai
(daripada tidak melaksanakan kutipan sampah ini) boleh dipulihkan oleh
menentukan --tiada-gc-bahagian pada baris arahan. Perhatikan bahawa sampah
pengumpulan untuk sasaran format COFF dan PE disokong, tetapi
pelaksanaan pada masa ini dianggap sebagai eksperimen.

--gc-bahagian memutuskan bahagian input mana yang digunakan dengan memeriksa
simbol dan penempatan semula. Bahagian yang mengandungi simbol kemasukan
dan semua bahagian yang mengandungi simbol yang tidak ditentukan pada baris arahan
akan disimpan, begitu juga bahagian yang mengandungi simbol yang dirujuk oleh
objek dinamik. Ambil perhatian bahawa apabila membina perpustakaan kongsi, fail
penghubung mesti menganggap bahawa sebarang simbol yang kelihatan dirujuk. sekali
set awal bahagian ini telah ditentukan, penghubung
menandakan secara rekursif sebagai digunakan mana-mana bahagian yang dirujuk oleh mereka
penempatan semula. Lihat --kemasukan and --tidak ditentukan.

Pilihan ini boleh ditetapkan apabila melakukan pautan separa (didayakan dengan
pilihan -r). Dalam kes ini, akar simbol yang disimpan mestilah
dinyatakan secara eksplisit sama ada oleh an --kemasukan or --tidak ditentukan pilihan atau
dengan arahan "ENTRY" dalam skrip pemaut.

--print-gc-bahagian
--tiada-cetak-gc-bahagian
Senaraikan semua bahagian yang dialih keluar oleh kutipan sampah. Penyenaraian adalah
dicetak pada stderr. Pilihan ini hanya berkesan jika sampah
koleksi telah didayakan melalui --gc-bahagian) pilihan. The
tingkah laku lalai (tidak menyenaraikan bahagian yang dialih keluar)
boleh dipulihkan dengan menyatakan --tiada-cetak-gc-bahagian atas arahan
line.

--print-output-format
Cetak nama format output lalai (mungkin dipengaruhi oleh
pilihan baris arahan lain). Ini adalah rentetan yang akan muncul
dalam arahan skrip pemaut "OUTPUT_FORMAT".

--cetak-memori-penggunaan
Cetak saiz terpakai, jumlah saiz dan saiz terpakai bagi kawasan memori yang dicipta
dengan MEMORY perintah. Ini berguna pada sasaran terbenam untuk
mempunyai pandangan pantas tentang jumlah memori percuma. Format bagi
output mempunyai satu tajuk dan satu baris bagi setiap wilayah. Ia adalah kedua-duanya manusia
boleh dibaca dan mudah dihuraikan oleh alatan. Berikut adalah contoh sebuah
pengeluaran:

Rantau memori Digunakan Saiz Rantau Saiz %umur Digunakan
ROM: 256 KB 1 MB 25.00%
RAM: 32 B 2 GB 0.00%

- membantu
Cetak ringkasan pilihan baris arahan pada output standard
dan keluar.

--sasaran-bantuan
Cetak ringkasan semua pilihan khusus sasaran pada standard
keluaran dan keluar.

-Peta=fail peta
Cetak peta pautan ke fail fail peta. Lihat penerangan tentang
-M pilihan, di atas.

--tidak-simpan-ingatan
ld biasanya mengoptimumkan kelajuan melebihi penggunaan memori dengan menyimpan cache
jadual simbol fail input dalam ingatan. Pilihan ini memberitahu ld kepada
sebaliknya mengoptimumkan penggunaan memori, dengan membaca semula jadual simbol
sebagai keperluan. Ini mungkin diperlukan jika ld kehabisan ruang ingatan
sambil memautkan boleh laku yang besar.

--tidak-tidak ditentukan
-z kekurangan
Laporkan rujukan simbol yang belum diselesaikan daripada fail objek biasa.
Ini dilakukan walaupun pemaut membuat perkongsian bukan simbolik
perpustakaan. suis --[no-]allow-shlib-undefined mengawal
tingkah laku untuk melaporkan rujukan yang tidak dapat diselesaikan yang ditemui dalam perkongsian
perpustakaan yang dihubungkan.

--benarkan-berbilang-takrifan
-z muldef
Biasanya apabila simbol ditakrifkan beberapa kali, penghubung akan
melaporkan kesilapan yang membawa maut. Pilihan ini membenarkan pelbagai definisi dan
definisi pertama akan digunakan.

--benarkan-shlib-undefined
--no-allow-shlib-undefined
Membenarkan atau tidak membenarkan simbol yang tidak ditentukan dalam perpustakaan kongsi. ini
suis adalah serupa dengan --tidak-tidak ditentukan kecuali ia menentukan
tingkah laku apabila simbol yang tidak ditentukan berada dalam perpustakaan kongsi
daripada fail objek biasa. Ia tidak menjejaskan bagaimana tidak ditentukan
simbol dalam fail objek biasa dikendalikan.

Tingkah laku lalai adalah untuk melaporkan ralat untuk sebarang simbol yang tidak ditentukan
dirujuk dalam perpustakaan kongsi jika pemaut sedang digunakan untuk
buat boleh laku, tetapi untuk membenarkannya jika pemaut sedang digunakan
untuk membuat perpustakaan kongsi.

Sebab untuk membenarkan rujukan simbol yang tidak ditentukan dalam perkongsian
perpustakaan yang dinyatakan pada masa pautan ialah:

· Pustaka kongsi yang ditentukan pada masa pautan mungkin tidak sama dengan
yang tersedia pada masa muat, jadi simbol mungkin
sebenarnya boleh diselesaikan pada masa muat.

· Terdapat beberapa sistem pengendalian, contohnya BeOS dan HPPA, di mana
simbol yang tidak ditentukan dalam perpustakaan kongsi adalah perkara biasa.

Kernel BeOS sebagai contoh menampal perpustakaan kongsi semasa dimuatkan
masa untuk memilih mana-mana fungsi yang paling sesuai untuk
seni bina semasa. Ini digunakan, sebagai contoh, untuk
pilih fungsi memset yang sesuai secara dinamik.

--no-undefined-version
Biasanya apabila simbol mempunyai versi yang tidak ditentukan, penyambung akan
abaikan. Pilihan ini tidak membenarkan simbol dengan versi yang tidak ditentukan dan
ralat maut akan dikeluarkan sebaliknya.

--default-symver
Cipta dan gunakan versi simbol lalai (soname) untuk
simbol eksport yang tidak diversi.

--default-imported-symver
Cipta dan gunakan versi simbol lalai (soname) untuk
simbol yang diimport tidak versi.

--tiada-amaran-tidak sepadan
Biasanya ld akan memberikan ralat jika anda cuba memautkan input bersama
fail yang tidak sepadan atas sebab tertentu, mungkin kerana fail tersebut
telah disusun untuk pemproses yang berbeza atau untuk yang berbeza
endiannesses. Pilihan ini memberitahu ld bahawa ia harus secara senyap membenarkan
kesilapan yang mungkin sedemikian. Pilihan ini hanya boleh digunakan dengan berhati-hati,
dalam kes apabila anda telah mengambil beberapa tindakan khas yang memastikan perkara itu
ralat penghubung tidak sesuai.

--tiada-amaran-carian-tidak sepadan
Biasanya ld akan memberi amaran jika ia mendapati perpustakaan yang tidak serasi
semasa carian perpustakaan. Pilihan ini menyenyapkan amaran.

--tiada-keseluruhan-arkib
Matikan kesan daripada --keseluruhan-arkib pilihan untuk seterusnya
fail arkib.

--noinhibit-exec
Kekalkan fail output boleh laku apabila ia masih boleh digunakan.
Biasanya, pemaut tidak akan menghasilkan fail output jika ia
menghadapi ralat semasa proses pautan; ia keluar tanpa menulis
fail output apabila ia mengeluarkan sebarang ralat.

-nostdlib
Hanya cari direktori perpustakaan yang dinyatakan secara eksplisit pada arahan
barisan. Direktori perpustakaan yang dinyatakan dalam skrip pemaut (termasuk
skrip penghubung yang dinyatakan pada baris arahan) diabaikan.

--oformat=format keluaran
ld boleh dikonfigurasikan untuk menyokong lebih daripada satu jenis fail objek.
Jika anda ld dikonfigurasikan dengan cara ini, anda boleh menggunakan --oformat pilihan
untuk menentukan format binari untuk fail objek output. Walaupun ketika
ld dikonfigurasikan untuk menyokong format objek alternatif, anda tidak
biasanya perlu menyatakan ini, sebagai ld harus dikonfigurasikan untuk menghasilkan
sebagai format output lalai format yang paling biasa pada setiap mesin.
format keluaran ialah rentetan teks, nama format tertentu
disokong oleh perpustakaan BFD. (Anda boleh menyenaraikan binari yang tersedia
format dengan objdump -i.) Perintah skrip "OUTPUT_FORMAT" boleh
juga menentukan format output, tetapi pilihan ini mengatasinya.

-pai
--pic-boleh laku
Cipta kedudukan bebas boleh laku. Ini pada masa ini sahaja
disokong pada platform ELF. Jawatan boleh laku bebas ialah
serupa dengan perpustakaan kongsi kerana ia dipindahkan oleh
pemaut dinamik ke alamat maya yang dipilih oleh OS untuk mereka
(yang boleh berbeza-beza antara seruan). Seperti biasa secara dinamik
boleh laku dipautkan ia boleh dilaksanakan dan simbol ditakrifkan dalam
boleh laku tidak boleh ditindih oleh perpustakaan kongsi.

-qmagic
Pilihan ini diabaikan untuk keserasian Linux.

-Qy Pilihan ini diabaikan untuk keserasian SVR4.

--berehat
--tidak-berehat
Pilihan dengan kesan bergantung kepada mesin. Pilihan ini hanya
disokong pada beberapa sasaran.

Pada beberapa platform --berehat pilihan melaksanakan sasaran khusus,
pengoptimuman global yang menjadi mungkin apabila penyambung diselesaikan
menangani dalam program, seperti mod alamat santai,
mensintesis arahan baharu, memilih versi semasa yang lebih pendek
arahan, dan menggabungkan nilai malar.

Pada sesetengah platform, pengoptimuman global masa pautan ini mungkin dibuat
penyahpepijatan simbolik daripada mustahil boleh laku yang terhasil. Ini adalah
dikenali sebagai kes bagi keluarga Matsushita MN10200 dan MN10300
pemproses.

Pada platform yang tidak disokong, --berehat diterima, tetapi
diabaikan.

Pada platform di mana --berehat diterima pilihan --tidak-berehat boleh
digunakan untuk melumpuhkan ciri tersebut.

--retain-symbols-file=nama fail
Kekalkan hanyalah simbol yang disenaraikan dalam fail nama fail, membuang semua
lain-lain. nama fail hanyalah fail rata, dengan satu nama simbol setiap
barisan. Pilihan ini amat berguna dalam persekitaran (seperti
VxWorks) di mana jadual simbol global yang besar terkumpul
secara beransur-ansur, untuk memulihara ingatan masa larian.

--retain-symbols-file tidak tidak buang simbol yang tidak ditentukan, atau
simbol yang diperlukan untuk penempatan semula.

Anda hanya boleh menentukan --retain-symbols-file sekali dalam arahan
barisan. Ia mengatasi -s and -S.

-rpath=dir
Tambahkan direktori pada laluan carian perpustakaan masa jalan. Ini digunakan
apabila memautkan ELF boleh laku dengan objek kongsi. Semua -rath
argumen digabungkan dan dihantar ke pemaut masa jalan, yang
menggunakannya untuk mencari objek kongsi semasa masa jalan. The -rath pilihan
juga digunakan apabila mencari objek kongsi yang diperlukan oleh
objek kongsi disertakan secara eksplisit dalam pautan; lihat penerangan
daripada -pautan-rpath pilihan. Jika -rath tidak digunakan semasa menghubungkan an
ELF boleh laku, kandungan pembolehubah persekitaran
"LD_RUN_PATH" akan digunakan jika ia ditakrifkan.

. -rath pilihan juga boleh digunakan pada SunOS. Secara lalai, pada SunOS,
pemaut akan membentuk laluan carian masa jalan daripada semua -L
pilihan yang diberikan. Sekiranya -rath pilihan digunakan, masa jalan
laluan carian akan dibentuk secara eksklusif menggunakan -rath pilihan,
mengabaikan -L pilihan. Ini boleh berguna apabila menggunakan gcc, yang
menambah banyak -L pilihan yang mungkin ada pada sistem fail yang dipasang NFS.

Untuk keserasian dengan penyambung ELF lain, jika -R pilihan adalah
diikuti dengan nama direktori, bukannya nama fail, ia adalah
diperlakukan sebagai -rath pilihan.

-pautan-rpath=dir
Apabila menggunakan ELF atau SunOS, satu perpustakaan kongsi mungkin memerlukan yang lain.
Ini berlaku apabila pautan "ld -shared" termasuk perpustakaan kongsi sebagai
salah satu fail input.

Apabila penyambung menghadapi pergantungan sedemikian apabila melakukan bukan-
pautan yang dikongsi, tidak boleh dipindahkan, ia akan cuba mencari secara automatik
perpustakaan kongsi yang diperlukan dan masukkannya dalam pautan, jika ada
tidak disertakan secara eksplisit. Dalam kes sedemikian, -pautan-rpath pilihan
menentukan set pertama direktori untuk dicari. The -pautan-rpath
pilihan boleh menentukan urutan nama direktori sama ada oleh
menyatakan senarai nama yang dipisahkan dengan titik bertindih, atau dengan muncul
berkali-kali.

Pilihan ini harus digunakan dengan berhati-hati kerana ia mengatasi carian
laluan yang mungkin sukar disusun ke dalam perpustakaan kongsi. Dalam
kes sedemikian adalah mungkin untuk menggunakan secara tidak sengaja yang berbeza
laluan carian daripada yang akan dilakukan oleh pemaut masa jalan.

Penyambung menggunakan laluan carian berikut untuk mencari yang diperlukan
perpustakaan kongsi:

1. Mana-mana direktori yang ditentukan oleh -pautan-rpath pilihan.

2. Mana-mana direktori yang ditentukan oleh -rath pilihan. Perbezaan
antara -rath and -pautan-rpath ialah direktori yang ditentukan oleh
-rath pilihan disertakan dalam boleh laku dan digunakan di
runtime, manakala -pautan-rpath pilihan hanya berkesan pada
masa pautan. Mencari -rath dengan cara ini hanya disokong oleh
pemaut asli dan pemaut silang yang telah dikonfigurasikan
dengan --dengan-sysroot pilihan.

3. Pada sistem ELF, untuk penyambung asli, jika -rath and
-pautan-rpath pilihan tidak digunakan, cari kandungan
pembolehubah persekitaran "LD_RUN_PATH".

4. Pada SunOS, jika -rath pilihan tidak digunakan, cari sebarang
direktori yang ditentukan menggunakan -L pilihan.

5. Untuk pemaut asli, cari kandungan persekitaran
pembolehubah "LD_LIBRARY_PATH".

6. Untuk pemaut ELF asli, direktori dalam "DT_RUNPATH" atau
"DT_RPATH" pustaka kongsi dicari untuk dikongsi
perpustakaan yang diperlukan olehnya. Entri "DT_RPATH" diabaikan jika
Entri "DT_RUNPATH" wujud.

7. Direktori lalai, biasanya / lib and / usr / lib.

8. Untuk pemaut asli pada sistem ELF, jika fail
/etc/ld.so.conf wujud, senarai direktori yang terdapat di dalamnya
fail.

Jika pustaka kongsi yang diperlukan tidak ditemui, pemaut akan mengeluarkan
amaran dan teruskan dengan pautan.

-berkongsi
-Boleh dikongsi
Buat pustaka kongsi. Pada masa ini ini hanya disokong pada ELF,
Platform XCOFF dan SunOS. Pada SunOS, pemaut akan secara automatik
buat perpustakaan kongsi jika -e pilihan tidak digunakan dan ada
simbol yang tidak ditentukan dalam pautan.

--macam-biasa
--sort-common=menaik
--sort-common=menurun
Pilihan ini memberitahu ld untuk mengisih simbol biasa mengikut penjajaran dalam
tertib menaik atau menurun apabila ia menempatkan mereka dalam
bahagian keluaran yang sesuai. Penjajaran simbol yang dipertimbangkan ialah
enam belas bait atau lebih besar, lapan bait, empat bait, dua bait dan satu-
bait. Ini adalah untuk mengelakkan jurang antara simbol akibat penjajaran
kekangan. Jika tiada susunan isihan ditentukan, kemudian menurun
pesanan diandaikan.

--sort-section=nama
Pilihan ini akan menggunakan "SORT_BY_NAME" pada semua bahagian kad bebas
corak dalam skrip penghubung.

--sort-section=alignment
Pilihan ini akan menggunakan "SORT_BY_ALIGNMENT" pada semua bahagian kad bebas
corak dalam skrip penghubung.

--split-by-file[=saiz]
Sama seperti --berpisah-dengan-reloc tetapi mencipta bahagian keluaran baharu untuk
setiap fail input apabila saiz dicapai. saiz lalai kepada saiz 1
jika tidak diberi.

--split-by-reloc[=mengira]
Cuba untuk mencipta bahagian tambahan dalam fail output supaya tidak
bahagian output tunggal dalam fail mengandungi lebih daripada mengira
penempatan semula. Ini berguna apabila menjana fail besar yang boleh dipindahkan
untuk memuat turun ke dalam kernel masa nyata tertentu dengan objek COFF
format fail; kerana COFF tidak boleh mewakili lebih daripada 65535
penempatan semula dalam satu bahagian. Ambil perhatian bahawa ini akan gagal berfungsi
dengan format fail objek yang tidak menyokong bahagian sewenang-wenangnya.
Penyambung tidak akan membahagikan bahagian input individu untuk
pengagihan semula, jadi jika bahagian input tunggal mengandungi lebih daripada
mengira penempatan semula satu bahagian output akan mengandungi sebanyak itu
penempatan semula. mengira lalai kepada nilai 32768.

--statistik
Kira dan paparkan statistik tentang operasi penyambung,
seperti masa pelaksanaan dan penggunaan ingatan.

--sysroot=direktori
Penggunaan direktori sebagai lokasi sysroot, mengatasi
lalai konfigurasi-masa. Pilihan ini hanya disokong oleh pemaut
yang telah dikonfigurasikan menggunakan --dengan-sysroot.

--format-tradisional
Untuk beberapa sasaran, output daripada ld berbeza dalam beberapa cara daripada
keluaran beberapa penghubung sedia ada. Permintaan suis ini ld untuk digunakan
sebaliknya format tradisional.

Contohnya, pada SunOS, ld menggabungkan entri pendua dalam simbol
meja bertali. Ini boleh mengurangkan saiz fail output dengan penuh
menyahpepijat maklumat sebanyak lebih 30 peratus. Malangnya, SunOS
Program "dbx" tidak boleh membaca program yang terhasil ("gdb" mempunyai no
masalah). The --format-tradisional suis memberitahu ld untuk tidak bergabung
entri pendua.

--bahagian-mula=nama bahagian=org
Cari bahagian dalam fail output pada alamat mutlak yang diberikan
by org. Anda boleh menggunakan pilihan ini seberapa banyak yang perlu untuk
cari beberapa bahagian dalam baris arahan. org mesti bujang
integer heksadesimal; untuk keserasian dengan pemaut lain, anda boleh
meninggalkan memimpin 0x biasanya dikaitkan dengan nilai heksadesimal.
Catatan: tidak sepatutnya ada ruang kosong di antara nama bahagian, yang
sama dengan tanda ("="), dan org.

-Tbss=org
-Tdata=org
-Ttext=org
Sama seperti --bahagian-mula, dengan ".bss", ".data" atau ".text" sebagai
nama bahagian.

-Ttext-segmen=org
Apabila mencipta ELF boleh laku, ia akan menetapkan alamat
bait pertama segmen teks.

-Trodata-segmen=org
Apabila mencipta objek boleh laku atau dikongsi ELF untuk sasaran di mana
data baca sahaja berada dalam segmennya sendiri yang berasingan daripada
teks boleh laku, ia akan menetapkan alamat bait pertama bagi
segmen data baca sahaja.

-Tldata-segmen=org
Apabila mencipta objek boleh laku atau dikongsi ELF untuk medium x86-64
model memori, ia akan menetapkan alamat bait pertama bagi
segmen ldata.

--simbol-tidak diselesaikan=kaedah
Tentukan cara mengendalikan simbol yang tidak dapat diselesaikan. Ada empat
nilai yang mungkin untuk kaedah:

abaikan semua
Jangan laporkan sebarang simbol yang belum diselesaikan.

laporan-semua
Laporkan semua simbol yang belum diselesaikan. Ini adalah lalai.

abaikan-dalam-objek-fail
Laporkan simbol yang belum diselesaikan yang terkandung dalam kongsi
perpustakaan, tetapi abaikan mereka jika ia datang dari objek biasa
fail.

ignore-in-shared-libs
Laporkan simbol yang belum diselesaikan yang datang daripada fail objek biasa,
tetapi abaikan mereka jika mereka datang dari perpustakaan kongsi. Ini boleh
berguna apabila mencipta binari dinamik dan diketahui bahawa
semua perpustakaan kongsi yang sepatutnya dirujuk adalah
disertakan pada baris arahan pemaut.

Tingkah laku untuk perpustakaan kongsi sendiri juga boleh
dikawal oleh --[no-]allow-shlib-undefined pilihan.

Biasanya penghubung akan menghasilkan mesej ralat untuk setiap satu
melaporkan simbol tidak diselesaikan tetapi pilihan --simbol-simbol-amaran-yang belum diselesaikan
boleh menukar ini kepada amaran.

--dll-verbose
--verbose[=NOMBOR]
Paparkan nombor versi untuk ld dan senaraikan emulasi penghubung
disokong. Paparkan fail input yang boleh dan tidak boleh dibuka.
Paparkan skrip pemaut yang digunakan oleh pemaut. Jika pilihan
NOMBOR argumen > 1, status simbol pemalam juga akan dipaparkan.

--version-script=version-scriptfile
Nyatakan nama skrip versi kepada pemaut. Ini adalah
biasanya digunakan semasa membuat perpustakaan kongsi untuk menentukan tambahan
maklumat tentang hierarki versi untuk perpustakaan itu
dicipta. Pilihan ini hanya disokong sepenuhnya pada platform ELF
yang menyokong perpustakaan kongsi; lihat VERSION. Ia adalah sebahagian
disokong pada platform PE, yang boleh menggunakan skrip versi untuk menapis
keterlihatan simbol dalam mod auto-eksport: sebarang simbol yang ditanda tempatan in
skrip versi tidak akan dieksport.

--amaran-biasa
Beri amaran apabila simbol biasa digabungkan dengan simbol biasa lain atau
dengan definisi simbol. Pemaut Unix membenarkan ini agak ceroboh
amalan, tetapi pemaut pada beberapa sistem pengendalian lain tidak. ini
pilihan membolehkan anda mencari masalah yang berpotensi daripada menggabungkan global
simbol. Malangnya, sesetengah perpustakaan C menggunakan amalan ini, jadi anda
mungkin mendapat beberapa amaran tentang simbol dalam perpustakaan dan juga dalam
program anda.

Terdapat tiga jenis simbol global, digambarkan di sini oleh C
contoh:

int i = 1;
Definisi, yang terdapat dalam bahagian data yang dimulakan pada
fail keluaran.

luar int i;
Rujukan yang tidak ditentukan, yang tidak memperuntukkan ruang. di sana
mestilah sama ada definisi atau simbol biasa untuk pembolehubah
suatu tempat.

int i;
Simbol biasa. Jika terdapat hanya (satu atau lebih) perkara biasa
simbol untuk pembolehubah, ia pergi dalam kawasan data yang tidak dimulakan
daripada fail output. Penghubung menggabungkan berbilang simbol biasa
untuk pembolehubah yang sama menjadi satu simbol. Jika mereka daripada
saiz yang berbeza, ia memilih saiz terbesar. Penghubung bertukar a
simbol biasa menjadi pengisytiharan, jika terdapat takrifan
pembolehubah yang sama.

. --amaran-biasa pilihan boleh menghasilkan lima jenis amaran. setiap satu
amaran terdiri daripada sepasang baris: yang pertama menerangkan simbol
baru sahaja ditemui, dan yang kedua menerangkan simbol sebelumnya
ditemui dengan nama yang sama. Satu atau kedua-dua daripada dua simbol
akan menjadi simbol biasa.

1. Menjadikan simbol biasa sebagai rujukan, kerana ada
sudah menjadi definisi untuk simbol.

( ): amaran: biasa ` '
ditindih mengikut takrifan
( ): amaran: ditakrifkan di sini

2. Menjadikan simbol biasa sebagai rujukan, kerana kemudian
definisi untuk simbol ditemui. Ini sama dengan
kes sebelumnya, kecuali simbol ditemui dalam a
susunan yang berbeza.

( ): amaran: definisi ` '
mengatasi perkara biasa
( ): amaran: biasa ada di sini

3. Menggabungkan simbol biasa dengan simbol biasa bersaiz sama sebelumnya
simbol.

( ): amaran: berbilang biasa
daripada ` '
( ): amaran: biasa sebelumnya ada di sini

4. Menggabungkan simbol biasa dengan simbol biasa yang lebih besar sebelumnya.

( ): amaran: biasa ` '
ditindih oleh biasa yang lebih besar
( ): amaran: common large is here

5. Menggabungkan simbol biasa dengan simbol biasa yang lebih kecil sebelumnya.
Ini adalah sama seperti kes sebelumnya, kecuali simbol
ditemui dalam susunan yang berbeza.

( ): amaran: biasa ` '
mengatasi perkara biasa yang lebih kecil
( ): amaran: commoner smaller is here

--amaran-pembina
Beri amaran jika mana-mana pembina global digunakan. Ini hanya berguna untuk
beberapa format fail objek. Untuk format seperti COFF atau ELF, format
penghubung tidak dapat mengesan penggunaan pembina global.

--amaran-berbilang-gp
Beri amaran jika berbilang nilai penunjuk global diperlukan dalam output
fail. Ini hanya bermakna untuk pemproses tertentu, seperti
Alfa. Khususnya, sesetengah pemproses meletakkan pemalar bernilai besar
bahagian khas. Mata daftar khas (penunjuk global).
ke tengah bahagian ini, supaya pemalar boleh dimuatkan
dengan cekap melalui mod pengalamatan relatif daftar asas. Sejak
offset dalam mod relatif daftar asas adalah tetap dan relatif
kecil (cth, 16 bit), ini mengehadkan saiz maksimum pemalar
kolam. Oleh itu, dalam program besar, selalunya perlu digunakan
berbilang nilai penunjuk global agar dapat menangani semua
pemalar yang mungkin. Pilihan ini menyebabkan amaran dikeluarkan
setiap kali kes ini berlaku.

--amaran-sekali
Hanya memberi amaran sekali untuk setiap simbol yang tidak ditentukan, bukannya sekali setiap
modul yang merujuk kepadanya.

--warn-section-align
Beri amaran jika alamat bahagian output ditukar kerana
penjajaran. Biasanya, penjajaran akan ditetapkan oleh input
bahagian. Alamat hanya akan ditukar jika ia tidak secara eksplisit
dinyatakan; iaitu, jika arahan "SECTIONS" tidak menyatakan a
alamat mula untuk bahagian tersebut.

--warn-shared-textrel
Beri amaran jika pemaut menambah DT_TEXTREL pada objek kongsi.

--amaran-ganti-em
Beri amaran jika objek mempunyai kod mesin ELF alternatif.

--simbol-simbol-amaran-yang belum diselesaikan
Jika penyambung akan melaporkan simbol yang tidak dapat diselesaikan (lihat
pilihan --simbol-tidak diselesaikan) ia biasanya akan menghasilkan ralat.
Pilihan ini menjadikannya menjana amaran sebaliknya.

--simbol-ralat-tidak-selesai
Ini memulihkan tingkah laku lalai pemaut untuk menjana ralat
apabila ia melaporkan simbol yang tidak diselesaikan.

--keseluruhan-arkib
Untuk setiap arkib yang disebut pada baris arahan selepas
--keseluruhan-arkib pilihan, sertakan setiap fail objek dalam arkib dalam
pautan, dan bukannya mencari arkib untuk objek yang diperlukan
fail. Ini biasanya digunakan untuk menukar fail arkib menjadi perkongsian
perpustakaan, memaksa setiap objek untuk dimasukkan ke dalam yang dihasilkan
perpustakaan kongsi. Pilihan ini boleh digunakan lebih daripada sekali.

Dua nota apabila menggunakan pilihan ini daripada gcc: Pertama, gcc tidak tahu
tentang pilihan ini, jadi anda perlu menggunakan -Wl,-keseluruhan-arkib. Kedua,
jangan lupa guna -Wl,-tiada-keseluruhan-arkib selepas senarai anda
arkib, kerana gcc akan menambah senarai arkibnya sendiri pada anda
pautan dan anda mungkin tidak mahu bendera ini juga mempengaruhinya.

--bungkus=lambang
Gunakan fungsi pembalut untuk lambang. Sebarang rujukan yang tidak ditentukan kepada
lambang akan diselesaikan untuk "__wrap_simbol". Mana-mana yang tidak ditentukan
merujuk kepada "__sebenar_simbol" akan diselesaikan untuk lambang.

Ini boleh digunakan untuk menyediakan pembungkus untuk fungsi sistem. The
fungsi pembungkus hendaklah dipanggil "__wrap_simbol". Jika ia mahu
panggil fungsi sistem, ia harus memanggil "__real_simbol".

Berikut adalah contoh remeh:

batal *
__wrap_malloc (saiz_t c)
{
printf ("malloc dipanggil dengan %zu\n", c);
pulangkan __real_malloc (c);
}

Jika anda memautkan kod lain dengan fail ini menggunakan --bungkus malloc, maka semua
panggilan ke "malloc" akan memanggil fungsi "__wrap_malloc" sebaliknya.
Panggilan kepada "__real_malloc" dalam "__wrap_malloc" akan memanggil yang sebenar
fungsi "mallok".

Anda mungkin ingin menyediakan fungsi "__real_malloc" juga, supaya
pautan tanpa --bungkus pilihan akan berjaya. Jika anda melakukan ini, anda
tidak sepatutnya meletakkan takrif "__real_malloc" dalam fail yang sama
sebagai "__wrap_malloc"; jika anda berbuat demikian, pemasang boleh menyelesaikan panggilan
sebelum pemaut mempunyai peluang untuk membungkusnya ke "malloc".

--eh-frame-hdr
Minta penciptaan bahagian ".eh_frame_hdr" dan ELF
Pengepala segmen "PT_GNU_EH_FRAME".

--no-ld-generated-unwind-info
Minta penciptaan maklumat unwind ".eh_frame" untuk pemaut yang dihasilkan
bahagian kod seperti PLT. Pilihan ini dihidupkan secara lalai jika pemaut
maklumat santai yang dihasilkan disokong.

--dayakan-dtags-baru
--disable-new-dtags
Penyambung ini boleh mencipta teg dinamik baharu dalam ELF. Tetapi yang lebih tua
Sistem ELF mungkin tidak memahaminya. Jika anda nyatakan
--dayakan-dtags-baru, teg dinamik baharu akan dibuat mengikut keperluan
dan teg dinamik yang lebih lama akan ditinggalkan. Jika anda nyatakan
--disable-new-dtags, tiada teg dinamik baharu akan dibuat. Oleh
lalai, teg dinamik baharu tidak dibuat. Perhatikan bahawa mereka
pilihan hanya tersedia untuk sistem ELF.

--saiz-cincang=nombor
Tetapkan saiz lalai jadual cincang pemaut kepada nombor perdana
dekat dengan nombor. Meningkatkan nilai ini boleh mengurangkan panjang
masa yang diperlukan penghubung untuk melaksanakan tugasnya, dengan mengorbankan
meningkatkan keperluan ingatan penyambung. Begitu juga mengurangkan
nilai ini boleh mengurangkan keperluan memori dengan mengorbankan
kelajuan.

--gaya hash=gaya
Tetapkan jenis jadual cincang pemaut. gaya boleh sama ada "sysv"
untuk bahagian ".hash" ELF klasik, "gnu" untuk GNU gaya baharu
Bahagian ".gnu.hash" atau "kedua-duanya" untuk kedua-dua ELF klasik ".hash" dan
jadual cincang ".gnu.hash" gaya baharu GNU. Lalai ialah "sysv".

--compress-debug-sections=tiada
--compress-debug-sections=zlib
--compress-debug-sections=zlib-gnu
--compress-debug-sections=zlib-gabi
Pada platform ELF , pilihan ini mengawal cara bahagian nyahpepijat DWARF
dimampatkan menggunakan zlib. --compress-debug-sections=tiada tidak
memampatkan bahagian nyahpepijat DWARF. --compress-debug-sections=zlib-gnu
memampatkan bahagian nyahpepijat DWARF dan menamakan semula nama bahagian nyahpepijat kepada
bermula dengan .zdebug bukan .debug.
--compress-debug-sections=zlib and
--compress-debug-sections=zlib-gabi memampatkan bahagian nyahpepijat DWARF
dengan SHF_COMPRESSED daripada ELF ABI. Tingkah laku lalai berbeza-beza
bergantung pada sasaran yang terlibat dan pilihan konfigurasi yang digunakan
untuk membina rantai alat. Lalai boleh ditentukan dengan memeriksa
output daripada penghubung - membantu pilihan.

--kurangkan-memori-overhed
Pilihan ini mengurangkan keperluan memori pada masa jalan ld, pada
perbelanjaan kelajuan menghubungkan. Ini diperkenalkan untuk memilih yang lama
Algoritma O(n^2) untuk penjanaan fail peta pautan, bukannya yang baharu
Algoritma O(n) yang menggunakan lebih kurang 40% memori untuk penyimpanan simbol.

Satu lagi kesan suis adalah untuk menetapkan saiz jadual cincang lalai
kepada 1021, yang sekali lagi menjimatkan memori dengan kos memanjangkan
masa larian penghubung. Ini tidak dilakukan walau bagaimanapun jika --saiz cincang
suis telah digunakan.

. --kurangkan-memori-overhed suis juga boleh digunakan untuk membolehkan
pertukaran lain dalam versi masa hadapan pemaut.

--build-id
--build-id=gaya
Minta penciptaan bahagian nota ELF ".note.gnu.build-id" atau
bahagian ".buildid" COFF. Kandungan nota adalah unik
bit yang mengenal pasti fail terpaut ini. gaya boleh menjadi "uuid" untuk menggunakan 128
bit rawak, "sha1" untuk menggunakan cincang SHA160 1-bit pada normatif
bahagian kandungan output, "md5" untuk menggunakan cincangan MD128 5-bit
bahagian normatif kandungan output, atau "0xhexstring" untuk digunakan
rentetan bit yang dipilih ditentukan sebagai nombor genap perenambelasan
digit ("-" dan ":" aksara antara pasangan digit diabaikan).
If gaya ditinggalkan, "sha1" digunakan.

Gaya "md5" dan "sha1" menghasilkan pengecam yang sentiasa
sama dalam fail output yang sama, tetapi akan menjadi unik di antara semua
fail keluaran tidak serupa. Ia tidak bertujuan untuk dibandingkan sebagai a
checksum untuk kandungan fail. Fail yang dipautkan boleh ditukar
kemudian oleh alat lain, tetapi rentetan bit ID binaan mengenal pasti
fail terpaut asal tidak berubah.

Lulus "tiada" untuk gaya melumpuhkan tetapan daripada mana-mana "--build-id"
pilihan lebih awal pada baris arahan.

Penyambung i386 PE menyokong -berkongsi pilihan, yang menyebabkan output
menjadi perpustakaan terpaut dinamik (DLL) dan bukannya biasa
boleh dilaksanakan. Anda harus menamakan output "*.dll" apabila anda menggunakan ini
pilihan. Di samping itu, penyambung menyokong sepenuhnya standard "*.def"
fail, yang mungkin ditentukan pada baris arahan pemaut seperti objek
fail (sebenarnya, ia harus mendahului arkib yang mengeksport simbol dari, ke
pastikan ia dipautkan, sama seperti fail objek biasa).

Sebagai tambahan kepada pilihan biasa untuk semua sasaran, penyambung i386 PE
menyokong pilihan baris arahan tambahan yang khusus untuk i386
Sasaran PE. Pilihan yang mengambil nilai mungkin dipisahkan daripada nilainya
dengan sama ada ruang atau tanda yang sama.

--add-stdcall-alias
Jika diberikan, simbol dengan akhiran stdcall (@nn) akan dieksport sebagai-
adalah dan juga dengan akhiran dilucutkan. [Pilihan ini khusus untuk
port sasaran i386 PE bagi pemaut]

--base-file fail
Penggunaan fail sebagai nama fail untuk menyimpan alamat asas
daripada semua penempatan semula yang diperlukan untuk menjana DLL dengan dlltool.
[Ini ialah pilihan khusus i386 PE]

--dll
Buat DLL dan bukannya boleh laku biasa. Anda juga boleh menggunakan
-berkongsi atau nyatakan "PERPUSTAKAAN" dalam fail ".def" yang diberikan. [Ini
pilihan adalah khusus untuk port sasaran i386 PE bagi pemaut]

--dayakan-nama-bahagian-panjang
--disable-long-section-namas
Varian PE bagi format objek COFF menambah sambungan itu
membenarkan penggunaan nama bahagian yang lebih panjang daripada lapan aksara, yang
had biasa untuk COFF. Secara lalai, nama ini hanya dibenarkan masuk
fail objek, kerana imej boleh laku yang dipautkan sepenuhnya tidak membawa fail
Jadual rentetan COFF diperlukan untuk menyokong nama yang lebih panjang. Sebagai GNU
sambungan, adalah mungkin untuk membenarkan penggunaannya dalam imej boleh laku
juga, atau (mungkin sia-sia!) tidak membenarkannya dalam objek
fail, dengan menggunakan dua pilihan ini. Imej boleh laku dihasilkan
dengan nama bahagian panjang ini sedikit tidak standard, membawa
kerana mereka melakukan jadual rentetan, dan boleh menjana output yang mengelirukan apabila
diperiksa dengan alat bukan sedar PE GNU, seperti pemapar fail dan
tempat pembuangan sampah. Walau bagaimanapun, GDB bergantung pada penggunaan nama bahagian panjang PE
untuk mencari bahagian maklumat nyahpepijat Dwarf-2 dalam imej boleh laku
semasa runtime, dan jika tiada pilihan dinyatakan pada arahan-
garis, ld akan mendayakan nama bahagian panjang, mengatasi lalai dan
tingkah laku yang betul secara teknikal, apabila ia mendapati kehadiran nyahpepijat
maklumat semasa memautkan imej boleh laku dan bukan menanggalkan
simbol. [Pilihan ini sah untuk semua pelabuhan sasaran PE bagi
penghubung]

--dayakan-stdcall-fixup
--disable-stdcall-fixup
Jika pautan menemui simbol yang tidak dapat diselesaikan, ia akan cuba
untuk melakukan "pemautan kabur" dengan mencari simbol lain yang ditakrifkan itu
berbeza hanya dalam format nama simbol (cdecl vs stdcall)
dan akan menyelesaikan simbol itu dengan memaut pada perlawanan. Sebagai contoh,
simbol "_foo" yang tidak ditentukan mungkin dikaitkan dengan fungsi tersebut
"_foo@12", atau simbol yang tidak ditentukan "_bar@16" mungkin dikaitkan dengan
fungsi "_bar". Apabila pemaut melakukan ini, ia mencetak amaran,
kerana ia biasanya gagal dipautkan, tetapi kadangkala import
perpustakaan yang dijana daripada dll pihak ketiga mungkin memerlukan ciri ini untuk
boleh digunakan. Jika anda nyatakan --dayakan-stdcall-fixup, ciri ini ialah
didayakan sepenuhnya dan amaran tidak dicetak. Jika anda nyatakan
--disable-stdcall-fixup, ciri ini dilumpuhkan dan sebagainya
ketidakpadanan dianggap sebagai kesilapan. [Pilihan ini khusus
ke port sasaran i386 PE bagi pemaut]

--memimpin-garis bawah
--tidak-menterajui-garis bawah
Untuk kebanyakan sasaran, awalan simbol lalai ialah garis bawah dan adalah
ditakrifkan dalam penerangan sasaran. Dengan pilihan ini adalah mungkin untuk
lumpuhkan/dayakan awalan simbol garis bawah lalai.

--eksport-semua-simbol
Jika diberikan, semua simbol global dalam objek yang digunakan untuk membina DLL
akan dieksport oleh DLL. Ambil perhatian bahawa ini adalah lalai jika
jika tidak, tiada simbol yang dieksport. Apabila simbol
dieksport secara eksplisit melalui fail DEF atau dieksport secara tersirat melalui
atribut fungsi, lalai adalah untuk tidak mengeksport apa-apa lagi
melainkan pilihan ini diberikan. Ambil perhatian bahawa simbol "DllMain@12",
"DllEntryPoint@0", "DllMainCRTSstartup@12", dan "impure_ptr" akan
tidak dieksport secara automatik. Juga, simbol yang diimport daripada yang lain
DLL tidak akan dieksport semula, begitu juga simbol yang menyatakan DLL
reka letak dalaman seperti yang bermula dengan "_head_" atau berakhir
dengan "_iname". Selain itu, tiada simbol daripada "libgcc", "libstd++",
"libmingw32", atau "crtX.o" akan dieksport. Simbol yang namanya
bermula dengan "__rtti_" atau "__builtin_" tidak akan dieksport, untuk membantu
dengan DLL C++. Akhirnya, terdapat senarai luas cygwin-
simbol peribadi yang tidak dieksport (jelas, ini terpakai pada
apabila membina DLL untuk sasaran cygwin). Pengecualian cygwin ini ialah:
"_cygwin_dll_entry@12", "_cygwin_crt0_common@8",
"_cygwin_noncygwin_dll_entry@12", "_fmode", "_impure_ptr",
"cygwin_attach_dll", "cygwin_premain0", "cygwin_premain1",
"cygwin_premain2", "cygwin_premain3", dan "persekitaran". [Pilihan ini
adalah khusus untuk port sasaran i386 PE bagi pemaut]

--kecualikan-simbol lambang,lambang, ...
Menentukan senarai simbol yang tidak sepatutnya secara automatik
dieksport. Nama simbol mungkin dihadkan dengan koma atau titik bertindih.
[Pilihan ini khusus untuk port sasaran i386 PE bagi
penghubung]

--kecualikan-semua-simbol
Menentukan tiada simbol harus dieksport secara automatik. [Ini
pilihan adalah khusus untuk port sasaran i386 PE bagi pemaut]

--penjajaran fail
Tentukan penjajaran fail. Bahagian dalam fail akan sentiasa bermula
pada pengimbangan fail yang merupakan gandaan nombor ini. Ini lalai
kepada 512. [Pilihan ini khusus untuk port sasaran i386 PE bagi
penghubung]

--timbunan rizab
--timbunan rizab,melakukan
Tentukan bilangan bait memori untuk ditempah (dan secara pilihan
commit) untuk digunakan sebagai timbunan untuk program ini. Lalai ialah 1MB
terpelihara, 4K komited. [Pilihan ini khusus untuk i386 PE
pelabuhan sasaran pemaut]

--asas-imej nilai
Penggunaan nilai sebagai alamat asas program atau dll anda. Ini adalah
lokasi memori terendah yang akan digunakan apabila program atau dll anda
dimuatkan. Untuk mengurangkan keperluan untuk menempatkan semula dan meningkatkan prestasi
dll anda, setiap satu harus mempunyai alamat pangkalan yang unik dan tidak
bertindih mana-mana dll lain. Lalai ialah 0x400000 untuk boleh laku,
dan 0x10000000 untuk dll. [Pilihan ini khusus untuk i386 PE
pelabuhan sasaran pemaut]

--bunuh-di
Jika diberikan, stdcall memberi imbuhan (@nn) akan dilucutkan daripada simbol
sebelum ia dieksport. [Pilihan ini khusus untuk i386 PE
pelabuhan sasaran pemaut]

--alamat-besar-sedar
Jika diberikan, bit yang sesuai dalam medan "Ciri-ciri" bagi
Pengepala COFF ditetapkan untuk menunjukkan bahawa boleh laku ini menyokong
alamat maya lebih besar daripada 2 gigabait. Ini harus digunakan dalam
bersama dengan /3GB atau /USERVA=nilai suis megabait dalam
"[sistem pengendalian]" bahagian BOOT.INI. Jika tidak, sedikit ini
tiada kesan. [Pilihan ini khusus untuk port sasaran PE bagi
penghubung]

--disable-large-address-aware
Mengembalikan kesan sebelumnya --alamat-besar-sedar pilihan.
Ini berguna jika --alamat-besar-sedar sentiasa ditetapkan oleh
pemacu pengkompil (cth Cygwin gcc) dan boleh laku tidak
menyokong alamat maya yang lebih besar daripada 2 gigabait. [Pilihan ini
adalah khusus untuk port sasaran PE bagi pemaut]

--versi-imej-utama nilai
Menetapkan nombor utama "versi imej". Lalai kepada 1.
[Pilihan ini khusus untuk port sasaran i386 PE bagi
penghubung]

--major-os-versi nilai
Menetapkan nombor utama "versi os". Lalai kepada 4. [Ini
pilihan adalah khusus untuk port sasaran i386 PE bagi pemaut]

--subsistem-versi utama nilai
Menetapkan nombor utama "versi subsistem". Lalai kepada 4.
[Pilihan ini khusus untuk port sasaran i386 PE bagi
penghubung]

--versi-imej-kecil nilai
Menetapkan nombor kecil "versi imej". Lalai kepada 0.
[Pilihan ini khusus untuk port sasaran i386 PE bagi
penghubung]

--minor-os-version nilai
Menetapkan nombor kecil "versi os". Lalai kepada 0. [Ini
pilihan adalah khusus untuk port sasaran i386 PE bagi pemaut]

--versi-subsistem-kecil nilai
Menetapkan nombor kecil "versi subsistem". Lalai kepada 0.
[Pilihan ini khusus untuk port sasaran i386 PE bagi
penghubung]

--output-def fail
Penyambung akan mencipta fail fail yang akan mengandungi fail DEF
sepadan dengan DLL yang dijana oleh pemaut. Fail DEF ini
(yang sepatutnya dipanggil "*.def") boleh digunakan untuk membuat import
perpustakaan dengan "dlltool" atau boleh digunakan sebagai rujukan kepada
simbol yang dieksport secara automatik atau tersirat. [Pilihan ini ialah
khusus untuk port sasaran i386 PE bagi pemaut]

--out-imlib fail
Penyambung akan mencipta fail fail yang akan mengandungi import
lib yang sepadan dengan DLL yang dijana oleh pemaut. Import ini
lib (yang sepatutnya dipanggil "*.dll.a" atau "*.a" boleh digunakan untuk memaut
pelanggan terhadap DLL yang dihasilkan; tingkah laku ini memungkinkan
untuk melangkau langkah penciptaan perpustakaan import "dlltool" yang berasingan. [Ini
pilihan adalah khusus untuk port sasaran i386 PE bagi pemaut]

--dayakan-asas-imej-auto
--enable-auto-image-base=nilai
Pilih pangkalan imej untuk DLL secara automatik, secara pilihan bermula
dengan asas nilai, melainkan jika ditentukan menggunakan "--image-base"
hujah. Dengan menggunakan cincang yang dihasilkan daripada nama dll untuk mencipta
pangkalan imej unik untuk setiap DLL, perlanggaran dalam memori dan
penempatan semula yang boleh melambatkan pelaksanaan program dielakkan. [Ini
pilihan adalah khusus untuk port sasaran i386 PE bagi pemaut]

--disable-auto-image-base
Jangan jana pangkalan imej unik secara automatik. Jika tiada
pangkalan imej yang ditentukan pengguna ("--image-base") kemudian gunakan platform
lalai. [Pilihan ini khusus untuk port sasaran i386 PE bagi
penghubung]

--dll-search-prefix rentetan
Apabila memaut secara dinamik ke dll tanpa perpustakaan import, cari
untuk " .dll" sebagai keutamaan kepada "lib .dll".
Tingkah laku ini membolehkan perbezaan mudah antara DLL yang dibina untuk
pelbagai "subplatform": asli, cygwin, uwin, pw, dll. Untuk
contohnya, DLL cygwin biasanya menggunakan "--dll-search-prefix=cyg".
[Pilihan ini khusus untuk port sasaran i386 PE bagi
penghubung]

--dayakan-auto-import
Lakukan pemautan canggih "_symbol" kepada "__imp__symbol" untuk DATA
import daripada DLL, dan cipta simbol thunking yang diperlukan apabila
membina perpustakaan import dengan eksport DATA tersebut. Nota: Penggunaan
sambungan 'import-auto' akan menyebabkan bahagian teks
fail imej untuk dibuat boleh ditulis. Ini tidak mematuhi PE-
Spesifikasi format COFF diterbitkan oleh Microsoft.

Nota - penggunaan sambungan 'import-auto' juga akan menyebabkan baca sahaja
data yang biasanya akan diletakkan ke dalam bahagian .rdata to be
diletakkan ke dalam bahagian .data sebaliknya. Ini adalah untuk bekerja
sekitar masalah dengan const yang diterangkan di sini:
http://www.cygwin.com/ml/cygwin/2004-09/msg01101.html

Menggunakan 'autoimport' secara amnya 'hanya berfungsi' -- tetapi kadangkala anda
boleh melihat mesej ini:

"pembolehubah ' ' tidak boleh diimport secara automatik. Sila baca
dokumentasi untuk "--dayakan-auto-import" ld untuk butiran."

Mesej ini berlaku apabila beberapa (sub) ungkapan mengakses alamat
akhirnya diberikan oleh jumlah dua pemalar (jadual import Win32
hanya membenarkan satu sahaja). Contoh di mana ini mungkin berlaku termasuk akses
kepada medan ahli pembolehubah struct yang diimport daripada DLL, juga
seperti menggunakan indeks malar ke dalam pembolehubah tatasusunan yang diimport daripada a
DLL. Mana-mana pembolehubah berbilang kata (tatasusunan, struktur, panjang panjang, dll) boleh
mencetuskan keadaan ralat ini. Walau bagaimanapun, tanpa mengira yang tepat
jenis data pembolehubah yang dieksport yang menyinggung, ld akan sentiasa mengesan
itu, keluarkan amaran, dan keluar.

Terdapat beberapa cara untuk menangani kesukaran ini, tidak kira
jenis data pembolehubah yang dieksport:

Satu cara ialah menggunakan suis --enable-runtime-pseudo-reloc. Ini meninggalkan
tugas melaraskan rujukan dalam kod klien anda untuk masa jalan
persekitaran, jadi kaedah ini hanya berfungsi apabila persekitaran masa jalan
menyokong ciri ini.

Penyelesaian kedua ialah memaksa salah satu 'pemalar' menjadi a
pembolehubah -- iaitu, tidak diketahui dan tidak boleh dioptimumkan pada masa penyusunan.
Untuk tatasusunan, terdapat dua kemungkinan: a) jadikan penerima indeks (the
alamat tatasusunan) pembolehubah, atau b) jadikan indeks 'malar' a
pembolehubah. Oleh itu:

jenis luaran extern_array[];
tatasusunan_luar[1] -->
{ jenis meruap *t=extern_array; t[1] }

or

jenis luaran extern_array[];
tatasusunan_luar[1] -->
{ int tidak menentu t=1; tatasusunan_luar[t] }

Untuk struct (dan kebanyakan jenis data berbilang kata lain) satu-satunya pilihan
adalah untuk membuat struct itu sendiri (atau panjang panjang, atau ...)
pemboleh ubah:

extern struct s extern_struct;
extern_struct.field -->
{ struct meruap s *t=&extern_struct; t->medan }

or

extern panjang panjang extern_ll;
extern_ll -->
{ volatile long long * local_ll=&extern_ll; *local_ll }

Kaedah ketiga untuk menangani kesukaran ini adalah dengan meninggalkan
'import-auto' untuk simbol yang menyinggung perasaan dan tandakannya dengan
"__declspec(dllimport)". Walau bagaimanapun, dalam amalan yang memerlukan menggunakan
compile-time #defines untuk menunjukkan sama ada anda sedang membina DLL,
membina kod pelanggan yang akan memaut ke DLL, atau semata-mata
membina/menghubungkan ke perpustakaan statik. Dalam membuat pilihan
antara pelbagai kaedah untuk menyelesaikan 'alamat langsung dengan
masalah offset berterusan, anda harus mempertimbangkan dunia sebenar yang tipikal
penggunaan:

Asal:

--foo.h
extern int arr[];
--foo.c
#include "foo.h"
batal utama(int argc, char **argv){
printf("%d\n",arr[1]);
}

Penyelesaian 1:

--foo.h
extern int arr[];
--foo.c
#include "foo.h"
batal utama(int argc, char **argv){
/* Penyelesaian ini adalah untuk win32 dan cygwin; jangan "optimumkan" */
int meruap *parr = arr;
printf("%d\n",parr[1]);
}

Penyelesaian 2:

--foo.h
/* Nota: eksport automatik diandaikan (tiada __declspec(dllexport)) */
#if (defined(_WIN32) || definition(__CYGWIN__)) && \
!(ditakrifkan(FOO_BUILD_DLL) || ditakrifkan(FOO_STATIC))
#define FOO_IMPORT __declspec(dllimport)
#selamat
#define FOO_IMPORT
#endif
extern FOO_IMPORT int arr[];
--foo.c
#include "foo.h"
batal utama(int argc, char **argv){
printf("%d\n",arr[1]);
}

Cara keempat untuk mengelakkan masalah ini ialah mengekod semula pustaka anda
gunakan antara muka berfungsi dan bukannya antara muka data untuk
pembolehubah yang menyinggung perasaan (cth set_foo() and get_foo() aksesori
fungsi). [Pilihan ini khusus untuk port sasaran i386 PE
daripada penghubung]

--disable-auto-import
Jangan cuba melakukan pemautan canggih "_symbol" kepada
"__imp__symbol" untuk import DATA daripada DLL. [Pilihan ini ialah
khusus untuk port sasaran i386 PE bagi pemaut]

--dayakan-runtime-pseudo-reloc
Jika kod anda mengandungi ungkapan yang diterangkan dalam --enable-auto-import
bahagian, iaitu, import DATA daripada DLL dengan offset bukan sifar, ini
suis akan mencipta vektor 'penempatan semula pseudo runtime' yang
boleh digunakan oleh persekitaran runtime untuk melaraskan rujukan sedemikian
data dalam kod pelanggan anda. [Pilihan ini khusus untuk i386 PE
pelabuhan sasaran pemaut]

--disable-runtime-pseudo-reloc
Jangan buat penempatan semula pseudo untuk import DATA yang tidak mengimbangi sifar
daripada DLL. [Pilihan ini khusus untuk port sasaran i386 PE
daripada penghubung]

--dayakan-extra-pe-debug
Tunjukkan maklumat nyahpepijat tambahan yang berkaitan dengan pemikiran simbol import automatik.
[Pilihan ini khusus untuk port sasaran i386 PE bagi
penghubung]

--penjajaran bahagian
Menetapkan penjajaran bahagian. Bahagian dalam ingatan akan sentiasa bermula
di alamat yang merupakan gandaan nombor ini. Lalai kepada
0x1000. [Pilihan ini khusus untuk port sasaran i386 PE bagi
penghubung]

--timbunan rizab
--timbunan rizab,melakukan
Tentukan bilangan bait memori untuk ditempah (dan secara pilihan
commit) untuk digunakan sebagai timbunan untuk program ini. Lalai ialah 2MB
terpelihara, 4K komited. [Pilihan ini khusus untuk i386 PE
pelabuhan sasaran pemaut]

--subsistem yang
--subsistem yang:utama
--subsistem yang:utama.kecil
Menentukan subsistem di mana program anda akan dilaksanakan. The
nilai undang-undang untuk yang ialah "asli", "windows", "console", "posix",
dan "xbox". Anda juga boleh menetapkan versi subsistem.
Nilai angka juga diterima untuk yang. [Pilihan ini ialah
khusus untuk port sasaran i386 PE bagi pemaut]

Pilihan berikut menetapkan bendera dalam medan "DllCharacteristics".
pengepala fail PE: [Pilihan ini khusus untuk sasaran PE
pelabuhan penyambung]

--entropi-va tinggi
Imej serasi dengan rawak susun atur ruang alamat 64-bit
(ASLR).

--dynamicbase
Alamat asas imej boleh dipindahkan menggunakan susun atur ruang alamat
rawak (ASLR). Ciri ini telah diperkenalkan dengan MS Windows
Vista untuk sasaran i386 PE.

--forceinteg
Pemeriksaan integriti kod dikuatkuasakan.

--nxcompat
Imej itu serasi dengan Pencegahan Pelaksanaan Data. ini
ciri diperkenalkan dengan MS Windows XP SP2 untuk sasaran i386 PE.

--tiada-pengasingan
Walaupun imej memahami pengasingan, jangan asingkan imej.

--tak-seh
Imej tidak menggunakan SEH. Tiada pengendali SE boleh dipanggil daripada ini
gambar.

--tidak-mengikat
Jangan ikat imej ini.

--wdmdriver
Pemacu menggunakan Model Pemacu MS Windows.

--tsaware
Imej itu diketahui oleh Pelayan Terminal.

--masukkan-cap masa
--tiada-masukkan-cap masa
Masukkan cap masa sebenar ke dalam imej. Ini adalah lalai
tingkah laku kerana ia sepadan dengan kod warisan dan ini bermakna imej itu
akan bekerja dengan alat proprietari yang lain. Masalah dengan ini
lalai ialah ia akan menghasilkan imej yang sedikit berbeza
dihasilkan setiap kali sumber yang sama dikaitkan. Pilihannya
--tiada-masukkan-cap masa boleh digunakan untuk memasukkan nilai sifar untuk
cap waktu, ini memastikan binari dihasilkan daripada yang serupa
sumber akan membandingkan secara sama.

Sasaran C6X uClinux menggunakan format binari yang dipanggil DSBT untuk menyokong
perpustakaan kongsi. Setiap perpustakaan kongsi dalam sistem perlu mempunyai a
indeks unik; semua boleh laku menggunakan indeks 0.

--dsbt-saiz saiz
Pilihan ini menetapkan bilangan entri dalam DSBT semasa
perpustakaan boleh laksana atau kongsi kepada saiz. Lalai adalah untuk mencipta a
jadual dengan 64 penyertaan.

--dsbt-index indeks
Pilihan ini menetapkan indeks DSBT bagi boleh laksana atau kongsi semasa
perpustakaan ke indeks. Lalai ialah 0, yang sesuai untuk
menjana boleh laku. Jika perpustakaan kongsi dijana dengan a
Indeks DSBT 0, relok "R_C6000_DSBT_INDEX" disalin ke dalam
fail keluaran.

. --no-merge-exidx-entry suis melumpuhkan penggabungan
entri exidx bersebelahan dalam info unwind frame.

Penyambung 68HC11 dan 68HC12 menyokong pilihan khusus untuk mengawal
pemetaan penukaran bank memori dan penjanaan kod trampolin.

--tiada-trampolin
Pilihan ini melumpuhkan penjanaan trampolin. Secara lalai a
trampolin dijana untuk setiap fungsi jauh yang dipanggil menggunakan
arahan "jsr" (ini berlaku apabila penunjuk ke fungsi jauh
diambil).

--tetingkap bank nama
Pilihan ini menunjukkan kepada pemaut nama kawasan memori
dalam MEMORY spesifikasi yang menerangkan tetingkap bank memori.
Takrifan wilayah tersebut kemudiannya digunakan oleh penghubung untuk mengira
halaman dan alamat dalam tetingkap memori.

Pilihan berikut disokong untuk mengawal pengendalian GOT
penjanaan apabila memaut untuk sasaran 68K.

--dapat=jenis
Pilihan ini memberitahu pemaut skema penjanaan GOT yang hendak digunakan.
jenis harus menjadi salah satu daripada tunggal, negatif, multigot or sasaran. Untuk
maklumat lanjut rujuk entri Info untuk ld.

Pilihan berikut disokong untuk mengawal arahan microMIPS
generasi apabila memaut untuk sasaran MIPS.

--insn32
--no-insn32
Pilihan ini mengawal pilihan arahan microMIPS yang digunakan dalam
kod yang dijana oleh pemaut, seperti itu dalam PLT atau malas
rintisan mengikat, atau dalam kelonggaran. Jika --insn32 digunakan, maka
penghubung hanya menggunakan pengekodan arahan 32-bit. Secara lalai atau jika
--no-insn32 digunakan, semua pengekodan arahan digunakan, termasuk
16-bit jika boleh.

PERSEKITARAN

Anda boleh mengubah tingkah laku ld dengan pembolehubah persekitaran
"GNUTARGET", "LDEMULATION" dan "COLLECT_NO_DEMANGLE".

"GNUTARGET" menentukan format objek fail input jika anda tidak menggunakan -b
(atau sinonimnya --format). Nilainya hendaklah salah satu daripada nama BFD
untuk format input. Jika tiada "GNUTARGET" dalam persekitaran, ld
menggunakan format semula jadi sasaran. Jika "GNUTARGET" ditetapkan kepada
"lalai" kemudian BFD cuba menemui format input dengan memeriksa
fail input binari; kaedah ini selalunya berjaya, tetapi ada potensi
kekaburan, kerana tiada kaedah untuk memastikan nombor ajaib itu
digunakan untuk menentukan format fail objek adalah unik. Walau bagaimanapun
prosedur konfigurasi untuk BFD pada setiap sistem meletakkan yang konvensional
format untuk sistem itu terlebih dahulu dalam senarai carian, jadi kekaburan adalah
diselesaikan memihak kepada konvensyen.

"LDEMULATION" menentukan emulasi lalai jika anda tidak menggunakan -m
pilihan. Emulasi boleh mempengaruhi pelbagai aspek tingkah laku penghubung,
terutamanya skrip pemaut lalai. Anda boleh menyenaraikan yang ada
emulasi dengan --verbose or -V pilihan. Sekiranya -m pilihan tidak
digunakan, dan pembolehubah persekitaran "LDEMULASI" tidak ditakrifkan, iaitu
emulasi lalai bergantung pada cara pemaut dikonfigurasikan.

Biasanya, pemaut akan lalai kepada demangling simbol. Namun, jika
"COLLECT_NO_DEMANGLE" ditetapkan dalam persekitaran, maka ia akan lalai
untuk tidak demangling simbol. Pembolehubah persekitaran ini digunakan dalam a
fesyen serupa oleh program pembalut pemaut "gcc". Lalai mungkin
ditindih oleh --demangle and --tiada-demangle pilihan.

Gunakan i686-linux-gnu-ld dalam talian menggunakan perkhidmatan onworks.net