nguồn dpkg - Trực tuyến trên đám mây

CHƯƠNG TRÌNH:

TÊN

dpkg-source - Công cụ thao tác gói nguồn Debian (.dsc)

SYNOPSIS

dpkg-nguồn [tùy chọn...] lệnh

MÔ TẢ

dpkg-nguồn gói và giải nén các kho lưu trữ nguồn Debian.

Không có lệnh nào trong số này cho phép kết hợp nhiều tùy chọn thành một và chúng không
cho phép giá trị của một tùy chọn được chỉ định trong một đối số riêng.

HÀNG

-x, --trích xuất tên tập tin.dsc [thư mục đầu ra]
Trích xuất gói nguồn (--trích xuất kể từ dpkg 1.17.14). Một đối số không có tùy chọn
phải được cung cấp, tên của tệp kiểm soát nguồn Debian (.dsc). Một tùy chọn
đối số không phải tùy chọn thứ hai có thể được cung cấp để chỉ định thư mục để trích xuất
gói nguồn vào, điều này không được tồn tại. Nếu không có thư mục đầu ra được chỉ định,
gói nguồn được trích xuất vào một thư mục có tên nguồn-phiên bản dưới hiện tại
thư mục làm việc.

dpkg-nguồn sẽ đọc tên của (các) tệp khác tạo nên gói nguồn
từ tệp điều khiển; chúng được cho là nằm trong cùng thư mục với .dsc.

Các tệp trong gói được giải nén sẽ được đặt quyền và quyền sở hữu
đối với những thứ được mong đợi nếu các tập tin và thư mục chỉ đơn giản là
đã được tạo - các thư mục và tệp thực thi sẽ là 0777 và các tệp đơn giản sẽ
là 0666, cả hai đều được sửa đổi bởi ô của bộ trích xuất; nếu thư mục mẹ là setgid
thì các thư mục được giải nén cũng vậy, và tất cả các tập tin và thư mục sẽ
kế thừa quyền sở hữu nhóm của nó.

Nếu gói nguồn sử dụng định dạng không chuẩn (hiện tại điều này có nghĩa là tất cả các định dạng
ngoại trừ “1.0”), tên của nó sẽ được lưu trong debian / source / format vì vậy mà
các bản dựng sau của gói nguồn sử dụng cùng định dạng theo mặc định.

-b, --xây dựng thư mục [tham số định dạng cụ thể]
Xây dựng gói nguồn (--xây dựng kể từ dpkg 1.17.14). Đối số không phải tùy chọn đầu tiên
được lấy làm tên của thư mục chứa cây nguồn đã được gỡ lỗi (tức là
với thư mục con debian và có thể thay đổi các tệp gốc). Phụ thuộc vào
định dạng gói nguồn được sử dụng để xây dựng gói, các tham số bổ sung có thể là
được chấp nhận.

dpkg-nguồn sẽ xây dựng gói nguồn với định dạng đầu tiên được tìm thấy trong này
danh sách có thứ tự: định dạng được biểu thị bằng --định dạng tùy chọn dòng lệnh,
định dạng được chỉ định trong debian / source / format, “1.0”. Dự phòng cho “1.0” là
không được dùng nữa và sẽ bị xóa vào một thời điểm nào đó trong tương lai, bạn phải luôn
ghi lại định dạng nguồn mong muốn trong debian / source / format. Xem phần SOURCE
GÓI M FORU ĐƠN để có mô tả chi tiết về các định dạng gói nguồn khác nhau.

--định dạng in thư mục
In định dạng nguồn sẽ được sử dụng để xây dựng gói nguồn nếu
dpkg-nguồn --xây dựng thư mục được gọi (trong cùng điều kiện và với cùng
thông số; kể từ dpkg 1.15.5).

- trước khi xây dựng thư mục
Chạy hook tương ứng của định dạng gói nguồn (kể từ dpkg 1.15.8). Cái này
hook được gọi trước bất kỳ bản dựng nào của gói (dpkg-buildpackage gọi nó rất
sớm thậm chí trước đó debian / quy tắc giống cá lăng). Lệnh này bình thường và có thể được gọi
nhiều lần. Không phải tất cả các định dạng nguồn đều triển khai điều gì đó trong hook này và những định dạng đó
chẳng hạn thường chuẩn bị cây nguồn cho bản dựng bằng cách đảm bảo rằng
các bản vá Debian được áp dụng.

- sau xây dựng thư mục
Chạy hook tương ứng của định dạng gói nguồn (kể từ dpkg 1.15.8). Cái này
hook được gọi sau bất kỳ bản dựng nào của gói (dpkg-buildpackage gọi nó cuối cùng).
Lệnh này bình thường và có thể được gọi nhiều lần. Không phải tất cả các định dạng nguồn
thực hiện điều gì đó trong hook này và những điều thường sử dụng nó để hoàn tác những gì
- trước khi xây dựng đã làm.

--làm [thư mục] ...
Ghi lại những thay đổi trong cây nguồn được giải nén trong thư mục (kể từ dpkg 1.16.1). Cái này
lệnh có thể lấy các tham số bổ sung tùy thuộc vào định dạng nguồn. Nó sẽ
lỗi đối với các định dạng mà thao tác này không có ý nghĩa gì.

-?, --Cứu giúp
Hiển thị thông báo sử dụng và thoát.

--phiên bản
Hiển thị phiên bản và thoát.

LỰA CHỌN

Chung xây dựng lựa chọn
-ckiểm soát-tập tin
Chỉ định tệp kiểm soát nguồn chính để đọc thông tin từ đó. Mặc định là
debian / control. Nếu được cung cấp với tên đường dẫn tương đối, điều này được hiểu bắt đầu từ
thư mục cấp cao nhất của cây nguồn.

-ltệp nhật ký thay đổi
Chỉ định tệp nhật ký thay đổi để đọc thông tin từ đó. Mặc định là
debian / changelog. Nếu được cung cấp với tên đường dẫn tương đối, điều này được hiểu bắt đầu từ
thư mục cấp cao nhất của cây nguồn.

-Fđịnh dạng nhật ký thay đổi
Chỉ định định dạng của nhật ký thay đổi. Nhìn thấy dpkg-parsechangelog(1) để biết thông tin
về các định dạng thay thế.

--format =giá trị
Sử dụng định dạng đã cho để xây dựng gói nguồn (kể từ dpkg 1.14.17). Nó có
ghi đè bất kỳ định dạng nào được đưa ra trong debian / source / format.

-Vtên=giá trị
Đặt biến thay thế đầu ra. Nhìn thấy deb-subsvars(5) để thảo luận về
thay thế đầu ra.

-Ttập tin phụ
Đọc các biến thay thế trong tập tin phụ; mặc định là không đọc bất kỳ tập tin nào.
Tùy chọn này có thể được sử dụng nhiều lần để đọc các biến thay thế từ nhiều
các tệp (kể từ dpkg 1.15.6).

-Dlĩnh vực=giá trị
Ghi đè hoặc thêm trường tệp điều khiển đầu ra.

-Ulĩnh vực
Xóa trường tệp kiểm soát đầu ra.

-Znén, --nén=nén
Chỉ định cách nén để sử dụng cho các tệp tarball và tệp khác biệt được tạo (--nén
kể từ dpkg 1.15.5). Lưu ý rằng tùy chọn này sẽ không làm cho các tarball hiện có bị
được nén lại, nó chỉ ảnh hưởng đến các tập tin mới. Các giá trị được hỗ trợ là: gzip, bzip2, lma
và xz. Mặc định là xz cho các định dạng 2.0 trở lên và gzip cho định dạng 1.0. xz
chỉ được hỗ trợ kể từ dpkg 1.15.5.

-zcấp, - cấp độ nén=cấp
Mức nén để sử dụng (- cấp độ nén kể từ dpkg 1.15.5). Như với -Z it
chỉ ảnh hưởng đến các tập tin mới được tạo. Các giá trị được hỗ trợ là: 1 đến 9, tốtvà Rychle.
Mặc định là 9 cho gzip và bzip2, 6 cho xz và lzma.

-i[biểu thức chính quy], --diff-bỏ qua[=biểu thức chính quy]
Bạn có thể chỉ định một biểu thức chính quy Perl để khớp với các tệp bạn muốn lọc ra
danh sách các tập tin cho sự khác biệt (--diff-bỏ qua kể từ dpkg 1.15.6). (Danh sách này là
được tạo bởi lệnh find.) (Nếu gói nguồn đang được xây dựng dưới dạng phiên bản 3
gói nguồn sử dụng VCS, điều này có thể được sử dụng để bỏ qua những thay đổi chưa được cam kết trên
tập tin cụ thể. Sử dụng -i.* sẽ bỏ qua tất cả chúng.)

Sản phẩm -i tùy chọn tự nó kích hoạt cài đặt này với biểu thức chính quy mặc định (giữ nguyên mọi
sửa đổi biểu thức chính quy mặc định được thực hiện bằng cách sử dụng trước đó --mở rộng-diff-bỏ qua)
nó sẽ lọc ra các tập tin và thư mục kiểm soát của bản sửa đổi phổ biến nhất
hệ thống điều khiển, sao lưu và trao đổi tệp cũng như thư mục đầu ra của bản dựng Libtool. Ở đó
chỉ có thể là một biểu thức chính quy đang hoạt động, trong số nhiều biểu thức chính quy -i chỉ có lựa chọn cuối cùng sẽ thực hiện
hiệu ứng.

Điều này rất hữu ích trong việc loại bỏ các tập tin không liên quan có trong phần khác biệt,
ví dụ: nếu bạn duy trì nguồn của mình trong hệ thống kiểm soát sửa đổi và muốn sử dụng
kiểm tra để xây dựng gói nguồn mà không bao gồm các tệp bổ sung và
các thư mục mà nó thường chứa (ví dụ CVS/, .cvsignore, .svn/). Các
Regex mặc định đã rất đầy đủ rồi, nhưng nếu bạn cần thay thế nó, vui lòng
lưu ý rằng theo mặc định, nó có thể khớp với bất kỳ phần nào của đường dẫn, vì vậy nếu bạn muốn khớp với
bắt đầu bằng tên tệp hoặc chỉ tên tệp đầy đủ, bạn sẽ cần cung cấp thông tin cần thiết
neo (ví dụ: '(^|/)', '($|/)') chính bạn.

--mở rộng-diff-bỏ qua=biểu thức chính quy
Biểu thức chính quy Perl được chỉ định sẽ mở rộng giá trị mặc định được sử dụng bởi
--diff-bỏ qua và giá trị hiện tại của nó, nếu được đặt (kể từ dpkg 1.15.6). Nó thực hiện điều này bằng cách
nối “|biểu thức chính quy” theo giá trị hiện có. Tùy chọn này thuận tiện để sử dụng trong
debian/nguồn/tùy chọn để loại trừ một số tệp được tạo tự động khỏi bản vá tự động
thế hệ.

-I[tệp-mẫu], --tar-bỏ qua[=tệp-mẫu]
Nếu tùy chọn này được chỉ định, mẫu sẽ được chuyển tới tar(1) của --loại trừ
tùy chọn khi nó được gọi để tạo tệp .orig.tar hoặc .tar (--tar-bỏ qua kể từ khi
dpkg 1.15.6). Ví dụ, -ICVS sẽ khiến tar bỏ qua các thư mục CVS ​​khi
tạo tệp .tar.gz. Tùy chọn có thể được lặp lại nhiều lần để liệt kê
nhiều mẫu để loại trừ.

-I tự nó thêm mặc định --loại trừ các tùy chọn sẽ lọc ra các tập tin điều khiển và
thư mục của các hệ thống kiểm soát sửa đổi phổ biến nhất, các tập tin sao lưu và trao đổi và
Libtool xây dựng thư mục đầu ra.

Lưu ý: Mặc dù chúng có mục đích tương tự nhau, -i và -I có cú pháp rất khác nhau và
ngữ nghĩa. -i chỉ có thể được chỉ định một lần và có biểu thức chính quy tương thích với Perl
được khớp với đường dẫn tương đối đầy đủ của mỗi tệp. -I có thể chỉ định nhiều
lần và lấy mẫu tên tệp bằng các ký tự đại diện shell. Mẫu được áp dụng cho
đường dẫn tương đối đầy đủ mà còn đến từng phần của đường dẫn riêng lẻ. Ngữ nghĩa chính xác của
hắc ín --loại trừ tùy chọn hơi phức tạp, xem
https://www.gnu.org/software/tar/manual/tar.html#wildcards for a full documentation.

Có thể thấy biểu thức chính quy và mẫu mặc định cho cả hai tùy chọn trong đầu ra của --Cứu giúp
chỉ huy.

Chung trích xuất lựa chọn
--không được sao chép
Không sao chép tarball gốc gần gói nguồn được giải nén (vì dpkg
1.14.17).

--Không kiểm tra
Không kiểm tra chữ ký và tổng kiểm tra trước khi giải nén (kể từ dpkg 1.14.17).

--yêu cầu-chữ ký hợp lệ
Từ chối giải nén gói nguồn nếu nó không chứa chữ ký OpenPGP
có thể được xác minh (kể từ dpkg 1.15.0) bằng thông tin của người dùng Trustkeys.gpg móc chìa khóa,
một trong các chuỗi khóa dành riêng cho nhà cung cấp hoặc một trong các chuỗi khóa chính thức của Debian
(/usr/share/keyrings/debian-keyring.gpg và
/usr/share/keyrings/debian-maintainers.gpg).

--bỏ qua-phiên bản xấu
Biến việc kiểm tra phiên bản gói nguồn xấu thành cảnh báo không gây tử vong (vì dpkg
1.17.7). Tùy chọn này chỉ cần thiết khi trích xuất nguồn cổ
các gói có phiên bản bị hỏng, chỉ để tương thích ngược.

SOURCE GÓI M FORU ĐƠN

Nếu bạn không biết nên sử dụng định dạng nguồn nào, có lẽ bạn nên chọn “3.0 (quilt)”
hoặc “3.0 (bản địa)”. Xem https://wiki.debian.org/Projects/DebSrc3.0 để biết thông tin về
triển khai các định dạng đó trong Debian.

Định dạng: 1.0
Gói nguồn ở định dạng này bao gồm một .orig.tar.gz liên kết với một .diff.gz
hoặc một .tar.gz (trong trường hợp đó gói được cho là tự nhiên).

Trích xuất

Trích xuất gói gốc là trích xuất đơn giản của tarball đơn trong mục tiêu
danh mục. Việc trích xuất một gói không phải gốc được thực hiện bằng cách trước tiên giải nén gói .orig.tar.gz và
sau đó áp dụng bản vá có trong .diff.gz tài liệu. Dấu thời gian của tất cả các tệp được vá
được đặt lại về thời gian trích xuất của gói nguồn (điều này tránh sai lệch dấu thời gian dẫn đến
các vấn đề khi các tệp được tạo tự động được vá). Sự khác biệt có thể tạo ra các tập tin mới (
toàn bộ thư mục debian được tạo theo cách đó) nhưng không thể xóa các tập tin (các tập tin trống sẽ bị
thức ăn thừa).

Xây dựng

Xây dựng gói gốc chỉ là tạo một tarball duy nhất với thư mục nguồn.
Việc xây dựng một gói không phải gốc bao gồm việc trích xuất tarball gốc trong một gói riêng biệt
Thư mục “.orig” và tạo lại .diff.gz bằng cách so sánh gói nguồn thư mục
với thư mục .orig.

Xây dựng lựa chọn (với --xây dựng):

Nếu đối số không phải tùy chọn thứ hai được cung cấp thì đó phải là tên của nguồn ban đầu
thư mục hoặc tarfile hoặc chuỗi trống nếu gói là gói dành riêng cho Debian, v.v.
không có sự khác biệt về Debianisation. Nếu không có đối số thứ hai được cung cấp thì dpkg-nguồn sẽ xem xét
cho tarfile nguồn ban đầu gói_upstream-version.orig.tar.gz hoặc bản gốc
thư mục nguồn thư mục.orig tùy thuộc vào -sX lập luận.

-sa, -sp, -sk, -su và -sr sẽ không ghi đè lên các tarfile hoặc thư mục hiện có. Nêu Đây la
mong muốn rồi -sA, -sP, -sK, -của anh ấy và -sR nên được sử dụng thay thế.

-sk Theo mặc định, chỉ định nguồn ban đầu là tarfile gói_upstream-
phiên bản.orig.tar.mở rộng. Nó sẽ giữ nguyên nguồn ban đầu này như một
tarfile hoặc sao chép nó vào thư mục hiện tại nếu nó chưa có ở đó. tarball
sẽ được giải nén vào thư mục.orig cho việc tạo ra sự khác biệt.

-sp Như -sk nhưng sẽ xóa lại thư mục sau đó.

-su Chỉ định rằng nguồn ban đầu được mong đợi là một thư mục, theo mặc định gói-
phiên bản ngược dòng.orig và dpkg-nguồn sẽ tạo một kho lưu trữ nguồn gốc mới
từ nó.

-sr Như -su nhưng sẽ xóa thư mục đó sau khi nó được sử dụng.

-NS Chỉ định rằng nguồn gốc có sẵn cả dưới dạng thư mục và dưới dạng
tarfile. dpkg-nguồn sẽ sử dụng thư mục để tạo khác biệt, nhưng tarfile để
tạo ra .dsc. Tùy chọn này phải được sử dụng cẩn thận - nếu thư mục và tarfile
không khớp, một kho lưu trữ nguồn xấu sẽ được tạo ra.

-sn Chỉ định không tìm kiếm bất kỳ nguồn gốc nào và không tạo ra sự khác biệt. Các
đối số thứ hai, nếu được cung cấp, phải là chuỗi trống. Cái này được sử dụng cho Debian-
các gói cụ thể không có nguồn ngược dòng riêng biệt và do đó có
không có sự khác biệt về debianisation.

-sa or -sA
Chỉ định tìm kho lưu trữ nguồn gốc dưới dạng tarfile hoặc dưới dạng thư mục -
đối số thứ hai, nếu có, có thể là một trong hai hoặc là chuỗi trống (điều này tương đương
đối với việc sử dụng -sn). Nếu tìm thấy một tarfile, nó sẽ giải nén nó để tạo ra sự khác biệt và
loại bỏ nó sau đó (điều này tương đương với -sp); nếu một thư mục được tìm thấy nó sẽ
đóng gói nó để tạo nguồn ban đầu và xóa nó sau đó (điều này tương đương với
đến -sr); nếu không tìm thấy thì nó sẽ cho rằng gói đó không có debianisation
khác biệt, chỉ là một kho lưu trữ nguồn đơn giản (điều này tương đương với -sn). Nếu cả hai
được tìm thấy sau đó dpkg-nguồn sẽ bỏ qua thư mục, ghi đè lên nó, nếu -sA là
được chỉ định (điều này tương đương với -sP) hoặc gây ra lỗi nếu -sa đã được chỉ định. -sA
là mặc định.

--abort-on-upstream-thay đổi
Quá trình không thành công nếu khác biệt được tạo có chứa các thay đổi đối với các tệp bên ngoài
thư mục con debian (kể từ dpkg 1.15.8). Tùy chọn này không được phép trong
debian/nguồn/tùy chọn nhưng có thể được sử dụng trong debian/nguồn/tùy chọn cục bộ.

Trích xuất lựa chọn (với --trích xuất):

Trong mọi trường hợp, mọi cây nguồn gốc hiện có sẽ bị xóa.

-sp Dùng khi giải nén thì nguồn gốc (nếu có) sẽ được để lại dưới dạng tarfile.
Nếu nó chưa nằm trong thư mục hiện tại hoặc nếu nó hiện có nhưng
tập tin khác ở đó nó sẽ được sao chép ở đó. (T is các mặc định).

-su Giải nén cây nguồn ban đầu.

-sn Đảm bảo rằng nguồn gốc không được sao chép vào thư mục hiện tại cũng như không
đã giải nén. Bất kỳ cây nguồn gốc nào có trong thư mục hiện tại vẫn được giữ nguyên
loại bỏ.

Tất cả các -sX các lựa chọn loại trừ lẫn nhau. Nếu bạn chỉ định nhiều hơn một cái cuối cùng
sẽ được sử dụng.

--skip-debianization
Bỏ qua việc áp dụng debian diff trên các nguồn ngược dòng (vì dpkg
1.15.1).

Định dạng: 2.0
Hỗ trợ trích xuất kể từ dpkg 1.13.9, hỗ trợ xây dựng kể từ dpkg 1.14.8. Còn được biết đến
như tóc giả & bút. Định dạng này không được khuyến khích sử dụng rộng rãi, định dạng “3.0 (quilt)”
thay thế nó. Wig&pen là thông số kỹ thuật đầu tiên của gói nguồn thế hệ mới
định dạng.

Hoạt động của định dạng này giống như định dạng “3.0 (quilt)” ngoại trừ việc nó
không sử dụng danh sách các bản vá rõ ràng. Tất cả các tập tin trong debian / các bản vá / phù hợp với perl
biểu hiện thông thường [\w-]+ phải là các bản vá hợp lệ: chúng được áp dụng tại thời điểm trích xuất.

Khi xây dựng gói nguồn mới, mọi thay đổi đối với nguồn ngược dòng sẽ được lưu trữ trong một bản vá
tên zz_debian-diff-auto.

Định dạng: 3.0 (tự nhiên)
Được hỗ trợ kể từ dpkg 1.14.17. Định dạng này là phần mở rộng của định dạng gói gốc như
được xác định ở định dạng 1.0. Nó hỗ trợ tất cả các phương pháp nén và sẽ bỏ qua theo mặc định
mọi tệp và thư mục cụ thể của VCS cũng như nhiều tệp tạm thời (xem giá trị mặc định
liên quan đến -I tùy chọn trong --Cứu giúp đầu ra).

Định dạng: 3.0 (may chăn)
Được hỗ trợ kể từ dpkg 1.14.17. Gói nguồn ở định dạng này chứa ít nhất một
tarball gốc (.orig.tar.ext Ở đâu ext có thể gz, bz2, lma và xz) và một debian
tập tin nén (.debian.tar.ext). Nó cũng có thể chứa các tarball gốc bổ sung
(.orig-thành phần.tar.ext). thành phần chỉ có thể chứa các ký tự chữ và số và dấu gạch nối
('-').

Trích xuất

Tarball gốc chính được trích xuất trước, sau đó tất cả các tarball gốc bổ sung sẽ được trích xuất.
được trích xuất trong các thư mục con được đặt tên theo thành phần một phần tên tập tin của họ (bất kỳ phần trước
thư mục hiện có được thay thế). Tarball debian được trích xuất ở đầu nguồn
thư mục sau khi loại bỏ bất kỳ thư mục nào tồn tại trước đó debian danh mục. Lưu ý rằng debian
tarball phải chứa một debian thư mục con nhưng nó cũng có thể chứa các tệp nhị phân bên ngoài
của thư mục đó (xem --bao gồm-nhị phân Tùy chọn).

Tất cả các bản vá được liệt kê trong debian/patches/debian.series or debian / các bản vá lỗi / loạt sau đó thì
áp dụng. Nếu tệp trước được sử dụng và tệp sau không tồn tại (hoặc là một liên kết tượng trưng),
sau đó cái sau được thay thế bằng một liên kết tượng trưng đến cái trước. Điều này nhằm đơn giản hóa việc sử dụng
of may chăn để quản lý tập hợp các bản vá. Tuy nhiên hãy lưu ý rằng trong khi dpkg-nguồn những con ngựa
các tệp chuỗi chính xác với các tùy chọn rõ ràng được sử dụng cho ứng dụng vá lỗi (được lưu trữ trên mỗi tệp
dòng sau tên tệp bản vá và một hoặc nhiều khoảng trắng), nó sẽ bỏ qua các tùy chọn đó và
luôn mong đợi các bản vá có thể được áp dụng với -p1 tùy chọn bản vá. Do đó nó sẽ phát ra
một cảnh báo khi gặp các tùy chọn như vậy và quá trình xây dựng có thể bị lỗi.

Dấu thời gian của tất cả các tệp được vá được đặt lại về thời gian giải nén của gói nguồn
(điều này tránh sai lệch dấu thời gian dẫn đến sự cố khi vá các tệp được tạo tự động).

Trái với may chănhành vi mặc định của nó, các bản vá dự kiến ​​sẽ được áp dụng mà không có bất kỳ sự nhầm lẫn nào.
Khi không đúng như vậy, bạn nên làm mới các bản vá đó bằng may chăn, hoặc là dpkg-nguồn sẽ
lỗi trong khi cố gắng áp dụng chúng.

Tương tự như may chănhành vi mặc định của nó, các bản vá cũng có thể xóa các tập tin.

Tập tin .pc/app-patches được tạo nếu một số bản vá đã được áp dụng trong quá trình
khai thác.

Xây dựng

Tất cả các tarball gốc được tìm thấy trong thư mục hiện tại đều được trích xuất tạm thời
thư mục bằng cách làm theo logic tương tự như khi giải nén, thư mục debian sẽ được sao chép
trong thư mục tạm thời và tất cả các bản vá ngoại trừ bản vá tự động
(debian-thay đổi-phiên bản or thay đổi debian, phụ thuộc vào --single-debian-patch) là
áp dụng. Thư mục tạm thời được so sánh với thư mục gói nguồn. Khi mà
diff không trống, quá trình xây dựng sẽ thất bại trừ khi --single-debian-patch or --tự động cam kết đã
được sử dụng, trong trường hợp đó, điểm khác biệt sẽ được lưu trong bản vá tự động. Nếu bản vá tự động được
được tạo/xóa, nó sẽ được thêm/xóa khỏi tập tin bộ truyện và từ may chăn metadata.

Bất kỳ thay đổi nào trên tệp nhị phân đều không thể biểu thị được trong một khác biệt và do đó sẽ dẫn đến lỗi
trừ khi người bảo trì cố tình quyết định đưa tệp nhị phân đã sửa đổi đó vào
debian tarball (bằng cách liệt kê nó trong debian/nguồn/bao gồm nhị phân). Việc xây dựng cũng sẽ thất bại
nếu nó tìm thấy các tệp nhị phân trong thư mục con debian trừ khi chúng được đưa vào danh sách trắng
thông qua debian/nguồn/bao gồm nhị phân.

Thư mục debian đã cập nhật và danh sách các tệp nhị phân đã sửa đổi sau đó được sử dụng để tạo
tarball debian.

Sự khác biệt được tạo tự động không bao gồm các thay đổi trên các tệp cụ thể của VCS cũng như
nhiều tệp tạm thời (xem giá trị mặc định liên quan đến -i tùy chọn trong --Cứu giúp đầu ra). TRONG
đặc biệt, .máy tính thư mục được sử dụng bởi may chăn bị bỏ qua trong quá trình tạo tự động
vá.

Lưu ý: dpkg-nguồn - trước khi xây dựng (Và --xây dựng) sẽ đảm bảo rằng tất cả các bản vá được liệt kê trong
tập tin sê-ri được áp dụng để bản dựng gói luôn được áp dụng tất cả các bản vá. Nó có
điều này bằng cách tìm các bản vá chưa được áp dụng (chúng được liệt kê trong loạt tập tin nhưng không có trong
.pc/app-patches) và nếu bản vá đầu tiên trong bộ đó có thể được áp dụng mà không có lỗi thì nó
sẽ áp dụng tất cả. tùy chọn --không cần chuẩn bị có thể được sử dụng để vô hiệu hóa hành vi này.

ghi âm thay đổi

--làm [thư mục] [tên bản vá] [tập tin vá lỗi]
Tạo một bản vá tương ứng với những thay đổi cục bộ không được quản lý bởi
may chăn hệ thống vá lỗi và tích hợp nó vào hệ thống vá lỗi dưới tên tên bản vá.
Nếu thiếu tên, nó sẽ được hỏi tương tác. Nếu như tập tin vá lỗi được cho, nó
được sử dụng làm bản vá tương ứng với những thay đổi cục bộ để tích hợp. Một lần
được tích hợp, một trình soạn thảo sẽ được khởi chạy để bạn có thể chỉnh sửa siêu thông tin trong
tiêu đề bản vá.

Đi qua tập tin vá lỗi chủ yếu hữu ích sau một lỗi xây dựng đã tạo trước điều này
tệp và trên cơ sở này, tệp đã cho sẽ bị xóa sau khi tích hợp. Cũng lưu ý
rằng những thay đổi có trong tệp vá phải được áp dụng trên cây
và các tập tin được sửa đổi bởi bản vá không được có phần bổ sung chưa được ghi lại
thay đổi.

Nếu quá trình tạo bản vá phát hiện các tệp nhị phân đã sửa đổi, chúng sẽ tự động được
thêm vào debian/nguồn/bao gồm nhị phân để chúng kết thúc trong tarball debian
(giống hệt như dpkg-nguồn --bao gồm-nhị phân --xây dựng sẽ làm).

Xây dựng lựa chọn

--allow-version-of-quilt-db=phiên bản
Cho phép dpkg-nguồn để xây dựng gói nguồn nếu phiên bản của may chăn siêu dữ liệu
là cái được chỉ định, ngay cả khi dpkg-nguồn không biết về nó (vì dpkg
1.15.5.4). Thực tế điều này nói lên rằng phiên bản đã cho của may chăn siêu dữ liệu là
tương thích với phiên bản 2 đó dpkg-nguồn hiện đang hỗ trợ. Phiên bản của
các may chăn siêu dữ liệu được lưu trữ trong .pc/.version.

--bao gồm-loại bỏ
Đừng bỏ qua các tệp đã bị xóa và đưa chúng vào bản vá được tạo tự động.

--bao gồm dấu thời gian
Bao gồm dấu thời gian trong bản vá được tạo tự động.

--bao gồm-nhị phân
Thêm tất cả các tệp nhị phân đã sửa đổi vào tarball debian. Đồng thời thêm chúng vào
debian/nguồn/bao gồm nhị phân: chúng sẽ được thêm theo mặc định trong các bản dựng tiếp theo
và do đó tùy chọn này không còn cần thiết nữa.

--không cần chuẩn bị
Đừng cố gắng chuẩn bị cây xây dựng bằng cách áp dụng các bản vá dường như
chưa được áp dụng (kể từ dpkg 1.14.18).

--single-debian-patch
Sử dụng debian/patches/debian-thay đổi thay vì debian/patches/debian-changes-phiên bản
tên của bản vá tự động được tạo trong quá trình xây dựng (kể từ dpkg 1.15.5.4).
Tùy chọn này đặc biệt hữu ích khi gói được duy trì trong VCS và
bộ bản vá không thể được tạo ra một cách đáng tin cậy. Thay vào đó là sự khác biệt hiện tại với ngược dòng
nên được lưu trữ trong một bản vá duy nhất. Tùy chọn sẽ được đưa vào
debian/nguồn/tùy chọn cục bộ và sẽ đi kèm với một
debian/source/local-patch-header tệp giải thích cách thay đổi Debian có thể tốt nhất
được xem xét, ví dụ như trong VCS được sử dụng.

--tạo-trống-nguồn gốc
Tự động tạo tarball gốc chính thành trống nếu nó bị thiếu và nếu
có các tarball gốc bổ sung (kể từ dpkg 1.15.6). Tùy chọn này là
được sử dụng khi gói nguồn chỉ là một gói gồm nhiều luồng ngược dòng
phần mềm và nơi không có phần mềm “chính”.

--không có bản vá lỗi không áp dụng, --unapply-bản vá lỗi
Theo mặc định, dpkg-nguồn sẽ tự động hủy áp dụng các bản vá trong - sau xây dựng
hook nếu nó đã áp dụng chúng trong - trước khi xây dựng (--unapply-bản vá lỗi kể từ khi dpkg
1.15.8, --no-không áp dụng-bản vá kể từ dpkg 1.16.5). Những lựa chọn đó cho phép bạn
buộc phải vô hiệu hóa hoặc kích hoạt quá trình hủy ứng dụng bản vá. Những lựa chọn đó là
chỉ được phép vào debian/nguồn/tùy chọn cục bộ để tất cả các gói nguồn được tạo ra
có hành vi tương tự theo mặc định.

--abort-on-upstream-thay đổi
Quá trình không thành công nếu bản vá tự động được tạo (kể từ dpkg 1.15.8).
Tùy chọn này có thể được sử dụng để đảm bảo rằng tất cả các thay đổi được ghi lại đúng cách trong
riêng biệt may chăn các bản vá trước khi xây dựng gói nguồn. Tùy chọn này không
được phép trong debian/nguồn/tùy chọn nhưng có thể được sử dụng trong debian/nguồn/tùy chọn cục bộ.

--tự động cam kết
Quá trình này không thất bại nếu một bản vá tự động được tạo ra, thay vào đó nó
ngay lập tức được ghi lại trong may chăn series.

Trích xuất lựa chọn

--skip-debianization
Bỏ qua việc trích xuất tarball debian trên các nguồn ngược dòng (vì dpkg
1.15.1).

--bỏ qua các bản vá
Không dán các bản vá vào cuối quá trình trích xuất (kể từ dpkg 1.14.18).

Định dạng: 3.0 (tập quán)
Được hỗ trợ kể từ dpkg 1.14.17. Định dạng này là đặc biệt. Nó không đại diện cho một nguồn thực sự
định dạng gói nhưng có thể được sử dụng để tạo các gói nguồn với các tệp tùy ý.

Xây dựng lựa chọn

Tất cả các đối số không phải tùy chọn được lấy dưới dạng tệp để tích hợp vào gói nguồn được tạo.
Chúng phải tồn tại và tốt nhất là nằm trong thư mục hiện tại. Ít nhất một tập tin phải được
được.

--định dạng mục tiêu=giá trị
Yêu cầu. Xác định định dạng thực của gói nguồn được tạo. Việc tạo ra
Tệp .dsc sẽ chứa giá trị này trong Định dạng trường chứ không phải “3.0 (tùy chỉnh)”.

Định dạng: 3.0 (git)
Được hỗ trợ kể từ dpkg 1.14.17. Định dạng này là thử nghiệm.

Gói nguồn ở định dạng này bao gồm một gói kho lưu trữ git .git đến
giữ nguồn của một gói. Cũng có thể có một .gitshallow sửa đổi danh sách tập tin cho
một bản sao git nông.

Trích xuất

Gói này được sao chép dưới dạng kho lưu trữ git vào thư mục đích. Nếu có một
gitshallow, nó được cài đặt dưới dạng .git/nông bên trong kho git nhân bản.

Lưu ý rằng theo mặc định, kho lưu trữ mới sẽ có cùng nhánh được kiểm tra
đã được kiểm tra trong nguồn ban đầu. (Thường là “master”, nhưng nó có thể là bất cứ thứ gì.) Bất kỳ
các chi nhánh khác sẽ có sẵn theo điều khiển từ xa/nguồn gốc/.

Xây dựng

Trước khi tiếp tục, chúng tôi thực hiện một số kiểm tra để đảm bảo rằng chúng tôi không có bất kỳ lỗi nào không-
bỏ qua những thay đổi không được cam kết.

git-bó(1) được sử dụng để tạo một gói kho git. Theo mặc định, tất cả
các nhánh và thẻ trong kho được bao gồm trong gói.

Xây dựng lựa chọn

--git-ref=ref
Cho phép chỉ định một tham chiếu git để đưa vào gói git. Sử dụng vô hiệu hóa mặc định
hành vi bao gồm tất cả các nhánh và thẻ. Có thể được chỉ định nhiều lần. Các
ref có thể là tên của một nhánh hoặc thẻ cần đưa vào. Nó cũng có thể là bất kỳ tham số nào
điều đó có thể được chuyển đến danh sách git-rev(1). Ví dụ: chỉ bao gồm bản gốc
chi nhánh, sử dụng --git-ref=bậc thầy. Để bao gồm tất cả các thẻ và nhánh, ngoại trừ
chi nhánh riêng, sử dụng --git-ref=--tất cả các --git-ref=^riêng tư

--git-độ sâu=con số
Tạo một bản sao nông với lịch sử được cắt bớt theo số lượng được chỉ định
các bản sửa đổi.

Định dạng: 3.0 (bzr)
Được hỗ trợ kể từ dpkg 1.14.17. Định dạng này là thử nghiệm. Nó tạo ra một tarball duy nhất
chứa kho lưu trữ bzr.

Trích xuất

Tarball được giải nén và sau đó bzr được sử dụng để kiểm tra nhánh hiện tại.

Xây dựng

Trước khi tiếp tục, chúng tôi thực hiện một số kiểm tra để đảm bảo rằng chúng tôi không có bất kỳ lỗi nào không-
bỏ qua những thay đổi không được cam kết.

Sau đó, phần cụ thể của VCS của thư mục nguồn sẽ được sao chép sang một thư mục tạm thời
danh mục. Trước khi thư mục tạm thời này được đóng gói trong tarball, nhiều công việc dọn dẹp khác nhau sẽ được thực hiện.
được thực hiện để tiết kiệm không gian.

CHẨN ĐOÁN

Không nguồn định dạng quy định in debian / source / format
Tập tin debian / source / format phải luôn tồn tại và cho biết định dạng nguồn mong muốn.
Để tương thích ngược, định dạng “1.0” được giả định khi tệp không tồn tại nhưng bạn
không nên dựa vào điều này: tại một thời điểm nào đó trong tương lai dpkg-nguồn sẽ được sửa đổi để thất bại
khi tập tin đó không tồn tại.

Lý do là định dạng “1.0” không còn là định dạng được khuyến nghị nữa, bạn thường nên
chọn một trong các định dạng mới hơn (“3.0 (quilt)”, “3.0 (bản địa)”) nhưng dpkg-nguồn sẽ không làm
điều này tự động cho bạn. Nếu bạn muốn tiếp tục sử dụng định dạng cũ, bạn nên
rõ ràng về nó và đặt “1.0” vào debian / source / format.

các khác Sửa các tiếp theo Thượng nguồn các tập tin
Khi sử dụng định dạng nguồn “1.0”, việc sửa đổi trực tiếp các tệp ngược dòng thường là một ý tưởng tồi
vì những thay đổi cuối cùng bị ẩn và hầu như không được ghi lại trong tệp .diff.gz. Thay vào đó bạn
nên lưu trữ các thay đổi của bạn dưới dạng bản vá trong thư mục debian và áp dụng chúng vào thời gian xây dựng.
Để tránh sự phức tạp này, bạn cũng có thể sử dụng định dạng “3.0 (quilt)” cung cấp tính năng này
nguyên bản

không thể đại diện thay đổi đến hồ sơ
Các thay đổi đối với nguồn ngược dòng thường được lưu trữ với các tệp vá lỗi, nhưng không phải tất cả các thay đổi đều có thể được lưu trữ.
được thể hiện bằng các bản vá: chúng chỉ có thể thay đổi nội dung của các tệp văn bản thuần túy. nếu bạn
hãy thử thay thế một tập tin bằng một loại khác (ví dụ thay thế một tập tin đơn giản
tệp có liên kết tượng trưng hoặc thư mục), bạn sẽ nhận được thông báo lỗi này.

mới tạo ra trống hồ sơ hồ sơ sẽ không be đại diện in khác
Không thể tạo các tệp trống bằng các tệp vá. Vì vậy sự thay đổi này không được ghi lại trong
gói nguồn và bạn được cảnh báo về nó.

thực thi được chế độ uốn tóc of hồ sơ sẽ không be đại diện in khác
Các tệp bản vá không ghi lại quyền của tệp và do đó, các quyền thực thi cũng không được ghi lại.
được lưu trữ trong gói nguồn. Cảnh báo này nhắc nhở bạn về thực tế đó.

đặc biệt chế độ uốn tóc of hồ sơ sẽ không be đại diện in khác
Các tệp bản vá không ghi lại quyền của tệp và do đó các quyền được sửa đổi không được ghi lại.
được lưu trữ trong gói nguồn. Cảnh báo này nhắc nhở bạn về thực tế đó.

FILE M FORU ĐƠN

debian / source / format
Tệp này chứa trên một dòng duy nhất định dạng sẽ được sử dụng để xây dựng nguồn
gói (các định dạng có thể được mô tả ở trên). Không được phép có khoảng trống ở đầu hoặc cuối.

debian/nguồn/bao gồm nhị phân
Tệp này chứa danh sách các tệp nhị phân (mỗi tệp một dòng) cần được đưa vào
debian tarball. Các khoảng trống ở đầu và cuối bị loại bỏ. Các dòng bắt đầu bằng '#' là
ý kiến ​​và được bỏ qua. Các dòng trống sẽ bị bỏ qua.

debian/nguồn/tùy chọn
Tệp này chứa một danh sách các tùy chọn dài sẽ được tự động thêm vào trước
tập hợp các tùy chọn dòng lệnh của một dpkg-nguồn --xây dựng or dpkg-nguồn --định dạng in gọi.
Các tùy chọn như --nén và - cấp độ nén rất phù hợp cho tập tin này.

Mỗi tùy chọn nên được đặt trên một dòng riêng biệt. Dòng trống và dòng bắt đầu bằng '#' là
làm ngơ. Sự lãnh đạo '--' nên bị loại bỏ và không được phép sử dụng các tùy chọn ngắn. Không bắt buộc
khoảng trống được phép xung quanh '=' biểu tượng và dấu ngoặc kép tùy chọn được phép xung quanh giá trị.
Đây là một ví dụ về một tập tin như vậy:

# hãy để dpkg-source tạo debian.tar.bz2 với mức nén tối đa
nén = "bzip2"
mức nén = 9
# sử dụng debian/patches/debian-changes làm bản vá tự động
bản vá đơn debian
# bỏ qua những thay đổi về cấu hình.{sub,guess}
mở rộng-diff-ignore = "(^|/)(config.sub|config.guess)$"

Lưu ý: định dạng các tùy chọn không được chấp nhận trong tệp này, bạn nên sử dụng debian / source / format
thay thế.

debian/nguồn/tùy chọn cục bộ
Chính xác như debian/nguồn/tùy chọn ngoại trừ việc tệp không được bao gồm trong tệp được tạo
gói nguồn. Có thể hữu ích khi lưu trữ một ưu tiên gắn liền với người duy trì hoặc với
Kho lưu trữ VCS nơi gói nguồn được duy trì.

debian/source/local-patch-header và debian/nguồn/tiêu đề bản vá
Văn bản dạng tự do được đặt phía trên bản vá tự động được tạo ở định dạng “2.0” hoặc
“3.0 (chăn bông)”. tiêu đề bản vá cục bộ không được bao gồm trong gói nguồn được tạo trong khi
tiêu đề bản vá là.

debian / các bản vá lỗi / loạt
Tệp này liệt kê tất cả các bản vá phải được áp dụng (theo thứ tự nhất định) ở trên cùng của tệp.
gói nguồn ngược dòng. Các khoảng trống ở đầu và cuối bị loại bỏ. Các dòng bắt đầu bằng
'#' là những bình luận và bị bỏ qua. Các dòng trống sẽ bị bỏ qua. Các dòng còn lại bắt đầu bằng
tên tệp vá (liên quan đến debian / các bản vá / thư mục) cho đến ký tự khoảng trắng đầu tiên
hoặc cuối dòng. Không bắt buộc may chăn các tùy chọn có thể theo dõi đến cuối dòng hoặc đầu tiên
'#' đứng trước một hoặc nhiều khoảng trắng (đánh dấu sự bắt đầu của nhận xét cho đến hết
hàng).

Sử dụng nguồn dpkg trực tuyến bằng dịch vụ onworks.net