Changes in sysfs-devices-node

84b25926 - acpi: numa: Add support to enumerate and store extended linear address mode

Wed, 26 Feb 2025 16:21:18 +0000

acpi: numa: Add support to enumerate and store extended linear address modeStore the address mode as part of the cache attriutes. Export the modeattribute to sysfs as all other cache attributes.Link: https://lore.kernel.org/linux-cxl/668333b17e4b2_5639294fd@dwillia2-xfh.jf.intel.com.notmuch/Reviewed-by: Jonathan Cameron Reviewed-by: Li Ming Reviewed-by: Alison Schofield Link: https://patch.msgid.link/20250226162224.3633792-2-dave.jiang@intel.comSigned-off-by: Dave Jiang List of files: /linux-6.15/Documentation/ABI/stable/sysfs-devices-node

4180887f - mm: memory-failure: document memory failure stats

Fri, 20 Jan 2023 03:46:22 +0000

mm: memory-failure: document memory failure statsAdd documentation for memory_failure's per NUMA node sysfs entriesLink: https://lkml.kernel.org/r/20230120034622.2698268-4-jiaqiyan@google.comSigned-off-by: Jiaqi Yan Acked-by: Naoya Horiguchi Cc: David Rientjes Cc: Kefeng Wang Cc: Tony Luck Cc: Yang Shi Signed-off-by: Andrew Morton List of files: /linux-6.15/Documentation/ABI/stable/sysfs-devices-node

50468e43 - x86/sgx: Add an attribute for the amount of SGX memory in a NUMA node

Tue, 16 Nov 2021 16:21:16 +0000

x86/sgx: Add an attribute for the amount of SGX memory in a NUMA node== Problem ==The amount of SGX memory on a system is determined by the BIOS and itvaries wildly between systems. It can be as small as dozens of MB'sand as large as many GB's on servers. Just like how applications needto know how much regular RAM is available, enclave builders need toknow how much SGX memory an enclave can consume.== Solution ==Introduce a new sysfs file: /sys/devices/system/node/nodeX/x86/sgx_total_bytesto enumerate the amount of SGX memory available in each NUMA node.This serves the same function for SGX as /proc/meminfo or/sys/devices/system/node/nodeX/meminfo does for normal RAM.'sgx_total_bytes' is needed today to help drive the SGX selftests.SGX-specific swap code is exercised by creating overcommitted enclaveswhich are larger than the physical SGX memory on the system. Theycurrently use a CPUID-based approach which can diverge from the actualamount of SGX memory available. 'sgx_total_bytes' ensures that theselftests can work efficiently and do not attempt stupid things likecreating a 100,000 MB enclave on a system with 128 MB of SGX memory.== Implementation Details ==Introduce CONFIG_HAVE_ARCH_NODE_DEV_GROUP opt-in flag to expose anarch specific attribute group, and add an attribute for the amount ofSGX memory in bytes to each NUMA node:== ABI Design Discussion ==As opposed to the per-node ABI, a single, global ABI was considered.However, this would prevent enclaves from being able to sizethemselves so that they fit on a single NUMA node. Essentially, asingle value would rule out NUMA optimizations for enclaves.Create a new "x86/" directory inside each "nodeX/" sysfs directory.'sgx_total_bytes' is expected to be the first of at least a fewsgx-specific files to be placed in the new directory. Just scanning/proc/meminfo, these are the no-brainers that we have for RAM, but weneed for SGX: MemTotal: xxxx kB // sgx_total_bytes (implemented here) MemFree: yyyy kB // sgx_free_bytes SwapTotal: zzzz kB // sgx_swapped_bytesSo, at *least* three. I think we will eventually end up needingsomething more along the lines of a dozen. A new directory (asopposed to being in the nodeX/ "root") directory avoids cluttering theroot with several "sgx_*" files.Place the new file in a new "nodeX/x86/" directory because SGX ishighly x86-specific. It is very unlikely that any other architecture(or even non-Intel x86 vendor) will ever implement SGX. Using "sgx/"as opposed to "x86/" was also considered. But, there is a real chancethis can get used for other arch-specific purposes.[ dhansen: rewrite changelog ]Signed-off-by: Jarkko Sakkinen Signed-off-by: Dave Hansen Acked-by: Greg Kroah-Hartman Acked-by: Borislav Petkov Link: https://lkml.kernel.org/r/20211116162116.93081-2-jarkko@kernel.org List of files: /linux-6.15/Documentation/ABI/stable/sysfs-devices-node

0c1bc6b8 - docs: filesystems: fix renamed references

Tue, 14 Apr 2020 16:48:37 +0000

docs: filesystems: fix renamed referencesSome filesystem references got broken by a previous patchseries I submitted. Address those.Signed-off-by: Mauro Carvalho Chehab Acked-by: David Sterba # fs/affs/KconfigLink: https://lore.kernel.org/r/57318c53008dbda7f6f4a5a9e5787f4d37e8565a.1586881715.git.mchehab+huawei@kernel.orgSigned-off-by: Jonathan Corbet List of files: /linux-6.15/Documentation/ABI/stable/sysfs-devices-node

4f4cfa6c - docs: admin-guide: add a series of orphaned documents

Thu, 27 Jun 2019 17:56:51 +0000

docs: admin-guide: add a series of orphaned documentsThere are lots of documents that belong to the admin-guide butare on random places (most under Documentation root dir).Move them to the admin guide.Signed-off-by: Mauro Carvalho Chehab Acked-by: Alexandre Belloni Acked-by: Bartlomiej Zolnierkiewicz List of files: /linux-6.15/Documentation/ABI/stable/sysfs-devices-node

acc02a10 - node: Add memory-side caching attributes

Mon, 11 Mar 2019 20:56:02 +0000

node: Add memory-side caching attributesSystem memory may have caches to help improve access speed to frequentlyrequested address ranges. While the system provided cache is transparentto the software accessing these memory ranges, applications can optimizetheir own access based on cache attributes.Provide a new API for the kernel to register these memory-side cachesunder the memory node that provides it.The new sysfs representation is modeled from the existing cpu cacheinfoattributes, as seen from /sys/devices/system/cpu//cache/. Unlike CPUcacheinfo though, the node cache level is reported from the view of thememory. A higher level number is nearer to the CPU, while lower levelsare closer to the last level memory.The exported attributes are the cache size, the line size, associativityindexing, and write back policy, and add the attributes for the systemmemory caches to sysfs stable documentation.Signed-off-by: Keith Busch Reviewed-by: Rafael J. Wysocki Reviewed-by: Brice Goglin Tested-by: Brice Goglin Signed-off-by: Greg Kroah-Hartman List of files: /linux-6.15/Documentation/ABI/stable/sysfs-devices-node

e1cf33aa - node: Add heterogenous memory access attributes

Mon, 11 Mar 2019 20:56:01 +0000

node: Add heterogenous memory access attributesHeterogeneous memory systems provide memory nodes with different latencyand bandwidth performance attributes. Provide a new kernel interfacefor subsystems to register the attributes under the memory targetnode's initiator access class. If the system provides this information,applications may query these attributes when deciding which node torequest memory.The following example shows the new sysfs hierarchy for a node exportingperformance attributes: # tree -P "read*|write*"/sys/devices/system/node/nodeY/accessZ/initiators/ /sys/devices/system/node/nodeY/accessZ/initiators/ |-- read_bandwidth |-- read_latency |-- write_bandwidth `-- write_latencyThe bandwidth is exported as MB/s and latency is reported innanoseconds. The values are taken from the platform as reported by themanufacturer.Memory accesses from an initiator node that is not one of the memory'saccess "Z" initiator nodes linked in the same directory may observedifferent performance than reported here. When a subsystem makes useof this interface, initiators of a different access number may not havethe same performance relative to initiators in other access numbers, oromitted from the any access class' initiators.Descriptions for memory access initiator performance access attributesare added to sysfs stable documentation.Acked-by: Jonathan Cameron Tested-by: Jonathan Cameron Signed-off-by: Keith Busch Reviewed-by: Rafael J. Wysocki Tested-by: Brice Goglin Signed-off-by: Greg Kroah-Hartman List of files: /linux-6.15/Documentation/ABI/stable/sysfs-devices-node

08d9dbe7 - node: Link memory nodes to their compute nodes

Mon, 11 Mar 2019 20:56:00 +0000

node: Link memory nodes to their compute nodesSystems may be constructed with various specialized nodes. Some nodesmay provide memory, some provide compute devices that access and usethat memory, and others may provide both. Nodes that provide memory arereferred to as memory targets, and nodes that can initiate memory accessare referred to as memory initiators.Memory targets will often have varying access characteristics fromdifferent initiators, and platforms may have ways to express thoserelationships. In preparation for these systems, provide interfaces forthe kernel to export the memory relationship among different nodes memorytargets and their initiators with symlinks to each other.If a system provides access locality for each initiator-target pair, nodesmay be grouped into ranked access classes relative to other nodes. Thenew interface allows a subsystem to register relationships of varyingclasses if available and desired to be exported.A memory initiator may have multiple memory targets in the same accessclass. The target memory's initiators in a given class indicate thenodes access characteristics share the same performance relative to otherlinked initiator nodes. Each target within an initiator's access class,though, do not necessarily perform the same as each other.A memory target node may have multiple memory initiators. All linkedinitiators in a target's class have the same access characteristics tothat target.The following example show the nodes' new sysfs hierarchy for a memorytarget node 'Y' with access class 0 from initiator node 'X': # symlinks -v /sys/devices/system/node/nodeX/access0/ relative: /sys/devices/system/node/nodeX/access0/targets/nodeY -> ../../nodeY # symlinks -v /sys/devices/system/node/nodeY/access0/ relative: /sys/devices/system/node/nodeY/access0/initiators/nodeX -> ../../nodeXThe new attributes are added to the sysfs stable documentation.Reviewed-by: Jonathan Cameron Signed-off-by: Keith Busch Reviewed-by: Rafael J. Wysocki Tested-by: Brice Goglin Signed-off-by: Greg Kroah-Hartman List of files: /linux-6.15/Documentation/ABI/stable/sysfs-devices-node

1ad1335d - docs/admin-guide/mm: start moving here files from Documentation/vm

Wed, 18 Apr 2018 08:07:49 +0000

docs/admin-guide/mm: start moving here files from Documentation/vmSeveral documents in Documentation/vm fit quite well into the "admin/userguide" category. The documents that don't overload the reader with lots ofimplementation details and provide coherent description of certain featurecan be moved to Documentation/admin-guide/mm.Signed-off-by: Mike Rapoport Signed-off-by: Jonathan Corbet List of files: /linux-6.15/Documentation/ABI/stable/sysfs-devices-node

ad56b738 - docs/vm: rename documentation files to .rst

Wed, 21 Mar 2018 19:22:47 +0000

docs/vm: rename documentation files to .rstSigned-off-by: Mike Rapoport Signed-off-by: Jonathan Corbet List of files: /linux-6.15/Documentation/ABI/stable/sysfs-devices-node

1f13ae39 - mm: remove noisy remainder of the scan_unevictable interface

Thu, 09 Oct 2014 22:27:39 +0000

mm: remove noisy remainder of the scan_unevictable interfaceThe deprecation warnings for the scan_unevictable interface triggers byscripts doing `sysctl -a | grep something else'. This is annoying and nothelpful.The interface has been defunct since 264e56d8247e ("mm: disable userinterface to manually rescue unevictable pages"), which was in 2011, andthere haven't been any reports of usecases for it, only reports that thedeprecation warnings are annying. It's unlikely that anybody is usingthis interface specifically at this point, so remove it.Signed-off-by: Johannes Weiner Signed-off-by: Andrew Morton Signed-off-by: Linus Torvalds List of files: /linux-6.15/Documentation/ABI/stable/sysfs-devices-node

5bbe1ec1 - Documentation: ABI: /sys/devices/system/node/

Tue, 18 Dec 2012 22:23:16 +0000

Documentation: ABI: /sys/devices/system/node/Describe NUMA node sysfs files/attributes.Note that for the specific dates and contacts I couldn't find,I left it as default for Oct 2002 and linux-mm.Signed-off-by: Davidlohr Bueso Cc: Greg Kroah-Hartman Signed-off-by: Andrew Morton Signed-off-by: Linus Torvalds List of files: /linux-6.15/Documentation/ABI/stable/sysfs-devices-node

e7c84ee2 - mm: document /sys/devices/system/node/nodeX

Fri, 05 Mar 2010 21:42:16 +0000

mm: document /sys/devices/system/node/nodeXAdd a bare description of what /sys/devices/system/node/nodeX is. Otherswill follow in time but right now, none of that tree is documented. Theexistence of this file might at least encourage people to document newentries.Signed-off-by: Mel Gorman Reviewed-by: KOSAKI Motohiro Signed-off-by: Andrew Morton Signed-off-by: Linus Torvalds List of files: /linux-6.15/Documentation/ABI/stable/sysfs-devices-node