mirror of
https://github.com/tiagovignatti/intel-gpu-tools.git
synced 2025-06-10 09:26:10 +00:00
doc: various spelling and typo fixes
Signed-off-by: Thomas Wood <thomas.wood@intel.com>
This commit is contained in:
parent
c256af5d44
commit
519f377ddd
@ -59,7 +59,7 @@
|
||||
|
||||
/**
|
||||
* SECTION:igt_aux
|
||||
* @short_description: Auxiliary libararies and support functions
|
||||
* @short_description: Auxiliary libraries and support functions
|
||||
* @title: i-g-t aux
|
||||
* @include: igt_aux.h
|
||||
*
|
||||
@ -222,7 +222,7 @@ void igt_permute_array(void *array, unsigned size,
|
||||
*
|
||||
* This function draws a progress indicator, which is useful for running
|
||||
* long-winded tests manually on the console. To avoid spamming logfiles in
|
||||
* automated runs the progress indicator is supressed when not running on a
|
||||
* automated runs the progress indicator is suppressed when not running on a
|
||||
* terminal.
|
||||
*/
|
||||
void igt_progress(const char *header, uint64_t i, uint64_t total)
|
||||
@ -325,11 +325,11 @@ void igt_system_suspend_autoresume(void)
|
||||
}
|
||||
|
||||
/**
|
||||
* igt_drop_roo:
|
||||
* igt_drop_root:
|
||||
*
|
||||
* Drop root priviledges and make sure it actually worked. Useful for tests
|
||||
* Drop root privileges and make sure it actually worked. Useful for tests
|
||||
* which need to check security constraints. Note that this should only be
|
||||
* called from manually forked processes, since the lack of root priviledges
|
||||
* called from manually forked processes, since the lack of root privileges
|
||||
* will wreak havoc with the automatic cleanup handlers.
|
||||
*/
|
||||
void igt_drop_root(void)
|
||||
@ -350,7 +350,7 @@ void igt_drop_root(void)
|
||||
* Waits for a key press when run interactively and when the corresponding debug
|
||||
* key is set in the IGT_DEBUG_INTERACTIVE environment variable. Multiple keys
|
||||
* can be specified as a comma-separated list or alternatively "all" if a wait
|
||||
* should happen for all keys. When not connected to a terminal the enviroment
|
||||
* should happen for all keys. When not connected to a terminal the environment
|
||||
* setting is ignored and execution immediately continues.
|
||||
*
|
||||
* This is useful for display tests where under certain situation manual
|
||||
|
@ -67,7 +67,7 @@
|
||||
* @title: i-g-t core
|
||||
* @include: igt_core.h
|
||||
*
|
||||
* This libary implements the core of the i-g-t test support infrastructure.
|
||||
* This library implements the core of the i-g-t test support infrastructure.
|
||||
* Main features are the subtest enumeration, cmdline option parsing helpers for
|
||||
* subtest handling and various helpers to structure testcases with subtests and
|
||||
* handle subtest test results.
|
||||
@ -141,9 +141,9 @@
|
||||
* conditions, but instead such assumptions should be written in a declarative
|
||||
* style. Use one of the many macros which encapsulate i-g-t's implicit
|
||||
* control flow. Pick the most suitable one to have as much debug output as
|
||||
* possible without polluting the code unecessarily. For example
|
||||
* possible without polluting the code unnecessarily. For example
|
||||
* igt_assert_cmpint() for comparing integers or do_ioctl() for running ioctls
|
||||
* and checking their results. Feel free to add new ones to the libary or
|
||||
* and checking their results. Feel free to add new ones to the library or
|
||||
* wrap up a set of checks into a private function to further condense your
|
||||
* test logic.
|
||||
*
|
||||
@ -197,7 +197,7 @@
|
||||
* run as non-root and doesn't require the i915 driver to be loaded (or any
|
||||
* intel gpu to be present). Then individual subtests can be run with
|
||||
* "--run-subtest". Usage help for tests with subtests can be obtained with the
|
||||
* "--help" commandline option.
|
||||
* "--help" command line option.
|
||||
*/
|
||||
|
||||
static unsigned int exit_handler_count;
|
||||
@ -734,7 +734,7 @@ void __igt_skip_check(const char *file, const int line,
|
||||
/**
|
||||
* igt_success:
|
||||
*
|
||||
* Complete a (subtest) as successfull
|
||||
* Complete a (subtest) as successful
|
||||
*
|
||||
* This bails out of a subtests and marks it as successful. For global tests it
|
||||
* it won't bail out of anything.
|
||||
@ -1041,9 +1041,9 @@ bool __igt_fork(void)
|
||||
* Wait for all children forked with igt_fork.
|
||||
*
|
||||
* The magic here is that exit codes from children will be correctly propagated
|
||||
* to the main thread, including the relevant exitcode if a child thread failed.
|
||||
* Of course if multiple children failed with differen exitcodes the resulting
|
||||
* exitcode will be non-deterministic.
|
||||
* to the main thread, including the relevant exit code if a child thread failed.
|
||||
* Of course if multiple children failed with different exit codes the resulting
|
||||
* exit code will be non-deterministic.
|
||||
*
|
||||
* Note that igt_skip() will not be forwarded, feature tests need to be done
|
||||
* before spawning threads with igt_fork().
|
||||
@ -1282,8 +1282,8 @@ void igt_enable_exit_handler(void)
|
||||
* igt_run_in_simulation:
|
||||
*
|
||||
* This function can be used to select a reduced test set when running in
|
||||
* simulation enviroments. This i-g-t mode is selected by setting the
|
||||
* INTEL_SIMULATION enviroment variable to 1.
|
||||
* simulation environments. This i-g-t mode is selected by setting the
|
||||
* INTEL_SIMULATION environment variable to 1.
|
||||
*
|
||||
* Returns: True when run in simulation mode, false otherwise.
|
||||
*/
|
||||
@ -1334,7 +1334,7 @@ void igt_skip_on_simulation(void)
|
||||
* to stderr and the test runner should treat this as an intermediate result
|
||||
* between SUCESS and FAILURE.
|
||||
*
|
||||
* The log level can be set through the IGT_LOG_LEVEL enviroment variable with
|
||||
* The log level can be set through the IGT_LOG_LEVEL environment variable with
|
||||
* values "debug", "info", "warn" and "none". By default verbose debug message
|
||||
* are disabled. "none" completely disables all output and is not recommended
|
||||
* since crucial issues only reported at the IGT_LOG_WARN level are ignored.
|
||||
|
@ -118,7 +118,7 @@ bool __igt_run_subtest(const char *subtest_name);
|
||||
* @name: name of the subtest
|
||||
*
|
||||
* This is a magic control flow block which denotes a subtest code block. Within
|
||||
* that codeblock igt_skip|success will only bail out of the subtest. The _f
|
||||
* that code block igt_skip|success will only bail out of the subtest. The _f
|
||||
* variant accepts a printf format string, which is useful for constructing
|
||||
* combinatorial tests.
|
||||
*
|
||||
@ -140,7 +140,7 @@ bool __igt_run_subtest(const char *subtest_name);
|
||||
* @...: format string and optional arguments
|
||||
*
|
||||
* This is a magic control flow block which denotes a subtest code block. Within
|
||||
* that codeblock igt_skip|success will only bail out of the subtest. The _f
|
||||
* that code block igt_skip|success will only bail out of the subtest. The _f
|
||||
* variant accepts a printf format string, which is useful for constructing
|
||||
* combinatorial tests.
|
||||
*
|
||||
|
@ -51,7 +51,7 @@
|
||||
* # Pipe CRC Support
|
||||
*
|
||||
* This library wraps up the kernel's support for capturing pipe CRCs into a
|
||||
* neat and tidy package. For the datailed usage see all the functions which
|
||||
* neat and tidy package. For the detailed usage see all the functions which
|
||||
* work on #igt_pipe_crc_t. This is supported on all platforms and outputs.
|
||||
*
|
||||
* Actually using pipe CRCs to write modeset tests is a bit tricky though, so
|
||||
@ -59,7 +59,7 @@
|
||||
* blending, color correction and other hardware and how exactly the CRC is
|
||||
* computed at each tap point vary by hardware generation and are not disclosed.
|
||||
*
|
||||
* The only way to use #igt_crc_t CRCs therefors is to compare CRCs among each
|
||||
* The only way to use #igt_crc_t CRCs therefore is to compare CRCs among each
|
||||
* another either for equality or difference. Otherwise CRCs must be treated as
|
||||
* completely opaque values. Note that not even CRCs from different pipes or tap
|
||||
* points on the same platform can be compared. Hence only use igt_crc_is_null()
|
||||
@ -218,7 +218,7 @@ bool igt_crc_is_null(igt_crc_t *crc)
|
||||
*
|
||||
* Compares two CRC values.
|
||||
*
|
||||
* Returns: Retruns true if the two CRCs match, false otherwise.
|
||||
* Returns: true if the two CRCs match, false otherwise.
|
||||
*/
|
||||
bool igt_crc_equal(igt_crc_t *a, igt_crc_t *b)
|
||||
{
|
||||
|
@ -153,7 +153,7 @@ int igt_open_forcewake_handle(void);
|
||||
* @STOP_RING_RENDER: Render ring
|
||||
* @STOP_RING_BSD: Video encoding/decoding ring
|
||||
* @STOP_RING_BLT: Blitter ring
|
||||
* @STOP_RING_VEBOX: Video enchanment ring
|
||||
* @STOP_RING_VEBOX: Video enhancement ring
|
||||
* @STOP_RING_ALL: All rings
|
||||
* @STOP_RING_ALLOW_ERRORS: Driver will not omit expected DRM_ERRORS
|
||||
* @STOP_RING_ALLOW_BAN: Driver will use context ban policy
|
||||
|
@ -70,7 +70,7 @@ enum port {
|
||||
* kmstest_port_name:
|
||||
* @port: display plane
|
||||
*
|
||||
* Returns: String represnting @port, e.g. "A".
|
||||
* Returns: String representing @port, e.g. "A".
|
||||
*/
|
||||
#define kmstest_port_name(port) ((port) + 'A')
|
||||
|
||||
|
@ -53,12 +53,12 @@
|
||||
* @include: intel_io.h
|
||||
*
|
||||
* This library provides register I/O helpers in both a basic version and a more
|
||||
* fancy version which also handles forcewak and can optionally check registers
|
||||
* fancy version which also handles forcewake and can optionally check registers
|
||||
* against a white-list. All register function are compatible. Hence the same
|
||||
* code can be used to decode registers with either of them, or also from a dump
|
||||
* file using intel_mmio_use_dump_file().
|
||||
*
|
||||
* Futhermore this library also provides helper functions for accessing the
|
||||
* Furthermore this library also provides helper functions for accessing the
|
||||
* various sideband interfaces found on Valleyview/Baytrail based platforms.
|
||||
*/
|
||||
|
||||
@ -84,7 +84,7 @@ static struct _mmio_data {
|
||||
* @file: name of the register dump file to open
|
||||
*
|
||||
* Sets up #mmio to point at the data contained in @file. This allows the same
|
||||
* code to get reused for dumping and decoding from running hardwared as from
|
||||
* code to get reused for dumping and decoding from running hardware as from
|
||||
* register dumps.
|
||||
*/
|
||||
void
|
||||
@ -109,7 +109,7 @@ intel_mmio_use_dump_file(char *file)
|
||||
* @pci_dev: intel gracphis pci device
|
||||
*
|
||||
* Sets up #mmio to point at the data contained in @file. This allows the same
|
||||
* code to get reused for dumping and decoding from running hardwared as from
|
||||
* code to get reused for dumping and decoding from running hardware as from
|
||||
* register dumps.
|
||||
*
|
||||
* @pci_dev can be obtained from intel_get_pci_device().
|
||||
|
@ -200,7 +200,7 @@ intel_get_total_swap_mb(void)
|
||||
*
|
||||
* Computes the total amount of memory required to allocate @count surfaces,
|
||||
* each of @size bytes, and includes an estimate for kernel overhead. It then
|
||||
* queries the kernel for the avilable amount of memory on the system (either
|
||||
* queries the kernel for the available amount of memory on the system (either
|
||||
* RAM and/or SWAP depending upon @mode) and determines whether there is
|
||||
* sufficient to run the test.
|
||||
*
|
||||
|
@ -506,7 +506,7 @@ void *gem_mmap__cpu(int fd, uint32_t handle, int size, int prot)
|
||||
* object is in need again it must be set back to WILLNEED before first use.
|
||||
*
|
||||
* Returns: When setting the madvise state to WILLNEED this returns whether the
|
||||
* backing storage was still avialable or not.
|
||||
* backing storage was still available or not.
|
||||
*/
|
||||
int gem_madvise(int fd, uint32_t handle, int state)
|
||||
{
|
||||
@ -597,7 +597,7 @@ bool gem_bo_busy(int fd, uint32_t handle)
|
||||
* Feature test macro to check whether the kernel internally uses ppgtt to
|
||||
* execute batches. The /aliasing/ in the function name is a bit a misnomer,
|
||||
* this driver parameter is also true when full ppgtt address spaces are
|
||||
* availabel since for batchbuffer construction only ppgtt or global gtt is
|
||||
* available since for batchbuffer construction only ppgtt or global gtt is
|
||||
* relevant.
|
||||
*
|
||||
* Returns: Whether batches are run through ppgtt.
|
||||
@ -623,7 +623,7 @@ bool gem_uses_aliasing_ppgtt(int fd)
|
||||
* @fd: open i915 drm file descriptor
|
||||
*
|
||||
* Feature test macro to query the kernel for the number of available fences
|
||||
* useable in a batchbuffer. Only relevant for pre-gen4.
|
||||
* usable in a batchbuffer. Only relevant for pre-gen4.
|
||||
*
|
||||
* Returns: The number of available fences.
|
||||
*/
|
||||
@ -663,7 +663,7 @@ bool gem_has_llc(int fd)
|
||||
* gem_get_num_rings:
|
||||
* @fd: open i915 drm file descriptor
|
||||
*
|
||||
* Feature test macro to query the number of avaible rings. This is useful in
|
||||
* Feature test macro to query the number of available rings. This is useful in
|
||||
* test loops which need to step through all rings and similar logic.
|
||||
*
|
||||
* For more explicit tests of ring availability see gem_has_enable_ring() and
|
||||
@ -702,7 +702,7 @@ skip:
|
||||
*
|
||||
* Feature test macro to query whether a specific ring is available.
|
||||
*
|
||||
* Returns: Whether the ring is avaible or not.
|
||||
* Returns: Whether the ring is available or not.
|
||||
*/
|
||||
bool gem_has_enable_ring(int fd,int param)
|
||||
{
|
||||
@ -729,7 +729,7 @@ bool gem_has_enable_ring(int fd,int param)
|
||||
*
|
||||
* Note that recent Bspec calls this the VCS ring for Video Command Submission.
|
||||
*
|
||||
* Returns: Whether the BSD ring is avaible or not.
|
||||
* Returns: Whether the BSD ring is available or not.
|
||||
*/
|
||||
bool gem_has_bsd(int fd)
|
||||
{
|
||||
@ -745,7 +745,7 @@ bool gem_has_bsd(int fd)
|
||||
*
|
||||
* Note that recent Bspec calls this the BCS ring for Blitter Command Submission.
|
||||
*
|
||||
* Returns: Whether the blitter ring is avaible or not.
|
||||
* Returns: Whether the blitter ring is available or not.
|
||||
*/
|
||||
bool gem_has_blt(int fd)
|
||||
{
|
||||
@ -763,7 +763,7 @@ bool gem_has_blt(int fd)
|
||||
* Note that recent Bspec calls this the VECS ring for Video Enhancement Command
|
||||
* Submission.
|
||||
*
|
||||
* Returns: Whether the vebox ring is avaible or not.
|
||||
* Returns: Whether the vebox ring is available or not.
|
||||
*/
|
||||
bool gem_has_vebox(int fd)
|
||||
{
|
||||
@ -775,7 +775,7 @@ bool gem_has_vebox(int fd)
|
||||
* @fd: open i915 drm file descriptor
|
||||
*
|
||||
* Feature test macro to query the kernel for the available gpu aperture size
|
||||
* useable in a batchbuffer.
|
||||
* usable in a batchbuffer.
|
||||
*
|
||||
* Returns: The available gtt address space size.
|
||||
*/
|
||||
@ -814,7 +814,7 @@ uint64_t gem_aperture_size(int fd)
|
||||
* @fd: open i915 drm file descriptor
|
||||
*
|
||||
* Feature test macro to query the kernel for the mappable gpu aperture size.
|
||||
* This is the area avaialble for GTT memory mappings.
|
||||
* This is the area available for GTT memory mappings.
|
||||
*
|
||||
* Returns: The mappable gtt address space size.
|
||||
*/
|
||||
|
Loading…
x
Reference in New Issue
Block a user