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

CHƯƠNG TRÌNH:

TÊN

apt-ftparchive - Tiện ích tạo tệp chỉ mục

SYNOPSIS

apt-ftparchive [-dsq] [--md5] [- liên kết] [--chỉ đọc] [- nội dung] [--vòm kiến trúc]
[-o =config_string] [-c =tập tin cấu hình]
{gói con đường... [ghi đè tệp [tiền tố đường dẫn]] |
nguồn con đường... [ghi đè tệp [tiền tố đường dẫn]] | nội dung con đường |
phát hành con đường | phát ra tập tin cấu hình phần... | dọn dẹp tập tin cấu hình |
{-v | --version} | {-h | --Cứu giúp}}

MÔ TẢ

apt-ftparchive là công cụ dòng lệnh tạo các tệp chỉ mục mà APT sử dụng để
truy cập nguồn phân phối. Các tệp chỉ mục phải được tạo trên trang gốc dựa trên
trên nội dung của trang web đó.

apt-ftparchive là một tập hợp siêu của gói quét dpkg(1) chương trình, bao gồm toàn bộ
chức năng thông qua lệnh gói. Nó cũng chứa một trình tạo tệp nội dung,
nội dung và một phương tiện phức tạp để 'viết kịch bản' cho quá trình tạo ra một
kho lưu trữ.

Nội bộ apt-ftparchive có thể sử dụng cơ sở dữ liệu nhị phân để lưu nội dung của tệp .deb
và nó không dựa vào bất kỳ chương trình bên ngoài nào ngoài gzip(1). Khi làm đầy đủ
tạo nó tự động thực hiện kiểm tra thay đổi tệp và xây dựng tệp nén mong muốn
các tập tin đầu ra.

Trừ khi -h, hoặc là --Cứu giúp tùy chọn được đưa ra, một trong các lệnh dưới đây phải có.

gói
Lệnh gói tạo một tệp gói từ cây thư mục. Nó có
thư mục đã cho và tìm kiếm đệ quy nó cho các tệp .deb, tạo ra một bản ghi gói
để stdout cho mỗi. Lệnh này gần tương đương với gói quét dpkg(1).

Tùy chọn --db có thể được sử dụng để chỉ định một DB bộ đệm nhị phân.

nguồn
Lệnh sources tạo một tệp chỉ mục nguồn từ một cây thư mục. Nó có
thư mục đã cho và tìm kiếm đệ quy nó cho các tệp .dsc, tạo ra một bản ghi nguồn
để stdout cho mỗi. Lệnh này gần tương đương với dpkg-Scannsources(1).

Nếu một tệp ghi đè được chỉ định thì tệp ghi đè nguồn sẽ được tìm kiếm với
một phần mở rộng của .src. Tùy chọn --source-override có thể được sử dụng để thay đổi nguồn
ghi đè tệp sẽ được sử dụng.

nội dung
Lệnh nội dung tạo tệp nội dung từ cây thư mục. Nó có
thư mục đã cho và tìm kiếm đệ quy nó cho các tệp .deb và đọc danh sách tệp
từ mỗi tệp. Sau đó, nó sắp xếp và ghi để sắp xếp danh sách các tệp phù hợp với
các gói. Thư mục không được ghi vào đầu ra. Nếu nhiều gói sở hữu giống nhau
thì mỗi gói được phân tách bằng dấu phẩy ở đầu ra.

Tùy chọn --db có thể được sử dụng để chỉ định một DB bộ đệm nhị phân.

phát hành
Lệnh phát hành tạo tệp Phát hành từ cây thư mục. Nó đệ quy
tìm kiếm trong thư mục nhất định để tìm các tệp và tệp Gói và Nguồn không được nén
nén với gzip, bzip2 or lma cũng như các tệp Release và md5sum.txt theo mặc định
(APT :: FTPArchive :: Release :: Default-Patterns). Các mẫu tên tệp bổ sung có thể được
được thêm bằng cách liệt kê chúng trong APT :: FTPArchive :: Release :: Mẫu. Sau đó nó ghi vào stdout
một tệp phát hành chứa (theo mặc định) thông báo MD5, SHA1, SHA256 và SHA512 cho mỗi
tập tin.

Giá trị cho các trường siêu dữ liệu bổ sung trong tệp Bản phát hành được lấy từ
các biến tương ứng trong APT :: FTPArchive :: Release, ví dụ:
APT :: FTPArchive :: Phát hành :: Nguồn gốc. Các trường được hỗ trợ là: Origin, Label, Suite,
Phiên bản, Tên mã, Ngày tháng, Còn hiệu lực, Kiến trúc, Thành phần, Mô tả.

tạo ra
Lệnh create được thiết kế để có thể chạy được từ tập lệnh cron và xây dựng các chỉ mục
theo tệp cấu hình đã cho. Ngôn ngữ cấu hình cung cấp một phương tiện linh hoạt
chỉ định tệp chỉ mục nào được tạo từ thư mục nào, cũng như cung cấp
phương tiện đơn giản để duy trì các cài đặt cần thiết.

giống cá lăng
Lệnh sạch sẽ thu dọn các cơ sở dữ liệu được sử dụng bởi tệp cấu hình đã cho bởi
loại bỏ bất kỳ hồ sơ nào không còn cần thiết.

CÁC THẾ HỆ CẤU HÌNH

Lệnh tạo sử dụng tệp cấu hình để mô tả các tệp lưu trữ sẽ
được tạo ra. Nó tuân theo định dạng cấu hình ISC điển hình như được thấy trong các công cụ ISC như
ràng buộc 8 và dhcpd. apt.conf(5) chứa mô tả về cú pháp. Lưu ý rằng
cấu hình tạo được phân tích cú pháp theo từng phần, nhưng apt.conf(5) được phân tích cú pháp trên cây
cách thức. Điều này chỉ ảnh hưởng đến cách xử lý thẻ phạm vi.

Cấu hình tạo có bốn phần riêng biệt, mỗi phần được mô tả bên dưới.

Chỉ đạo Phần
Phần Dir xác định các thư mục tiêu chuẩn cần thiết để định vị các tệp được yêu cầu
trong quá trình phát sinh. Các thư mục này được thêm vào trước các đường dẫn tương đối nhất định
được xác định trong các phần sau để tạo ra một đường dẫn tuyệt đối hoàn chỉnh.

Lưu trữDir
Chỉ định gốc của kho lưu trữ FTP, trong cấu hình Debian tiêu chuẩn, đây là
thư mục chứa các nút ls-LR và dist.

Ghi đèDir
Chỉ định vị trí của các tệp ghi đè.

Bộ nhớ cacheDir
Chỉ định vị trí của các tệp bộ đệm.

FileListDir
Chỉ định vị trí của các tệp danh sách tệp, nếu cài đặt Danh sách tệp được sử dụng bên dưới.

Mặc định Phần
Phần Mặc định chỉ định các giá trị mặc định và cài đặt kiểm soát hoạt động của
máy phát điện. Các phần khác có thể ghi đè các giá trị mặc định này bằng cài đặt cho mỗi phần.

Gói :: Nén
Đặt các lược đồ nén mặc định để sử dụng cho các tệp chỉ mục gói. Nó là một
chuỗi chứa danh sách được phân tách bằng dấu cách của ít nhất một trong số: '.' (không nén),
'gzip' và 'bzip2'. Mặc định cho tất cả các lược đồ nén là '. gzip '.

Gói :: Tiện ích mở rộng
Đặt danh sách mặc định của phần mở rộng tệp là tệp gói. Điều này mặc định là
'.deb'.

Nguồn :: Nén
Điều này tương tự như Packages :: Compress ngoại trừ việc nó kiểm soát quá trình nén cho
Tệp nguồn.

Nguồn :: Tiện ích mở rộng
Đặt danh sách mặc định của phần mở rộng tệp là tệp nguồn. Điều này mặc định là
'.dsc'.

Nội dung :: Nén
Điều này tương tự như Packages :: Compress ngoại trừ việc nó kiểm soát quá trình nén cho
Nội dung tệp.

Bản dịch :: Nén
Điều này tương tự như Packages :: Compress ngoại trừ việc nó kiểm soát quá trình nén cho
Tệp chính bản dịch-en.

DeLinkLimit
Chỉ định số kilobyte để xóa liên kết (và thay thế bằng liên kết cứng) mỗi lần chạy.
Điều này được sử dụng cùng với cài đặt Liên kết ngoài theo từng phần.

Chế độ tập tin
Chỉ định chế độ của tất cả các tệp chỉ mục đã tạo. Nó mặc định là 0644. Tất cả các tệp chỉ mục
được đặt ở chế độ này mà không liên quan đến umask.

Mô tả dài
Chỉ định xem mô tả dài có nên được đưa vào tệp Gói hay phần tách
thành một tệp tin dịch thuật chính.

CâyMặc Định Phần
Đặt các giá trị mặc định cụ thể cho các phần Cây. Tất cả các biến này đều là biến thay thế
và có các chuỗi $ (DIST), $ (SECTION) và $ (ARCH) được thay thế bằng các chuỗi tương ứng của chúng
các giá trị.

Nội dung tối đaThay đổi
Đặt số kilobyte tệp nội dung được tạo mỗi ngày. Các
các tệp nội dung được tổng hợp lại để sau vài ngày, tất cả chúng sẽ được xây dựng lại.

Nội dungTuổi
Kiểm soát số ngày tệp nội dung được phép kiểm tra mà không thay đổi.
Nếu vượt qua giới hạn này, thời gian của tệp nội dung sẽ được cập nhật. Trường hợp này có thể xảy ra
nếu tệp gói được thay đổi theo cách không dẫn đến nội dung mới
tệp [ghi đè chỉnh sửa chẳng hạn]. Tạm dừng được cho phép với hy vọng rằng .debs mới sẽ
được cài đặt, dù thế nào cũng yêu cầu một tệp mới. Giá trị mặc định là 10, đơn vị tính là ngày.

thư mục
Đặt phần trên cùng của cây thư mục .deb. Mặc định là
$ (DIST) / $ (SECTION) / binary - $ (ARCH) /

SrcThư mục
Đặt trên cùng của cây thư mục gói nguồn. Mặc định là
$ (DIST) / $ (SECTION) / source /

Gói
Đặt tệp Gói đầu ra. Mặc định là $ (DIST) / $ (SECTION) / binary - $ (ARCH) / Packages

nguồn
Đặt tệp Nguồn đầu ra. Mặc định là $ (DIST) / $ (SECTION) / source / Sources

Dịch
Đặt tệp chính Dịch-en đầu ra với các mô tả dài nếu chúng cần
không được bao gồm trong tệp Gói. Mặc định là
$ (DIST) / $ (SECTION) / i18n / Dịch-vi

Tiền tố nội bộ
Đặt tiền tố đường dẫn khiến liên kết tượng trưng được coi là liên kết nội bộ thay thế
của một liên kết bên ngoài. Mặc định là $ (DIST) / $ (SECTION) /

Nội dung
Đặt tệp Nội dung đầu ra. Mặc định là $ (DIST) / $ (SECTION) / Contents - $ (ARCH). Nếu như
cài đặt này khiến nhiều tệp Gói ánh xạ vào một tệp Nội dung (như là
mặc định) sau đó apt-ftparchive sẽ tích hợp các tệp gói đó với nhau
tự động.

Nội dung :: Tiêu đề
Đặt tệp tiêu đề để thêm trước vào đầu ra nội dung.

BinCacheDB
Đặt cơ sở dữ liệu bộ đệm nhị phân để sử dụng cho phần này. Nhiều phần có thể chia sẻ
cùng một cơ sở dữ liệu.

Danh sách tập tin
Chỉ định rằng thay vì đi bộ cây thư mục, apt-ftparchive nên đọc
danh sách các tệp từ tệp đã cho. Tên tệp tương đối được đặt trước với kho lưu trữ
thư mục.

NguồnFileList
Chỉ định rằng thay vì đi bộ cây thư mục, apt-ftparchive nên đọc
danh sách các tệp từ tệp đã cho. Tên tệp tương đối được đặt trước với kho lưu trữ
danh mục. Điều này được sử dụng khi xử lý các chỉ mục nguồn.

Cây Phần
Phần Cây xác định một cây tệp Debian tiêu chuẩn bao gồm một thư mục cơ sở,
sau đó là nhiều phần trong thư mục cơ sở đó và cuối cùng là nhiều Kiến trúc trong mỗi
phần. Việc vỗ nhẹ chính xác được sử dụng được xác định bởi biến thay thế Thư mục.

Phần Cây lấy thẻ phạm vi đặt biến $ (DIST) và xác định gốc của
cây (đường dẫn có tiền tố là ArchiveDir). Thông thường, đây là một cài đặt chẳng hạn như
dists / jessie.

Tất cả các cài đặt được xác định trong phần TreeDefault có thể được sử dụng trong phần Cây như
cũng như ba biến mới.

Khi xử lý một phần Cây apt-ftparchive thực hiện một hoạt động tương tự như:

cho tôi trong Phần làm
cho j trong Kiến trúc làm
Tạo cho DIST = phạm vi SECTION = i ARCH = j

Mục
Đây là danh sách các phần được phân tách bằng dấu cách xuất hiện dưới bản phân phối;
thường đây là một cái gì đó giống như đóng góp chính không miễn phí

Kiến trúc
Đây là danh sách được phân tách bằng dấu cách của tất cả các kiến ​​trúc xuất hiện trong tìm kiếm
phần. Kiến trúc đặc biệt 'nguồn' được sử dụng để chỉ ra rằng cây này có
nguồn lưu trữ. Kiến trúc 'tất cả' báo hiệu rằng cấu trúc các tệp cụ thể như
Các gói không được bao gồm thông tin về kiến ​​trúc tất cả các gói trong tất cả các tệp
vì chúng sẽ có sẵn trong một tệp chuyên dụng.

Mô tả dài
Chỉ định xem mô tả dài có nên được đưa vào tệp Gói hay phần tách
thành một tệp tin dịch thuật chính.

Ghi đè thùng rác
Đặt tệp ghi đè nhị phân. Tệp ghi đè chứa phần, mức độ ưu tiên và
thông tin địa chỉ người bảo trì.

SrcGhi đè
Đặt tệp ghi đè nguồn. Tệp ghi đè chứa thông tin phần.

ghi đè thêm
Đặt tệp ghi đè bổ sung nhị phân.

SrcExtraGhi đè
Đặt tệp ghi đè bổ sung nguồn.

thư mục bin Phần
Phần thư mục nhị phân định nghĩa cây thư mục nhị phân không có cấu trúc đặc biệt. Các
thẻ phạm vi chỉ định vị trí của thư mục nhị phân và cài đặt tương tự như
phần Cây không có biến thay thế hoặc cài đặt Kiến trúc Phần.

Gói
Đặt đầu ra tệp Gói.

nguồn
Đặt đầu ra tệp Nguồn. Ít nhất một trong các Gói hoặc Nguồn là bắt buộc.

Nội dung
Đặt đầu ra tệp Nội dung (tùy chọn).

Ghi đè thùng rác
Đặt tệp ghi đè nhị phân.

SrcGhi đè
Đặt tệp ghi đè nguồn.

ghi đè thêm
Đặt tệp ghi đè bổ sung nhị phân.

SrcExtraGhi đè
Đặt tệp ghi đè bổ sung nguồn.

BinCacheDB
Đặt DB bộ nhớ cache.

Tiền tố đường dẫn
Thêm một đường dẫn đến tất cả các đường dẫn đầu ra.

Danh sách tập tin, NguồnFileList
Chỉ định tệp danh sách tệp.

CÁC nhị phân GHI ĐÈ FILE

Tệp ghi đè nhị phân hoàn toàn tương thích với gói quét dpkg(1). Nó chứa bốn
các trường được phân tách bằng dấu cách. Trường đầu tiên là tên gói, trường thứ hai là
ưu tiên để buộc gói đó, thứ ba là phần để buộc gói đó và
trường cuối cùng là trường hoán vị duy trì.

Dạng chung của trường bảo trì là:

cũ [// oldn] * => mới

hoặc đơn giản,

mới

Biểu mẫu đầu tiên cho phép danh sách các địa chỉ email cũ được phân tách bằng dấu gạch chéo
được chỉ định. Nếu bất kỳ cái nào trong số đó được tìm thấy thì mới được thay thế cho trường bảo trì. Các
hình thức thứ hai thay thế trường bảo trì một cách vô điều kiện.

CÁC SOURCE GHI ĐÈ FILE

Tệp ghi đè nguồn hoàn toàn tương thích với dpkg-Scannsources(1). Nó chứa hai
các trường được phân tách bằng dấu cách. Trường đầu tiên là tên gói nguồn, trường thứ hai là
phần để gán nó.

CÁC EXTRA GHI ĐÈ FILE

Tệp ghi đè bổ sung cho phép thêm hoặc thay thế bất kỳ thẻ tùy ý nào trong đầu ra. Nó
có ba cột, cột đầu tiên là gói, cột thứ hai là thẻ và phần còn lại của
dòng là giá trị mới.

LỰA CHỌN

Tất cả các tùy chọn dòng lệnh có thể được thiết lập bằng cách sử dụng tệp cấu hình, mô tả
cho biết tùy chọn cấu hình để thiết lập. Đối với các tùy chọn boolean, bạn có thể ghi đè cấu hình
tập tin bằng cách sử dụng một cái gì đó như -NS-,--không-f, -f = không hoặc một số biến thể khác.

--md5, --sha1, --sha256, --sha512
Tạo tổng kiểm tra đã cho. Các tùy chọn này được mặc định thành bật, khi tắt
các tệp chỉ mục được tạo sẽ không có các trường tổng kiểm tra nếu có thể. Cấu hình
Các mục: APT :: FTPArchive ::Checksum và APT :: FTPArchive ::Chỉ số::Checksum Ở đâu Chỉ số có thể
là Gói, Nguồn hoặc Bản phát hành và Checksum có thể là MD5, SHA1, SHA256 hoặc SHA512.

-d, --db
Sử dụng một DB bộ nhớ đệm nhị phân. Điều này không ảnh hưởng đến lệnh tạo. Cấu hình
Mục: APT :: FTPArchive :: DB.

-q, --Yên lặng
Yên lặng; tạo ra đầu ra phù hợp cho việc ghi nhật ký, bỏ qua các chỉ số tiến độ. Thêm q của
sẽ tạo ra yên tĩnh hơn lên đến tối đa là 2. Bạn cũng có thể sử dụng -q = # để thiết lập sự yên tĩnh
cấp, ghi đè tệp cấu hình. Mục cấu hình: yên tĩnh.

- liên kết
Thực hiện Delinking. Nếu cài đặt Liên kết ngoài được sử dụng thì tùy chọn này thực sự
cho phép xóa các tệp. Nó mặc định là bật và có thể tắt bằng
--no-delink. Mục cấu hình: APT :: FTPArchive :: DeLinkAct.

- nội dung
Thực hiện tạo nội dung. Khi tùy chọn này được đặt và các chỉ mục gói đang được
được tạo bằng Cơ sở dữ liệu bộ nhớ cache thì danh sách tệp cũng sẽ được trích xuất và lưu trữ trong
DB để sử dụng sau này. Khi sử dụng lệnh tạo, tùy chọn này cũng cho phép
tạo bất kỳ tệp Nội dung nào. Mặc định được bật. Mục cấu hình:
APT :: FTPArchive :: Nội dung.

-s, - ghi đè nguồn
Chọn tệp ghi đè nguồn để sử dụng với lệnh sources. Mục cấu hình:
APT :: FTPArchive :: SourceOverride.

--chỉ đọc
Làm cho cơ sở dữ liệu bộ nhớ đệm chỉ đọc. Mục cấu hình: APT :: FTPArchive :: ReadOnlyDB.

-a, --vòm
Chấp nhận trong các gói và lệnh nội dung chỉ các tệp gói phù hợp với * _arch.deb hoặc
* _all.deb thay vì tất cả các tệp gói trong đường dẫn nhất định. Mục cấu hình:
APT :: FTPArchive :: Kiến trúc.

APT :: FTPArchive :: AlwaysStat
apt-ftparchive(1) lưu trữ càng nhiều siêu dữ liệu càng tốt trong một bộ nhớ đệm. Nếu các gói là
được biên dịch lại và / hoặc tái xuất bản với cùng một phiên bản lần nữa, điều này sẽ dẫn đến sự cố
vì siêu dữ liệu được lưu trong bộ nhớ cache hiện đã lỗi thời như kích thước và tổng kiểm tra sẽ được sử dụng. Với cái này
tùy chọn được bật, điều này sẽ không còn xảy ra nữa vì nó sẽ được kiểm tra xem tệp có
đã thay đổi. Lưu ý rằng tùy chọn này được đặt thành "false" theo mặc định vì nó không được khuyến nghị
tải lên nhiều phiên bản / bản dựng của một gói có cùng số phiên bản, vì vậy về lý thuyết
không ai sẽ gặp những vấn đề này và do đó tất cả những kiểm tra bổ sung này là vô ích.

APT :: FTPArchive :: LongDescription
Tùy chọn cấu hình này được đặt mặc định là "true" và chỉ nên được đặt thành "false" nếu
Lưu trữ được tạo bằng apt-ftparchive(1) cũng cung cấp các tập tin Dịch. Lưu ý rằng
tệp chính Bản dịch-en chỉ có thể được tạo trong lệnh tạo.

-h, --Cứu giúp
Hiển thị một bản tóm tắt sử dụng ngắn.

-v, --phiên bản
Hiển thị phiên bản chương trình.

-c, --tập tin cấu hình
Tập tin cấu hình; Chỉ định một tệp cấu hình để sử dụng. Chương trình sẽ đọc
tệp cấu hình mặc định và sau đó là tệp cấu hình này. Nếu cấu hình cài đặt
cần được đặt trước khi phân tích cú pháp tệp cấu hình mặc định, chỉ định tệp có
các APT_CONFIG biến môi trường. Nhìn thấy apt.conf(5) để biết thông tin cú pháp.

-o, --Lựa chọn
Đặt một tùy chọn cấu hình; Điều này sẽ thiết lập một tùy chọn cấu hình tùy ý. Các
cú pháp là -o Foo :: Bar = thanh. -o và --Lựa chọn có thể được sử dụng nhiều lần để thiết lập
lựa chọn khác nhau.

VÍ DỤ

Để tạo tệp Gói nén cho thư mục chứa gói nhị phân (.deb):

apt-ftparchive gói thư mục | gzip > Packages.gz

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