Chương 5. Các tệp khác trong thư mục debian

Một trong những điều gây phiền phức nhất về phần mềm là khi bạn đã dành rất nhiều thời gian và nỗ lực để cấu hình một chương trình, và khi nâng cấp phần mềm thì mọi thay đổi của bạn bị đè. Debian giải quyết vấn đề này bằng cách gọi các tập tin cấu hình trong gói là conffiles. ^[55] Khi bạn nâng cấp một gói, bạn sẽ được hỏi rằng bạn có muốn giữ các tệp cấu hình cũ (hiện tại) hay không.

dh_installdeb(1) tự động đánh dâu bất kỳ tệp nào trong thư mục /etc là conffiles, vậy nếu chương trình của bạn có conffiles ở đây, bạn không cần thiết phải thêm chúng vào trong tệp này. Hầu hết các loại gói, nơi lưu trữ conffiles duy nhất nên là /etc, và vì thế tệp này không cần thiết phải tồn tại

Nếu chương trình của bạn sử dụng các tệp cấu hình nhưng cũng viết lại chúng như là cơ sở dư liệu, tốt nhất bạn không nên định nghĩa chúng là conffiles vì ​​dpkg sẽ nhắc nhở người dùng xác minh các thay đổi mọi lúc.

Nếu chương trình bạn đang đóng gói đòi hỏi mỗi người dùng chỉnh sửa các tập tin cấu hình trong thư mục /etc, có hai cách phổ biến để định nghĩ chúng không phải là conffiles, giữ dpkg yên tĩnh:

Để biêt thêm thông tin về maintainer scripts, xem Phần 5.18, “{pre,post}{inst,rm}”.

Các tệp này được liệt kê trong tệp install không cần thư mục của chúng đuợc tạo trước. Xem Phần 5.11, “install”.

Tốt nhất là thử cài đặt trước và chỉ sửa dụng điều này nếu bạn gặp rắc rối. Không có dấu gạch chéo trước tên thư mục được liệt kê trong dirs

Document: gentoo
Title: Gentoo Manual
Author: Emil Brink
Abstract: This manual describes what Gentoo is, and how it can be used.
Section: File Management
Format: HTML
Index: /usr/share/doc/gentoo/html/index.html
Files: /usr/share/doc/gentoo/html/*.html

Để biết thêm chi tiết về cài đặt tài liệu bổ sung, vui lòng xem Phần 3.3, “Cài đặt các tệp tin đến đích của chúng”

Tệp package.init được cài đặt vào kịch bản /etc/init.d/package mà có thể starts và stops tiếng trình daemon. Một bộ khung mẫu được cung cấp bởi lệnh dh_make là init.d.ex. Bạn sẽ có thể phải đổi tên và chỉnh sửa nó, khá nhiều, trong khi đảm bảo cung cấp header phù hợp với Linux Standard Base (LSB). Nó được cài đặt vào thư mục tạm thời bởi dh_installinit(1).

Tệp package.default sẽ được cài đặt vào /etc/default/package. Tệp này cài đặt mặc định được sử dụng bởi kịch bản init. Tệp package.default thường được sử dụng để vô hiệu hoá một daemon đang chạy, hoặc cài đặt vài tuỳ chọn mặc định hoặc độ trê. Nếu kịch bản init của bạn có các tính năng cấu hình nhất định, bạn có thể cài chúng vào tệppackage.default, thay vì viết trực tiếp vào chính kịch bản init.

Nếu chương trình của bạn cung cấp một tệp cho kịch bản init, bạn cũng có thể sử dụng nó hoặc không. Nếu bạn không sử dụng kịch bản init của họ thì hãy tạo một tệp là package.init. Tuy nhiên nếu kịch bản init của thượng nguồn trông ổn và để đúng vị trí, bạn vẫn cần cài đặt liên kết tượng trưng rc*. Để làm điểu này bạn cần phải ghi đè dh_installinit trong tệp rules với các dòng sau:

override_dh_installinit:
        dh_installinit --onlyscripts

Nếu bạn không cần nó, hãy xoá những tệp này.

Nếu những tệp tin này cần được cài đặt vào trong gói của bạn nhưng make install của bạn sẽ không làm điều đó. Vậy hãy đặt các tên tập tin và đích của nó vào tệp install này, chúng sẽ được cài đặt bởi dh_install(1).^[56] Bạn nên kiểm tra có hay không cách khác cụ thể hơn để sử dụng trước. Ví dụ, các tài liệu nên đặt ở docs chứ không phải trong tệp này.

Mỗi dòng trong tệp install thể hiện cho mỗi tệp được cài đặt, mỗi dòng bắt đầu với tên của tệp nguồn (tương đối với thư mục build) sao đó một dấu cách (phím space) và tiếp theo là vị trí thư mục đích sẽ được cài đặt (tương đối với thư mục cài đặt). Một ví dụ như tệp nhị phân src/bar muốn cài đặt; tệp install trông giống như sau:

src/bar usr/bin

Nghĩa là khi gói này được cài đặt, sẽ có một lệnh thực thi ở /usr/bin/bar.

Ngoài ra, tệp install có thể chứa tên của tệp tin mà không có thư mục đích để cài đặt khi thư mục tương đối không thay đổi. Định dạng này thường được sử dụng cho một gói lớn phân chia đầu ra của gói của nó thành nhiều gói nhị phân bằng cách sử dụng package-1.install, package-2.install, vân vân.

Lệnh dh_install sẽ tìm laị trong thư mục debian/tmp, nếu nó không tìm thấy chúng trong thư mục hiện tại, (hoặc bạn đã nói với nó qua tuỳ chọn --sourcedir).

Các tệp postinst, preinst, postrm và prerm ^[58] được gọi là maintainer scripts. Chúng là các kịch bản được đặt trong vùng điều khiển của gói và sẽ được chạy bởi dpkg khi gói của bạn được cài đặt, nâng cấp hoặc xóa.

Là một chuyên gia bảo trì, bạn nên tránh bất kỳ chỉnh sửa thủ công các tập lệnh bảo trì vì chúng dễ xảy ra vấn đề. Để biết thêm thông tin, hãy tham khảo Debian Policy Manual, 6 "Package maintainer scripts and installation procedure", và xem các tệp ví dụ được cung cấp bởi dh_make.

Nếu bạn không lắng nghe tôi và đã tạo ra tập lệnh bảo trì tuỳ chỉnh cho một gói, bạn nên chắc chắn kiểm tra chúng không chỉ với install và upgrade mà còn remove và purge.

Nâng cấp lên phiên bản mới nên silent (lặng lẽ, ổn định) và không phá vỡ (để các người dùng không cần chú ý nâng cấp ngoại trừ việc phát hiện ra rằng lỗi cũ đã được khắc phục và có thể có các tính năng mới).

Khi sự nâng cấp cần thiết việc xâm nhập (ví dụ: các tập tin cấu hình rải rác thông qua các thư mục chính của người dùng với cấu trúc hoàn toàn khác), và bạn có thể coi đây là phương án cuối cùng để chuyển gói sang trạng thái dự phòng an toàn (ví dụ như vô hiệu hóa dịch vụ) và cung cấp tài liệu thích hợp theo yêu cầu của chính sách (README.Debian và NEWS.Debian). Đừng làm phiền người dùng với các câu hỏi debconf được gọi từ các tập lệnh bảo trì để nâng cấp.

Gói ucf cung cấp conffile-like xử lý hạ tầng để ngăn người dùng thay đổi các tệp mà không được gắn nhãn conffiles chẳng hạn như những tài liệu được quản lý bởi các kịch bản bảo trì. Điều này sẽ giảm thiếu các vấn đề phát sinh.

Các kịch bản bảo trì nằm trong số các cải tiến Debian nhằm giải thích tại sao mọi người chọn Debian. Bạn phải thật cẩn thận để không biết chúng thành nguồn gây phiền toái.

Việc đóng gói một thư viện là không dễ dàng cho người bảo trì mới làm quen và nên tránh. Còn nếu gói của bạn có các thử viện, bạn nên có tệp debian/package.symbols. Xem Phần A.2, “Quản lý debian/package.symbols”.

Định dạng tệp watch là tài liệu uscan(1). Tệp watch cấu hình chương trình uscan (có trong gói devscripts) để theo dõi trang web mà bạn lấy nguồn. Nó cũng được sử dụng bởi dịch vụ Debian Package Tracker.

Đây là nội dung của nó:

# watch control file for uscan
version=3
http://sf.net/gentoo/gentoo-(.+)\.tar\.gz debian uupdate

Thông thường với một tệp watch, đường dẫn URL tại http://sf.net/gentoo được tải về và tìm kiểm cho các liên kết theo biểu mẫu <a href=...>. Tên (phần phía sau của đường dẫn /) của mỗi liên kết URL được so sánh với mẫu biểu thức chính quy Perl (xem perlre(1))gentoo-(.+)\.tar\.gz. Trong số các tệp phù hợp, tệp đượctải xuống có số phiên bản lớn nhất và chương trình uupdateđược chạy để tạo một bản nguồn đã được cập nhật.

Mặc dù điều này là đúng cho vài trang web, dịch vụ tải của SourceForge tại http://sf.net là một ngoại lệ. Khi tệp watch chứa một đường dẫn URL khớp với biểu thức chính quy Perl ^http://sf\.net/, chương trình uscan thay thế nó với http://qa.debian.org/watch/sf.php/ và sau đó áp dụng quy tắc này. Dịch vụ chuyển hướng URL tại http://qa.debian.org/ được thiết kế để cung cấp dịch vụ ổn định đến tệp mong muốn với bất kỳ watch mẫu biểu thức http://sf.net/project/tar-name-(.+)\.tar\.gz. Điều này giải quyết các vấn đề liên quan đế thay đổi định kỳ các đường dẫn SourceForge.

Nếu thượng nguồn cung cấp chữ ký mật mã của tarball, bạn nên xác minh tính xác thực của nó bằng cách sử dụng tùy chọn pgpsigurlmangle như mô tả trong uscan(1).

Định dạng 3.0 (quilt) mới sẽ ghi lại các sửa đổi trong một loạt bản vá lỗi quilt trong thư mục debian/patches . Những thay đổi này sau đó sẽ tự động được áp dụng trong quá trình giải nén gói nguồn. ^[59] Các sửa đổi Debian chỉ đơn giản được lưu trữ trong kho lưu trữ debian.tar.gz chứa tất cả các tệp tin trong thư mục debian. Định dạng mới này hỗ trợ đưa các tệp tin nhị phân như các biểu tượng PNG của người bảo trì gói mà không yêu cầu thủ thuật. ^[60]

Khi dpkg-source giải nén một gói nguồn trong định dạng nguồn 3.0 (quilt), nó sẽ tự động áp dụng tất cả các bản vá được liệt kê trong debian patches/series. Bạn có thể bỏ qua việc áp dụng các bản vá ở cuối quá trình giải nén với tùy chọn --skip-patches.

Các tệp được tự động sinh trong cây nguồn có thể gây khó chịu cho đóng gói vì chúng tạo ra các tệp vá lỗi không có ý nghĩa. Có các mô đun tùy chỉnh như dh_autoreconf nhằm giải quyết các vấn đề này như mô tả trong Phần 4.4.3, “Tuỳ chỉnh tệp rules”.

Bạn có thể cung cấp một biểu thức chính quy Perl là đối số của tùy chọn --extend-diff-ignore khi chạy dpkg-source (1) để bỏ qua các thay đổi được thực hiện đối với các tệp được tạo tự động trong khi tạo gói nguồn.

Như một giải pháp chung để giải quyết vấn đề của các tệp tự động tạo mới, bạn có thể lưu trữ một đối số tùy chọn dpkg-source trong tệp tin source/options . Ví dụ sau sẽ bỏ qua việc tạo tệp vá cho config.sub, config.guess và Makefile.

extend-diff-ignore = "(^|/)(config\.sub|config\.guess|Makefile)$"

Định dạng mới 3.0 (quilt) sẽ lưu các bản vá lỗi vào các tệp debian/patches/* bằng cách sử dụng công cụ quilt. Các bản vá này và các dữ liệu gói khác nằm trong thư mục debian được đóng gói dưới dạng tệp debian.tar.gz. Do lệnh dpkg-source có thể xử lý dữ liệu vá lỗi định dạng của quilt trong định dạng 3.0 (quilt) mà không cần tới gói quilt, nó không cần quilt ở trong mục Build-Depends. ^[61]

Lệnh quilt được giải thích trong quilt(1). Nó ghi chép lại các thay đổi của mã nguồn và tạo thành các bản vá -p1 trong thư mục debian/patches và cây mã nguồn không bị ảnh hưởng ngoại trừ thư mục debian. Trình tự áp dụng bản vá được ghi lại tại tệp debian/patches/series. Bạn có thể áp dụng (=push), un-apply (=pop), và làm mới một các dễ dàng. ^[62]

Đối với Chương 3, Sửa đổi mã nguồn, chúng tôi đã tạo ba bản vá lỗi trong debian/patches.

Vì các bản vá lỗi của Debian được đặt trong debian/patches, hãy đảm bảo thiết lập lệnh dquilt đúng như mô tả trong Phần 3.1, “Cài đặt quilt”.

Khi mọi người (kể cả bạn) cung cấp một bản vá lỗi mới foo.patch cho mã nguồn, áp dụng cho mã nguồn định dạng gói nguồn 3.0 (quilt) khá đơn giản:

$ dpkg-source -x gentoo_0.9.12.dsc
$ cd gentoo-0.9.12
$ dquilt import ../foo.patch
$ dquilt push
$ dquilt refresh
$ dquilt header -e
... describe patch

Các bản vá được lưu trữ trong phiên bản mới 3.0 (quilt) phải là fuzz tự do. Bạn có thể đảm bảo điều này với dquilt pop -a; while dquilt push; do dquilt refresh; done.