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

CHƯƠNG TRÌNH:

TÊN

geninfo - Tạo tệp theo dõi từ tệp .da

SYNOPSIS

thông tin gen [-h|--Cứu giúp] [-v|--phiên bản] [-q|--Yên lặng]
[-i|--ban đầu] [-t|- tên thử nghiệm tên kiểm tra]
[-o|--tên tệp xuất ra tên tập tin] [-f|--theo dõi]
[-b|--base-thư mục thư mục]
[--tổng kiểm tra] [--no-tổng kiểm tra]
[--compat-libtool] [--no-compat-libtool]
[--gcov-công cụ công cụ] [- lỗi nặng lỗi]
[- không đệ quy] thư mục [--bên ngoài] [- không bên ngoài]
[--tập tin cấu hình tập tin cấu hình] [- không có dấu]
[--derive-func-dữ liệu] [--tương thích chế độ= bật | tắt | tự động]
[--rc từ khóa=giá trị]

MÔ TẢ

thông tin gen chuyển đổi tất cả các tệp dữ liệu phạm vi GCOV được tìm thấy trong thư mục vào các tập tin theo dõi,
các genhtml công cụ có thể chuyển đổi sang đầu ra HTML.

Trừ khi tùy chọn --output-filename được chỉ định, thông tin gen ghi đầu ra của nó vào một tệp
mỗi tệp .da, tên của tệp đó được tạo bằng cách chỉ cần thêm ".info" vào
tên tệp .da.

Lưu ý rằng người dùng hiện tại cần quyền ghi vào cả hai thư mục cũng như bản gốc
vị trí mã nguồn. Điều này là cần thiết vì một số tệp tạm thời phải được tạo
ở đó trong quá trình chuyển đổi.

Cũng lưu ý rằng thông tin gen được gọi từ bên trong lcov, do đó thường không cần phải
gọi nó trực tiếp.

Loại trừ đánh dấu

Để loại trừ các dòng mã cụ thể khỏi tệp theo dõi, bạn có thể thêm các điểm đánh dấu loại trừ vào
mã nguồn. Ngoài ra, bạn có thể loại trừ các chi nhánh cụ thể khỏi phạm vi chi nhánh mà không có
loại trừ các dòng liên quan khỏi phạm vi dòng và chức năng. Các điểm đánh dấu loại trừ là
các từ khóa có thể được thêm vào ví dụ dưới dạng nhận xét. Nhìn thấy lcovrc(5) làm thế nào để
ghi đè một số trong số chúng.

Các điểm đánh dấu sau được geninfo nhận dạng:

LCOV_EXCL_LINE
Các dòng chứa điểm đánh dấu này sẽ bị loại trừ.
LCOV_EXCL_START
Đánh dấu phần bắt đầu của phần bị loại trừ. Dòng hiện tại là một phần của
phần.
LCOV_EXCL_STOP
Đánh dấu phần cuối của phần bị loại trừ. Dòng hiện tại không phải là một phần của phần này.
LCOV_EXCL_BR_LINE
Các dòng có chứa điểm đánh dấu này sẽ bị loại trừ khỏi phạm vi chi nhánh.
LCOV_EXCL_BR_START
Đánh dấu phần đầu của phần bị loại trừ khỏi phạm vi chi nhánh. Các
dòng hiện tại là một phần của phần này.
LCOV_EXCL_BR_STOP
Đánh dấu phần cuối của phần bị loại trừ khỏi phạm vi chi nhánh. Dòng hiện tại
không phải là một phần của phần này.

LỰA CHỌN

-b thư mục
--base-thư mục thư mục
Sử dụng thư mục làm thư mục cơ sở cho các đường dẫn tương đối.

Sử dụng tùy chọn này để chỉ định thư mục cơ sở của môi trường xây dựng khi geninfo
tạo ra các thông báo lỗi như:

LỖI: không thể đọc tệp nguồn
/home/user/project/subdir1/subdir2/subdir1/subdir2/file.c

Trong ví dụ này, sử dụng / home / user / project làm thư mục cơ sở.

Tùy chọn này là bắt buộc khi sử dụng geninfo trên các dự án được xây dựng bằng libtool hoặc
môi trường xây dựng tương tự hoạt động với thư mục cơ sở, tức là môi trường,
nơi thư mục làm việc hiện tại khi gọi trình biên dịch không giống nhau
thư mục chứa tệp mã nguồn.

Lưu ý rằng tùy chọn này sẽ không hoạt động trong môi trường có nhiều thư mục cơ sở
được sử dụng. Trong trường hợp đó, hãy sử dụng cài đặt tệp cấu hình geninfo_auto_base = 1 (xem
lcovrc(5)).

--tổng kiểm tra
--no-tổng kiểm tra
Chỉ định có tạo dữ liệu tổng kiểm tra khi viết tệp theo dõi hay không.

Sử dụng --checksum để kích hoạt tạo tổng kiểm tra hoặc --no-checksum để vô hiệu hóa nó.
Checksum thế hệ là bị vô hiệu hóa theo mặc định.

Khi kích hoạt tạo tổng kiểm tra, một tổng kiểm tra sẽ được tạo cho mỗi nguồn
dòng mã và được lưu trữ cùng với dữ liệu vùng phủ sóng. Tổng kiểm tra này sẽ được sử dụng để
ngăn chặn nỗ lực kết hợp dữ liệu phạm vi từ các phiên bản mã nguồn khác nhau.

Nếu bạn không làm việc với các phiên bản mã nguồn khác nhau, hãy tắt tùy chọn này để tăng tốc độ
tăng cường xử lý dữ liệu vùng phủ sóng và giảm kích thước của các tập tin theo dõi.

--tương thích chế độ=giá trị[,chế độ=giá trị, ...]
Đặt chế độ tương thích.

Sử dụng --compat để chỉ định rằng geninfo sẽ bật một hoặc nhiều chế độ tương thích
khi nắm bắt dữ liệu vùng phủ sóng. Bạn có thể cung cấp danh sách mode = value được phân tách bằng dấu phẩy
các cặp để chỉ định các giá trị cho nhiều chế độ.

Hợp lệ giá trị là:

on
Bật chế độ tương thích.
off
Tắt chế độ tương thích.
tự động
Áp dụng tính năng tự động phát hiện để xác định xem có cần chế độ tương thích hay không. Ghi chú
rằng tính năng tự động phát hiện không khả dụng cho tất cả các chế độ tương thích.

Nếu không có giá trị nào được chỉ định, thì 'on' được coi là giá trị mặc định.

Hợp lệ chế độ là:

libtool
Bật chế độ này nếu bạn đang thu thập dữ liệu vùng phủ sóng cho một dự án đã
được xây dựng bằng cơ chế libtool. Xem thêm --compat-libtool.

Giá trị mặc định cho cài đặt này là 'bật'.

búa
Bật chế độ này nếu bạn đang thu thập dữ liệu vùng phủ sóng cho một dự án đã
được xây dựng bằng phiên bản GCC 3.3 có sửa đổi (bản vá búa)
của các phiên bản GCC sau này. Bạn có thể xác định GCC 3.3 đã sửa đổi bằng cách kiểm tra
xây dựng thư mục của dự án của bạn cho các tệp kết thúc bằng phần mở rộng '.bbg'.
Các phiên bản chưa sửa đổi của GCC 3.3 đặt tên cho các tệp này là '.bb'.

Giá trị mặc định cho cài đặt này là 'tự động'.

chia_crc
Bật chế độ này nếu bạn đang thu thập dữ liệu vùng phủ sóng cho một dự án đã
được xây dựng bằng phiên bản GCC 4.6 có sửa đổi (tách
tổng kiểm tra chức năng) của các phiên bản GCC mới hơn. Thông báo lỗi điển hình khi
chạy geninfo trên dữ liệu phạm vi được tạo ra bởi các phiên bản GCC như vậy đã hết
bộ nhớ 'và' đến cuối tệp không mong muốn '.

Giá trị mặc định cho cài đặt này là 'tự động'

--compat-libtool
--no-compat-libtool
Chỉ định có bật chế độ tương thích libtool hay không.

Sử dụng --compat-libtool để bật chế độ tương thích libtool hoặc --no-compat-libtool để
vô hiệu hóa nó. Chế độ tương thích libtool là kích hoạt theo mặc định.

Khi chế độ tương thích libtool được bật, geninfo sẽ giả định rằng nguồn
mã liên quan đến tệp .da nằm trong thư mục có tên ".libs" có thể được tìm thấy trong
thư mục mẹ của nó.

Nếu bạn có các thư mục có tên ".libs" trong môi trường xây dựng của mình nhưng không sử dụng
libtool, tắt tùy chọn này để tránh các sự cố khi chụp dữ liệu vùng phủ sóng.

--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.

Khi tùy chọn này được chỉ định, cả tệp cấu hình toàn hệ thống
/ etc / lcovrc, cũng không phải tệp cấu hình cho mỗi người dùng ~ / .lcovrc được đọc.

Tùy chọn này có thể hữu ích khi cần chạy một số trường hợp thông tin gen
với các tùy chọn tệp cấu hình khác nhau song song.

--derive-func-dữ liệu
Tính toán dữ liệu vùng phủ của chức năng từ dữ liệu vùng phủ của đường truyền.

Sử dụng tùy chọn này để thu thập dữ liệu về phạm vi chức năng, ngay cả khi phiên bản của gcov
công cụ được cài đặt trên hệ thống thử nghiệm không cung cấp dữ liệu này. lcov sẽ thay thế
lấy dữ liệu về phạm vi chức năng từ dữ liệu về phạm vi của đường dây và thông tin về
dòng thuộc về một hàm.

--bên ngoài
- không bên ngoài
Chỉ định có nắm bắt dữ liệu vùng phủ sóng cho các tệp nguồn bên ngoài hay không.

Các tệp nguồn bên ngoài là các tệp không nằm trong một trong các thư mục
được chỉ định bởi --directory hoặc --base-directory. Sử dụng --external để bao gồm bên ngoài
các tệp nguồn trong khi thu thập dữ liệu vùng phủ sóng hoặc - không bên ngoài để bỏ qua dữ liệu này.

Dữ liệu cho các tệp nguồn bên ngoài là bao gồm theo mặc định.

-f
--theo dõi
Theo các liên kết khi tìm kiếm tệp .da.

--gcov-công cụ công cụ
Chỉ định vị trí của công cụ gcov.

-h
--Cứu giúp
In một văn bản trợ giúp ngắn, sau đó thoát.

- lỗi nặng lỗi
Chỉ định danh sách các lỗi sau đó để tiếp tục xử lý.

Sử dụng tùy chọn này để chỉ định danh sách một hoặc nhiều lớp lỗi sau đó
geninfo sẽ tiếp tục xử lý thay vì hủy bỏ.

lỗi có thể là danh sách được phân tách bằng dấu phẩy gồm các từ khóa sau:

gcov: công cụ gcov được trả về với mã trả lại khác XNUMX.

nguồn: không thể tìm thấy tệp mã nguồn cho tập dữ liệu.

-i
--ban đầu
Chụp dữ liệu vùng phủ XNUMX ban đầu.

Chạy geninfo với tùy chọn này trên các thư mục chứa tệp .bb, .bbg hoặc .gcno
trước khi chạy bất kỳ trường hợp thử nghiệm nào. Kết quả là một tệp dữ liệu phạm vi "đường cơ sở"
không bao gồm phạm vi bảo hiểm cho mọi đường dây và chức năng thiết bị. Kết hợp dữ liệu này
tệp (sử dụng lcov -a) với các tệp dữ liệu phạm vi được ghi lại sau khi chạy thử nghiệm để đảm bảo
rằng phần trăm tổng số dòng được bao phủ là đúng ngay cả khi không phải tất cả mã đối tượng
các tệp đã được tải trong quá trình kiểm tra.

Lưu ý: hiện tại, tùy chọn --initial không tạo ra phạm vi chi nhánh
thông tin.

- không có dấu
Sử dụng tùy chọn này nếu bạn muốn nhận dữ liệu về phạm vi bảo hiểm mà không liên quan đến loại trừ
các điểm đánh dấu trong tệp mã nguồn.

- không đệ quy
Sử dụng tùy chọn này nếu bạn chỉ muốn nhận dữ liệu vùng phủ sóng cho thư mục được chỉ định
mà không cần xử lý thư mục con.

-o tên tệp xuất ra
--tên tệp xuất ra tên tệp xuất ra
Ghi tất cả dữ liệu vào tên tệp xuất ra.

Nếu bạn muốn ghi tất cả dữ liệu vào một tệp (để xử lý dễ dàng hơn), hãy sử dụng
tùy chọn này để chỉ định tên tệp tương ứng. Theo mặc định, một tệp theo dõi sẽ là
được tạo cho mỗi tệp .da được xử lý.

-q
--Yên lặng
Không in thông báo tiến độ.

Chặn tất cả đầu ra tiến độ thông tin. Khi bật công tắc này, chỉ
thông báo lỗi hoặc cảnh báo được in.

--rc từ khóa=giá trị
Ghi đè chỉ thị cấu hình.

Sử dụng tùy chọn này để chỉ định một từ khóa=giá trị tuyên bố ghi đè
câu lệnh cấu hình tương ứng trong tệp cấu hình lcovrc. Bạn có thể
chỉ định tùy chọn này nhiều lần để ghi đè nhiều câu lệnh cấu hình.
Xem lcovrc(5) để biết danh sách các từ khóa có sẵn và ý nghĩa của chúng.

-t tên kiểm tra
- tên thử nghiệm tên kiểm tra
Sử dụng tên trường hợp thử nghiệm tên kiểm tra cho dữ liệu kết quả. Tên trường hợp thử nghiệm hợp lệ có thể bao gồm
gồm các chữ cái, chữ số thập phân và ký tự gạch dưới ('_').

Điều này tỏ ra hữu ích khi dữ liệu từ một số trường hợp thử nghiệm được hợp nhất (tức là chỉ đơn giản là
nối các tệp theo dõi tương ứng) trong trường hợp đó, một tên kiểm tra có thể được sử dụng để
phân biệt giữa dữ liệu từ mỗi trường hợp thử nghiệm.

-v
--phiên bản
In số phiên bản, sau đó thoát.

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