| | | | |
| Offset 34, 15 lines modified | Offset 34, 15 lines modified |
| 34 | .SH·NAME | 34 | .SH·NAME |
| 35 | .sp | 35 | .sp |
| 36 | lcov | 36 | lcov |
| 37 | Capture·and·manipulate·coverage·data·from·lcov·tracefiles·or·gcov | 37 | Capture·and·manipulate·coverage·data·from·lcov·tracefiles·or·gcov |
| 38 | .SH·SYNOPSIS | 38 | .SH·SYNOPSIS |
| 39 | .sp | 39 | .sp |
| 40 | Capture·coverage·data·tracefile·(from·compiler\-generated·data). | 40 | Capture·coverage·data·tracefile·(from·compiler\-generated·data). |
| 41 | The·lcov·tracefile·(“.info”·file)·format·is·described·in·\fBgeninfo(1)·\%<file://\:\:../\:man/\:geninfo\:.1\:.html>\fP\&. | 41 | The·lcov·tracefile·(\(dq.info\(dq·file)·format·is·described·in·\fBgeninfo(1)·\%<file://\:\:../\:man/\:geninfo\:.1\:.html>\fP\&. |
| 42 | .INDENT·0.0 | 42 | .INDENT·0.0 |
| 43 | .INDENT·3.5 | 43 | .INDENT·3.5 |
| 44 | .sp | 44 | .sp |
| 45 | .EX | 45 | .EX |
| 46 | lcov·\-c·|·\-\-capture | 46 | lcov·\-c·|·\-\-capture |
| 47 | ····[·\-d·|·\-\-directory·*directory*·] | 47 | ····[·\-d·|·\-\-directory·*directory*·] |
| 48 | ····[·\-k·|·\-\-kernel\-directory·*directory*·] | 48 | ····[·\-k·|·\-\-kernel\-directory·*directory*·] |
| Offset 252, 15 lines modified | Offset 252, 15 lines modified |
| 252 | ····[·\-\-fail\-under\-branches·*percentage*·] | 252 | ····[·\-\-fail\-under\-branches·*percentage*·] |
| 253 | ····[·\-\-fail\-under\-lines·*percentage*·] | 253 | ····[·\-\-fail\-under\-lines·*percentage*·] |
| 254 | .EE | 254 | .EE |
| 255 | .UNINDENT | 255 | .UNINDENT |
| 256 | .UNINDENT | 256 | .UNINDENT |
| 257 | .SH·DESCRIPTION | 257 | .SH·DESCRIPTION |
| 258 | .sp | 258 | .sp |
| 259 | \fBlcov\fP·is·a·graphical·front\-end·for·GCC’s·coverage·testing·tool·gcov.·It·collects | 259 | \fBlcov\fP·is·a·graphical·front\-end·for·GCC\(aqs·coverage·testing·tool·gcov.·It·collects |
| 260 | line,·function·and·branch·coverage·data·for·multiple·source·files·and·creates | 260 | line,·function·and·branch·coverage·data·for·multiple·source·files·and·creates |
| 261 | HTML·pages·containing·the·source·code·annotated·with·coverage·information. | 261 | HTML·pages·containing·the·source·code·annotated·with·coverage·information. |
| 262 | It·also·adds·overview·pages·for·easy·navigation·within·the·file·structure. | 262 | It·also·adds·overview·pages·for·easy·navigation·within·the·file·structure. |
| 263 | .sp | 263 | .sp |
| 264 | Use·\fBlcov\fP·to·collect·coverage·data·and·\fBgenhtml\fP·to·create·HTML·pages.·Coverage·data·can·either·be·collected·from·the | 264 | Use·\fBlcov\fP·to·collect·coverage·data·and·\fBgenhtml\fP·to·create·HTML·pages.·Coverage·data·can·either·be·collected·from·the |
| 265 | currently·running·Linux·kernel·or·from·a·user·space·application.·To·do·this, | 265 | currently·running·Linux·kernel·or·from·a·user·space·application.·To·do·this, |
| 266 | you·have·to·complete·the·following·preparation·steps: | 266 | you·have·to·complete·the·following·preparation·steps: |
| Offset 273, 21 lines modified | Offset 273, 21 lines modified |
| 273 | .UNINDENT | 273 | .UNINDENT |
| 274 | .UNINDENT | 274 | .UNINDENT |
| 275 | .sp | 275 | .sp |
| 276 | For·user·space·application·coverage: | 276 | For·user·space·application·coverage: |
| 277 | .INDENT·0.0 | 277 | .INDENT·0.0 |
| 278 | .INDENT·3.5 | 278 | .INDENT·3.5 |
| 279 | Compile·the·application·with·GCC·using·the·options | 279 | Compile·the·application·with·GCC·using·the·options |
| 280 | “\-fprofile\-arcs”·and·“\-ftest\-coverage”·or·“–coverage”. | 280 | \(dq\-fprofile\-arcs\(dq·and·\(dq\-ftest\-coverage\(dq·or·\(dq\-\-coverage\(dq. |
| 281 | .UNINDENT | 281 | .UNINDENT |
| 282 | .UNINDENT | 282 | .UNINDENT |
| 283 | .sp | 283 | .sp |
| 284 | Please·note·that·this·man·page·refers·to·the·output·format·of | 284 | Please·note·that·this·man·page·refers·to·the·output·format·of |
| 285 | \fBlcov\fP·as·“.info·file”·or·“tracefile”·and·that·the·output·of·GCOV | 285 | \fBlcov\fP·as·\(dq.info·file\(dq·or·\(dqtracefile\(dq·and·that·the·output·of·GCOV |
| 286 | is·called·“.da·file”. | 286 | is·called·\(dq.da·file\(dq. |
| 287 | .sp | 287 | .sp |
| 288 | Also·note·that·when·printing·percentages,·0%·and·100%·are·only·printed·when | 288 | Also·note·that·when·printing·percentages,·0%·and·100%·are·only·printed·when |
| 289 | the·values·are·exactly·0%·and·100%·respectively.·Other·values·which·would | 289 | the·values·are·exactly·0%·and·100%·respectively.·Other·values·which·would |
| 290 | conventionally·be·rounded·to·0%·or·100%·are·instead·printed·as·nearest | 290 | conventionally·be·rounded·to·0%·or·100%·are·instead·printed·as·nearest |
| 291 | non\-boundary·value.·This·behavior·is·in·accordance·with·that·of·the | 291 | non\-boundary·value.·This·behavior·is·in·accordance·with·that·of·the |
| 292 | \fBgcov(1)·\%<file://\:\:../\:man/\:gcov\:.1\:.html>\fP·tool. | 292 | \fBgcov(1)·\%<file://\:\:../\:man/\:gcov\:.1\:.html>\fP·tool. |
| 293 | .sp | 293 | .sp |
| Offset 316, 15 lines modified | Offset 316, 15 lines modified |
| 316 | Specify·several·tracefiles·using·the·\-a·switch·to·combine·the·coverage·data | 316 | Specify·several·tracefiles·using·the·\-a·switch·to·combine·the·coverage·data |
| 317 | contained·in·these·files·by·adding·up·execution·counts·for·matching·test·and | 317 | contained·in·these·files·by·adding·up·execution·counts·for·matching·test·and |
| 318 | filename·combinations. | 318 | filename·combinations. |
| 319 | .sp | 319 | .sp |
| 320 | The·result·of·the·add·operation·will·be·written·to·stdout·or·the·tracefile | 320 | The·result·of·the·add·operation·will·be·written·to·stdout·or·the·tracefile |
| 321 | specified·with·\-o. | 321 | specified·with·\-o. |
| 322 | .sp | 322 | .sp |
| 323 | Only·one·of··\-z,·\-c,·\-a,·\-e,·\-r,·\-l·or·–summary·may·be | 323 | Only·one·of··\-z,·\-c,·\-a,·\-e,·\-r,·\-l·or·\-\-summary·may·be |
| 324 | specified·at·a·time. | 324 | specified·at·a·time. |
| 325 | .UNINDENT | 325 | .UNINDENT |
| 326 | .UNINDENT | 326 | .UNINDENT |
| 327 | .sp | 327 | .sp |
| 328 | \fB\-b\fP·\fIdirectory\fP | 328 | \fB\-b\fP·\fIdirectory\fP |
| 329 | \fB\-\-base\-directory\fP·\fIdirectory\fP | 329 | \fB\-\-base\-directory\fP·\fIdirectory\fP |
| 330 | .INDENT·0.0 | 330 | .INDENT·0.0 |
| Offset 368, 25 lines modified | Offset 368, 25 lines modified |
| 368 | for·details. | 368 | for·details. |
| 369 | .UNINDENT | 369 | .UNINDENT |
| 370 | .UNINDENT | 370 | .UNINDENT |
| 371 | .sp | 371 | .sp |
| 372 | \fB\-\-source\-directory\fP·\fIdirname\fP | 372 | \fB\-\-source\-directory\fP·\fIdirname\fP |
| 373 | .INDENT·0.0 | 373 | .INDENT·0.0 |
| 374 | .INDENT·3.5 | 374 | .INDENT·3.5 |
| 375 | Add·‘dirname’·to·the·list·of·places·to·look·for·source·files. | 375 | Add·\(aqdirname\(aq·to·the·list·of·places·to·look·for·source·files. |
| 376 | .sp | 376 | .sp |
| 377 | For·relative·source·file·paths·listed·in | 377 | For·relative·source·file·paths·listed·in |
| 378 | \fIe.g.\fP | 378 | \fIe.g.\fP |
| 379 | paths·found·in | 379 | paths·found·in |
| 380 | \fItracefile\fP, | 380 | \fItracefile\fP, |
| 381 | or·found·in·gcov·output·during | 381 | or·found·in·gcov·output·during |
| 382 | \fI–capture\fP | 382 | \fI\-\-capture\fP |
| 383 | \-·possibly·after·substitutions·have·been·applied·\- | 383 | \-·possibly·after·substitutions·have·been·applied·\- |
| 384 | \fBlcov\fP | 384 | \fBlcov\fP |
| 385 | will·first·look·for·the·path·from·‘cwd’·(where·genhtml·was | 385 | will·first·look·for·the·path·from·\(aqcwd\(aq·(where·genhtml·was |
| 386 | invoked)·and | 386 | invoked)·and |
| 387 | then·from·each·alternate·directory·name·in·the·order·specified. | 387 | then·from·each·alternate·directory·name·in·the·order·specified. |
| 388 | The·first·location·matching·location·is·used. | 388 | The·first·location·matching·location·is·used. |
| 389 | .sp | 389 | .sp |
| 390 | This·option·can·be·specified·multiple·times,·to·add·more·directories·to·the·source·search·path. | 390 | This·option·can·be·specified·multiple·times,·to·add·more·directories·to·the·source·search·path. |
| 391 | .UNINDENT | 391 | .UNINDENT |
| 392 | .UNINDENT | 392 | .UNINDENT |
| Offset 394, 15 lines modified | Offset 394, 15 lines modified |
| 394 | \fB\-c\fP | 394 | \fB\-c\fP |
| 395 | \fB\-\-capture\fP | 395 | \fB\-\-capture\fP |
| 396 | .INDENT·0.0 | 396 | .INDENT·0.0 |
| 397 | .INDENT·3.5 | 397 | .INDENT·3.5 |
| 398 | Capture·runtime·coverage·data. | 398 | Capture·runtime·coverage·data. |
| 399 | .sp | 399 | .sp |
| 400 | By·default·captures·the·current·kernel·execution·counts·and·writes·the | 400 | By·default·captures·the·current·kernel·execution·counts·and·writes·the |
| 401 | resulting·coverage·data·to·the·standard·output.·Use·the·–directory | 401 | resulting·coverage·data·to·the·standard·output.·Use·the·\-\-directory |
| 402 | option·to·capture·counts·for·a·user·space·program. | 402 | option·to·capture·counts·for·a·user·space·program. |
| 403 | .sp | 403 | .sp |
| 404 | The·result·of·the·capture·operation·will·be·written·to·stdout·or·the·tracefile | 404 | The·result·of·the·capture·operation·will·be·written·to·stdout·or·the·tracefile |
| 405 | specified·with·\-o. | 405 | specified·with·\-o. |
| 406 | .sp | 406 | .sp |
| 407 | When·combined·with·the | 407 | When·combined·with·the |
| 408 | \fB\-\-all\fP | 408 | \fB\-\-all\fP |
| Offset 411, 39 lines modified | Offset 411, 39 lines modified |
| 411 | \fB\-\-initial\fP | 411 | \fB\-\-initial\fP |
| 412 | flag,·below. | 412 | flag,·below. |
| 413 | .sp | 413 | .sp |
| 414 | See·man | 414 | See·man |
| 415 | \fBgeninfo(1)·\%<file://\:\:../\:man/\:geninfo\:.1\:.html>\fP) | 415 | \fBgeninfo(1)·\%<file://\:\:../\:man/\:geninfo\:.1\:.html>\fP) |
| 416 | for·more·details·about·the·capture·process·and·available·options·and·parameters. | 416 | for·more·details·about·the·capture·process·and·available·options·and·parameters. |
| 417 | .sp | 417 | .sp |
| 418 | Only·one·of··\-z,·\-c,·\-a,·\-e,·\-r,·\-l,·–diff·or·–summary·may·be | 418 | Only·one·of··\-z,·\-c,·\-a,·\-e,·\-r,·\-l,·\-\-diff·or·\-\-summary·may·be |
| 419 | specified·at·a·time. | 419 | specified·at·a·time. |
| 420 | .UNINDENT | 420 | .UNINDENT |
| 421 | .UNINDENT | 421 | .UNINDENT |
| 422 | .sp | 422 | .sp |
| 423 | \fB\-\-branch\-coverage\fP | 423 | \fB\-\-branch\-coverage\fP |
| 424 | .INDENT·0.0 | 424 | .INDENT·0.0 |
| 425 | .INDENT·3.5 | 425 | .INDENT·3.5 |
|
Max report size reached; 36470/41348 bytes (88.20%) of diff not shown.
|