git-cat-file - Trực tuyến trên Đám mây

CHƯƠNG TRÌNH:

TÊN

git-cat-file - Cung cấp nội dung hoặc thông tin loại và kích thước cho các đối tượng kho lưu trữ

SYNOPSIS

git tập tin mèo (-t [--allow-chưa biết-loại] | -s [--allow-không xác định-loại] | -e | -p | | --textconv)
git tập tin mèo (--batch | --batch-check) [--theo-liên kết tượng trưng]

MÔ TẢ

Ở dạng đầu tiên, lệnh cung cấp nội dung hoặc kiểu của một đối tượng trong
kho. Loại này là bắt buộc trừ khi -t or -p được sử dụng để tìm loại đối tượng, hoặc -s is
được sử dụng để tìm kích thước đối tượng, hoặc --textconv được sử dụng (ngụ ý loại "blob").

Trong biểu mẫu thứ hai, danh sách các đối tượng (được phân tách bằng nguồn cấp dữ liệu dòng) được cung cấp trên stdin và
SHA-1, loại và kích thước của mỗi đối tượng được in trên stdout.

LỰA CHỌN

Tên của đối tượng để hiển thị. Để có danh sách đầy đủ hơn về các cách đánh vần đối tượng
tên, hãy xem phần "CÂU HỎI CỤ THỂ" trong gitrevision(7).

-t
Thay vì nội dung, hãy hiển thị loại đối tượng được xác định bởi .

-s
Thay vì nội dung, hãy hiển thị kích thước đối tượng được xác định bởi .

-e
Ngăn chặn tất cả các đầu ra; thay vào đó, thoát với trạng thái XNUMX nếu tồn tại và là một hợp lệ
vật.

-p
In đẹp nội dung của dựa trên loại của nó.


Thông thường, điều này phù hợp với loại thực của nhưng yêu cầu một loại có thể
tầm thường được tham chiếu từ cái đã cho cũng được cho phép. Một ví dụ là
yêu cầu một "cây" với là một đối tượng cam kết có chứa nó hoặc để yêu cầu một
"blob" với là một đối tượng thẻ trỏ vào nó.

--textconv
Hiển thị nội dung dưới dạng được chuyển đổi bởi bộ lọc textconv. Trong trường hợp này, đã được của
hình thức : , hoặc : để áp dụng bộ lọc cho nội dung
được ghi lại trong chỉ mục tại .

--batch, --batch =
In thông tin đối tượng và nội dung cho từng đối tượng được cung cấp trên stdin. Có thể không
kết hợp với bất kỳ tùy chọn hoặc đối số nào khác. Xem phần BATCH OUTPUT bên dưới để biết
chi tiết.

- kiểm tra hàng loạt, - kiểm tra hàng loạt =
In thông tin đối tượng cho từng đối tượng được cung cấp trên stdin. Có thể không được kết hợp với
bất kỳ tùy chọn hoặc đối số nào khác. Xem phần BATCH OUTPUT bên dưới để biết thêm chi tiết.

--batch-all-object
Thay vì đọc danh sách các đối tượng trên stdin, hãy thực hiện thao tác hàng loạt được yêu cầu
trên tất cả các đối tượng trong kho lưu trữ và bất kỳ đối tượng thay thế nào lưu trữ (không chỉ có thể truy cập
các đối tượng). Yêu cầu --batch hoặc --batch-check được chỉ định. Lưu ý rằng các đối tượng là
đã truy cập theo thứ tự được sắp xếp theo hàm băm của chúng.

--đệm
Thông thường đầu ra hàng loạt được xóa sau khi mỗi đối tượng được xuất ra, để một quy trình có thể
đọc và ghi tương tác từ cat-file. Với tùy chọn này, đầu ra sử dụng bình thường
đệm stdio; điều này hiệu quả hơn nhiều khi gọi - kiểm tra hàng loạt trên một
số lượng đối tượng.

--allow-không xác định-type
Cho phép -s hoặc -t truy vấn các đối tượng bị hỏng / bị hỏng thuộc loại không xác định.

--follow-liên kết tượng trưng
Với --batch hoặc --batch-check, hãy theo dõi các liên kết tượng trưng bên trong kho lưu trữ khi yêu cầu
các đối tượng có biểu thức SHA-1 mở rộng của dạng tree-ish: path-in-tree. Thay vì
cung cấp đầu ra về bản thân liên kết, cung cấp đầu ra về đối tượng được liên kết. Nếu như
một liên kết tượng trưng trỏ ra ngoài tree-ish (ví dụ: một liên kết tới / foo hoặc một liên kết cấp cơ sở tới
../foo), phần liên kết nằm ngoài cây sẽ được in.

Tùy chọn này không (hiện tại) hoạt động chính xác khi một đối tượng trong chỉ mục
được chỉ định (ví dụ: liên kết thay vì HEAD: liên kết) thay vì một liên kết trong cây.

Không thể (hiện tại) sử dụng tùy chọn này trừ khi --batch hoặc --batch-check được sử dụng.

Ví dụ: hãy xem xét một kho lưu trữ git chứa:

f: một tệp chứa "hello \ n"
liên kết: một liên kết tượng trưng đến f
dir / link: một liên kết tượng trưng tới ../f
plink: một liên kết tượng trưng tới ../f
alink: một liên kết tượng trưng tới / etc / passwd

Đối với tệp thông thường f, echo HEAD: f | git cat-file --batch will print

ce013625030ba8dba906f756967f9e9ca394464a blob 6

Và echo HEAD: liên kết | git cat-file --batch --follow-symlinks se in y tuong
điều, cũng như HEAD: dir / link, vì cả hai đều trỏ đến HEAD: f.

Nếu không có --follow-symlinks, những liên kết này sẽ in dữ liệu về chính liên kết tượng trưng. bên trong
trường hợp của HEAD: liên kết, bạn sẽ thấy

4d1ae35ba2c8ec712fa2a379db44ad639ca277bd blob 1

Cả plink và alink đều trỏ ra ngoài cây, vì vậy chúng sẽ in ra tương ứng:

liên kết tượng trưng 4
../NS

liên kết tượng trưng 11
/ etc / passwd

OUTPUT

If -t được chỉ định, một trong những .

If -s được chỉ định, kích thước của tính bằng byte.

If -e được chỉ định, không có đầu ra.

If -p được chỉ định, nội dung của được in đẹp.

Nếu như được chỉ định, nội dung thô (mặc dù không nén) của sẽ là
trả lại.

PIN OUTPUT

Nếu --batch hoặc --batch-check được đưa ra, cat-file sẽ đọc các đối tượng từ stdin, một đối tượng trên mỗi dòng,
và in thông tin về chúng. Theo mặc định, toàn bộ dòng được coi là một đối tượng,
như thể nó được cho ăn git-rev-phân tích cú pháp(1).

Bạn có thể chỉ định thông tin hiển thị cho từng đối tượng bằng cách sử dụng tùy chỉnh . Các
được sao chép theo nghĩa đen sang stdout cho từng đối tượng, với trình giữ chỗ của biểu mẫu
% (nguyên tử) được mở rộng, theo sau là một dòng mới. Các nguyên tử có sẵn là:

tên của môn học
Tên đối tượng 40-hex của đối tượng.

loại đối tượng
Loại đối tượng (giống như báo cáo cat-file -t).

đồ vật
Kích thước, tính bằng byte, của đối tượng (giống như báo cáo cat-file -s).

objectize: disk
Kích thước, tính bằng byte, đối tượng chiếm trên đĩa. Xem ghi chú về kích thước trên đĩa
trong phần CAVEATS bên dưới.

cơ sở đồng bằng
Nếu đối tượng được lưu trữ dưới dạng delta trên đĩa, đối tượng này sẽ mở rộng thành 40-hex sha1 của
đối tượng cơ sở delta. Nếu không, mở rộng đến sha1 null (40 số XNUMX). Xem CAVEATS bên dưới.

phần còn lại
Nếu nguyên tử này được sử dụng trong chuỗi đầu ra, các dòng đầu vào sẽ được tách ra ở lần đầu tiên
ranh giới khoảng trắng. Tất cả các ký tự trước khoảng trắng đó được coi là
tên của môn học; các ký tự sau lần chạy khoảng trắng đầu tiên đó (tức là "phần còn lại" của
dòng) là đầu ra thay cho% (phần còn lại) nguyên tử.

Nếu không có định dạng nào được chỉ định, thì định dạng mặc định là% (objectname)% (objecttype)
% (kích thước đối tượng).

Nếu --batch được chỉ định, thông tin đối tượng được theo sau bởi nội dung đối tượng
(bao gồm% (kích thước đối tượng) byte), theo sau là một dòng mới.

Ví dụ: --batch không có định dạng tùy chỉnh sẽ tạo ra:

SP SP LF
LF

Trong khi --batch-check = '% (objectname)% (objecttype)' sẽ tạo ra:

SP LF

Nếu một tên được chỉ định trên stdin không thể được giải quyết cho một đối tượng trong kho lưu trữ,
thì cat-file sẽ bỏ qua bất kỳ định dạng tùy chỉnh nào và in:

SP thiếu LF

Nếu --follow-symlinks được sử dụng và một liên kết tượng trưng trong kho lưu trữ hướng ra bên ngoài
kho lưu trữ, sau đó cat-file sẽ bỏ qua bất kỳ định dạng tùy chỉnh nào và in:

liên kết tượng trưng SP LF
LF

Liên kết biểu tượng sẽ là tuyệt đối (bắt đầu bằng dấu /) hoặc liên quan đến gốc cây.
Ví dụ: nếu dir / link trỏ đến ../../foo, thì sẽ là ../foo. Là
kích thước của liên kết biểu tượng tính bằng byte.

Nếu --follow-symlinks được sử dụng, các thông báo lỗi sau sẽ được hiển thị:

SP thiếu LF

được in khi liên kết biểu tượng ban đầu được yêu cầu không tồn tại.

SP lủng lẳng LF
LF

được in khi liên kết tượng trưng ban đầu tồn tại, nhưng một cái gì đó mà nó (transitive-of) trỏ đến
không.

vòng lặp SP LF
LF

được in cho các vòng lặp liên kết tượng trưng (hoặc bất kỳ liên kết tượng trưng nào yêu cầu hơn 40 độ phân giải liên kết
để giải quyết).

notdir SP LF
LF

được in khi, trong quá trình phân giải liên kết biểu tượng, một tệp được sử dụng làm tên thư mục.

THẬN TRỌNG

Lưu ý rằng kích thước của các đối tượng trên đĩa được báo cáo chính xác, nhưng cần cẩn thận
trong việc rút ra kết luận về các tham chiếu hoặc đối tượng nào chịu trách nhiệm cho việc sử dụng đĩa. Các
kích thước của một đối tượng không phải delta được đóng gói có thể lớn hơn nhiều so với kích thước của các đối tượng mà delta
chống lại nó, nhưng việc lựa chọn đối tượng nào là cơ sở và đối tượng nào là đồng bằng là tùy ý
và có thể thay đổi trong quá trình đóng gói lại.

Cũng lưu ý rằng nhiều bản sao của một đối tượng có thể có trong cơ sở dữ liệu đối tượng; trong này
trường hợp, không xác định được kích thước hoặc cơ sở delta của bản sao nào sẽ được báo cáo.

GIT

Một phần của git(1) bộ

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