Kernel Comments

Comments from the Linux kernel source code (edited for readability)
/* here be dragons and swear words */

2026-01-26

/* WARNING: This routine is hairy and very complicated, but it must be as fast as possible as it handles the allocation of register windows to the user and kernel. If you touch this code be very careful as many other pieces of the kernel depend upon how this code behaves. You have been duly warned... */

github.com/torvalds/linux/blob

#linux #kernel #sparc

2026-01-22

/* I'm sure the JFFS2 code has done me permanent damage. I now think the following is normal */

github.com/torvalds/linux/blob

#linux #kernel #jffs2

2025-11-21
/*
* "Define 'is'", Bill Clinton
* "Define 'if'", Steven Rostedt
*/

github.com/torvalds/linux/blob

#linux #kernel #billclinton

2025-11-19

/* This is ALPHA test software. This code may break your machine, randomly fail to work with new releases, misbehave and/or generally screw up. It might even work. */

github.com/torvalds/linux/blob

#linux #kernel #x25

2025-09-29
/* BLACKLIST !!
*
* First blacklist any products that are egregiously nonconformant
* with the CDC Ethernet specs. Minor braindamage we cope with; when
* they're not even trying, needing a separate driver is only the first
* of the differences to show up.
*/

github.com/torvalds/linux/blob

#linux #kernel #net #usb

2025-08-30

/* Register the notifier if/when the first device type is registered, to prevent the link/init ordering from fucking us over. */

elixir.bootlin.com/linux/v6.16

#linux #kernel #block

2025-08-10

/* BEWARE!!! Protocol handlers, mangling input packets, MUST BE last in hash buckets and checking protocol handlers MUST start from promiscuous ptype_all chain in net_bh. It is true now, do not change it. Explanation follows: if protocol handler, mangling packet, will be the first on list, it is not able to sense, that packet is cloned and should be copied-on-write, so that it will change it and subsequent readers will get broken packet. --ANK (980803) */

elixir.bootlin.com/linux/v6.16

#linux #kernel #net

2025-07-23

/* Calculate the boot block checksum on an ADFS drive. Note that this will appear to be correct if the sector contains all zeros, so also check that the disk size is non-zero!!! */

elixir.bootlin.com/linux/v6.15

#linux #kernel #adfs #checksum

2025-07-14

/* ummm.. yes.. should really figure out wtf this is and why it's needed some day.. it's almost certainly wrong, but, it also somehow makes things work... */

elixir.bootlin.com/linux/v6.15

#linux #kernel #nouveau

Client Info

Server: https://mastodon.social
Version: 2025.07
Repository: https://github.com/cyevgeniy/lmst