dh - Dalam talian di Awan

JADUAL:

NAMA

dh - penjujukan arahan debhelper

SINOPSIS

dh turutan [--dengan addon[,addon ...]] [--senarai] [pilihan debhelper]

DESCRIPTION

dh menjalankan urutan perintah debhelper. Yang disokong turutans sesuai dengan
sasaran a debian/peraturan fail: membina-gerbang, bina-indep, membina, membersihkan, pasang-indep,
pasang-gerbang, memasang, binary-arch, binari-indep, dan perduaan.

TINGGALKAN SASARAN

A debian/peraturan fail menggunakan dh boleh mengatasi arahan yang dijalankan pada mana-mana langkah dalam a
urutan, dengan mentakrifkan sasaran penggantian.

Untuk mengatasi perintah_dh, tambahkan sasaran bernama override_perintah_dh kepada fail peraturan. Bila ia
biasanya akan berjalan perintah_dh, dh sebaliknya akan memanggil sasaran itu. Sasaran override boleh
kemudian jalankan arahan dengan pilihan tambahan, atau jalankan arahan yang sama sekali berbeza.
Lihat contoh di bawah.

Gantikan sasaran juga boleh ditakrifkan untuk dijalankan hanya apabila membina seni bina bergantung atau
pakej bebas seni bina. Gunakan sasaran dengan nama seperti override_perintah_dh-gerbang
and override_perintah_dh-indep. (Perhatikan bahawa untuk menggunakan ciri ini, anda harus Build-Depend on
debhelper 8.9.7 atau lebih tinggi.)

PILIHAN

--dengan addon[,addon ...]
Tambahkan arahan debhelper yang ditentukan oleh addon yang diberikan ke tempat yang sesuai dalam
urutan arahan yang dijalankan. Pilihan ini boleh diulang lebih daripada sekali, atau
berbilang tambahan boleh disenaraikan, dipisahkan dengan koma. Ini digunakan apabila terdapat a
pakej pihak ketiga yang menyediakan arahan debhelper. Lihat PROGRAMMING fail untuk
dokumentasi tentang antara muka addon jujukan.

--tanpa addon
Songsang daripada --dengan, melumpuhkan menggunakan addon yang diberikan. Pilihan ini boleh diulang
lebih daripada sekali, atau berbilang alat tambah untuk dilumpuhkan boleh disenaraikan, dipisahkan dengan koma.

--senarai, -l
Senaraikan semua tambahan yang tersedia.

--tidak-bertindak
Mencetak arahan yang akan dijalankan untuk urutan tertentu, tetapi tidak menjalankannya.

Ambil perhatian bahawa dh lazimnya melangkau arahan yang ia tahu tidak akan melakukan apa-apa. Dengan
--no-act, senarai penuh arahan dalam urutan dicetak.

Pilihan lain diserahkan kepada dh diteruskan kepada setiap arahan yang dijalankannya. Ini boleh digunakan untuk menetapkan
pilihan seperti -v or -X or -N, serta untuk pilihan yang lebih khusus.

CONTOH

Untuk melihat arahan yang disertakan dalam urutan, tanpa melakukan apa-apa:

dh binary-arch --no-act

Ini adalah fail peraturan yang sangat mudah, untuk pakej dengan urutan lalai arahan
bekerja tanpa pilihan tambahan.

#!/usr/bin/make -f
%:
dh $@

Selalunya anda ingin menghantar pilihan kepada arahan debhelper tertentu. Cara yang mudah untuk dilakukan
dengan adalah dengan menambahkan sasaran penggantian untuk arahan itu.

#!/usr/bin/make -f
%:
dh $@

override_dh_strip:
dh_strip -Xfoo

override_dh_auto_configure:
dh_auto_configure -- --with-foo --disable-bar

Kadang-kadang automatik dh_auto_configure(1) dan dh_auto_build(1) tidak dapat meneka apa yang perlu dilakukan
untuk pakej pelik. Berikut ialah cara untuk mengelak daripada berlari sama ada dan sebaliknya menjalankan sendiri
menyuruh.

#!/usr/bin/make -f
%:
dh $@

override_dh_auto_configure:
./mondoconfig

override_dh_auto_build:
buat alam semesta-meletup-dalam-nikmat

Satu lagi kes biasa ialah ingin melakukan sesuatu secara manual sebelum atau selepas sesuatu
arahan debhelper dijalankan.

#!/usr/bin/make -f
%:
dh $@

override_dh_fixperms:
dh_fixperms
chmod 4755 debian/foo/usr/bin/foo

Jika pakej anda menggunakan autotools dan anda ingin menyegarkan config.sub and config. guess bersama
versi yang lebih baru daripada autotools-dev pakej pada masa binaan, anda boleh menggunakan beberapa arahan
disediakan dalam autotools-dev yang mengautomasikannya, seperti ini.

#!/usr/bin/make -f
%:
dh $@ --dengan autotools_dev

Alat Python tidak dijalankan oleh dh secara lalai, disebabkan oleh perubahan berterusan di kawasan itu.
(Sebelum tahap keserasian v9, dh berjalan dh_pysupport.) Inilah cara untuk menggunakan dh_python2.

#!/usr/bin/make -f
%:
dh $@ --dengan python2

Berikut ialah cara memaksa penggunaan Perl Modul::Bina membina sistem, yang boleh diperlukan jika
debhelper tersalah mengesan bahawa pakej menggunakan MakeMaker.

#!/usr/bin/make -f
%:
dh $@ --buildsystem=perl_build

Berikut ialah contoh mengatasi di mana dh_auto_* arahan mencari sumber pakej,
untuk pakej di mana sumber terletak dalam subdirektori.

#!/usr/bin/make -f
%:
dh $@ --sourcedirectory=src

Dan berikut adalah contoh bagaimana untuk memberitahu dh_auto_* arahan untuk membina dalam subdirektori,
yang akan dikeluarkan pada membersihkan.

#!/usr/bin/make -f
%:
dh $@ --builddirectory=build

Jika pakej anda boleh dibina secara selari, sila sama ada gunakan compat 10 atau pass --selari
ke dh. Kemudian dpkg-buildpackage -j akan bekerja.

#!/usr/bin/make -f
%:
dh $@ --selari

Jika pakej anda tidak boleh dibina dengan pasti semasa menggunakan berbilang benang, sila lulus
--tidak selari kepada dh (atau yang berkaitan dh_auto_* arahan):

#!/usr/bin/make -f
%:
dh $@ --tidak selari

Berikut adalah cara untuk mencegah dh daripada menjalankan beberapa arahan yang anda tidak mahu ia dijalankan,
dengan menentukan sasaran penggantian kosong untuk setiap arahan.

#!/usr/bin/make -f
%:
dh $@

# Perintah untuk tidak dijalankan:
override_dh_auto_test override_dh_compress override_dh_fixperms:

Proses binaan yang panjang untuk pakej dokumentasi yang berasingan boleh diasingkan menggunakan
seni bina mengatasi bebas. Ini akan dilangkau apabila menjalankan build-arch dan
jujukan binari-arka.

#!/usr/bin/make -f
%:
dh $@

override_dh_auto_build-indep:
$(MAKE) -C dokumen

# Tiada ujian diperlukan untuk dokumen
override_dh_auto_test-indep:

override_dh_auto_install-indep:
$(MAKE) -C pemasangan docs

Menambah contoh di atas, katakan anda perlu chmod fail, tetapi hanya apabila membina fail
pakej bergantung kepada seni bina, kerana ia tidak hadir semasa membina dokumentasi sahaja.

override_dh_fixperms-arch:
dh_fixperms
chmod 4755 debian/foo/usr/bin/foo

DALAMAN

Jika anda ingin tahu tentang dhdalaman, berikut ialah cara ia berfungsi di bawah tudung.

Setiap arahan debhelper akan merekodkan apabila ia berjaya dijalankan
debian/package.debhelper.log. (Yang dh_bersih memadam.) Jadi dh boleh memberitahu arahan yang ada
telah dijalankan, untuk pakej yang mana, dan langkau menjalankan arahan tersebut sekali lagi.

Setiap masa dh dijalankan, ia memeriksa log, dan mencari arahan log terakhir yang ada dalam
urutan yang ditentukan. Ia kemudian diteruskan dengan arahan seterusnya dalam urutan. The --sehingga,
--sebelum ini, --selepas, dan --yang tinggal pilihan boleh mengatasi tingkah laku ini.

Urutan juga boleh menjalankan sasaran bergantung dalam debian/peraturan. Sebagai contoh, "perduaan"
urutan menjalankan sasaran "pasang".

dh menggunakan DH_INTERNAL_OPTIONS pembolehubah persekitaran untuk menghantar maklumat melalui
arahan debhelper yang dijalankan di dalam mengatasi sasaran. Kandungan (dan sesungguhnya,
kewujudan) pembolehubah persekitaran ini, seperti namanya, tertakluk kepada perubahan
pada bila bila masa.

Perintah dalam bina-indep, pasang-indep and binari-indep urutan dilalui -i
pilihan untuk memastikan ia hanya berfungsi pada pakej bebas seni bina, dan arahan dalam
membina-gerbang, pasang-gerbang and binary-arch urutan dilalui -a pilihan untuk memastikan mereka
hanya berfungsi pada pakej bergantung pada seni bina.

TERDAPAT PILIHAN

Pilihan berikut telah ditamatkan. Adalah lebih baik untuk menggunakan sasaran penggantian sebaliknya.
Mereka tidak tersedia dalam compat 10.

--sehingga cmd
Jalankan arahan dalam urutan sehingga dan termasuk cmd, kemudian berhenti.

--sebelum ini cmd
Jalankan arahan dalam urutan sebelum cmd, kemudian berhenti.

--selepas cmd
Jalankan arahan dalam urutan yang datang selepas cmd.

--yang tinggal
Jalankan semua arahan dalam urutan yang masih belum dijalankan.

Dalam pilihan di atas, cmd boleh menjadi nama penuh perintah debhelper, atau subrentetan. Ia akan
mula-mula cari arahan dalam urutan yang betul-betul sepadan dengan nama, untuk mengelakkan sebarang
kekaburan. Jika terdapat berbilang padanan subrentetan, yang terakhir dalam urutan itu ialah
terpakai.

Guna dh dalam talian menggunakan perkhidmatan onworks.net