llvm-ar - Trực tuyến trên Đám mây

CHƯƠNG TRÌNH:

TÊN

llvm-ar - trình lưu trữ LLVM

SYNOPSIS

llvm-ar [-] {dmpqrtx} [Rabfikou] [relpos] [đếm] [các tập tin...]

MÔ TẢ

Sản phẩm llvm-ar lệnh tương tự như tiện ích Unix phổ biến, ar. Nó lưu trữ một số tệp
cùng nhau thành một tệp duy nhất. Mục đích của việc này là tạo ra các thư viện lưu trữ bằng LLVM
mã bit có thể được liên kết vào một chương trình LLVM. Tuy nhiên, kho lưu trữ có thể chứa bất kỳ loại nào
của tệp. Theo mặc định, llvm-ar tạo một bảng ký hiệu giúp liên kết nhanh hơn vì
chỉ bảng ký hiệu cần được tham khảo, không phải từng thành viên tệp riêng lẻ của
kho lưu trữ.

Sản phẩm llvm-ar lệnh có thể được sử dụng để đọc Các tệp lưu trữ kiểu SVR4, GNU và BSD. Tuy vậy,
ngay bây giờ nó chỉ có thể viết ở định dạng GNU. Nếu một kho lưu trữ kiểu SVR4 hoặc BSD được sử dụng
với r (thay thế) hoặc q (cập nhật nhanh) hoạt động, kho lưu trữ sẽ được xây dựng lại trong
Định dạng GNU.

Đây là nơi llvm-ar khởi hành từ trước ar triển khai:

Mã Bàn
từ llvm-ar hỗ trợ các tệp bitcode. Bảng ký hiệu mà nó tạo ra có định dạng GNU và
bao gồm cả tệp gốc và tệp mã bit.

dài Đường dẫn
Hiện nay llvm-ar có thể đọc các tên tệp dài GNU và BSD, nhưng chỉ ghi các tệp lưu trữ với
định dạng GNU.

LỰA CHỌN

Các tùy chọn để llvm-ar tương thích với khác ar triển khai. Tuy nhiên, có một
một vài bổ ngữ (R) mà không được tìm thấy trong khác ar triển khai. Các tùy chọn để llvm-ar
chỉ định một thao tác cơ bản duy nhất để thực hiện trên kho lưu trữ, nhiều công cụ sửa đổi cho
thao tác đó, tên của tệp lưu trữ và danh sách tên tệp tùy chọn. Này
các tùy chọn được sử dụng để xác định cách llvm-ar nên xử lý tệp lưu trữ.

Các phép toán và phép sửa đổi được giải thích trong các phần bên dưới. Tập hợp tối thiểu của
tùy chọn là ít nhất một toán tử và tên của kho lưu trữ. Thông thường, tệp lưu trữ kết thúc
với một .a hậu tố, nhưng điều này không bắt buộc. Theo dõi tên lưu trữ đi kèm một danh sách
các tập tin chỉ ra các thành viên cụ thể của kho lưu trữ để hoạt động. Nếu các tập tin tùy chọn
không được chỉ định, nó thường có nghĩa là "không có" hoặc "tất cả" thành viên, tùy thuộc vào
hoạt động.

Hoạt động
d
Xóa tệp khỏi kho lưu trữ. Không có công cụ sửa đổi nào có thể áp dụng cho hoạt động này. Các
các tập tin các tùy chọn chỉ định thành viên nào nên được xóa khỏi kho lưu trữ. Nó không phải là một
lỗi nếu một tệp được chỉ định không xuất hiện trong kho lưu trữ. Nếu không các tập tin Được xác định,
kho lưu trữ không được sửa đổi.

m [abi]
Di chuyển tệp từ vị trí này trong kho lưu trữ sang vị trí khác. Các a, bvà i bổ ngữ áp dụng
cho hoạt động này. Các các tập tin tất cả sẽ được di chuyển đến vị trí được cung cấp bởi các bổ ngữ.
Nếu không có phần bổ trợ nào được sử dụng, các tệp sẽ được chuyển đến cuối kho lưu trữ. Nếu không
các tập tin được chỉ định, kho lưu trữ không được sửa đổi.

p
In tệp ở đầu ra tiêu chuẩn. Thao tác này chỉ cần in các tập tin chỉ định cho
đầu ra tiêu chuẩn. Nếu không các tập tin được chỉ định, toàn bộ kho lưu trữ được in.
Việc in các tệp bitcode là không nên vì chúng có thể gây nhầm lẫn cho cài đặt đầu cuối của bạn. Các
p hoạt động không bao giờ sửa đổi kho lưu trữ.

q
Nhanh chóng nối các tệp vào cuối kho lưu trữ. Thao tác này nhanh chóng thêm các tập tin
vào kho lưu trữ mà không kiểm tra các bản sao cần được xóa trước. Nếu không
các tập tin được chỉ định, kho lưu trữ không được sửa đổi. Bởi vì cách đó llvm-ar
xây dựng tệp lưu trữ, nó không rõ ràng liệu q hoạt động nhanh hơn bất kỳ
r hoạt động.

r [abu]
Thay thế hoặc chèn các thành viên tệp. Các a, bvà u bổ ngữ áp dụng cho hoạt động này.
Thao tác này sẽ thay thế hiện tại các tập tin hoặc chèn chúng vào cuối kho lưu trữ nếu
họ không tồn tại. Nếu không các tập tin được chỉ định, kho lưu trữ không được sửa đổi.

truyền hình]
In mục lục. Không có bất kỳ công cụ sửa đổi nào, thao tác này chỉ in ra
tên của các thành viên đến đầu ra tiêu chuẩn. Với v bổ nghĩa, llvm-ar cũng in
loại tệp (B = mã bit, S = bảng biểu tượng, trống = tệp thông thường), chế độ cho phép,
chủ sở hữu và nhóm, kích thước và ngày tháng. Nếu có các tập tin được chỉ định, danh sách là
chỉ dành cho những tệp đó. Nếu không các tập tin được chỉ định, mục lục cho toàn bộ
kho lưu trữ được in.

x [oP]
Giải nén các thành viên lưu trữ trở lại tệp. Các o sửa đổi áp dụng cho hoạt động này. Cái này
hoạt động truy xuất chỉ định các tập tin từ kho lưu trữ và ghi chúng trở lại
hệ thống tập tin của hệ điều hành. Nếu không các tập tin được chỉ định, toàn bộ kho lưu trữ là
trích xuất.

Bổ ngữ (hoạt động riêng)
Các công cụ sửa đổi bên dưới dành riêng cho một số hoạt động nhất định. Xem phần Hoạt động (ở trên)
để xác định công cụ sửa đổi nào có thể áp dụng cho các hoạt động nào.

[A]
Khi chèn hoặc di chuyển các tệp thành viên, tùy chọn này chỉ định đích của tệp mới
các tập tin như sau quan hệ thành viên. Nếu như quan hệ không được tìm thấy, các tệp được đặt tại
phần cuối của kho lưu trữ.

[B]
Khi chèn hoặc di chuyển các tệp thành viên, tùy chọn này chỉ định đích của tệp mới
các tập tin trước khi quan hệ thành viên. Nếu như quan hệ không được tìm thấy, các tệp được đặt
ở cuối kho lưu trữ. Công cụ sửa đổi này giống với i bổ nghĩa.

[I]
Một từ đồng nghĩa với b tùy chọn.

[hoặc là]
Khi giải nén tệp, tùy chọn này sẽ gây ra llvm-ar để bảo tồn bản gốc
thời gian sửa đổi của các tệp mà nó ghi.

[hoặc là]
Khi thay thế các tệp hiện có trong kho lưu trữ, chỉ thay thế những tệp có thời gian
đóng dấu hơn dấu thời gian của thành viên trong kho lưu trữ.

Bổ ngữ (chung)
Các sửa đổi dưới đây có thể được áp dụng cho bất kỳ hoạt động nào.

[c]
Đối với tất cả các hoạt động, llvm-ar sẽ luôn tạo kho lưu trữ nếu nó không tồn tại.
Thông thường, llvm-ar sẽ in một thông báo cảnh báo cho biết rằng kho lưu trữ đang được
tạo. Sử dụng công cụ sửa đổi này sẽ tắt cảnh báo đó.

[S]
Công cụ sửa đổi này yêu cầu một chỉ mục lưu trữ (hoặc bảng ký hiệu) được thêm vào kho lưu trữ.
Đây là chế độ hoạt động mặc định. Bảng ký hiệu sẽ chứa tất cả các
các hàm hiển thị và các biến toàn cục được xác định bởi tất cả các tệp bitcode trong kho lưu trữ.

[NS]
Công cụ sửa đổi này đối lập với s bổ nghĩa. Nó hướng dẫn llvm-ar không xây dựng
bảng ký hiệu. Nếu cả hai s và S được sử dụng, công cụ sửa đổi cuối cùng xuất hiện trong các tùy chọn sẽ
Chiếm ưu thế.

[V]
Công cụ sửa đổi này hướng dẫn llvm-ar để nói chi tiết về những gì nó đang làm. Mỗi lần chỉnh sửa
hoạt động được thực hiện đối với kho lưu trữ sẽ tạo ra một dòng kết quả cho biết những gì đang được
làm xong.

TIÊU CHUẨN

Sản phẩm llvm-ar tiện ích nhằm cung cấp một tập hợp siêu IEEE Std 1003.2 (POSIX.2)
chức năng cho ar. llvm-ar có thể đọc cả tệp lưu trữ SVR4 và BSD4.4 (hoặc Mac OS X). Nếu
f bổ ngữ được trao cho x or r hoạt động sau đó llvm-ar sẽ viết SVR4 tương thích
kho lưu trữ. Nếu không có công cụ sửa đổi này, llvm-ar sẽ ghi các kho lưu trữ tương thích BSD4.4 có
tên dài ngay sau tiêu đề và được chỉ ra bằng ký hiệu "# 1 / ddd" cho
tên trong tiêu đề.

FILE FORMAT

Định dạng tệp cho tệp Lưu trữ LLVM tương tự như định dạng tệp lưu trữ BSD 4.4 hoặc Mac OSX
các tập tin. Trên thực tế, ngoại trừ bảng ký hiệu, ar lệnh trên các hệ điều hành đó
sẽ có thể đọc các tệp lưu trữ LLVM. Sau đây là chi tiết của định dạng tệp.

Mỗi kho lưu trữ bắt đầu bằng số ma thuật của kho lưu trữ là tám ký tự có thể in được
”! n "trong đó n đại diện cho ký tự dòng mới (0x0A). Theo số ma thuật,
tệp bao gồm các thành viên có độ dài chẵn bắt đầu bằng tiêu đề kho lưu trữ và kết thúc bằng
một ký tự đệm nếu cần (để làm cho độ dài bằng nhau). Mỗi thành viên tệp được bao gồm
của tiêu đề (được định nghĩa bên dưới), "tên tệp dài" được kết thúc bằng dòng mới tùy chọn và
nội dung của tệp.

Các trường của tiêu đề được mô tả trong các mục bên dưới. Tất cả các trường của tiêu đề
chỉ chứa các ký tự ASCII, được căn trái và được đệm bên phải bằng khoảng trắng
ký tự.

tên - char [16]
Trường tiêu đề này cung cấp tên của thành viên lưu trữ. Nếu tên dài hơn
hơn 15 ký tự hoặc chứa ký tự gạch chéo (/), thì trường này chứa # 1 / nnn
Ở đâu nnn cung cấp độ dài của tên và # 1 / là nghĩa đen. Trong trường hợp này,
tên thực của tệp được cung cấp trong nnn byte ngay sau tiêu đề.
Nếu tên có 15 ký tự trở xuống, nó được chứa trực tiếp trong trường này và
được kết thúc bằng một ký tự gạch chéo (/).

ngày tháng - char [12]
Trường này cung cấp ngày sửa đổi tệp ở dạng số thập phân
số được mã hóa cung cấp số giây kể từ kỷ nguyên (kể từ 00:00:00 tháng XNUMX
1, 1970) theo thông số kỹ thuật của Posix.

uid - char [6]
Trường này cung cấp id người dùng của tệp được mã hóa dưới dạng chuỗi ASCII thập phân. Cái này
trường có thể không có nhiều ý nghĩa trên các hệ thống không phải Unix. Trên Unix, nó có cùng giá trị với
trường st_uid của cấu trúc thống kê được trả về bởi stat(2) cuộc gọi hệ điều hành.

gid - char [6]
Trường này cung cấp id nhóm của tệp được mã hóa dưới dạng chuỗi ASCII thập phân. Cái này
trường có thể không có nhiều ý nghĩa trên các hệ thống không phải Unix. Trên Unix, nó có cùng giá trị với
trường st_gid của cấu trúc thống kê được trả về bởi stat(2) cuộc gọi hệ điều hành.

chế độ - char [8]
Trường này cung cấp chế độ truy cập của tệp được mã hóa dưới dạng chuỗi ASCII bát phân. Cái này
trường có thể không có nhiều ý nghĩa trên các hệ thống không phải Unix. Trên Unix, nó có cùng giá trị với
trường st_mode của cấu trúc trạng thái được trả về bởi stat(2) cuộc gọi hệ điều hành.

kích thước - ký tự [10]
Trường này cung cấp kích thước của tệp, tính bằng byte, được mã hóa dưới dạng chuỗi ASCII thập phân.

fmag - char [2]
Trường này là số ma thuật của thành viên tệp lưu trữ. Nội dung của nó luôn là hai
ký tự đánh dấu lùi (0x60) và dòng mới (0x0A). Điều này cung cấp một số tiện ích đo lường trong
xác định các tệp lưu trữ đã bị hỏng.

offset - số nguyên 32 bit được mã hóa vbr
Mục bù đắp cung cấp phần bù vào tệp lưu trữ nơi có thành viên mã bit
được lưu trữ được liên kết với biểu tượng. Giá trị bù đắp là 0 dựa vào đầu của
thành viên tệp "bình thường" đầu tiên. Để lấy được phần bù tệp thực tế của thành viên, bạn
phải thêm số byte bị chiếm bởi chữ ký tệp (8 byte) và ký hiệu
những cái bàn. Giá trị của mục này được mã hóa bằng cách sử dụng mã hóa tốc độ bit thay đổi để giảm
kích thước của bảng ký hiệu. Mã hóa tốc độ bit thay đổi sử dụng bit cao (0x80) của
mỗi byte để cho biết nếu có nhiều byte hơn để theo dõi. 7 bit còn lại trong mỗi
byte mang bit từ giá trị. Byte cuối cùng không có bộ bit cao.

chiều dài - số nguyên 32 bit được mã hóa vbr
Mục độ dài cung cấp độ dài của ký hiệu theo sau. Như thế này bù đắp bài báo,
độ dài được mã hóa tốc độ bit thay đổi.

biểu tượng - mảng ký tự
Mục biểu tượng cung cấp văn bản của biểu tượng được liên kết với bù đắp. Các
biểu tượng không được kết thúc bởi bất kỳ ký tự nào. Chiều dài của nó được cung cấp bởi chiều dài trường.
Lưu ý rằng được phép (nhưng không cẩn thận) sử dụng các ký tự không in được (thậm chí 0x00) trong
Biểu tượng. Điều này cho phép nhiều mã hóa tên biểu tượng.

EXIT TÌNH TRẠNG

If llvm-ar thành công, nó sẽ thoát với 0. Một lỗi sử dụng, dẫn đến mã thoát là 1. A
lỗi hard (hệ thống tệp thường) dẫn đến mã thoát là 2. Khác hoặc không xác định
lỗi dẫn đến mã thoát là 3.

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