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

CHƯƠNG TRÌNH:

TÊN

jigdo-file - Chuẩn bị tệp để Tải xuống ghép hình (phân phối các tệp lớn, ví dụ: CD
hình ảnh).

SYNOPSIS

tập tin jigdo COMMAND
[ --image =cdrom.iso ] [ --jigdo =cdrom.jigdo ] [ --template =cdrom.template ] [ --lực lượng ] [
MORE LỰA CHỌN ] [ CÁC TẬP TIN hữu ích. Cảm ơn ! | --files-from =f ]
Chung LỆNH: trang điểm, trang điểm, xác minh

MÔ TẢ

Tải xuống ghép hình, hoặc ghép hình ngắn, là một chương trình được phát triển chủ yếu để giúp bạn dễ dàng
phân phối hình ảnh hệ thống tệp lớn (ví dụ: hình ảnh CD (ISO9660) hoặc DVD (UDF)) qua
internet, nhưng nó cũng có thể được sử dụng cho các dữ liệu khác mà khó xử lý do
kích thước, như tệp âm thanh / video hoặc gói phần mềm lớn.

jigdo cố gắng đảm bảo rằng tệp lớn (luôn được gọi là hình ảnh từ bây giờ) được tải xuống
trong các phần nhỏ có thể được lưu trữ trên các máy chủ khác nhau. Những người muốn tải xuống
hình ảnh làm như vậy bằng cách nói với trò đùa(1) (KHÔNG PHẢI ĐÃ THỰC HIỆN NHƯNG) tải xuống công cụ để xử lý một
`.jigdo' tập tin; sử dụng nó, trò đùa tải xuống các bộ phận và lắp ráp lại hình ảnh. tập tin jigdo
được sử dụng để chuẩn bị các tệp để tải xuống.

Điều làm cho jigdo trở nên đặc biệt là các bộ phận được sử dụng để tái tạo lại hình ảnh có thể có
bất kỳ kích thước và nội dung nào - chúng chỉ cần được chứa trong một vùng liền kề ở bất kỳ đâu trong
bức hình.

Ví dụ: nếu bạn muốn phân phối hình ảnh ISO9660 có chứa ảnh chụp nhanh của một
Máy chủ FTP, bạn có thể hướng dẫn tập tin jigdo để chuẩn bị dữ liệu tải xuống theo cách
khi mọi người sử dụng trò đùa để tải xuống hình ảnh, trò đùa thực sự tìm nạp các tệp riêng lẻ
từ máy chủ FTP và tập hợp chúng thành một bản sao chính xác của hình ảnh của bạn - trong quá trình
Tải xuống! (Nếu hình ảnh không phải là kết xuất hệ thống tệp, bạn có thể sử dụng chia(1) để tạo ra
các phần mà hình ảnh sẽ được tập hợp lại từ đó.)

Bạn hoàn toàn tự do lựa chọn nơi lưu trữ các phần riêng lẻ của hình ảnh:
có thể nằm trong các thư mục hoàn toàn khác nhau trên các máy chủ khác nhau (ví dụ: vì
hạn chế về lưu trữ / băng thông), nhưng điều này vô hình đối với những người tải xuống
hình ảnh. Thông tin về các máy chủ có sẵn chỉ cần được thêm vào `.jigdo' tập tin
bởi bạn trước khi phân phối nó.

Phần `` CHI TIẾT '' bên dưới chứa các chi tiết kỹ thuật về cách hoạt động của jigdo. CÁC VÍ DỤ
phần liệt kê một số tình huống phổ biến và có thể giúp bạn hình dung về jigdo
là hữu ích cho.

LỰA CHỌN

Nhiều tùy chọn dành riêng cho một COMMAND; những cái dưới đây là chung chung hoặc được sử dụng bởi
một số lệnh. Các tùy chọn khác được liệt kê bên dưới với các lệnh riêng lẻ. Tất cả các
các tùy chọn sẽ bị bỏ qua một cách im lặng nếu chúng không áp dụng được cho lệnh hiện tại. Bất cứ gì
BYTES tham số cho các tùy chọn, bạn có thể thêm một trong các chữ cái `` k '', `` M '' hoặc `` G '' vào
số lượng bạn chỉ định, để biểu thị kilobyte, megabyte hoặc gigabyte.

-h --Cứu giúp
Xuất ra bản tóm tắt ngắn gọn về các lệnh và tùy chọn.

-H - trợ giúp tất cả
Xuất ra bản tóm tắt hoàn chỉnh các lệnh và tùy chọn.

-v --phiên bản
Phiên bản chương trình đầu ra.

-i --image =cdrom.iso
Chỉ định vị trí của tệp chứa hình ảnh. Hình ảnh là tệp lớn
bạn muốn phân phối.

-j --jigdo =cdrom.jigdo
Chỉ định vị trí của tệp mô tả Tải xuống ghép hình. Tệp jigdo là một
tệp con người có thể đọc được tạo bởi tập tin jigdo, mà bạn thêm thông tin về tất cả
máy chủ mà bạn sẽ tải tệp lên. trò đùa sẽ tải xuống tệp này dưới dạng
bước đầu tiên của việc truy xuất hình ảnh.

-t --template =cdrom.template
Chỉ định vị trí của tệp `` mẫu '' hình ảnh. Tệp mẫu là tệp nhị phân
được tạo ra bởi tập tin jigdo, nó chứa thông tin về cách lắp ráp lại hình ảnh và
cũng (ở dạng nén) tất cả dữ liệu từ hình ảnh không được tìm thấy trong bất kỳ
các bộ phận.

Tùy thuộc vào lệnh, mỗi trong số ba tệp này đôi khi được sử dụng để nhập liệu,
đôi khi cho đầu ra. Nếu tệp được sử dụng để xuất cho một lệnh cụ thể
và tệp đầu ra đã tồn tại, tập tin jigdo thoát ra với một lỗi, trừ khi --lực lượng
là món quà.

Trong hầu hết các trường hợp, bạn sẽ chỉ cần chỉ định một trong số -i -j -t, bởi vì bất kỳ
tên tệp bị thiếu sẽ được suy ra từ tên bạn chỉ định. Điều này được thực hiện trước
tước bất kỳ phần mở rộng nào khỏi tên đã cung cấp và sau đó không nối thêm gì (nếu
suy luận --hình ảnh), `.jigdo'hoặc'.bản mẫu'.

-r --report = default | noprogress | yên tĩnh | grep
Kiểm soát độ dài của chương trình và định dạng đầu ra có: không vi phạm is
giống như mặc định ngoại trừ việc không có thông báo tiến độ `` x% done '' nào được in. yên tĩnh
hạn chế đầu ra ở những gì thực sự cần thiết, chủ yếu là thông báo lỗi. grep
chỉ khác với mặc định cho trang điểm lệnh: Nó cho phép đầu ra trong
một đơn giản 'định dạng hữu ích khi tìm kiếm các tệp nhị phân
trong các tệp nhị phân khác.

-f --lực lượng
Ghi đè các tệp đầu ra tồn tại mà không phàn nàn.

--không có lực lượng
T is các mặc định. Từ chối ghi đè các tệp đầu ra hiện có.

-c --cache =jigdo-cache.db
tập tin jigdo thường cần đọc toàn bộ nội dung của tất cả CÁC TẬP TIN bạn chỉ định.
Nếu bạn sử dụng nó nhiều lần (ví dụ: vì bạn cung cấp ảnh CD mới hàng ngày),
lưu vào bộ nhớ đệm thông tin tệp sẽ làm tăng tốc độ của chương trình lên đáng kể. Các
tập tin bộ nhớ cache được tạo tự động nếu nó chưa có. Dữ liệu thường là cả hai
đọc từ và viết vào nó.

- không có bộ nhớ cache
T is các mặc định. Không sử dụng bộ nhớ cache.

--cache-hết hạn =GIÂY
Đặt tuổi tối đa của các mục nhập trong bộ nhớ cache. Bất kỳ mục nào cũ hơn mục này sẽ bị xóa khỏi
bộ nhớ cache. Giá trị mặc định là 30 ngày. Bạn có thể thêm một trong các chữ cái `h ',` d', `w ',
`m ',` y' để biểu thị giờ, ngày, tuần, tháng hoặc năm tương ứng. Một giá trị của
Giá trị `` 0 '' hoặc `` tắt '' vô hiệu hóa thời hạn sử dụng, do đó tất cả các mục nhập sẽ ở trong bộ nhớ cache vĩnh viễn.
Xem phần `` CACHE FILES '' bên dưới để biết thêm thông tin.

--readbuffer =BYTES
Đặt kích thước của bộ đệm bên trong. Giá trị mặc định là 128k - nếu bạn có đĩa nhanh,
tăng giá trị này có thể làm cho tập tin jigdo nhanh hơn, nhưng nói chung, thay đổi nó là
không cần thiết.

--md5-block-size =BYTES
Không quan tâm nội bộ tham số. Đặt kích thước khối thành các tệp
chia nhỏ. Mặc định là 128k. Nếu bạn thay đổi nó, bất kỳ tệp bộ đệm nào sẽ phải
tái sinh. Trong nội bộ, tập tin jigdo có thể chọn sử dụng lớn hơn hoặc nhỏ hơn một chút
giá trị.

-T --files-from =hồ sơ
Đọc tên tệp và thư mục từ tệp được chỉ định. Nếu như hồ sơ là `- ', đọc tên
từ đầu vào tiêu chuẩn. Mỗi dòng trong tệp được lấy làm tên, vì vậy tên có thể
chứa khoảng trắng, nhưng không chứa ký tự dòng mới. Một dòng trống gây ra tập tin jigdo để ngăn chặn
đọc từ tệp.

tìm(1) là một công cụ mạnh mẽ để tạo danh sách tệp, nhưng hãy đảm bảo sử dụng `tìm
-kiểu f'nếu có thể - nếu không, nếu bạn hướng dẫn tìm để xuất cả tên tệp
và một liên kết tượng trưng cho tên tệp đó, tập tin jigdo sẽ đọc nội dung tệp hai lần.

--hex Tổng kiểm tra đầu ra ở dạng thập lục phân thay vì định dạng giống Base64. Điều này không nên
được sử dụng với trang điểm lệnh, bởi vì kết quả `.jigdo'tập tin vi phạm
cái '.jigdo'định dạng tệp. Mục đích sử dụng của nó là làm cho tập tin jigdo tương tác hơn
với các tiện ích Unix shell khác như md5sum(1).

--không có hex
T is các mặc định. Sử dụng mã hóa tổng kiểm tra giống Base64 của riêng jigdo.

--debug [= help | = all | =ĐƠN VỊ, ~ ĐƠN VỊ ... ]
Bật hoặc tắt đầu ra gỡ lỗi. Chỉ cần `--debug 'tương đương với` --debug = all'.
Đối số là danh sách tên đơn vị được phân tách bằng dấu phẩy mà đầu ra gỡ lỗi là
được bật hoặc tắt nếu tên đứng trước dấu `~ '. Tên đặc biệt `` all ''
có nghĩa là tất cả các đơn vị. Theo mặc định, đầu ra gỡ lỗi bị tắt ngoại trừ các đơn vị
`` khẳng định '' và `` chung chung ''. Danh sách chính xác các đơn vị có sẵn để gỡ lỗi có thể
được bật tùy thuộc vào việc jigdo được biên dịch với hỗ trợ gỡ lỗi hay không -
danh sách có thể được in bằng `--debug = help '.

CÁC TẬP TIN Tên của tệp hoặc thư mục để sử dụng làm đầu vào. Đây là những phần được
có trong hình ảnh. Trong trường hợp một trong các tên là thư mục, chương trình
quét đệ quy thư mục và thêm tất cả các tệp có trong đó. Trong khi làm
điều này, nó theo sau các liên kết tượng trưng, ​​nhưng tránh các vòng lặp liên kết tượng trưng.

Nếu một trong các tên tệp bắt đầu bằng ký tự `- ', bạn phải đứng trước danh sách
các tệp có dấu `- '. Giá trị của `- 'có Không ý nghĩa đặc biệt trong danh sách này, nó là viết tắt của
một tệp có tên là một dấu gạch ngang.

HÀNG

Tên lệnh là đối số không phải tùy chọn đầu tiên được chuyển đến tập tin jigdo. Hầu hết các lệnh đều có
tên viết tắt ngắn cũng như tên dài. Sản phẩm ngắn lệnh tên nên không be đã sử dụng in
kịch bản - có có thể be không tương thích thay đổi đến họ in các Tương lai!

LÀM MẪU, MT
Đọc hình ảnh và CÁC TẬP TIN, tạo ra `.jigdo'và'.bản mẫu'. Đây là chức năng chính của
tập tin jigdo.

Có thể chỉ định cả hai --image = - và --files-from = -. Trong trường hợp này, đầu tiên danh sách
của tệp được đọc từ đầu vào chuẩn cho đến khi gặp dòng trống. Mọi điều
theo sau nó được giả định là dữ liệu hình ảnh. Điều này có thể hữu ích nếu bạn sử dụng mkisofs(1) hoặc
các chương trình tương tự có thể xuất ra hình ảnh hoàn chỉnh trên đầu ra tiêu chuẩn của chúng, bởi vì
không cần phải lưu hình ảnh trên đĩa tạm thời.

Nếu một CÁC TẬP TIN đối số chứa các ký tự `// '(Unix) hoặc` \. \' (Windows), điều này có
Ý nghĩa đặc biệt. Trong tệp jigdo cuối cùng mà người dùng sẽ tải xuống, mỗi phần là
được tham chiếu trong phần `[Phần] 'với URI có dạng` Nhãn: một số / tên tệp'. (Nhìn thấy
`ĐỊNH DẠNG CÁC LỌC .JIGDO 'bên dưới để có mô tả chi tiết.) Phần` `[Máy chủ]' cung cấp
ánh xạ các nhãn tới các máy chủ trên internet, với các dòng như
`Nhãn =http://myserver.org/jigdofiles/'. Sử dụng thông tin này, trò đùa sẽ tạo ra
URI tải xuống cuối cùng cho một phần,http://myserver.org/jigdofiles/some/filename'.
Việc chỉ định `// '(hoặc` \. \') Trong tên tệp hoặc thư mục sẽ giúp `` cắt bỏ '' các tên tại
cấp thư mục phù hợp. Ví dụ: nếu đường dẫn Unix của một trong những CÁC TẬP TIN is
`/ path / some / filename ', bạn có thể nói tập tin jigdo để cắt bỏ sau dấu `/ đường dẫn 'bằng cách vượt qua nó
đối số `/ path // some / filename 'hoặc` / path //' nếu bạn muốn quét toàn bộ thư mục.
Tên đường dẫn không cần phải tuyệt đối; `somedirectory // 'cũng có thể.

--nhãn mác Nhãn = / đường dẫn
Chỉ định một tên để sử dụng làm tên nhãn cho một đường dẫn trên đĩa. (Ảnh hưởng đến đầu ra
tệp jigdo.) Nếu bạn đã sử dụng `// 'trong CÁC TẬP TIN đối số như được mô tả ở trên, tập tin jigdo
theo mặc định sẽ tự động chọn tên nhãn (`` A ', `B', v.v.). Với tùy chọn này,
bạn có thể đặt cho nhãn những cái tên có ý nghĩa hơn. Lưu ý rằng tên nhãn sẽ chỉ là
được sử dụng nếu một hoặc nhiều CÁC TẬP TIN bắt đầu bằng `/ path // '.

Cố gắng sử dụng các tên nhãn bắt đầu bằng các ký tự viết hoa để phân biệt chúng
rõ ràng từ các tên giao thức như `` http ', `` ftp'.

--uri Nhãn =http://some.server.org/
Theo mặc định, sử dụng --nhãn mác như được mô tả ở trên sẽ gây ra các dòng của biểu mẫu
`Label = file: / path / 'được ghi vào phần` `[Máy chủ]' của jigdo đầu ra
tập tin. Nếu bạn muốn ghi đè URI `tệp: 'để dòng đọc
`Nhãn =http://some.server.org/', bạn có thể làm như vậy bằng cách chỉ định --uri cùng với
--nhãn mác. Cho chỉ --uri Nhãn = ... không có tương ứng --nhãn mác Nhãn = ...
không có hiệu lực và ngay cả khi bạn chỉ định cả hai, một mục nhập chỉ được thêm vào
Phần `[Máy chủ] 'nếu nhãn được tham chiếu bởi ít nhất một mục nhập` [Bộ phận]'.

Giá trị được cung cấp không được trích dẫn bởi chương trình; nếu nó chứa các ký tự như
khoảng trắng hoặc bất kỳ ký tự nào trong số các ký tự # "'\ thì bạn phải trích dẫn nó. (Trong Unix, bạn có thể
cần phải trích dẫn giá trị hai lần để bảo vệ nó khỏi shell, ví dụ: \\\\ hoặc '\\'
để nhận được một dấu gạch chéo ngược trong URI.)

Ánh xạ được chỉ định với --uri tùy chọn bị bỏ qua nếu nó đã có trong
tệp jigdo đầu ra.

Người dùng phiên bản Windows có thể nhận thấy rằng các dấu phân tách thư mục `\ 'là
được chuyển đổi thành `/ 'trong các URI` tệp:' được tạo theo mặc định. Xong rồi
để tăng khả năng tương thích đa nền tảng của `tệp: '- the thiếu bản in mệnh lệnh của
phiên bản Windows sẽ tự động chuyển đổi lại các ký tự khi nó in
URI. Trong trường hợp bạn cung cấp URI 'tệp:' của riêng mình trong Windows bằng cách sử dụng --uri, quý vị phải
cũng trao đổi `/ 'và` \'.

-0 đến -9
Đặt lượng nén trong tệp mẫu đầu ra, từ -0 (không nén) thành
-9 (nén tối đa). Mặc định là -9, có thể tạo ra mẫu
khá chậm. Theo mặc định, thuật toán nén được sử dụng giống như đối với gzip(1).

--gzip và --bzip2
Chọn giữa thuật toán nén gzip và bzip2. Mặc định là gzip.
Bzip2 thường cho tỷ lệ nén tốt hơn, nhưng nén đáng kể
chậm hơn so với gzip.

--min-length =BYTES
Đặt chiều dài tối thiểu của một bộ phận cho tập tin jigdo để tìm kiếm nó trong hình ảnh. Các
mặc định là 1k. Các bộ phận nhỏ hơn kích thước này sẽ không bao giờ được tìm thấy trong hình ảnh, vì vậy chúng
dữ liệu sẽ được đưa vào tệp mẫu. Thuật toán tìm kiếm được sử dụng yêu cầu như vậy
độ dài tối thiểu, nếu không việc tạo mẫu có thể trở nên cực kỳ chậm. nếu bạn
biết chắc chắn rằng tất cả của bạn CÁC TẬP TIN lớn hơn một số tiền nhất định, bạn có thể
tăng tập tin jigdocủa tốc độ một chút bằng cách chỉ định số tiền với tùy chọn này.
Có tối thiểu tuyệt đối có dây cứng là 256 byte - bất kỳ thứ gì thấp hơn sẽ im lặng
được đặt thành 256.

--merge =FILE
Bao gồm các nội dung của FILE trong đầu ra '.jigdo' tập tin. Tệp có thể chứa dữ liệu
mà bạn muốn thêm vào đầu ra (ví dụ: phần [Máy ​​chủ] 'với danh sách
của máy chủ của bạn dưới dạng mục nhập) hoặc nó có thể là tệp jigdo đầu ra của một lần chạy trước đó
of tập tin jigdo.

Có thể chỉ định cùng một tệp cho đầu vào với - hợp nhất và cho đầu ra với
--jigdo. Tuy nhiên, bạn cũng sẽ cần sử dụng --lực lượng để làm cho chương trình ghi đè
phiên bản cũ của tệp jigdo với phiên bản mới. FILE có thể là `- 'cho tiêu chuẩn
đầu vào.

Thời Gian thêm thông tin mới cho tệp được cung cấp, tập tin jigdo sẽ không chèn mới
vào phần `` [Bộ phận] 'nếu mục nhập cho cùng một tổng kiểm tra MD5 (nhưng không
nhất thiết phải có cùng một URI!) đã tồn tại và nó sẽ không chèn các dòng mới
vào phần `[Máy chủ] 'nếu đã tồn tại một mục nhập hoàn toàn giống nhau.

Thời Gian đọc in hiện tại FILE, hành vi hơi khác một chút:
bảo tồn các mục nhập trong phần `` [Phần] 'có tổng kiểm tra giống hệt nhau, nhưng khác
URI. Đối với các mục nhập hoàn toàn giống nhau (cùng tổng kiểm tra và URI), chỉ có một mục nhập là
được bảo toàn và các bản sao được loại bỏ. Phần `` [Máy ​​chủ] 'ở bên trái
không bị đụng chạm.

- phần hình ảnh
T is các mặc định. Nguyên nhân tập tin jigdo để thêm phần `[Hình ảnh] 'vào phần`.jigdo'
tập tin.

Là một ngoại lệ, phần `` [Hình ảnh] 'mới là không được thêm vào nếu bạn sử dụng - hợp nhất và
tệp cần hợp nhất chứa phần `` [Hình ảnh] 'với một dòng có nội dung `Mẫu-
MD5Sum = '(cuối dòng sau dấu' = '). Trong trường hợp này, dữ liệu mẫu được tạo
Giá trị tổng kiểm tra MD5 chỉ được thêm vào sau dấu `= 'của dòng đầu tiên của biểu mẫu này trong
tệp - không có phần `[Hình ảnh] 'hoàn toàn mới nào được thêm vào. Hành vi này rất hữu ích
bởi vì nó cho phép bạn đi qua - hợp nhất phần `[Hình ảnh] 'với tùy ý
nội dung và sau đó có tổng kiểm tra MD5 tự động được thêm vào tập tin jigdo. Các
phần `` ĐỊNH DẠNG CÁC PHIM .JIGDO 'bên dưới giải thích nội dung phần `` [Hình ảnh]' trong
chi tiết hơn.

- phần không có hình ảnh
Do không bao gồm một phần `` [Hình ảnh] 'trong `.jigdo' tập tin. Bạn cần thêm một
bản thân nếu bạn sử dụng tùy chọn này. Tuy nhiên, để làm được điều đó không hề dễ dàng (bạn cũng cần phải
thêm dòng `` Template-MD5Sum '' với tổng kiểm tra chính xác, hoặc trò đùa sẽ phàn nàn), vì vậy
không khuyến khích sử dụng tùy chọn này.

--servers-phần
T is các mặc định. Nguyên nhân tập tin jigdo để thêm phần `[Máy chủ] 'vào phần`.jigdo'
tập tin. Phần mặc định này sử dụng URI `tệp: ', cho phép lắp ráp lại ngay lập tức
của hình ảnh từ hệ thống tệp cục bộ và cũng hữu ích nếu bạn muốn chỉnh sửa
tệp theo cách thủ công và thay thế các URI `tệp: 'bằng các URI khác.

- phần không có máy chủ
Do không thêm phần `[Máy chủ] 'vào cuối phần`.jigdo' tập tin. Hữu ích, ví dụ: nếu
bạn sẽ nối phần bằng một tập lệnh.

--match-executive =SHELLCOMMAND
Bất cứ khi nào tệp được tìm thấy trong hình ảnh, hãy thực hiện chuỗi lệnh được cung cấp bằng cách
chuyển nó vào một shell. tập tin jigdo thiết lập một số biến môi trường với
thông tin về sự trùng khớp của tệp. Ví dụ, nếu tệp/ đường dẫn // a / b / tệp' là
được tìm thấy trong hình ảnh và `` Nhãn: a / b / tệp 'sẽ được ghi vào `.jigdo'
tập tin:

· LABEL= "Nhãn" - Tên nhãn cho tệp. Ví dụ giả định rằng `--nhãn mác
Nhãn = / đường dẫn 'do bạn chỉ định. Trong trường hợp không có tùy chọn như vậy, LABEL sẽ
được đặt nhưng trống.

· DẪN NHÃN= "/ path /" - Đường dẫn tương ứng với nhãn, hay nói cách khác,
tiền tố của đường dẫn tệp phù hợp sẽ không xuất hiện trong đầu ra '.jigdo'
tập tin. Được đặt ngay cả khi không có bất kỳ `--nhãn mác'tùy chọn hiện tại. Kết thúc bằng một dấu gạch chéo.

· ĐƯỜNG LỐI= "a / b /" - Phần còn lại của đường dẫn, không có tên lá của kết quả phù hợp
tập tin. Để trống hoặc kết thúc bằng dấu gạch chéo.

· LÁ CÂY= "tệp" - Tên lá của tệp phù hợp.

· MD5SUM= "lNVdUSqbo2yqm33webrhnw" - md5sum của tệp phù hợp, giống Base64
định dạng.

· FILE= "/ path // a / b / file" - Để thuận tiện, đường dẫn đầy đủ của tệp. Các
biến luôn được đặt thành $ LABELPATH $ MATCHPATH $ LEAF.

Hãy cẩn thận trích dẫn chính xác chuỗi được chuyển đến tùy chọn này, nếu không
lệnh được cung cấp sẽ không hoạt động với tên tệp chứa khoảng trắng. Ví dụ, để
tạo bản sao lưu các liên kết cứng đến các tệp phù hợp, sử dụng tùy chọn sau: --match-
executive = 'mkdir -p "$ {LABEL: -.} / $ MATCHPATH" && ln -f "$ FILE" "$ {LABEL: -.} / $ MATCHPATH $ LEAF"'

Theo mặc định, không có lệnh nào được thực thi. Sử dụng --match-exec = "" để xóa một chuỗi lệnh
đã được thiết lập với việc sử dụng tùy chọn này trước đó.

- phù hợp với tham lam
T is các mặc định. Hãy tưởng tượng rằng hình ảnh của bạn chứa .tar đến lượt nó
chứa một tập tin khác xvà bạn cung cấp cả .tar và các tệp bên trong nó
trên dòng lệnh. Khi nào tập tin jigdo quét hình ảnh, nó bắt đầu
của .tar tệp, và sau đó là tệp x.

Tại thời điểm này, một quyết định phải được thực hiện: Nếu tệp nhỏ hơn x được ghi lại là
phù hợp, hoặc nó nên được bỏ qua để có lợi cho so khớp lớn hơn (và do đó tốt hơn) của
các .tar tập tin? Thật không may, tại thời điểm này, không rõ liệu có
thực sự là một trận đấu đầy đủ của .tar, vì vậy theo mặc định, chương trình ưu tiên
phù hợp.

- không tham lam-phù hợp
Trong trường hợp có một kết quả phù hợp một phần lớn và một kết hợp ngắn hơn đã được
xác nhận, bỏ qua trận đấu nhỏ. (Xem tùy chọn ở trên.)

LÀM HÌNH ẢNH, MI
Đọc '.bản mẫu'và CÁC TẬP TIN, tạo hình ảnh (hoặc `tên hình ảnh.tmp'). Cung cấp một
cách lắp ráp lại các hình ảnh - trò đùa thường phù hợp hơn cho nhiệm vụ này. Tuy nhiên, trong
tương phản với trò đùa, không `.jigdo'là bắt buộc.

Nếu hình ảnh được ghi vào một tệp (và không phải đầu ra tiêu chuẩn), có thể
tạo hình ảnh trong một số bước, với một số lời gọi của `tập tin jigdo trang điểm', như
sau: Lần đầu tiên bạn gọi tập tin jigdo, chỉ định bao nhiêu tệp có sẵn tại đây
thời gian. Chương trình quét các tệp và những tệp có trong hình ảnh được sao chép vào
một tệp tạm thời, có tên được hình thành bằng cách nối `.tmp'vào tên tệp hình ảnh.

Đối với tất cả các tệp khác có thể là một phần của hình ảnh, bạn lặp lại quá trình này. Ngay sau
vì tất cả các phần đều có mặt, tệp tạm thời sẽ bị cắt bớt một chút (để xóa một số
dữ liệu quản trị tập tin jigdo nối ở cuối) và đổi tên thành hình ảnh cuối cùng
Tên. Khả năng tập hợp lại hình ảnh trong một số bước đặc biệt hữu ích cho
thu thập các tệp từ phương tiện di động, ví dụ như một số đĩa CD cũ hơn.

Tập lệnh sử dụng trang điểm có thể phát hiện xem việc tạo hình ảnh đã hoàn tất hay chưa bằng cách kiểm tra
trạng thái thoát: 0 báo hiệu tạo thành công, ngược lại 1 có nghĩa là cần có nhiều tệp hơn
đã cung cấp. Các lỗi khác dẫn đến trạng thái thoát là 2 (`` có thể khôi phục ', ví dụ: không tìm thấy tệp)
hoặc 3 (không thể khôi phục, ví dụ: lỗi ghi).

--kiểm tra các tập tin
T is các mặc định. Bất cứ khi nào bất kỳ phần nào được sao chép vào hình ảnh, hãy kiểm tra lại
tổng kiểm tra so với tổng kiểm tra được lưu trữ trong mẫu. Chúng tôi khuyên bạn nên
hãy để chế độ này được bật, ngay cả khi nó làm chậm quá trình tạo ảnh một chút.

--không-kiểm tra-tập tin
Không kiểm tra tổng kiểm tra của tệp khi sao chép chúng vào hình ảnh. Điều này có thể được an toàn
được sử dụng khi không có tệp bộ đệm nào được sử dụng (có nghĩa là tệp sẽ được ghi vào
hình ảnh ngay sau khi được quét) hoặc toàn bộ hình ảnh được kiểm tra sau đó với
xác minh chỉ huy.

IN-MISSING, PM
Đọc '.jigdo','.bản mẫu'và (nếu có)'tên hình ảnh.tmp', xuất ra danh sách các URI vẫn
cần thiết để lắp ráp lại hoàn toàn hình ảnh.

Cùng với trang điểm lệnh này cung cấp hầu hết các chức năng của trò đùa on
dòng lệnh.

Đối với mỗi phần chưa có trong tệp hình ảnh tạm thời, tổng kiểm tra tệp là
được tra cứu trong phần `` [Phần] 'của tệp jigdo. Bất kỳ nhãn nào trong mục nhập tương ứng
sau đó được mở rộng theo định nghĩa nhãn trong phần `` [Máy ​​chủ] 'và được in
trên đầu ra tiêu chuẩn. trò đùa cho phép bạn chỉ định một số vị trí thay thế cho mỗi
nhãn trong phần này, nhưng thiếu bản in sẽ chỉ xuất cái đầu tiên cho mỗi cái bị thiếu
phần.

Nếu tổng tổng kiểm tra không thể được tìm thấy trong phần `` [Phần] '' (điều này sẽ không xảy ra trừ khi
bạn đã xóa phần đó), thay vào đó, một tra cứu được thực hiện cho `MD5Sum:', giống như
với trò đùa. (Vì vậy, nếu bạn muốn thoát khỏi phần `` [Phần] '', bạn có thể làm như vậy nếu bạn
đổi tên từng phần thành tổng kiểm tra của chính nó.)

--uri Nhãn =http://some.server.org/
Ghi đè các mục trong `.jigdo'cho bất kỳ nhãn nào có URI bạn chọn.
Với ví dụ trên, mục nhập `[Phần] 'của` Nhãn: một số / tên tệp' sẽ gây ra
dòng `http://some.server.org/some/filename' Được in.

Giá trị được cung cấp không được trích dẫn bởi chương trình; nếu nó chứa các ký tự như
khoảng trắng hoặc bất kỳ ký tự nào trong số các ký tự # "'\ thì bạn phải trích dẫn nó. (Trong Unix, bạn có thể
cần phải trích dẫn giá trị hai lần để bảo vệ nó khỏi shell, ví dụ: \\\\ hoặc '\\'
để nhận được một dấu gạch chéo ngược trong URI.)

IN-MISSING-ALL, PMA
Giống như thiếu bản in, lệnh này xuất ra danh sách các URI vẫn cần thiết để
lắp ráp lại hình ảnh. Tuy vậy, tất cả các các vị trí tải xuống thay thế được in thay vì
chỉ một. Trong đầu ra, các URI cho một tệp được phân tách khỏi các URI của các tệp khác bằng
dòng trống. Các --uri tùy chọn có tác dụng tương tự như đối với thiếu bản in.

XÁC NHẬN, VER
Đọc hình ảnh (có lẽ được tạo bằng trang điểm) và `.bản mẫu', kiểm tra xem có đúng không
tổng kiểm tra của hình ảnh.

Dữ liệu mẫu không chỉ chứa tổng tổng của các phần riêng lẻ mà còn chứa
hình ảnh nói chung. trang điểm đã thực hiện một số kiểm tra nội bộ, nhưng nếu bạn
như, bạn có thể kiểm tra thêm hình ảnh bằng lệnh này.

QUÉT, SC
Đọc tất cả CÁC TẬP TIN và nhập chúng vào bộ đệm, trừ khi chúng đã được lưu vào bộ đệm. Các
--bộ nhớ đệm tùy chọn phải có cho lệnh này.

--no-quét-toàn bộ tập tin
T is các mặc định. Điều này chỉ gây ra đầu tiên --md5-kích thước khối byte của mỗi tệp
được đọc. Nếu bộ nhớ cache được sử dụng sau này bởi tập tin jigdo trang điểm, phân con lại của
tệp sẽ được đọc khi các byte đầu tiên này được nhận dạng trong hình ảnh đầu vào.

--quét-toàn bộ tập tin
Đọc ngay toàn bộ nội dung tệp và lưu trữ chúng trong bộ nhớ đệm.

MD5SUM, MD5
Đọc tất cả CÁC TẬP TIN và in ra tổng kiểm tra MD5 của nội dung của chúng. Lệnh này khá
tương tự như md5sum(1), ngoại trừ việc tổng kiểm tra được xuất ra ở dạng mã hóa giống Base64
cũng được sử dụng ở những nơi khác bởi tập tin jigdo.

Sản phẩm CÁC TẬP TIN các đối số được xử lý theo cách tương tự như với các lệnh khác, có nghĩa là
quá trình đệ quy tự động diễn ra đối với bất kỳ đối số nào là thư mục và
các liên kết tượng trưng không được liệt kê ngoại trừ khi (các) tệp mà chúng trỏ đến không thể truy cập được
trực tiếp.

Trong danh sách tổng kiểm tra được in ở đầu ra tiêu chuẩn, chỉ một phần của tên tệp sau
bất kỳ `// '(hoặc` \. \' trên Windows) được in. Không tí nào --bộ nhớ đệm sẽ được sử dụng để truy vấn tệp '
Tổng kiểm tra MD5 và / hoặc ghi tổng kiểm tra của các tệp được quét.

DANH SÁCH-TEMPLATE, LS
Đọc một `.bản mẫu'và xuất ra thông tin cấp thấp về hình ảnh và tất cả các bộ phận
chứa trong nó, bao gồm offset, length và checksum.

Bạn cũng có thể sử dụng lệnh này với các tệp hình ảnh tạm thời (bằng cách chỉ định một cái gì đó như
--template = imagename.tmp) - trong trường hợp đó, đầu ra cũng phân biệt giữa các phần
đã được ghi vào hình ảnh và những phần chưa được ghi.

Định dạng đầu ra chính xác có thể thay đổi không tương thích giữa các bản phát hành jigdo khác nhau. Các
sau các loại đường khác nhau có thể được xuất ra. `has-file 'chỉ xảy ra cho`.tmp'
tệp, cho biết tệp đã được ghi thành công vào tệp tạm thời:

trong khuôn mẫu bù đắp trong hình ảnh chiều dài
cần-tập tin bù đắp trong hình ảnh chiều dài tệp-md5sum filestart-rsyncsum
có-tập tin bù đắp trong hình ảnh chiều dài tệp-md5sum filestart-rsyncsum
thông tin hình ảnh chiều dài hình ảnh hình ảnh-md5sum kích thước rsyncsum

CHI TIẾT

Jigsaw Download được tạo với định dạng ảnh CD ISO9660 - tuy nhiên,
sau đây cũng áp dụng cho nhiều định dạng hệ thống tệp khác, cũng như cho các kho lưu trữ `` tar '' và
kho lưu trữ zip không nén. Một hình ảnh CD chứa cả hai thông tin để tổ chức
hệ thống tệp (tiêu đề với tên đĩa, v.v., dữ liệu thư mục ISO9660, dữ liệu của các phần mở rộng như
Joliet hoặc RockRidge, zero padding) và các tệp có trong CD. Điều quan trọng
thuộc tính mà jigdo dựa vào là mỗi tệp được lưu trữ trong một phần liền kề của
hình ảnh; nó không được chia thành hai hoặc nhiều phần.

Thời Gian tập tin jigdo được cung cấp một số tệp có thể chứa trong một hình ảnh, nó sẽ phát hiện
liệu có bất kỳ tệp nào trong số các tệp hiện diện bằng cách sử dụng một tổng kiểm tra luân phiên lấy cảm hứng từ tệp được sử dụng hay không
by rsync(1). Dữ liệu kết quả được ghi vào `.bản mẫu'tệp: Nếu một phần của
hình ảnh không thể khớp (ví dụ: đó là thông tin thư mục), dữ liệu được nén và
được ghi trực tiếp vào mẫu. Tuy nhiên, nếu một tệp phù hợp được tìm thấy, dữ liệu của nó là
bị bỏ qua khỏi mẫu. Thay vào đó, chỉ một tham chiếu (tổng kiểm tra MD5 của tệp) là
được chèn vào mẫu.

Lưu ý rằng dữ liệu mẫu chỉ chứa dữ liệu nhị phân, không chứa bất kỳ tên tệp nào
hoặc URI, vì nó không thể dễ dàng chỉnh sửa trong trường hợp cần thay đổi bất kỳ giá trị nào trong số này.
Tất cả thông tin đó được lưu trữ trong.jigdo', một tệp văn bản mà bạn có thể thêm URL
cho (các) máy chủ của bạn. Tệp jigdo cung cấp ánh xạ cho mỗi tổng kiểm tra MD5 đến một hoặc nhiều
các vị trí tải xuống thay thế cho phần tương ứng.

Ngoài ánh xạ các tổng MD5 thành các URI, tệp jigdo cũng chứa một trỏ URI
đến vị trí tải xuống tệp mẫu. Theo cách này, trò đùa công cụ tải xuống chỉ cần
được cung cấp một URI (URI của.jigdo'file) để có thể tải xuống và lắp ráp lại
hình ảnh hoàn chỉnh.

FORMAT OF .JIGDO CÁC TẬP TIN

Định dạng tổng thể của `.jigdo'các tệp sau đó của `. Initial', cũng như được sử dụng bởi
Dự án Gnome và KDE cho một số dữ liệu. Tệp được tổ chức thành các phần, mỗi phần
được đặt trước bởi một dòng đọc `[Tên phần] '. Trong mỗi phần, các dòng có dạng
`Nhãn = Giá trị '. Những dòng như vậy còn được gọi là `` mục nhập '' bên dưới. Tất cả.jigdo'các tệp sử dụng UTF-8 như
mã hóa ký tự của chúng.

Nhận xét được giới thiệu bằng ký tự `# 'và kéo dài đến cuối dòng.
Khoảng trắng bị bỏ qua ở đầu và cuối dòng cũng như ở bên trái và bên phải của phần
tên và dấu `= 'trong các mục nhập. Hơn nữa, các tiện ích jigdo chia nhỏ văn bản của
giá trị nhập (tức là phần sau dấu `= ') thành các từ được phân tách bằng khoảng trắng, giống như
Vỏ Unix. Dấu ngoặc kép '' và dấu ngoặc kép "" có thể được sử dụng để ngăn chặn điều đó, ví dụ: URI
chứa khoảng trắng được tách ra. Tương tự, các ký tự có ý nghĩa đặc biệt (
các ký tự '"# \ và dấu cách / tab) phải được trích dẫn bằng \ để xuất hiện trong giá trị. Như với
shell, có sự khác biệt giữa '' và "": Trong '', các ký tự "# \ và
khoảng trắng mất đi ý nghĩa đặc biệt của chúng và trở thành các ký tự bình thường, trong khi bên trong "",
chỉ có ký tự # và khoảng trắng mới mất đi ý nghĩa đặc biệt của chúng - nói cách khác,
thoát dấu gạch chéo ngược vẫn hoạt động bên trong "", nhưng không hoạt động "".

`.jigdo'tùy chọn tệp có thể được nén bằng gzip(1). tập tin jigdo luôn luôn đầu ra
các tệp không nén mà bạn có thể tự nén. jigdo-lite hỗ trợ đơn
các tệp không nén và nén.

(Hành vi có thể thay đổi trong tương lai và không nên dựa vào: trò đùa
bổ sung hỗ trợ bất kỳ số lượng bản rõ được ghép nối và các phần được nén trong các tệp
- ví dụ, bạn có thể nén một dấu `.jigdo'và sau đó thêm một vài dòng
dữ liệu không nén đến cuối.)

Trong mọi trường hợp,.gzphần mở rộng 'nên được xóa khỏi tên tệp - các công cụ sẽ
tự động xác định từ nội dung tệp xem tệp có được nén hay không.

Dưới đây là mô tả về các tên phần riêng lẻ được jigdo sử dụng.

JIGDO PHẦN
[Jigdo]
Phiên bản = 1.1
Generator = jigdo-file / 1.0.0

Thông tin về phiên bản của định dạng tệp jigdo được sử dụng và chương trình
đã tạo ra nó. Nên có một phần như vậy cho mỗi `.jigdo' tập tin.

IMAGE PHẦN
[Hình ảnh]
Tên tệp ="tên tệp cho tiết kiệm on người dùng đĩa"
Mẫu ="URI Ở đâu đến lấy mẫu tập tin"
Template-MD5Sum=OQ8riqT1BuyzsrT9964A7g
ShortInfo =một dòng Mô tả of các hình ảnh (200 nhân vật tối đa)
Thông tin =Dài Mô tả (5000 nhân vật tối đa)

Giá trị cho mục nhập `` Mẫu '' có thể là một URL (tuyệt đối hoặc liên quan đến URL
của tệp jigdo) hoặc một chuỗi có dạng `nhãn:tên đường dẫn'(KHÔNG ĐƯỢC SỬA ĐỔI), như mô tả
phía dưới.

Mục nhập `` Template-MD5Sum '' được thêm vào bởi tập tin jigdo và chỉ định tổng kiểm tra MD5 của
tạo ra.bản mẫu' tập tin. Nó được sử dụng bởi trò đùa để phát hiện các trường hợp tải xuống
dữ liệu mẫu bị hỏng hoặc thuộc về một hình ảnh khác.

Không giống như các giá trị mục nhập khác, giá trị của các mục nhập `` ShortInfo '' và `` Thông tin '' là không chia
thành lời, thay vào đó tất cả trích dẫn được giữ nguyên.

Giá trị của mục nhập `` Thông tin '' đặc biệt ở chỗ trò đùa(1) có thể tùy chọn phân tích cú pháp đánh dấu XML
Nó chứa. Nếu đánh dấu có lỗi như thẻ không cân bằng / không được hỗ trợ, thì chuỗi
được hiển thị theo nghĩa đen, không cần phân tích cú pháp XML. Các thẻ được hỗ trợ là (in đậm),
(chữ nghiêng), (phông chữ máy đánh chữ), (gạch dưới), (phông chữ lớn hơn),
(phông chữ nhỏ hơn) và (ngắt dòng). Các thực thể được hỗ trợ bao gồm <
(`<'),> (` `>') và & (` & '). Lưu ý rằng toàn bộ mục nhập `` Thông tin '' phải nằm trên một dòng trong
tệp jigdo.

Phần này có thể xảy ra nhiều lần, nhưng tất cả ngoại trừ phần đầu tiên sẽ bị bỏ qua. Cái này
rất hữu ích, ví dụ: khi tạo một `.jigdo'cho một hình ảnh DVD khi bạn đã có
`.jigdo'cho các đĩa CD có cùng nội dung: Bạn có thể chỉ cần `` [Bao gồm]' (xem bên dưới)
Tệp jigdo của đĩa CD ở cuối tệp jigdo của DVD, sau phần `` [Hình ảnh] 'của nó.

CÁC BỘ PHẬN PHẦN
[Các bộ phận]
xJNkjrq8NYMraeGavUpllw = LabelA: part0
GoTResP2EC6Lb_2wTsqOoQ = LabelA: part1
kyfebwu6clbYqqWUdFIyaw = LabelB: some / path / part2
-J9UAimo0Bqg9c0oOXI1mQ=http://some.where.com/part3

Tất cả các dòng trong phần, cung cấp ánh xạ từ tổng kiểm tra MD5 sang URI, có
cùng định dạng: Ở phía bên trái của dấu `= 'tổng kiểm tra (được mã hóa bằng Base64 giống
mã hóa) được đưa ra và ở bên phải một chuỗi tương ứng với phần có
tổng kiểm tra; hoặc là một URI hoàn chỉnh hoặc một chuỗi có dạng `nhãn:tên đường dẫn', đó là
được mở rộng thành một hoặc nhiều URI bằng cách tra cứu (các) định nghĩa cho nhãn trong
Phần [Máy ​​chủ].

Trong trường hợp không thể tìm thấy tổng kiểm tra MD5 cụ thể trong bất kỳ phần `` [Phần] '' nào bằng cách trò đùa, Các
chương trình sẽ thực hiện tra cứu `MD5Sum:', ví dụ cho
`MD5Sum: xJNkjrq8NYMraeGavUpllw 'nếu bạn đã xóa dòng cho` part0' ở trên.

Tổng kiểm tra xuất hiện nhiều lần trong phần này cho biết tải xuống thay thế
vị trí cho bộ phận.

Có thể có bất kỳ số phần `` [Phần] '' nào trong tệp; tất cả chúng đều được coi là khi
tra cứu tổng kiểm tra MD5.

tập tin jigdo luôn đặt phần `` [Phần] 'ở cuối tệp và nó thậm chí
sắp xếp lại bất kỳ tệp nào được chỉ định với - hợp nhất chỉ có một phần như vậy ở cuối. Cái này
được thực hiện để cho phép trò đùa để hiển thị thông tin từ phần `` [Hình ảnh] 'trong khi
phần còn lại của tệp đó vẫn đang được tải xuống.

MÁY CHỦ PHẦN
[May chủ]
NhãnA =http://myserver.org/
NhãnA =ftp://mirror.myserver.org/
LabelB = LabelC: thư mục con /
NhãnC =http://some.where.com/jigdo/

Tất cả các dòng trong phần, cung cấp ánh xạ từ nhãn máy chủ đến máy chủ
vị trí, có cùng định dạng: Ở phía bên trái của dấu `= ', tên nhãn được đưa ra và
ở bên phải giá trị để mở rộng tên nhãn thành.

Tên nhãn xuất hiện nhiều lần trong phần này cho biết tải xuống thay thế
vị trí cho các bộ phận sử dụng nhãn trong phần `` [Bộ phận] '. Ký hiệu này làm cho
rất dễ dàng để thêm gương vào tệp jigdo.

Như được minh họa trong ví dụ trên, bản thân các giá trị nhãn có thể tham chiếu đến các nhãn khác. Trong
trong trường hợp này, mục nhập `LabelB: some / path / part2 'trong phần` `[Phần]' sẽ mở rộng thành
`http://some.where.com/jigdo/subdirectory/some/path/part2'. Các vòng lặp trong nhãn
định nghĩa dẫn đến hành vi không xác định và phải tránh.

Có thể có bất kỳ số phần `` [Máy ​​chủ] '' nào trong tệp; tất cả chúng đều được coi là khi
tra cứu nhãn. Có thể bỏ qua một trong hai `[Bộ phận] 'hoặc` [Máy ​​chủ]', nhưng không phải cả hai,
tệp jigdo.

LÀM THẾ NÀO PHẦN
[Bình luận]
Bất kỳ văn bản nào, ngoại trừ các dòng không được bắt đầu bằng dấu `['.

Tất cả văn bản sau dòng `` [Nhận xét] 'hoặc `[nhận xét]' đều bị bỏ qua, cho đến dòng tiếp theo với
một nhãn phần.

BAO GỒM TRỰC TIẾP
[Bao gồm http://some.url/file.jigdo]

Các dòng của biểu mẫu này làm cho nội dung của tệp jigdo được chỉ định được tải xuống và
được phân tích cú pháp giống như tệp jigdo chính. Hiệu ứng sẽ giống như sao chép
nội dung của tệp vào tệp chứa chỉ thị include. (Ngoại lệ: Bất kỳ
URL tương đối luôn được giải quyết bằng cách sử dụng URL của `.jigdo'tệp chứa cái đó
URL tương đối.)

Đối số URL có thể là URL tuyệt đối hoặc URL tương đối. URL tương đối được giả định là
liên quan đến URL của tệp jigdo chứa chỉ thị include. Bao gồm lon
được lồng vào nhau, nhưng đó là một lỗi khi tạo một vòng lặp các chỉ thị include. Nó là không có thể
để sử dụng các URL của biểu mẫu `nhãn:tên đường dẫn'.

URL không thể được trích dẫn bằng "". Mọi ký tự `] 'trong đối số phải được thoát ra dưới dạng
'% 5D' và bất kỳ khoảng trắng nào dưới dạng '% 20'.

Chỉ thị bao gồm chỉ được hỗ trợ bởi trò đùa, họ bị bỏ qua bởi jigdo-lite.

Chỉ thị include chấm dứt bất kỳ phần nào trước đó, nhưng nó không bắt đầu phần mới. Trong
nói cách khác, một phần mới phải luôn được bắt đầu sau dòng bao gồm, trò đùa không
cho phép các mục nhập bình thường xuất hiện bên dưới `[Bao gồm] '.

CACHE CÁC TẬP TIN

Bất kỳ tệp nào được chỉ định với --bộ nhớ đệm tùy chọn được sử dụng để lưu trữ thông tin về CÁC TẬP TIN
trình bày cho tập tin jigdo. Khi truy vấn bộ nhớ cache, một tệp được coi là không thay đổi (và
dữ liệu đã lưu trong bộ nhớ cache được sử dụng) chỉ khi tên tệp, kích thước tệp và thời gian sửa đổi lần cuối (mtime) khớp
chính xác. Đối với khớp tên tệp, không phải toàn bộ tên tệp được sử dụng mà chỉ sử dụng một phần
theo sau bất kỳ dấu `// 'nào, để mọi thay đổi đối với phần trước dấu` //' sẽ không làm mất hiệu lực
bộ nhớ cache.

Các mục nhập bộ đệm cũ sẽ bị xóa khỏi bộ đệm nếu chúng chưa được đọc hoặc ghi vào
trong khoảng thời gian được chỉ định với --cache-hết hạn. Mục nhập là không ngay lập tức bị loại bỏ
từ bộ nhớ cache nếu tệp mà chúng đề cập đến không còn tồn tại - điều này giúp bạn có thể
thông tin bộ nhớ cache về các tệp trên phương tiện di động.

Hết hạn bộ nhớ cache chỉ diễn ra sau khi tập tin jigdo đã hoàn thành công việc chính của nó - nếu có bất kỳ mục cũ nào
được truy cập trước khi hết hạn sử dụng, chúng sẽ được giữ lại. Ví dụ: nếu chương trình
chạy bằng thời gian hết hạn mặc định là 30 ngày, nhưng truy cập tệp bộ đệm ẩn với các mục nhập
được tạo cách đây 2 tháng, sau đó là các mục nhập trong bộ nhớ cache đó sẽ được xem xét, và chỉ những
các mục nhập bộ nhớ cache không cần thiết trong quá trình chạy chương trình sẽ hết hạn.

Do đặc thù của thư viện cơ sở dữ liệu bên dưới (libdb3), các tệp bộ đệm ẩn không bao giờ
co lại, chúng chỉ phát triển. Nếu một số lượng lớn các mục nhập đã hết hạn từ tệp bộ nhớ cache của bạn và
bạn muốn nó thu nhỏ, bạn có thể chỉ cần xóa nó (tất nhiên sau đó mọi thứ sẽ có
được tạo lại) hoặc sử dụng các tiện ích đi kèm libdb3 để kết xuất và khôi phục
cơ sở dữ liệu, với một lệnh như `db3_dump old-cache.db | db3_load new-cache.db'. Đối với Debian,
các chương trình này được cung cấp trong gói 'libdb3-use'.

Nếu khác --md5-kích thước khối được chỉ định, toàn bộ tệp cần được đọc lại
cập nhật mục nhập bộ nhớ cache của nó. Nếu khác --Độ dài nhỏ nhất được chỉ định, chỉ cái đầu tiên
Cần đọc lại byte `md5-block-size 'của tệp.

VÍ DỤ

CHUẨN BỊ CỦA BẠN CD IMAGE CHO PHÂN PHỐI
Bạn đã tạo một ảnh CD 'hình ảnh.iso'từ một số tệp được lưu trữ trong thư mục
`/ home / ftp'trên đĩa cứng của bạn, cũng có sẵn trực tuyến như là'ftp://mysite.org'. Như
bạn không muốn lãng phí dung lượng bằng cách lưu trữ hiệu quả cùng một dữ liệu hai lần (một lần khi các tệp trên
máy chủ FTP, một khi bên trong hình ảnh), và bạn chán ngấy với việc tải xuống của người dùng bị hủy bỏ
sau 200MB và họ khởi động lại quá trình tải xuống hàng chục lần, bạn quyết định sử dụng jigdo.
Làm thế nào để bạn chuẩn bị hình ảnh để tải xuống?

Trên thực tế, chỉ một lệnh là cần thiết:

tập tin jigdo trang điểm --image = image.iso --jigdo = / home / ftp / image.jigdo
--template = / home / ftp / image.template / home / ftp // --nhãn mác Mysite = / home / ftp --uri
Mysite =ftp://mysite.org/

Mọi người bây giờ có thể chỉ trò đùa tại `ftp://mysite.org/image.jigdo'để tải xuống hình ảnh của bạn. Các
tệp mẫu cần có thể truy cập được dưới dạng `ftp://mysite.org/image.template'.

Lưu ý rằng không có gì ngăn cản bạn làm điều tương tự đối với một máy chủ FTP không
do bạn quản lý - trong trường hợp đó, bạn chỉ cần lưu trữ `.jigdo'và'.bản mẫu'
các tệp trên máy chủ / trang chủ của riêng bạn.

CHUẨN BỊ AN BẤT KỲ LARGE FILE CHO PHÂN PHỐI
Chúng tôi giả định rằng bạn có một tệp lớn không phải là một hệ thống tệp, ví dụ:phim.mpeg'. Tại vì
về vấn đề không gian, bạn muốn phân phối dữ liệu trên hai máy chủ.

Trong trường hợp này, các phần của hình ảnh cần được tạo nhân tạo với chia
chỉ huy. Ví dụ: để tạo các phần 4MB mỗi phần, hãy sử dụng `chia -b 4m phim.mpeg một phần'.
Sao chép các tệp kết quả `phầnXX'thành hai thư mục'1'và'2'mà bạn tạo ra,
theo cách bạn muốn các tệp được phân phối giữa các máy chủ. Tiếp theo, tạo
tệp jigdo và tệp mẫu với `tập tin jigdo trang điểm --image = movie.mpeg 1 // 2 //'. Bạn
sẽ cần phải chỉnh sửa.jigdo'và cung cấp các URI phù hợp cho hai máy chủ
bạn sẽ tải lênphầnXX'để.

Độc lập PHIÊN BẢN OF HÌNH ẢNH
Vì có thể chỉ định một URI khác nhau cho từng phần của hình ảnh nếu cần,
jigdo rất linh hoạt. Chỉ có một ví dụ là khả năng có các phiên bản tùy chỉnh của
hình ảnh: Giả sử ai đó đang phân phối hình ảnh đĩa CD và bạn muốn tạo một vài hình ảnh
những thay đổi nhỏ đối với nó và phân phối lại phiên bản của riêng bạn. Bạn tải về `chính thức.iso' ĐĨA CD
hình ảnh với trò đùa (chuyển cho nó URL của `Official.jigdo'), ghi nó vào CD-R, làm cho
thay đổi (giả sử, thêm tệp từ `tập tin của tôithư mục 'trên đĩa cứng của bạn) và tạo
phiên bản riêng,myversion.iso'. Tiếp theo, bạn hướng dẫn tập tin jigdo để tạo jigdo và
tệp mẫu cho hình ảnh đã sửa đổi của bạn, sử dụng lệnh

tập tin jigdo trang điểm --image = myversion.iso / mnt / cdrom / myfiles // --nhãn mác
Của tôi = myfiles / --uri Của tôi =http://my.homepage.net/ --merge = official.jigdo
trong khichính thức.iso'được gắn dưới'/ mnt / cdrom'. Bằng cách sử dụng - hợp nhất, bạn đã nói jigdo-
hồ sơ lấy nội dung của `Official.jigdo', thêm vào đó một phần `` [Hình ảnh]' mới cho
`myversion.iso'và ghi tệp jigdo kết quả vào `myversion.jigdo' - vậy bây giờ
`myversion.jigdo'cung cấp hai hình ảnh để tải xuống, phiên bản gốc và hình ảnh đã sửa đổi của bạn
phiên bản. (Nếu bạn không muốn nó cung cấp phiên bản chính thức, hãy chỉnh sửa nó và xóa
Phần [Hình ảnh] 'liệt kê `chính thức.iso'.)

Bây giờ bạn có thể tải lên.jigdo'tập tin,'.bản mẫu'tệp và cả các tệp trong `tập tin của tôi'
đến `http://my.homepage.net/'. Do đó, để mọi người tải xuống hình ảnh đã sửa đổi của bạn, bạn phải
không cần tải toàn bộ nội dung hình ảnh lên không gian web của bạn, nhưng chỉ những thay đổi bạn
làm ra!

(Trong trường hợp bạn chỉ thực hiện rất ít thay đổi, bạn cũng có thể bỏ qua tham số `myfiles 'trong
lệnh trên, sau đó tất cả các thay đổi của bạn sẽ kết thúc trong tệp mẫu mới.)

KẾT HỢP Nhiều JIGDO-QUẢN LÝ HÌNH ẢNH VÀO ONE
Cũng không có vấn đề gì khi kết hợp dữ liệu từ một số nguồn sử dụng jigdo. Ví dụ, nếu
trong số năm máy chủ khác nhau và không liên quan, mỗi máy chủ phân phối một hình ảnh CD khác nhau qua
jigdo, bạn có thể tạo hình ảnh DVD tùy chỉnh có chứa dữ liệu từ tất cả các đĩa CD này.
Khi mọi người sử dụng trò đùa để tải xuống hình ảnh của bạn, các tệp riêng lẻ trên DVD sẽ được tìm nạp
từ các nguồn giống như các đĩa CD gốc.

Do đó, mặc dù bạn sẽ phân phối tệp 3.2 GB qua không gian web của mình,
lượng dữ liệu thực tế được lưu trữ trên máy chủ của bạn sẽ chỉ theo thứ tự của một số
MB.

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