Linux kernel mirror (for testing) git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel os linux

Documentation: admin-guide: correct spelling

Correct spelling problems for Documentation/admin-guide/ as reported
by codespell.

Signed-off-by: Randy Dunlap <rdunlap@infradead.org>
Reviewed-by: Mukesh Ojha <quic_mojha@quicinc.com>
Cc: Tejun Heo <tj@kernel.org>
Cc: Zefan Li <lizefan.x@bytedance.com>
Cc: Johannes Weiner <hannes@cmpxchg.org>
Cc: cgroups@vger.kernel.org
Cc: Alasdair Kergon <agk@redhat.com>
Cc: Mike Snitzer <snitzer@kernel.org>
Cc: dm-devel@redhat.com
Cc: Mauro Carvalho Chehab <mchehab@kernel.org>
Cc: linux-media@vger.kernel.org
Cc: linux-mm@kvack.org
Link: https://lore.kernel.org/r/20230129231053.20863-2-rdunlap@infradead.org
Signed-off-by: Jonathan Corbet <corbet@lwn.net>

authored by

Randy Dunlap and committed by
Jonathan Corbet
dbeb56fe b7cb8405

+41 -41
+1 -1
Documentation/admin-guide/bcache.rst
··· 204 204 This should present your unmodified backing device data in /dev/loop0 205 205 206 206 If your cache is in writethrough mode, then you can safely discard the 207 - cache device without loosing data. 207 + cache device without losing data. 208 208 209 209 210 210 E) Wiping a cache device
+1 -1
Documentation/admin-guide/cgroup-v1/blkio-controller.rst
··· 106 106 see Documentation/block/bfq-iosched.rst. 107 107 108 108 blkio.bfq.weight_device 109 - Specifes per cgroup per device weights, overriding the default group 109 + Specifies per cgroup per device weights, overriding the default group 110 110 weight. For more details, see Documentation/block/bfq-iosched.rst. 111 111 112 112 Following is the format::
+5 -5
Documentation/admin-guide/cgroup-v2.rst
··· 622 622 Limits 623 623 ------ 624 624 625 - A child can only consume upto the configured amount of the resource. 625 + A child can only consume up to the configured amount of the resource. 626 626 Limits can be over-committed - the sum of the limits of children can 627 627 exceed the amount of resource available to the parent. 628 628 ··· 639 639 Protections 640 640 ----------- 641 641 642 - A cgroup is protected upto the configured amount of the resource 642 + A cgroup is protected up to the configured amount of the resource 643 643 as long as the usages of all its ancestors are under their 644 644 protected levels. Protections can be hard guarantees or best effort 645 645 soft boundaries. Protections can also be over-committed in which case 646 - only upto the amount available to the parent is protected among 646 + only up to the amount available to the parent is protected among 647 647 children. 648 648 649 649 Protections are in the range [0, max] and defaults to 0, which is ··· 1076 1076 1077 1077 $MAX $PERIOD 1078 1078 1079 - which indicates that the group may consume upto $MAX in each 1079 + which indicates that the group may consume up to $MAX in each 1080 1080 $PERIOD duration. "max" for $MAX indicates no limit. If only 1081 1081 one number is written, $MAX is updated. 1082 1082 ··· 2289 2289 For a valid partition root with the sibling cpu exclusivity 2290 2290 rule enabled, changes made to "cpuset.cpus" that violate the 2291 2291 exclusivity rule will invalidate the partition as well as its 2292 - sibiling partitions with conflicting cpuset.cpus values. So 2292 + sibling partitions with conflicting cpuset.cpus values. So 2293 2293 care must be taking in changing "cpuset.cpus". 2294 2294 2295 2295 A valid non-root parent partition may distribute out all its CPUs
+2 -2
Documentation/admin-guide/cifs/usage.rst
··· 399 399 sep 400 400 if first mount option (after the -o), overrides 401 401 the comma as the separator between the mount 402 - parms. e.g.:: 402 + parameters. e.g.:: 403 403 404 404 -o user=myname,password=mypassword,domain=mydom 405 405 ··· 765 765 Some debugging statements are not compiled into the 766 766 cifs kernel unless CONFIG_CIFS_DEBUG2 is enabled in the 767 767 kernel configuration. cifsFYI may be set to one or 768 - nore of the following flags (7 sets them all):: 768 + more of the following flags (7 sets them all):: 769 769 770 770 +-----------------------------------------------+------+ 771 771 | log cifs informational messages | 0x01 |
+1 -1
Documentation/admin-guide/device-mapper/cache-policies.rst
··· 70 70 cache block). 71 71 72 72 All this means smq uses ~25bytes per cache block. Still a lot of 73 - memory, but a substantial improvement nontheless. 73 + memory, but a substantial improvement nonetheless. 74 74 75 75 Level balancing 76 76 ^^^^^^^^^^^^^^^
+1 -1
Documentation/admin-guide/device-mapper/dm-ebs.rst
··· 31 31 32 32 Optional parameter: 33 33 34 - <underyling sectors>: 34 + <underlying sectors>: 35 35 Number of sectors defining the logical block size of <dev path>. 36 36 2^N supported, e.g. 8 = emulate 8 sectors of 512 bytes = 4KiB. 37 37 If not provided, the logical block size of <dev path> will be used.
+1 -1
Documentation/admin-guide/device-mapper/dm-zoned.rst
··· 46 46 The zones of the device(s) are separated into 2 types: 47 47 48 48 1) Metadata zones: these are conventional zones used to store metadata. 49 - Metadata zones are not reported as useable capacity to the user. 49 + Metadata zones are not reported as usable capacity to the user. 50 50 51 51 2) Data zones: all remaining zones, the vast majority of which will be 52 52 sequential zones used exclusively to store user data. The conventional
+5 -5
Documentation/admin-guide/device-mapper/unstriped.rst
··· 35 35 36 36 This small bash script will setup 4 loop devices and use the existing 37 37 striped target to combine the 4 devices into one. It then will use 38 - the unstriped target ontop of the striped device to access the 38 + the unstriped target on top of the striped device to access the 39 39 individual backing loop devices. We write data to the newly exposed 40 40 unstriped devices and verify the data written matches the correct 41 41 underlying device on the striped array:: ··· 110 110 Example dmsetup usage 111 111 ===================== 112 112 113 - unstriped ontop of Intel NVMe device that has 2 cores 114 - ----------------------------------------------------- 113 + unstriped on top of Intel NVMe device that has 2 cores 114 + ------------------------------------------------------ 115 115 116 116 :: 117 117 ··· 124 124 /dev/mapper/nvmset0 125 125 /dev/mapper/nvmset1 126 126 127 - unstriped ontop of striped with 4 drives using 128K chunk size 128 - -------------------------------------------------------------- 127 + unstriped on top of striped with 4 drives using 128K chunk size 128 + --------------------------------------------------------------- 129 129 130 130 :: 131 131
+1 -1
Documentation/admin-guide/dynamic-debug-howto.rst
··· 330 330 331 331 // boot-args example, with newlines and comments for readability 332 332 Kernel command line: ... 333 - // see whats going on in dyndbg=value processing 333 + // see what's going on in dyndbg=value processing 334 334 dynamic_debug.verbose=3 335 335 // enable pr_debugs in the btrfs module (can be builtin or loadable) 336 336 btrfs.dyndbg="+p"
+1 -1
Documentation/admin-guide/gpio/gpio-sim.rst
··· 123 123 directory for each exposed line 124 124 (e.g. ``/sys/devices/platform/gpio-sim.X/gpiochipY/``). The name of each group 125 125 is of the form: ``'sim_gpioX'`` where X is the offset of the line. Inside each 126 - group there are two attibutes: 126 + group there are two attributes: 127 127 128 128 ``pull`` - allows to read and set the current simulated pull setting for 129 129 every line, when writing the value must be one of: ``'pull-up'``,
+2 -2
Documentation/admin-guide/hw-vuln/mds.rst
··· 64 64 Attack scenarios 65 65 ---------------- 66 66 67 - Attacks against the MDS vulnerabilities can be mounted from malicious non 68 - priviledged user space applications running on hosts or guest. Malicious 67 + Attacks against the MDS vulnerabilities can be mounted from malicious non- 68 + privileged user space applications running on hosts or guest. Malicious 69 69 guest OSes can obviously mount attacks as well. 70 70 71 71 Contrary to other speculation based vulnerabilities the MDS vulnerability
+4 -4
Documentation/admin-guide/kernel-parameters.txt
··· 670 670 Sets the size of kernel per-numa memory area for 671 671 contiguous memory allocations. A value of 0 disables 672 672 per-numa CMA altogether. And If this option is not 673 - specificed, the default value is 0. 673 + specified, the default value is 0. 674 674 With per-numa CMA enabled, DMA users on node nid will 675 675 first try to allocate buffer from the pernuma area 676 676 which is located in node nid, if the allocation fails, ··· 942 942 driver code when a CPU writes to (or reads from) a 943 943 random memory location. Note that there exists a class 944 944 of memory corruptions problems caused by buggy H/W or 945 - F/W or by drivers badly programing DMA (basically when 945 + F/W or by drivers badly programming DMA (basically when 946 946 memory is written at bus level and the CPU MMU is 947 947 bypassed) which are not detectable by 948 948 CONFIG_DEBUG_PAGEALLOC, hence this option will not help ··· 1726 1726 boot-time allocation of gigantic hugepages is skipped. 1727 1727 1728 1728 hugetlb_free_vmemmap= 1729 - [KNL] Reguires CONFIG_HUGETLB_PAGE_OPTIMIZE_VMEMMAP 1729 + [KNL] Requires CONFIG_HUGETLB_PAGE_OPTIMIZE_VMEMMAP 1730 1730 enabled. 1731 1731 Control if HugeTLB Vmemmap Optimization (HVO) is enabled. 1732 1732 Allows heavy hugetlb users to free up some more ··· 3684 3684 implementation; requires CONFIG_GENERIC_IDLE_POLL_SETUP 3685 3685 to be effective. This is useful on platforms where the 3686 3686 sleep(SH) or wfi(ARM,ARM64) instructions do not work 3687 - correctly or when doing power measurements to evalute 3687 + correctly or when doing power measurements to evaluate 3688 3688 the impact of the sleep instructions. This is also 3689 3689 useful when using JTAG debugger. 3690 3690
+1 -1
Documentation/admin-guide/laptops/thinkpad-acpi.rst
··· 1488 1488 Text corresponding to keyboard layout to be set in sysfs are: be(Belgian), 1489 1489 cz(Czech), da(Danish), de(German), en(English), es(Spain), et(Estonian), 1490 1490 fr(French), fr-ch(French(Switzerland)), hu(Hungarian), it(Italy), jp (Japan), 1491 - nl(Dutch), nn(Norway), pl(Polish), pt(portugese), sl(Slovenian), sv(Sweden), 1491 + nl(Dutch), nn(Norway), pl(Polish), pt(portuguese), sl(Slovenian), sv(Sweden), 1492 1492 tr(Turkey) 1493 1493 1494 1494 WWAN Antenna type
+1 -1
Documentation/admin-guide/md.rst
··· 317 317 suspended (not supported yet) 318 318 All IO requests will block. The array can be reconfigured. 319 319 320 - Writing this, if accepted, will block until array is quiessent 320 + Writing this, if accepted, will block until array is quiescent 321 321 322 322 readonly 323 323 no resync can happen. no superblocks get written.
+1 -1
Documentation/admin-guide/media/bttv.rst
··· 909 909 - TVPhone98 (Bt878) 910 910 - AVerTV und TVCapture98 w/VCR (Bt 878) 911 911 - AVerTVStudio und TVPhone98 w/VCR (Bt878) 912 - - AVerTV GO Serie (Kein SVideo Input) 912 + - AVerTV GO Series (Kein SVideo Input) 913 913 - AVerTV98 (BT-878 chip) 914 914 - AVerTV98 mit Fernbedienung (BT-878 chip) 915 915 - AVerTV/FM98 (BT-878 chip)
+1 -1
Documentation/admin-guide/media/building.rst
··· 137 137 from remote controllers. 138 138 139 139 The ``Support for eBPF programs attached to lirc devices`` option allows 140 - the usage of special programs (called eBPF) that would allow aplications 140 + the usage of special programs (called eBPF) that would allow applications 141 141 to add extra remote controller decoding functionality to the Linux Kernel. 142 142 143 143 The ``Remote controller decoders`` option allows selecting the
+1 -1
Documentation/admin-guide/media/si476x.rst
··· 142 142 indicator 143 143 0x18 lassi Signed Low side adjacent Channel 144 144 Strength indicator 145 - 0x19 hassi ditto fpr High side 145 + 0x19 hassi ditto for High side 146 146 0x20 mult Multipath indicator 147 147 0x21 dev Frequency deviation 148 148 0x24 assi Adjacent channel SSI
+1 -1
Documentation/admin-guide/media/vivid.rst
··· 580 580 ---------------- 581 581 582 582 The Metadata capture generates UVC format metadata. The PTS and SCR are 583 - transmitted based on the values set in vivid contols. 583 + transmitted based on the values set in vivid controls. 584 584 585 585 The Metadata device will only work for the Webcam input, it will give 586 586 back an error for all other inputs.
+1 -1
Documentation/admin-guide/mm/hugetlbpage.rst
··· 84 84 85 85 Note: When the feature of freeing unused vmemmap pages associated with each 86 86 hugetlb page is enabled, we can fail to free the huge pages triggered by 87 - the user when ths system is under memory pressure. Please try again later. 87 + the user when the system is under memory pressure. Please try again later. 88 88 89 89 Pages that are used as huge pages are reserved inside the kernel and cannot 90 90 be used for other purposes. Huge pages cannot be swapped out under
+2 -2
Documentation/admin-guide/mm/numa_memory_policy.rst
··· 244 244 interleaved system default policy works in this mode. 245 245 246 246 MPOL_PREFERRED_MANY 247 - This mode specifices that the allocation should be preferrably 247 + This mode specifies that the allocation should be preferably 248 248 satisfied from the nodemask specified in the policy. If there is 249 249 a memory pressure on all nodes in the nodemask, the allocation 250 250 can fall back to all existing numa nodes. This is effectively ··· 358 358 2) examination of the policy to determine the policy mode and associated node 359 359 or node lists, if any, for page allocation. This is considered a "hot 360 360 path". Note that for MPOL_BIND, the "usage" extends across the entire 361 - allocation process, which may sleep during page reclaimation, because the 361 + allocation process, which may sleep during page reclamation, because the 362 362 BIND policy nodemask is used, by reference, to filter ineligible nodes. 363 363 364 364 We can avoid taking an extra reference during the usages listed above as
+1 -1
Documentation/admin-guide/perf/hns3-pmu.rst
··· 53 53 event pair. And the bit 16 of config indicates getting counter 0 or 54 54 counter 1 of hardware event. 55 55 56 - After getting two values of event pair in usersapce, the formula of 56 + After getting two values of event pair in userspace, the formula of 57 57 computation to calculate real performance data is::: 58 58 59 59 counter 0 / counter 1
+1 -1
Documentation/admin-guide/pm/amd-pstate.rst
··· 403 403 404 404 * We can introduce more functional or performance tests to align the result together, it will benefit power and performance scale optimization. 405 405 406 - 1. Test case decriptions 406 + 1. Test case descriptions 407 407 408 408 1). Basic tests 409 409
+2 -2
Documentation/admin-guide/spkguide.txt
··· 1105 1105 Alternatively, you can add the above line to your file 1106 1106 ~/.bashrc or ~/.bash_profile. 1107 1107 1108 - If your system administrator ran himself the script, all the users will be able 1109 - to change from English to the language choosed by root and do directly 1108 + If your system administrator himself ran the script, all the users will be able 1109 + to change from English to the language chosen by root and do directly 1110 1110 speakupconf load (or add this to the ~/.bashrc or 1111 1111 ~/.bash_profile file). If there are several languages to handle, the 1112 1112 administrator (or every user) will have to run the first steps until speakupconf
+2 -2
Documentation/admin-guide/sysctl/vm.rst
··· 356 356 357 357 But, these values are not used directly. The kernel calculates # of protection 358 358 pages for each zones from them. These are shown as array of protection pages 359 - in /proc/zoneinfo like followings. (This is an example of x86-64 box). 359 + in /proc/zoneinfo like the following. (This is an example of x86-64 box). 360 360 Each zone has an array of protection pages like this:: 361 361 362 362 Node 0, zone DMA ··· 433 433 that cannot be handled by the kernel. In some cases (like the page 434 434 still having a valid copy on disk) the kernel will handle the failure 435 435 transparently without affecting any applications. But if there is 436 - no other uptodate copy of the data it will kill to prevent any data 436 + no other up-to-date copy of the data it will kill to prevent any data 437 437 corruptions from propagating. 438 438 439 439 1: Kill all processes that have the corrupted and not reloadable page mapped
+1 -1
Documentation/admin-guide/sysrq.rst
··· 138 138 ``v`` Forcefully restores framebuffer console 139 139 ``v`` Causes ETM buffer dump [ARM-specific] 140 140 141 - ``w`` Dumps tasks that are in uninterruptable (blocked) state. 141 + ``w`` Dumps tasks that are in uninterruptible (blocked) state. 142 142 143 143 ``x`` Used by xmon interface on ppc/powerpc platforms. 144 144 Show global PMU Registers on sparc64.