From b6b130c5ebb82145000eed0b16f951d844e8a126 Mon Sep 17 00:00:00 2001 From: Jani Nikula Date: Tue, 1 Mar 2016 12:57:25 +0200 Subject: man: update intel_reg.rst to be more in line with the others Use the definitions and formatting used in other man pages, etc. Signed-off-by: Jani Nikula --- man/intel_reg.rst | 106 ++++++++++++++++++++++-------------------------------- 1 file changed, 42 insertions(+), 64 deletions(-) (limited to 'man') diff --git a/man/intel_reg.rst b/man/intel_reg.rst index d90c307d..d1af178a 100644 --- a/man/intel_reg.rst +++ b/man/intel_reg.rst @@ -5,18 +5,18 @@ intel_reg --------------------------------- Intel graphics register multitool --------------------------------- - +.. include:: defs.rst :Author: Jani Nikula -:Date: 2015-04-14 -:Version: intel-gpu-tools -:Copyright: 2015 Intel Corporation -:Manual section: 1 -:Manual group: General Commands Manual +:Date: 2016-03-01 +:Version: |PACKAGE_STRING| +:Copyright: 2015-2016 Intel Corporation +:Manual section: |MANUAL_SECTION| +:Manual group: |MANUAL_GROUP| SYNOPSIS ======== -**intel_reg** [*option* ...] *command* +**intel_reg** [*OPTIONS*] *COMMAND* DESCRIPTION =========== @@ -30,50 +30,33 @@ OPTIONS Some options are global, and some specific to commands. --verbose ---------- - -Increase verbosity. + Increase verbosity. --quiet -------- - -Decrease verbosity. + Decrease verbosity. --count=N ---------- - -Read N registers. + Read N registers. --binary --------- - -Output binary values. + Output binary values. --all ------ - -Decode registers for all known platforms. + Decode registers for all known platforms. --mmio=FILE ------------ - -Use MMIO bar from FILE. + Use MMIO bar from FILE. --devid=DEVID -------------- - -Pretend to be PCI ID DEVID. Useful with MMIO bar snapshots from other machines. + Pretend to be PCI ID DEVID. Useful with MMIO bar snapshots from other + machines. --spec=PATH ------------ - -Read register spec from directory or file specified by PATH; see REGISTER SPEC -DEFINITIONS below for details. + Read register spec from directory or file specified by PATH; see REGISTER + SPEC DEFINITIONS below for details. --help ------- - -Show brief help. + Show brief help. COMMANDS ======== @@ -123,52 +106,42 @@ REGISTER REFERENCES Registers are defined as [(PORTNAME|PORTNUM|MMIO-OFFSET):](REGNAME|REGADDR). PORTNAME --------- - -The register access method, most often MMIO, which is the default. The methods -supported on all platforms are "mmio", "portio-vga", and "mmio-vga". + The register access method, most often MMIO, which is the default. The + methods supported on all platforms are "mmio", "portio-vga", and "mmio-vga". -On BYT and CHV, the sideband ports "bunit", "punit", "nc", "dpio", "gpio-nc", -"cck", "ccu", "dpio2", and "flisdsi" are also supported. + On BYT and CHV, the sideband ports "bunit", "punit", "nc", "dpio", + "gpio-nc", "cck", "ccu", "dpio2", and "flisdsi" are also supported. PORTNUM -------- + Port number for the sideband ports supported on BYT and CHV. Only numbers + mapped to the supported ports are allowed, arbitrary numbers are not + accepted. -Port number for the sideband ports supported on BYT and CHV. Only numbers mapped -to the supported ports are allowed, arbitrary numbers are not accepted. - -Numbers above 0xff are automatically interpreted as MMIO offsets, not port -numbers. + Numbers above 0xff are automatically interpreted as MMIO offsets, not port + numbers. MMIO-OFFSET ------------ - -Use MMIO, and add this offset to the register address. + Use MMIO, and add this offset to the register address. -Numbers equal to or below 0xff are automatically interpreted as port numbers, -not MMIO offsets. + Numbers equal to or below 0xff are automatically interpreted as port + numbers, not MMIO offsets. REGNAME -------- + Name of the register as defined in the register spec. -Name of the register as defined in the register spec. - -If MMIO offset is not specified, it is picked up from the register -spec. However, ports are not; the port is a namespace for the register names. + If MMIO offset is not specified, it is picked up from the register + spec. However, ports are not; the port is a namespace for the register + names. REGADDR -------- - -Register address. The corresponding register name need not be specified in the -register spec. + Register address. The corresponding register name need not be specified in + the register spec. ENVIRONMENT =========== INTEL_REG_SPEC --------------- - -Path to a directory or a file containing register spec definitions. + Path to a directory or a file containing register spec definitions. REGISTER SPEC DEFINITIONS ========================= @@ -226,3 +199,8 @@ BUGS ==== Reading some registers may hang the GPU or the machine. + +REPORTING BUGS +============== + +Report bugs to https://bugs.freedesktop.org. -- cgit v1.2.3