[aegl:rdt-aet-v10 61/61] htmldocs: Documentation/filesystems/resctrl.rst:526: WARNING: Inline emphasis start-string without end-string. [docutils]

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 



tree:   https://git.kernel.org/pub/scm/linux/kernel/git/aegl/linux.git rdt-aet-v10
head:   89f7ddfa06e19e9b7acd666c1ae7e04034bc2636
commit: 89f7ddfa06e19e9b7acd666c1ae7e04034bc2636 [61/61] x86,fs/resctrl: Update Documentation for package events
reproduce: (https://download.01.org/0day-ci/archive/20250913/202509131227.pXo5yK6u-lkp@xxxxxxxxx/reproduce)

If you fix the issue in a separate patch/commit (i.e. not just a new version of
the same patch/commit), kindly add following tags
| Reported-by: kernel test robot <lkp@xxxxxxxxx>
| Closes: https://lore.kernel.org/oe-kbuild-all/202509131227.pXo5yK6u-lkp@xxxxxxxxx/

All warnings (new ones prefixed by >>):

   ERROR: Cannot find file ./include/linux/jbd2.h
   ERROR: Cannot find file ./include/linux/jbd2.h
   WARNING: No kernel-doc for file ./include/linux/jbd2.h
   ERROR: Cannot find file ./include/linux/netfs.h
   WARNING: No kernel-doc for file ./include/linux/netfs.h
>> Documentation/filesystems/resctrl.rst:526: WARNING: Inline emphasis start-string without end-string. [docutils]
   ERROR: Cannot find file ./include/linux/pipe_fs_i.h
   ERROR: Cannot find file ./include/linux/pipe_fs_i.h
   WARNING: No kernel-doc for file ./include/linux/pipe_fs_i.h
   WARNING: ./drivers/gpu/drm/amd/display/dc/dc.h:254 struct member 'num_rmcm_3dluts' not described in 'mpc_color_caps'
   ERROR: Cannot find file ./include/linux/backlight.h


vim +526 Documentation/filesystems/resctrl.rst

   518	
   519	"mon_data":
   520		This contains directories for each monitor domain. One set for
   521		each instance of an L3 cache, another set for each processor
   522		package. The L3 cache directories are named "mon_L3_00",
   523		"mon_L3_01" etc. The package directories "mon_PERF_PKG_00",
   524		"mon_PERF_PKG_01" etc.
   525	
 > 526		Within each directory there is one file per event. For
   527		example the L3 directories may contain "llc_occupancy", "mbm_total_bytes",
   528		and "mbm_local_bytes". The PERF_PKG directories may contain "core_energy",
   529		"activity", etc. The info/*/mon_features files provide the full
   530		list of event/file names.
   531	
   532		"core energy" reports a floating point number for the energy (in Joules)
   533		consumed by cores (registers, arithmetic units, TLB and L1/L2 caches)
   534		during execution of instructions summed across all logical CPUs on a
   535		package for the current RMID.
   536	
   537		"activity" also reports a floating point value (in Farads).
   538		This provides an estimate of work done independent of the
   539		frequency that the CPUs used for execution.
   540	
   541		Note that these two counters only measure energy/activity
   542		in the "core" of the CPU (arithmetic units, TLB, L1 and L2
   543		caches, etc.). They do not include L3 cache, memory, I/O
   544		devices etc.
   545	
   546		All other events report decimal integer values.
   547	
   548		In a MON group these files provide a read out of the current
   549		value of the event for all tasks in the group. In CTRL_MON groups
   550		these files provide the sum for all tasks in the CTRL_MON group
   551		and all tasks in MON groups. Please see example section for more
   552		details on usage.
   553	
   554		On systems with Sub-NUMA Cluster (SNC) enabled there are extra
   555		directories for each node (located within the "mon_L3_XX" directory
   556		for the L3 cache they occupy). These are named "mon_sub_L3_YY"
   557		where "YY" is the node number.
   558	
   559		When the 'mbm_event' counter assignment mode is enabled, reading
   560		an MBM event of a MON group returns 'Unassigned' if no hardware
   561		counter is assigned to it. For CTRL_MON groups, 'Unassigned' is
   562		returned if the MBM event does not have an assigned counter in the
   563		CTRL_MON group nor in any of its associated MON groups.
   564	

-- 
0-DAY CI Kernel Test Service
https://github.com/intel/lkp-tests/wiki




[Index of Archives]     [Kernel Newbies]     [Security]     [Netfilter]     [Bugtraq]     [Linux FS]     [Yosemite Forum]     [MIPS Linux]     [ARM Linux]     [Linux Security]     [Linux RAID]     [Samba]     [Video 4 Linux]     [Device Mapper]     [Linux Resources]

  Powered by Linux