dh - Trực tuyến trên đám mây

CHƯƠNG TRÌNH:

TÊN

dh - trình tự sắp xếp lệnh debhelper

SYNOPSIS

dh trình tự [--với addon[,addon ...]] [--danh sách] [tùy chọn gỡ lỗi]

MÔ TẢ

dh chạy một chuỗi lệnh gỡ lỗi. Được hỗ trợ trình tựs tương ứng với
mục tiêu của một debian / quy tắc tập tin: xây dựng vòm, xây dựng, xây dựng, giống cá lăng, cài đặt độc lập,
cài đặt vòm, cài đặt, dựng lên, nhị phân, nhị phân độc lậpvà nhị phân.

GHI ĐÈ MỤC TIÊU

A debian / quy tắc tập tin sử dụng dh có thể ghi đè lệnh được chạy ở bất kỳ bước nào trong
trình tự, bằng cách xác định một mục tiêu ghi đè.

Ghi đè dh_lệnh, thêm một mục tiêu có tên ghi đè_dh_lệnh vào tệp quy tắc. Khi nó
bình thường sẽ chạy dh_lệnh, dh thay vào đó sẽ gọi mục tiêu đó. Mục tiêu ghi đè có thể
sau đó chạy lệnh với các tùy chọn bổ sung hoặc chạy các lệnh hoàn toàn khác thay thế.
Xem ví dụ bên dưới.

Mục tiêu ghi đè cũng có thể được xác định để chạy chỉ khi xây dựng phụ thuộc vào kiến ​​trúc hoặc
các gói độc lập về kiến ​​trúc. Sử dụng các mục tiêu có tên như ghi đè_dh_lệnh-sao
và ghi đè_dh_lệnh-độc lập. (Lưu ý rằng để sử dụng tính năng này, bạn nên Xây dựng-Phụ thuộc vào
debhelper 8.9.7 trở lên.)

LỰA CHỌN

--với addon[,addon ...]
Thêm các lệnh gỡ lỗi được chỉ định bởi addon đã cho vào những vị trí thích hợp trong
chuỗi lệnh được chạy. Tùy chọn này có thể được lặp lại nhiều lần, hoặc
nhiều addon có thể được liệt kê, phân tách bằng dấu phẩy. Điều này được sử dụng khi có
gói của bên thứ ba cung cấp các lệnh gỡ lỗi. Xem CHƯƠNG TRÌNH nộp cho
tài liệu về giao diện addon trình tự.

--không có addon
Sự nghịch đảo của --với, vô hiệu hóa bằng cách sử dụng addon đã cho. Tùy chọn này có thể được lặp lại
nhiều hơn một lần hoặc nhiều phần bổ trợ cần tắt có thể được liệt kê, phân tách bằng dấu phẩy.

--danh sách, -l
Liệt kê tất cả các addon có sẵn.

- không hành động
In các lệnh sẽ chạy cho một trình tự nhất định, nhưng không chạy chúng.

Lưu ý rằng dh thường bỏ qua các lệnh đang chạy mà nó biết sẽ không làm gì cả. Với
--no-action, danh sách đầy đủ các lệnh trong một chuỗi sẽ được in.

Các tùy chọn khác được chuyển đến dh được chuyển cho mỗi lệnh mà nó chạy. Điều này có thể được sử dụng để thiết lập
một lựa chọn như -v or -X or -N, cũng như các tùy chọn chuyên biệt hơn.

VÍ DỤ

Để xem những lệnh nào được bao gồm trong một chuỗi mà không thực sự làm bất cứ điều gì:

dh binary-Arch --no-action

Đây là một tệp quy tắc rất đơn giản, dành cho các gói trong đó chuỗi lệnh mặc định
làm việc mà không có tùy chọn bổ sung.

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

Thường thì bạn sẽ muốn chuyển một tùy chọn cho một lệnh gỡ lỗi cụ thể. Cách dễ dàng để làm
với là bằng cách thêm một mục tiêu ghi đè cho lệnh đó.

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

ghi đè_dh_strip:
dh_strip -Xfoo

ghi đè_dh_auto_configure:
dh_auto_configure - --with-foo --disable-bar

Đôi khi tự động dh_auto_configure(1) dh_auto_build(1) không thể đoán phải làm gì
cho một gói lạ. Đây là cách để tránh chạy một trong hai và thay vào đó chạy của riêng bạn
lệnh.

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

ghi đè_dh_auto_configure:
./mondoconfig

ghi đè_dh_auto_build:
làm cho vũ trụ-bùng nổ-trong-niềm-vui

Một trường hợp phổ biến khác là muốn làm điều gì đó theo cách thủ công trước hoặc sau một
lệnh debhelper được chạy.

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

ghi đè_dh_fixperms:
dh_fixperms
chmod 4755 debian / foo / usr / bin / foo

Nếu gói của bạn sử dụng công cụ tự động và bạn muốn làm mới config.sub và config.guess với
phiên bản mới hơn từ autotools-dev gói tại thời điểm xây dựng, bạn có thể sử dụng một số lệnh
cung cấp autotools-dev tự động hóa nó, như thế này.

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

Các công cụ Python không được chạy bằng dh theo mặc định, do sự thay đổi liên tục trong lĩnh vực đó.
(Trước khi mức tương thích v9, dh chạy dh_pysupport.) Đây là cách sử dụng dh_python2.

#!/ usr / bin / make -f
%:
dh $ @ - với python2

Đây là cách bắt buộc sử dụng Perl's Mô-đun :: Xây dựng xây dựng hệ thống, có thể cần thiết nếu
debhelper phát hiện sai rằng gói sử dụng MakeMaker.

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

Đây là một ví dụ về ghi đè nơi dh_auto_* lệnh tìm nguồn của gói,
cho một gói mà nguồn nằm trong một thư mục con.

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

Và đây là một ví dụ về cách nói dh_auto_* các lệnh để xây dựng trong một thư mục con,
cái nào sẽ bị xóa vào giống cá lăng.

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

Nếu gói của bạn có thể được xây dựng song song, vui lòng sử dụng compat 10 hoặc vượt qua --song song
sang dh. sau đó dpkg-buildpackage -j sẽ làm việc.

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

Nếu gói của bạn không thể được xây dựng một cách đáng tin cậy trong khi sử dụng nhiều luồng, vui lòng chuyển
- không song song sang dh (hoặc liên quan dh_auto_* yêu cầu):

#!/ usr / bin / make -f
%:
dh $ @ - không song song

Đây là một cách để ngăn chặn dh khỏi việc chạy một số lệnh mà bạn không muốn nó chạy,
bằng cách xác định các mục tiêu ghi đè trống cho mỗi lệnh.

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

# Các lệnh không chạy:
ghi đè_dh_auto_test ghi đè_dh_compress ghi đè_dh_fixperms:

Một quá trình xây dựng dài cho một gói tài liệu riêng biệt có thể được tách ra bằng cách sử dụng
ghi đè độc lập kiến ​​trúc. Chúng sẽ bị bỏ qua khi chạy build-Arch và
chuỗi nhị phân-vòm.

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

ghi đè_dh_auto_build-indep:
Tài liệu $ (MAKE) -C

# Không cần kiểm tra tài liệu
ghi đè_dh_auto_test-indep:

ghi đè_dh_auto_install-indep:
$ (MAKE) -C cài đặt tài liệu

Thêm vào ví dụ trên, giả sử bạn cần chmod một tệp, nhưng chỉ khi tạo
gói phụ thuộc kiến ​​trúc, vì nó không xuất hiện khi chỉ xây dựng tài liệu.

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

NỘI BỘ

Nếu bạn tò mò về dhcủa bên trong, đây là cách nó hoạt động dưới mui xe.

Mỗi lệnh debhelper sẽ ghi lại khi nó chạy thành công trong
debian / package.debhelper.log. (Cái mà dh_sạch xóa.) Vì vậy dh có thể cho biết lệnh nào có
đã được chạy, cho gói nào và bỏ qua việc chạy lại các lệnh đó.

Mỗi lần dh được chạy, nó kiểm tra nhật ký và tìm lệnh được ghi cuối cùng trong
trình tự xác định. Sau đó, nó tiếp tục với lệnh tiếp theo trong chuỗi. Các --cho đến khi,
--trước, --sauvà - còn lại các tùy chọn có thể ghi đè hành vi này.

Một chuỗi cũng có thể chạy các mục tiêu phụ thuộc trong debian / rules. Ví dụ: "nhị phân"
trình tự chạy mục tiêu "cài đặt".

dh sử dụng DH_INTERNAL_OPTIONS biến môi trường để chuyển thông tin đến
lệnh debhelper được chạy bên trong các mục tiêu ghi đè. Nội dung (và thực sự,
sự tồn tại) của biến môi trường này, như tên có thể gợi ý, có thể thay đổi
bất cứ lúc nào.

Các lệnh trong xây dựng, cài đặt độc lập và nhị phân độc lập trình tự được thông qua -i
tùy chọn để đảm bảo chúng chỉ hoạt động trên các gói độc lập về kiến ​​trúc và các lệnh trong
xây dựng vòm, cài đặt vòm và nhị phân trình tự được thông qua -a tùy chọn để đảm bảo họ
chỉ hoạt động trên các gói phụ thuộc vào kiến ​​trúc.

KHÔNG DÙNG LỰA CHỌN

Các tùy chọn sau không được dùng nữa. Thay vào đó, tốt hơn nên sử dụng các mục tiêu ghi đè.
Họ là không có sẵn trong compat 10.

--cho đến khi cmd
Chạy các lệnh theo trình tự cho đến khi và bao gồm cmd, sau đó dừng lại.

--trước cmd
Chạy các lệnh trong trình tự trước cmd, sau đó dừng lại.

--sau cmd
Chạy các lệnh theo trình tự sau cmd.

- còn lại
Chạy tất cả các lệnh trong trình tự chưa được chạy.

Trong các tùy chọn trên, cmd có thể là tên đầy đủ của lệnh gỡ lỗi hoặc một chuỗi con. Nó sẽ
trước tiên hãy tìm kiếm một lệnh trong chuỗi khớp chính xác với tên, để tránh bất kỳ lệnh nào
sự mơ hồ. Nếu có nhiều chuỗi con phù hợp, chuỗi cuối cùng trong chuỗi sẽ là
đã sử dụng.

Sử dụng dh trực tuyến bằng các dịch vụ onworks.net