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

CHƯƠNG TRÌNH:

TÊN

llvm-cov - phát ra thông tin phủ sóng

SYNOPSIS

llvm-cov lệnh [args ...]

MÔ TẢ

Sản phẩm llvm-cov công cụ hiển thị thông tin về phạm vi mã cho các chương trình được thiết kế để
phát ra dữ liệu hồ sơ. Nó có thể được sử dụng để làm việc với gcovbảo hiểm theo phong cách hoặc với kêu vang's
lập hồ sơ dựa trên thiết bị đo đạc.

Nếu chương trình được gọi với tên cơ sở là gcov, nó sẽ hoạt động như thể llvm-cov gcov
lệnh đã được gọi. Nếu không, một lệnh sẽ được cung cấp.

HÀNG

· gcov

· hiển thị

· báo cáo

GCOV COMMAND

SYNOPSIS
llvm-cov gcov [lựa chọn] NGUỒN

MÔ TẢ
Sản phẩm llvm-cov gcov công cụ đọc các tệp dữ liệu vùng phủ mã và hiển thị vùng phủ sóng
thông tin cho một tệp nguồn được chỉ định. Nó tương thích với gcov công cụ từ phiên bản
4.2 của GCC và cũng có thể tương thích với một số phiên bản mới hơn của gcov.

sử dụng llvm-cov gcov, trước tiên bạn phải xây dựng một phiên bản công cụ cho ứng dụng của mình
thu thập dữ liệu vùng phủ sóng khi nó chạy. Biên dịch với -fprofile-arc và
-phải bảo hiểm tốt nhất các tùy chọn để thêm thiết bị. (Ngoài ra, bạn có thể sử dụng
--phủ sóng tùy chọn, bao gồm cả hai tùy chọn khác.) Bạn nên biên dịch với
thông tin gỡ lỗi (-g) và không có tối ưu hóa (-O0); nếu không, dữ liệu về phạm vi
không thể được ánh xạ chính xác trở lại mã nguồn.

Tại thời điểm bạn biên dịch mã công cụ, .gcno tệp dữ liệu sẽ được tạo cho
từng tệp đối tượng. Này .gcno tệp chứa một nửa dữ liệu phạm vi. Nửa còn lại của
dữ liệu đến từ .gcda các tệp được tạo khi bạn chạy chương trình công cụ,
với một sự riêng biệt .gcda tệp cho từng tệp đối tượng. Mỗi khi bạn chạy chương trình,
số lượng thực thi được tổng hợp thành bất kỳ .gcda các tệp, vì vậy hãy đảm bảo xóa mọi tệp cũ
nếu bạn không muốn nội dung của chúng được đưa vào.

Theo mặc định, .gcda các tệp được ghi vào cùng một thư mục với các tệp đối tượng, nhưng
bạn có thể ghi đè điều đó bằng cách đặt GCOV_PREFIX và GCOV_PREFIX_STRIP môi trường
biến. Các GCOV_PREFIX_STRIP biến chỉ định một số thành phần thư mục được
bị xóa khỏi đầu đường dẫn tuyệt đối đến thư mục tệp đối tượng. Sau khi tước
những thư mục đó, tiền tố từ GCOV_PREFIX biến được thêm vào. Những môi trường
các biến cho phép bạn chạy chương trình công cụ trên một máy có đối tượng gốc
thư mục tệp không thể truy cập được, nhưng sau đó bạn sẽ cần sao chép .gcda các tập tin trở lại
đến các thư mục tệp đối tượng, nơi llvm-cov gcov mong đợi để tìm thấy chúng.

Khi bạn đã tạo các tệp dữ liệu phạm vi, hãy chạy llvm-cov gcov cho mỗi nguồn chính
nộp hồ sơ nơi bạn muốn kiểm tra kết quả bảo hiểm. Điều này nên được chạy từ cùng một
thư mục mà trước đó bạn đã chạy trình biên dịch. Kết quả cho tệp nguồn được chỉ định
được ghi vào một tệp có tên bằng cách thêm một .gcov hậu tố. Một tệp đầu ra riêng biệt cũng là
được tạo cho mỗi tệp được bao gồm bởi tệp nguồn chính, cũng với .gcov đã thêm hậu tố.

Nội dung cơ bản của một .gcov tệp đầu ra là một bản sao của tệp nguồn với một quá trình thực thi
đếm và số dòng được thêm vào trước mỗi dòng. Số lượng thực thi được hiển thị dưới dạng - nếu một dòng
không chứa bất kỳ mã thực thi nào. Nếu một dòng chứa mã nhưng mã đó chưa bao giờ
được thực thi, số đếm được hiển thị là #####.

LỰA CHỌN
-một, - tất cả các khối
Hiển thị tất cả các khối cơ bản. Nếu có nhiều khối cho một dòng nguồn
mã, tùy chọn này khiến llvm-cov hiển thị số lượng cho mỗi khối thay vì chỉ
một số đếm cho toàn bộ dòng.

-NS, - xác suất đồng bộ
Hiển thị xác suất chi nhánh có điều kiện và tóm tắt thông tin chi nhánh.

-NS, --bộ đếm
Hiển thị số nhánh thay vì xác suất (yêu cầu -b).

-NS, - tóm tắt chức năng
Hiển thị bản tóm tắt về phạm vi cho từng chức năng thay vì chỉ một bản tóm tắt cho một
toàn bộ tệp nguồn.

--Cứu giúp Hiển thị các tùy chọn có sẵn (- trợ giúp ẩn để biết thêm).

-l, --tên tập tin dài
Để có đầu ra bao gồm các tệp được bao gồm từ tệp nguồn chính, hãy thêm tệp chính
tên theo sau bởi ## làm tiền tố cho tên tệp đầu ra. Điều này có thể được kết hợp với
tùy chọn --preserve-path để sử dụng các đường dẫn hoàn chỉnh cho cả tệp chính và
tập tin bao gồm.

-N, - không có đầu ra
Không xuất ra bất kỳ .gcov các tập tin. Thông tin tóm tắt vẫn được hiển thị.

-o = , --object-directory = , --object-file =
Tìm các đối tượng trong DIR hoặc dựa trên đường dẫn của FILE. Nếu bạn chỉ định một đối tượng cụ thể
tệp, các tệp dữ liệu phạm vi được mong đợi có cùng tên cơ sở với .gcno
và .gcda các phần mở rộng. Nếu bạn chỉ định một thư mục, các tệp được mong đợi trong đó
thư mục có cùng tên cơ sở với tệp nguồn.

-P, --preserve-path
Bảo tồn các thành phần đường dẫn khi đặt tên cho các tệp đầu ra vùng phủ. Ngoài các
tên tệp nguồn, bao gồm các thư mục từ đường dẫn đến tệp đó. Các
các thư mục được tách biệt bởi # ký tự, với . thư mục bị xóa và ..
thư mục được thay thế bởi ^ nhân vật. Khi được sử dụng với tùy chọn --long-file-names,
điều này áp dụng cho cả tên tệp chính và tên tệp được bao gồm.

-bạn, - chi nhánh không điều kiện
Bao gồm các nhánh vô điều kiện trong đầu ra cho tùy chọn --branch-Probilities.

-phiên bản
Hiển thị phiên bản của llvm-cov.

EXIT TÌNH TRẠNG
llvm-cov gcov trả về 1 nếu nó không thể đọc các tập tin đầu vào. Nếu không, nó sẽ thoát bằng không.

HIỂN THỊ COMMAND

SYNOPSIS
llvm-cov hiển thị [lựa chọn] -instr-hồ sơ HỒ SƠ BIN [NGUỒN]

MÔ TẢ
Sản phẩm llvm-cov hiển thị lệnh hiển thị mức độ bao phủ từng dòng của một tệp nhị phân BIN sử dụng hồ sơ
dữ liệu HỒ SƠ. Nó có thể được lọc theo tùy chọn để chỉ hiển thị mức độ phù hợp cho các tệp được liệt kê
in NGUỒN.

sử dụng llvm-cov hiển thị, bạn cần một chương trình được biên dịch với thiết bị đo đạc để phát ra
dữ liệu hồ sơ và phạm vi bảo hiểm. Để xây dựng một chương trình như vậy với kêu vang sử dụng
-fprofile-hướng dẫn-tạo và -fcoverage-ánh xạ cờ. Nếu liên kết với kêu vang người lái xe,
vượt qua -fprofile-hướng dẫn-tạo đến giai đoạn liên kết để đảm bảo thời gian chạy cần thiết
các thư viện được liên kết trong.

Thông tin về phạm vi được lưu trữ trong tệp thực thi hoặc thư viện được xây dựng, và đây là
những gì bạn nên vượt qua llvm-cov hiển thị như BIN tranh luận. Dữ liệu hồ sơ được tạo
bằng cách chạy chương trình công cụ này một cách bình thường. Khi chương trình thoát ra, nó sẽ viết ra một
tệp hồ sơ thô, thường được gọi là mặc định.profraw, có thể được chuyển đổi thành một định dạng
điều đó phù hợp với HỒ SƠ đối số bằng cách sử dụng llvm-profdata hợp nhất công cụ.

LỰA CHỌN
-show-line-đếm
Hiển thị số lượng thực thi cho mỗi dòng. Điều này được bật theo mặc định, trừ khi
-chỉ tùy chọn được sử dụng.

-show-mở rộng
Mở rộng bao gồm, chẳng hạn như macro bộ xử lý trước hoặc bao gồm văn bản, nội dòng trong
hiển thị của tệp nguồn.

-show-Instantiations
Đối với các vùng nguồn được khởi tạo nhiều lần, chẳng hạn như các mẫu trong C + +,
hiển thị từng bản tóm tắt riêng biệt cũng như bản tóm tắt kết hợp.

-show-khu vực
Hiển thị số lần thực thi cho từng khu vực bằng cách hiển thị dấu mũ trỏ đến
ký tự nơi bắt đầu của vùng.

-show-line-counts-or-region
Hiển thị số lượng thực thi cho mỗi dòng nếu chỉ có một vùng trên dòng,
nhưng hiển thị các vùng riêng lẻ nếu có nhiều vùng trên dòng.

-use-color [= VALUE]
Bật hoặc tắt đầu ra màu. Theo mặc định, điều này được tự động phát hiện.

-arch =
Nếu nhị phân được bao phủ là nhị phân phổ quát, hãy chọn kiến ​​trúc để sử dụng. Nó là
một lỗi để chỉ định một kiến ​​trúc không được bao gồm trong nhị phân phổ quát hoặc
để sử dụng một kiến ​​trúc không khớp với một hệ nhị phân không phổ quát.

-tên =
Chỉ hiển thị phạm vi mã cho các chức năng có tên đã cho.

-name-regex =
Chỉ hiển thị phạm vi mã cho các hàm phù hợp với biểu thức chính quy đã cho.

-line-cover-gt =
Chỉ hiển thị vùng phủ mã cho các chức năng có vùng phủ đường lớn hơn mức đã cho
Ngưỡng.

-line-cover-lt =
Chỉ hiển thị vùng phủ mã cho các chức năng có vùng phủ đường nhỏ hơn mức đã cho
Ngưỡng.

-vùng-phủ-gt =
Chỉ hiển thị vùng phủ mã cho các chức năng có vùng phủ sóng lớn hơn vùng đã cho
Ngưỡng.

-khu vực-bảo hiểm-lt =
Chỉ hiển thị vùng phủ mã cho các chức năng có vùng phủ sóng nhỏ hơn vùng đã cho
Ngưỡng.

BÁO CÁO COMMAND

SYNOPSIS
llvm-cov báo cáo [lựa chọn] -instr-hồ sơ HỒ SƠ BIN [NGUỒN]

MÔ TẢ
Sản phẩm llvm-cov báo cáo lệnh hiển thị một bản tóm tắt về phạm vi của một tệp nhị phân BIN bằng cách sử dụng
dữ liệu hồ sơ HỒ SƠ. Nó có thể được lọc theo tùy chọn để chỉ hiển thị mức độ phù hợp cho
các tệp được liệt kê trong NGUỒN.

Nếu không có tệp nguồn nào được cung cấp, một dòng tóm tắt sẽ được in cho từng tệp trong phạm vi bảo hiểm
dữ liệu. Nếu có bất kỳ tệp nào được cung cấp, các bản tóm tắt được hiển thị cho từng chức năng trong các tệp được liệt kê
thay thế.

Để biết thông tin về việc biên dịch các chương trình cho phạm vi bảo hiểm và tạo dữ liệu hồ sơ, hãy xem HIỂN THỊ
COMMAND.

LỰA CHỌN
-use-color [= VALUE]
Bật hoặc tắt đầu ra màu. Theo mặc định, điều này được tự động phát hiện.

-arch =
Nếu nhị phân được bao phủ là nhị phân phổ quát, hãy chọn kiến ​​trúc để sử dụng. Nó là
một lỗi để chỉ định một kiến ​​trúc không được bao gồm trong nhị phân phổ quát hoặc
để sử dụng một kiến ​​trúc không khớp với một hệ nhị phân không phổ quát.

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