<feed xmlns='http://www.w3.org/2005/Atom'>
<title>kernel/include/linux/devcoredump.h, branch linux-3.19.y</title>
<subtitle>Hosts the 0x221E linux distro kernel.</subtitle>
<id>https://universe.0xinfinity.dev/distro/kernel/atom?h=linux-3.19.y</id>
<link rel='self' href='https://universe.0xinfinity.dev/distro/kernel/atom?h=linux-3.19.y'/>
<link rel='alternate' type='text/html' href='https://universe.0xinfinity.dev/distro/kernel/'/>
<updated>2014-09-24T05:53:15Z</updated>
<entry>
<title>device coredump: add new device coredump class</title>
<updated>2014-09-24T05:53:15Z</updated>
<author>
<name>Johannes Berg</name>
<email>johannes.berg@intel.com</email>
</author>
<published>2014-09-12T07:01:56Z</published>
<link rel='alternate' type='text/html' href='https://universe.0xinfinity.dev/distro/kernel/commit/?id=833c95456a70826d1384883b73fd23aff24d366f'/>
<id>urn:sha1:833c95456a70826d1384883b73fd23aff24d366f</id>
<content type='text'>
Many devices run firmware and/or complex hardware, and most of that
can have bugs. When it misbehaves, however, it is often much harder
to debug than software running on the host.

Introduce a "device coredump" mechanism to allow dumping internal
device/firmware state through a generalized mechanism. As devices
are different and information needed can vary accordingly, this
doesn't prescribe a file format - it just provides mechanism to
get data to be able to capture it in a generalized way (e.g. in
distributions.)

The dumped data will be readable in sysfs in the virtual device's
data file under /sys/class/devcoredump/devcd*/. Writing to it will
free the data and remove the device, as does a 5-minute timeout.

Note that generalized capturing of such data may result in privacy
issues, so users generally need to be involved. In order to allow
certain users/system integrators/... to disable the feature at all,
introduce a Kconfig option to override the drivers that would like
to have the feature.

For now, this provides two ways of dumping data:
 1) with a vmalloc'ed area, that is then given to the subsystem
    and freed after retrieval or timeout
 2) with a generalized reader/free function method

We could/should add more options, e.g. a list of pages, since the
vmalloc area is very limited on some architectures.

Signed-off-by: Johannes Berg &lt;johannes.berg@intel.com&gt;
Signed-off-by: Greg Kroah-Hartman &lt;gregkh@linuxfoundation.org&gt;
</content>
</entry>
</feed>
.y</option>
<option value='linux-2.6.33.y'>linux-2.6.33.y</option>
<option value='linux-2.6.34.y'>linux-2.6.34.y</option>
<option value='linux-2.6.35.y'>linux-2.6.35.y</option>
<option value='linux-2.6.36.y'>linux-2.6.36.y</option>
<option value='linux-2.6.37.y'>linux-2.6.37.y</option>
<option value='linux-2.6.38.y'>linux-2.6.38.y</option>
<option value='linux-2.6.39.y'>linux-2.6.39.y</option>
<option value='linux-3.0.y'>linux-3.0.y</option>
<option value='linux-3.1.y'>linux-3.1.y</option>
<option value='linux-3.10.y'>linux-3.10.y</option>
<option value='linux-3.11.y'>linux-3.11.y</option>
<option value='linux-3.12.y'>linux-3.12.y</option>
<option value='linux-3.13.y'>linux-3.13.y</option>
<option value='linux-3.14.y'>linux-3.14.y</option>
<option value='linux-3.15.y'>linux-3.15.y</option>
<option value='linux-3.16.y'>linux-3.16.y</option>
<option value='linux-3.17.y'>linux-3.17.y</option>
<option value='linux-3.18.y'>linux-3.18.y</option>
<option value='linux-3.19.y'>linux-3.19.y</option>
<option value='linux-3.2.y'>linux-3.2.y</option>
<option value='linux-3.3.y'>linux-3.3.y</option>
<option value='linux-3.4.y'>linux-3.4.y</option>
<option value='linux-3.5.y'>linux-3.5.y</option>
<option value='linux-3.6.y'>linux-3.6.y</option>
<option value='linux-3.7.y'>linux-3.7.y</option>
<option value='linux-3.8.y'>linux-3.8.y</option>
<option value='linux-3.9.y'>linux-3.9.y</option>
<option value='linux-4.0.y'>linux-4.0.y</option>
<option value='linux-4.1.y'>linux-4.1.y</option>
<option value='linux-4.10.y'>linux-4.10.y</option>
<option value='linux-4.11.y'>linux-4.11.y</option>
<option value='linux-4.12.y'>linux-4.12.y</option>
<option value='linux-4.13.y'>linux-4.13.y</option>
<option value='linux-4.14.y'>linux-4.14.y</option>
<option value='linux-4.15.y'>linux-4.15.y</option>
<option value='linux-4.16.y'>linux-4.16.y</option>
<option value='linux-4.17.y'>linux-4.17.y</option>
<option value='linux-4.18.y'>linux-4.18.y</option>
<option value='linux-4.19.y'>linux-4.19.y</option>
<option value='linux-4.2.y'>linux-4.2.y</option>
<option value='linux-4.20.y'>linux-4.20.y</option>
<option value='linux-4.3.y'>linux-4.3.y</option>
<option value='linux-4.4.y'>linux-4.4.y</option>
<option value='linux-4.5.y'>linux-4.5.y</option>
<option value='linux-4.6.y'>linux-4.6.y</option>
<option value='linux-4.7.y'>linux-4.7.y</option>
<option value='linux-4.8.y'>linux-4.8.y</option>
<option value='linux-4.9.y'>linux-4.9.y</option>
<option value='linux-5.0.y'>linux-5.0.y</option>
<option value='linux-5.1.y'>linux-5.1.y</option>
<option value='linux-5.10.y'>linux-5.10.y</option>
<option value='linux-5.11.y'>linux-5.11.y</option>
<option value='linux-5.12.y'>linux-5.12.y</option>
<option value='linux-5.13.y'>linux-5.13.y</option>
<option value='linux-5.14.y'>linux-5.14.y</option>
<option value='linux-5.15.y'>linux-5.15.y</option>
<option value='linux-5.16.y'>linux-5.16.y</option>
<option value='linux-5.17.y'>linux-5.17.y</option>
<option value='linux-5.18.y'>linux-5.18.y</option>
<option value='linux-5.19.y'>linux-5.19.y</option>
<option value='linux-5.2.y'>linux-5.2.y</option>
<option value='linux-5.3.y'>linux-5.3.y</option>
<option value='linux-5.4.y'>linux-5.4.y</option>
<option value='linux-5.5.y'>linux-5.5.y</option>
<option value='linux-5.6.y'>linux-5.6.y</option>
<option value='linux-5.7.y'>linux-5.7.y</option>
<option value='linux-5.8.y'>linux-5.8.y</option>
<option value='linux-5.9.y'>linux-5.9.y</option>
<option value='linux-6.0.y'>linux-6.0.y</option>
<option value='linux-6.1.y'>linux-6.1.y</option>
<option value='linux-6.10.y'>linux-6.10.y</option>
<option value='linux-6.11.y'>linux-6.11.y</option>
<option value='linux-6.12.y' selected='selected'>linux-6.12.y</option>
<option value='linux-6.13.y'>linux-6.13.y</option>
<option value='linux-6.14.y'>linux-6.14.y</option>
<option value='linux-6.15.y'>linux-6.15.y</option>
<option value='linux-6.16.y'>linux-6.16.y</option>
<option value='linux-6.17.y'>linux-6.17.y</option>
<option value='linux-6.18.y'>linux-6.18.y</option>
<option value='linux-6.19.y'>linux-6.19.y</option>
<option value='linux-6.2.y'>linux-6.2.y</option>
<option value='linux-6.3.y'>linux-6.3.y</option>
<option value='linux-6.4.y'>linux-6.4.y</option>
<option value='linux-6.5.y'>linux-6.5.y</option>
<option value='linux-6.6.y'>linux-6.6.y</option>
<option value='linux-6.7.y'>linux-6.7.y</option>
<option value='linux-6.8.y'>linux-6.8.y</option>
<option value='linux-6.9.y'>linux-6.9.y</option>
<option value='linux-rolling-lts'>linux-rolling-lts</option>
<option value='linux-rolling-stable'>linux-rolling-stable</option>
<option value='master'>master</option>
</select> <input type='submit' value='switch'/></form></td></tr>
<tr><td class='sub'>Hosts the 0x221E linux distro kernel.</td><td class='sub right'>Ubuntu</td></tr></table>
<table class='tabs'><tr><td>
<a href='/distro/kernel/?h=linux-6.12.y'>summary</a><a href='/distro/kernel/refs/?h=linux-6.12.y&amp;id=9197b73fd7bb263084a95d1c578b7ee0ad54dfb3'>refs</a><a class='active' href='/distro/kernel/log/Documentation/cdrom?h=linux-6.12.y&amp;showmsg=1'>log</a><a href='/distro/kernel/tree/Documentation/cdrom?h=linux-6.12.y&amp;id=9197b73fd7bb263084a95d1c578b7ee0ad54dfb3'>tree</a><a href='/distro/kernel/commit/Documentation/cdrom?h=linux-6.12.y&amp;id=9197b73fd7bb263084a95d1c578b7ee0ad54dfb3'>commit</a><a href='/distro/kernel/diff/Documentation/cdrom?h=linux-6.12.y&amp;id=9197b73fd7bb263084a95d1c578b7ee0ad54dfb3'>diff</a></td><td class='form'><form class='right' method='get' action='/distro/kernel/log/Documentation/cdrom'>
<input type='hidden' name='h' value='linux-6.12.y'/><input type='hidden' name='id' value='9197b73fd7bb263084a95d1c578b7ee0ad54dfb3'/><input type='hidden' name='showmsg' value='1'/><select name='qt'>
<option value='grep'>log msg</option>
<option value='author'>author</option>
<option value='committer'>committer</option>
<option value='range'>range</option>
</select>
<input class='txt' type='search' size='10' name='q' value=''/>
<input type='submit' value='search'/>
</form>
</td></tr></table>
<div class='path'>path: <a href='/distro/kernel/log/?h=linux-6.12.y&amp;id=9197b73fd7bb263084a95d1c578b7ee0ad54dfb3&amp;showmsg=1'>root</a>/<a href='/distro/kernel/log/Documentation?h=linux-6.12.y&amp;id=9197b73fd7bb263084a95d1c578b7ee0ad54dfb3&amp;showmsg=1'>Documentation</a>/<a href='/distro/kernel/log/Documentation/cdrom?h=linux-6.12.y&amp;id=9197b73fd7bb263084a95d1c578b7ee0ad54dfb3&amp;showmsg=1'>cdrom</a></div><div class='content'><table class='list nowrap'><tr class='nohover'><th class='left'>Age</th><th class='left'>Commit message (<a href='/distro/kernel/log/Documentation/cdrom?h=linux-6.12.y&amp;id=9197b73fd7bb263084a95d1c578b7ee0ad54dfb3'>Collapse</a>)</th><th class='left'>Author</th></tr>
<tr class='logheader'><td><span title='2024-05-15 10:05:24 -0400'>2024-05-15</span></td><td class='logsubject'><a href='/distro/kernel/commit/Documentation/cdrom?h=linux-6.12.y&amp;id=9fad9d560af5c654bb38e0b07ee54a4e9acdc5cd'>scsi: sr: Fix unintentional arithmetic wraparound</a></td><td>Justin Stitt</td></tr>
<tr class='nohover-highlight'><td/><td colspan='3' class='logmsg'>
Running syzkaller with the newly reintroduced signed integer overflow
sanitizer produces this report:

[   65.194362] ------------[ cut here ]------------
[   65.197752] UBSAN: signed-integer-overflow in ../drivers/scsi/sr_ioctl.c:436:9
[   65.203607] -2147483648 * 177 cannot be represented in type 'int'
[   65.207911] CPU: 2 PID: 10416 Comm: syz-executor.1 Not tainted 6.8.0-rc2-00035-gb3ef86b5a957 #1
[   65.213585] Hardware name: QEMU Standard PC (i440FX + PIIX, 1996), BIOS 1.16.3-debian-1.16.3-2 04/01/2014
[   65.219923] Call Trace:
[   65.221556]  &lt;TASK&gt;
[   65.223029]  dump_stack_lvl+0x93/0xd0
[   65.225573]  handle_overflow+0x171/0x1b0
[   65.228219]  sr_select_speed+0xeb/0xf0
[   65.230786]  ? __pm_runtime_resume+0xe6/0x130
[   65.233606]  sr_block_ioctl+0x15d/0x1d0
...

Historically, the signed integer overflow sanitizer did not work in the
kernel due to its interaction with `-fwrapv` but this has since been
changed [1] in the newest version of Clang. It was re-enabled in the kernel
with Commit 557f8c582a9b ("ubsan: Reintroduce signed overflow sanitizer").

Firstly, let's change the type of "speed" to unsigned long as
sr_select_speed()'s only caller passes in an unsigned long anyways.

$ git grep '\.select_speed'
|	drivers/scsi/sr.c:      .select_speed           = sr_select_speed,
...
|	static int cdrom_ioctl_select_speed(struct cdrom_device_info *cdi,
|	                unsigned long arg)
|	{
|	        ...
|	        return cdi-&gt;ops-&gt;select_speed(cdi, arg);
|	}

Next, let's add an extra check to make sure we don't exceed 0xffff/177
(350) since 0xffff is the max speed. This has two benefits: 1) we deal
with integer overflow before it happens and 2) we properly respect the
max speed of 0xffff. There are some "magic" numbers here but I did not
want to change more than what was necessary.

Link: https://github.com/llvm/llvm-project/pull/82432 [1]
Closes: https://github.com/KSPP/linux/issues/357
Cc: linux-hardening@vger.kernel.org
Signed-off-by: Justin Stitt &lt;justinstitt@google.com&gt;
Link: https://lore.kernel.org/r/20240508-b4-b4-sio-sr_select_speed-v2-1-00b68f724290@google.com
Reviewed-by: Kees Cook &lt;keescook@chromium.org&gt;
Signed-off-by: Martin K. Petersen &lt;martin.petersen@oracle.com&gt;


</td></tr>
<tr class='logheader'><td><span title='2023-05-16 12:49:31 -0600'>2023-05-16</span></td><td class='logsubject'><a href='/distro/kernel/commit/Documentation/cdrom?h=linux-6.12.y&amp;id=96e3cc270d61cb9945b1c2894effcba15010f097'>Documentation: use capitalization for chapters and acronyms</a></td><td>Randy Dunlap</td></tr>
<tr class='nohover-highlight'><td/><td colspan='3' class='logmsg'>
Use capital letters in acronyms for CD-ROM, FPGA, and PCMCIA.

Use capital letter in the first word of chapter headings for
Locking, Timers, and "Brief tutorial on CRC computation".

Signed-off-by: Randy Dunlap &lt;rdunlap@infradead.org&gt;
Cc: Moritz Fischer &lt;mdf@kernel.org&gt;
Cc: Wu Hao &lt;hao.wu@intel.com&gt;
Cc: Tom Rix &lt;trix@redhat.com&gt;
Cc: Peter Zijlstra &lt;peterz@infradead.org&gt;
Cc: Ingo Molnar &lt;mingo@redhat.com&gt;
Cc: Will Deacon &lt;will@kernel.org&gt;
Cc: Waiman Long &lt;longman@redhat.com&gt;
Cc: Boqun Feng &lt;boqun.feng@gmail.com&gt;
Cc: Dominik Brodowski &lt;linux@dominikbrodowski.net&gt;
Cc: Thomas Gleixner &lt;tglx@linutronix.de&gt;
Acked-by: Xu Yilun &lt;yilun.xu@intel.com&gt;
Reviewed-by: Phillip Potter &lt;phil@philpotter.co.uk&gt;
Link: https://lore.kernel.org/r/20230516001518.14514-1-rdunlap@infradead.org
Signed-off-by: Jonathan Corbet &lt;corbet@lwn.net&gt;


</td></tr>
<tr class='logheader'><td><span title='2022-05-25 11:17:41 -0700'>2022-05-25</span></td><td class='logsubject'><a href='/distro/kernel/commit/Documentation/cdrom?h=linux-6.12.y&amp;id=88a618920e9baabc1780479e2fbb68e5551d0563'>Merge tag 'docs-5.19' of git://git.lwn.net/linux</a></td><td>Linus Torvalds</td></tr>
<tr class='nohover-highlight'><td/><td colspan='3' class='logmsg'>
Pull documentation updates from Jonathan Corbet:
 "It was a moderately busy cycle for documentation; highlights include:

   - After a long period of inactivity, the Japanese translations are
     seeing some much-needed maintenance and updating.

   - Reworked IOMMU documentation

   - Some new documentation for static-analysis tools

   - A new overall structure for the memory-management documentation.
     This is an LSFMM outcome that, it is hoped, will help encourage
     developers to fill in the many gaps. Optimism is eternal...but
     hopefully it will work.

   - More Chinese translations.

  Plus the usual typo fixes, updates, etc"

* tag 'docs-5.19' of git://git.lwn.net/linux: (70 commits)
  docs: pdfdocs: Add space for chapter counts &gt;= 100 in TOC
  docs/zh_CN: Add dev-tools/gdb-kernel-debugging.rst Chinese translation
  input: Docs: correct ntrig.rst typo
  input: Docs: correct atarikbd.rst typos
  MAINTAINERS: Become the docs/zh_CN maintainer
  docs/zh_CN: fix devicetree usage-model translation
  mm,doc: Add new documentation structure
  Documentation: drop more IDE boot options and ide-cd.rst
  Documentation/process: use scripts/get_maintainer.pl on patches
  MAINTAINERS: Add entry for DOCUMENTATION/JAPANESE
  docs/trans/ja_JP/howto: Don't mention specific kernel versions
  docs/ja_JP/SubmittingPatches: Request summaries for commit references
  docs/ja_JP/SubmittingPatches: Add Suggested-by as a standard signature
  docs/ja_JP/SubmittingPatches: Randy has moved
  docs/ja_JP/SubmittingPatches: Suggest the use of scripts/get_maintainer.pl
  docs/ja_JP/SubmittingPatches: Update GregKH links
  Documentation/sysctl: document max_rcu_stall_to_panic
  Documentation: add missing angle bracket in cgroup-v2 doc
  Documentation: dev-tools: use literal block instead of code-block
  docs/zh_CN: add vm numa translation
  ...


</td></tr>
<tr class='logheader'><td><span title='2022-05-15 18:31:28 -0600'>2022-05-15</span></td><td class='logsubject'><a href='/distro/kernel/commit/Documentation/cdrom?h=linux-6.12.y&amp;id=03fea699b050805ad6ee111f9db04f223f3e835e'>cdrom: remove the unused driver specific disc change ioctl</a></td><td>Paul Gortmaker</td></tr>
<tr class='nohover-highlight'><td/><td colspan='3' class='logmsg'>
This was only used by the ide-cd driver, which went away in
commit b7fb14d3ac63 ("ide: remove the legacy ide driver")
so we might as well take advantage of that and get rid of
this hook as well.

Cc: Christoph Hellwig &lt;hch@lst.de&gt;
Cc: Jens Axboe &lt;axboe@kernel.dk&gt;
Cc: Phillip Potter &lt;phil@philpotter.co.uk&gt;
Signed-off-by: Paul Gortmaker &lt;paul.gortmaker@windriver.com&gt;
Link: https://lore.kernel.org/all/20220427132436.12795-2-paul.gortmaker@windriver.com
Signed-off-by: Phillip Potter &lt;phil@philpotter.co.uk&gt;
Link: https://lore.kernel.org/r/20220515205833.944139-3-phil@philpotter.co.uk
Signed-off-by: Jens Axboe &lt;axboe@kernel.dk&gt;


</td></tr>
<tr class='logheader'><td><span title='2022-05-09 16:20:07 -0600'>2022-05-09</span></td><td class='logsubject'><a href='/distro/kernel/commit/Documentation/cdrom?h=linux-6.12.y&amp;id=4a840d5fdcfcfff55b8b22896c1193a9b26405aa'>Documentation: drop more IDE boot options and ide-cd.rst</a></td><td>Randy Dunlap</td></tr>
<tr class='nohover-highlight'><td/><td colspan='3' class='logmsg'>
Drop ide-* command line options.
Drop cdrom/ide-cd.rst documentation.

Fixes: 898ee22c32be ("Drop Documentation/ide/")
Signed-off-by: Randy Dunlap &lt;rdunlap@infradead.org&gt;
Cc: Jens Axboe &lt;axboe@kernel.dk&gt;
Cc: Christoph Hellwig &lt;hch@lst.de&gt;
Acked-by: Damien Le Moal &lt;damien.lemoal@opensource.wdc.com&gt;
Acked-by: Phillip Potter &lt;phil@philpotter.co.uk&gt;
Link: https://lore.kernel.org/r/20220424033701.7988-1-rdunlap@infradead.org
[jc: also deleted reference from cdrom/index.rst]
Signed-off-by: Jonathan Corbet &lt;corbet@lwn.net&gt;


</td></tr>
<tr class='logheader'><td><span title='2022-02-15 16:15:33 -0700'>2022-02-15</span></td><td class='logsubject'><a href='/distro/kernel/commit/Documentation/cdrom?h=linux-6.12.y&amp;id=013ebb6d822a51ccc8ad162e7c8d02fbd7e90dd1'>Documentation: Fix links for udftools project and pktcdvd tool</a></td><td>Pali Rohár</td></tr>
<tr class='nohover-highlight'><td/><td colspan='3' class='logmsg'>
Signed-off-by: Pali Rohár &lt;pali@kernel.org&gt;
Link: https://lore.kernel.org/r/20220210192200.30828-1-pali@kernel.org
Signed-off-by: Jonathan Corbet &lt;corbet@lwn.net&gt;


</td></tr>
<tr class='logheader'><td><span title='2021-09-14 20:05:26 -0600'>2021-09-14</span></td><td class='logsubject'><a href='/distro/kernel/commit/Documentation/cdrom?h=linux-6.12.y&amp;id=67f1e027c27054e641584655020a417eaac9cb3a'>drivers/cdrom: improved ioctl for media change detection</a></td><td>Lukas Prediger</td></tr>
<tr class='nohover-highlight'><td/><td colspan='3' class='logmsg'>
The current implementation of the CDROM_MEDIA_CHANGED ioctl relies on
global state, meaning that only one process can detect a disc change
while the ioctl call will return 0 for other calling processes afterwards
(see bug 213267).

This introduces a new cdrom ioctl, CDROM_TIMED_MEDIA_CHANGE, that
works by maintaining a timestamp of the last detected disc change instead
of a boolean flag: Processes calling this ioctl command can provide
a timestamp of the last disc change known to them and receive
an indication whether the disc was changed since then and the updated
timestamp.

I considered fixing the buggy behavior in the original
CDROM_MEDIA_CHANGED ioctl but that would require maintaining state
for each calling process in the kernel, which seems like a worse
solution than introducing this new ioctl.

Signed-off-by: Lukas Prediger &lt;lumip@lumip.de&gt;
Link: https://lore.kernel.org/all/20210912191207.74449-1-lumip@lumip.de
Signed-off-by: Phillip Potter &lt;phil@philpotter.co.uk&gt;
Link: https://lore.kernel.org/r/20210913230942.1188-1-phil@philpotter.co.uk
Signed-off-by: Jens Axboe &lt;axboe@kernel.dk&gt;


</td></tr>
<tr class='logheader'><td><span title='2021-05-11 11:00:17 -0600'>2021-05-11</span></td><td class='logsubject'><a href='/distro/kernel/commit/Documentation/cdrom?h=linux-6.12.y&amp;id=918d9c77791cc8267b5b5ab556c868dfa57e0d93'>docs: cdrom-standard.rst: get rid of uneeded UTF-8 chars</a></td><td>Mauro Carvalho Chehab</td></tr>
<tr class='nohover-highlight'><td/><td colspan='3' class='logmsg'>
This file was converted from a LaTeX one. The conversion used
some UTF-8 characters at the literal blocks. Replace them
by normal ASCII characters.

Signed-off-by: Mauro Carvalho Chehab &lt;mchehab+huawei@kernel.org&gt;
Acked-by: Jens Axboe &lt;axboe@kernel.dk&gt;
Link: https://lore.kernel.org/r/79c3f482da17ea48d69b6e6ad1b7fb102b9dd7bf.1620744606.git.mchehab+huawei@kernel.org
Signed-off-by: Jonathan Corbet &lt;corbet@lwn.net&gt;


</td></tr>
<tr class='logheader'><td><span title='2020-08-13 13:57:45 -0700'>2020-08-13</span></td><td class='logsubject'><a href='/distro/kernel/commit/Documentation/cdrom?h=linux-6.12.y&amp;id=dddcbc139e96bd18d8c65ef7b7e440f0d32457c2'>Merge tag 'docs-5.9-2' of git://git.lwn.net/linux</a></td><td>Linus Torvalds</td></tr>
<tr class='nohover-highlight'><td/><td colspan='3' class='logmsg'>
Pull documentation fixes from Jonathan Corbet:
 "A handful of obvious fixes that wandered in during the merge window"

* tag 'docs-5.9-2' of git://git.lwn.net/linux:
  Documentation/locking/locktypes: fix the typo
  doc/zh_CN: resolve undefined label warning in admin-guide index
  doc/zh_CN: fix title heading markup in admin-guide cpu-load
  docs: remove the 2.6 "Upgrading I2C Drivers" guide
  docs: Correct the release date of 5.2 stable
  mailmap: Update comments for with format and more detalis
  docs: cdrom: Fix a typo and rst markup
  Doc: admin-guide: use correct legends in kernel-parameters.txt
  Documentation/features: refresh RISC-V arch support files
  documentation: coccinelle: Improve command example for make C={1,2}
  Core-api: Documentation: Replace deprecated :c:func: Usage
  Dev-tools: Documentation: Replace deprecated :c:func: Usage
  Filesystems: Documentation: Replace deprecated :c:func: Usage
  docs: trace: fix a typo


</td></tr>
<tr class='logheader'><td><span title='2020-08-11 10:43:06 -0600'>2020-08-11</span></td><td class='logsubject'><a href='/distro/kernel/commit/Documentation/cdrom?h=linux-6.12.y&amp;id=502b675050a506fb966c6f273d2ce42e5d8ddb07'>docs: cdrom: Fix a typo and rst markup</a></td><td>Remi Andruccioli</td></tr>
<tr class='nohover-highlight'><td/><td colspan='3' class='logmsg'>
"The capability fags" should be "The capability flags".

In rst markup, a incorrect markup expression is causing bad rendering in
Sphinx output. Replace the erroneous single quote by a backquote.

Signed-off-by: Remi Andruccioli &lt;remi.andruccioli@gmail.com&gt;
Link: https://lore.kernel.org/r/20200808163123.17643-1-remi.andruccioli@gmail.com
Signed-off-by: Jonathan Corbet &lt;corbet@lwn.net&gt;


</td></tr>
<tr class='logheader'><td><span title='2020-07-08 16:20:01 -0600'>2020-07-08</span></td><td class='logsubject'><a href='/distro/kernel/commit/Documentation/cdrom?h=linux-6.12.y&amp;id=8c22eb3a77373c616f141b56f44ef225ee15c96b'>cdrom: remove the unused cdrom_media_changed function</a></td><td>Christoph Hellwig</td></tr>
<tr class='nohover-highlight'><td/><td colspan='3' class='logmsg'>
As well as the -&gt;media_changed method.  All these are left over from
before the drivers were switched over to the check_events scheme.

Signed-off-by: Christoph Hellwig &lt;hch@lst.de&gt;
Signed-off-by: Jens Axboe &lt;axboe@kernel.dk&gt;


</td></tr>
<tr class='logheader'><td><span title='2019-07-15 11:03:03 -0300'>2019-07-15</span></td><td class='logsubject'><a href='/distro/kernel/commit/Documentation/cdrom?h=linux-6.12.y&amp;id=113094f743fc97559c068ad20fd2808b64f6989d'>docs: add some directories to the main documentation index</a></td><td>Mauro Carvalho Chehab</td></tr>
<tr class='nohover-highlight'><td/><td colspan='3' class='logmsg'>
The contents of those directories were orphaned at the documentation
body.

While those directories could likely be moved to be inside some guide,
I'm opting to just adding their indexes to the main one, removing the
:orphan: and adding the SPDX header.

For the drivers, the rationale is that the documentation contains
a mix of Kernelspace, uAPI and admin-guide. So, better to keep them on
separate directories, as we've be doing with similar subsystem-specific
docs that were not split yet.

For the others, well... I'm too lazy to do the move. Also, it
seems to make sense to keep at least some of those at the main
dir (like kbuild, for example). In any case, a latter patch
could do the move.

Signed-off-by: Mauro Carvalho Chehab &lt;mchehab+samsung@kernel.org&gt;
Acked-by: Bartlomiej Zolnierkiewicz &lt;b.zolnierkie@samsung.com&gt;


</td></tr>
<tr class='logheader'><td><span title='2019-06-14 14:21:18 -0600'>2019-06-14</span></td><td class='logsubject'><a href='/distro/kernel/commit/Documentation/cdrom?h=linux-6.12.y&amp;id=d7b461c5e82fc5f5e4261f3b0228ecda58eb9f1a'>docs: ide: convert docs to ReST and rename to *.rst</a></td><td>Mauro Carvalho Chehab</td></tr>
<tr class='nohover-highlight'><td/><td colspan='3' class='logmsg'>
The conversion is actually:
  - add blank lines and identation in order to identify paragraphs;
  - fix tables markups;
  - add some lists markups;
  - mark literal blocks;
  - adjust title markups.

At its new index.rst, let's add a :orphan: while this is not linked to
the main index.rst file, in order to avoid build warnings.

Signed-off-by: Mauro Carvalho Chehab &lt;mchehab+samsung@kernel.org&gt;
Acked-by: Geert Uytterhoeven &lt;geert@linux-m68k.org&gt;
Signed-off-by: Jonathan Corbet &lt;corbet@lwn.net&gt;


</td></tr>
<tr class='logheader'><td><span title='2019-06-14 14:20:46 -0600'>2019-06-14</span></td><td class='logsubject'><a href='/distro/kernel/commit/Documentation/cdrom?h=linux-6.12.y&amp;id=8ea618899b6b4fbe97c8462e7d769867307de011'>docs: cdrom: convert docs to ReST and rename to *.rst</a></td><td>Mauro Carvalho Chehab</td></tr>
<tr class='nohover-highlight'><td/><td colspan='3' class='logmsg'>
The stuff there is almost already at ReST format. A
conversion for them is trivial: just add a missing titles
and fix some scape codes for them to match ReST syntax.

While here, rename the cdrom-standard.txt, with was converted
from LaTeX to ReST on the previous patch, and add it to the
index file.

At its new index.rst, let's add a :orphan: while this is not linked to
the main index.rst file, in order to avoid build warnings.

Signed-off-by: Mauro Carvalho Chehab &lt;mchehab+samsung@kernel.org&gt;
Signed-off-by: Jonathan Corbet &lt;corbet@lwn.net&gt;


</td></tr>
<tr class='logheader'><td><span title='2019-06-14 14:20:43 -0600'>2019-06-14</span></td><td class='logsubject'><a href='/distro/kernel/commit/Documentation/cdrom?h=linux-6.12.y&amp;id=e327cfcb25422c91f4bb8e8a3488386ac95955f1'>docs: cdrom-standard.tex: convert from LaTeX to ReST</a></td><td>Mauro Carvalho Chehab</td></tr>
<tr class='nohover-highlight'><td/><td colspan='3' class='logmsg'>
This is the only LaTeX documentation file inside the documentation.

Instead of having a Latex document directly there, convert
it to ReST format, as this is the format we're using for docs.

For now, let's keep the extension as .txt in order to avoid
warnings when building the documentation with Sphinx.

The next patch patch will rename it to .rst and add it to the
building system.

Signed-off-by: Mauro Carvalho Chehab &lt;mchehab+samsung@kernel.org&gt;
Signed-off-by: Jonathan Corbet &lt;corbet@lwn.net&gt;


</td></tr>
<tr class='logheader'><td><span title='2018-09-09 15:08:58 -0600'>2018-09-09</span></td><td class='logsubject'><a href='/distro/kernel/commit/Documentation/cdrom?h=linux-6.12.y&amp;id=a7ddcea58ae22d85d94eabfdd3de75c3742e376b'>Drop all 00-INDEX files from Documentation/</a></td><td>Henrik Austad</td></tr>
<tr class='nohover-highlight'><td/><td colspan='3' class='logmsg'>
This is a respin with a wider audience (all that get_maintainer returned)
and I know this spams a *lot* of people. Not sure what would be the correct
way, so my apologies for ruining your inbox.

The 00-INDEX files are supposed to give a summary of all files present
in a directory, but these files are horribly out of date and their
usefulness is brought into question. Often a simple "ls" would reveal
the same information as the filenames are generally quite descriptive as
a short introduction to what the file covers (it should not surprise
anyone what Documentation/sched/sched-design-CFS.txt covers)

A few years back it was mentioned that these files were no longer really
needed, and they have since then grown further out of date, so perhaps
it is time to just throw them out.

A short status yields the following _outdated_ 00-INDEX files, first
counter is files listed in 00-INDEX but missing in the directory, last
is files present but not listed in 00-INDEX.

List of outdated 00-INDEX:
Documentation: (4/10)
Documentation/sysctl: (0/1)
Documentation/timers: (1/0)
Documentation/blockdev: (3/1)
Documentation/w1/slaves: (0/1)
Documentation/locking: (0/1)
Documentation/devicetree: (0/5)
Documentation/power: (1/1)
Documentation/powerpc: (0/5)
Documentation/arm: (1/0)
Documentation/x86: (0/9)
Documentation/x86/x86_64: (1/1)
Documentation/scsi: (4/4)
Documentation/filesystems: (2/9)
Documentation/filesystems/nfs: (0/2)
Documentation/cgroup-v1: (0/2)
Documentation/kbuild: (0/4)
Documentation/spi: (1/0)
Documentation/virtual/kvm: (1/0)
Documentation/scheduler: (0/2)
Documentation/fb: (0/1)
Documentation/block: (0/1)
Documentation/networking: (6/37)
Documentation/vm: (1/3)

Then there are 364 subdirectories in Documentation/ with several files that
are missing 00-INDEX alltogether (and another 120 with a single file and no
00-INDEX).

I don't really have an opinion to whether or not we /should/ have 00-INDEX,
but the above 00-INDEX should either be removed or be kept up to date. If
we should keep the files, I can try to keep them updated, but I rather not
if we just want to delete them anyway.

As a starting point, remove all index-files and references to 00-INDEX and
see where the discussion is going.

Signed-off-by: Henrik Austad &lt;henrik@austad.us&gt;
Acked-by: "Paul E. McKenney" &lt;paulmck@linux.vnet.ibm.com&gt;
Just-do-it-by: Steven Rostedt &lt;rostedt@goodmis.org&gt;
Reviewed-by: Jens Axboe &lt;axboe@kernel.dk&gt;
Acked-by: Paul Moore &lt;paul@paul-moore.com&gt;
Acked-by: Greg Kroah-Hartman &lt;gregkh@linuxfoundation.org&gt;
Acked-by: Mark Brown &lt;broonie@kernel.org&gt;
Acked-by: Mike Rapoport &lt;rppt@linux.vnet.ibm.com&gt;
Cc: [Almost everybody else]
Signed-off-by: Jonathan Corbet &lt;corbet@lwn.net&gt;


</td></tr>
<tr class='logheader'><td><span title='2018-03-08 19:35:29 -0700'>2018-03-08</span></td><td class='logsubject'><a href='/distro/kernel/commit/Documentation/cdrom?h=linux-6.12.y&amp;id=da5ff37c7ede7aa4e6883f4dd5a83b6cf8b9837f'>Documentation/cdrom: fix German sharp s in LaTex</a></td><td>Randy Dunlap</td></tr>
<tr class='nohover-highlight'><td/><td colspan='3' class='logmsg'>
Apparently the LaTex abbreviation for the German "sharp s" (ß)
(Unicode U+00DF) has changed from {\sz} to {\ss}.  With {\sz},
I get this error at line 1016 (line number after another patch):

! Undefined control sequence.
l.1016 ...nel~2.0.  Further thanks to Heiko Ei{\sz
                                                  }feldt,

This is fixed by changing the {\sz} to {\ss}.

Signed-off-by: Randy Dunlap &lt;rdunlap@infradead.org&gt;
Signed-off-by: Jens Axboe &lt;axboe@kernel.dk&gt;


</td></tr>
<tr class='logheader'><td><span title='2018-03-08 19:35:27 -0700'>2018-03-08</span></td><td class='logsubject'><a href='/distro/kernel/commit/Documentation/cdrom?h=linux-6.12.y&amp;id=0a703c1f89af614d38808a4802744db6c8638762'>Documentation/cdrom: update cdrom-standard.tex for kernel changes</a></td><td>Randy Dunlap</td></tr>
<tr class='nohover-highlight'><td/><td colspan='3' class='logmsg'>
Documentation updates for Documentation/cdrom/cdrom-standard.tex:

cdrom_device_ops:
- add check_events() and generic_packet()

cdrom_device_info:
- add one 'const' modifier
- correct some field descriptions
- add some missing fields
- drop 'kdev_t dev;' field

Also drop &lt;n_discs&gt; sentence from documentation because it is not
referenced anywhere in the kernel header or C files.

Signed-off-by: Randy Dunlap &lt;rdunlap@infradead.org&gt;
Signed-off-by: Jens Axboe &lt;axboe@kernel.dk&gt;


</td></tr>
<tr class='logheader'><td><span title='2017-10-12 11:25:31 -0600'>2017-10-12</span></td><td class='logsubject'><a href='/distro/kernel/commit/Documentation/cdrom?h=linux-6.12.y&amp;id=1ad6e3b2652b310e4ab1a544894c79d4f7cb39d3'>documentation: Update ide-cd documentation to reflect CONFIG_BLK_DEV_HD_IDE ↵</a></td><td>Finn Thain</td></tr>
<tr class='nohover-highlight'><td/><td colspan='3' class='logmsg'>
removal

CONFIG_BLK_DEV_HD_IDE was removed in commit 80aa31cb460d ("ide:
remove CONFIG_BLK_DEV_HD_IDE config option (take 2)") but the ide-cd
documentation was not updated and still asks users to disable it,
which is misleading and involves a fruitless search.

Signed-off-by: Finn Thain &lt;fthain@telegraphics.com.au&gt;
Signed-off-by: Jonathan Corbet &lt;corbet@lwn.net&gt;


</td></tr>
<tr class='logheader'><td><span title='2017-02-14 08:29:56 -0700'>2017-02-14</span></td><td class='logsubject'><a href='/distro/kernel/commit/Documentation/cdrom?h=linux-6.12.y&amp;id=853fe1bf7554155376bb3b231112cdff9ff79177'>cdrom: Make device operations read-only</a></td><td>Kees Cook</td></tr>
<tr class='nohover-highlight'><td/><td colspan='3' class='logmsg'>
Since function tables are a common target for attackers, it's best to keep
them in read-only memory. As such, this makes the CDROM device ops tables
const. This drops additionally n_minors, since it isn't used meaningfully,
and sets the only user of cdrom_dummy_generic_packet explicitly so the
variables can all be const.

Inspired by similar changes in grsecurity/PaX.

Signed-off-by: Kees Cook &lt;keescook@chromium.org&gt;
Acked-by: David S. Miller &lt;davem@davemloft.net&gt;
Signed-off-by: Jens Axboe &lt;axboe@fb.com&gt;


</td></tr>
<tr class='logheader'><td><span title='2011-09-27 18:08:04 +0200'>2011-09-27</span></td><td class='logsubject'><a href='/distro/kernel/commit/Documentation/cdrom?h=linux-6.12.y&amp;id=395cf9691d72173d8cdaa613c5f0255f993af94b'>doc: fix broken references</a></td><td>Paul Bolle</td></tr>
<tr class='nohover-highlight'><td/><td colspan='3' class='logmsg'>
There are numerous broken references to Documentation files (in other
Documentation files, in comments, etc.). These broken references are
caused by typo's in the references, and by renames or removals of the
Documentation files. Some broken references are simply odd.

Fix these broken references, sometimes by dropping the irrelevant text
they were part of.

Signed-off-by: Paul Bolle &lt;pebolle@tiscali.nl&gt;
Signed-off-by: Jiri Kosina &lt;jkosina@suse.cz&gt;


</td></tr>
<tr class='logheader'><td><span title='2010-08-04 15:21:40 +0200'>2010-08-04</span></td><td class='logsubject'><a href='/distro/kernel/commit/Documentation/cdrom?h=linux-6.12.y&amp;id=0ea6e61122196509af82cc4f36cbdaacbefb8227'>Documentation: update broken web addresses.</a></td><td>Justin P. Mattock</td></tr>
<tr class='nohover-highlight'><td/><td colspan='3' class='logmsg'>
Below you will find an updated version from the original series bunching all patches into one big patch
updating broken web addresses that are located in Documentation/*
Some of the addresses date as far far back as 1995 etc... so searching became a bit difficult,
the best way to deal with these is to use web.archive.org to locate these addresses that are outdated.
Now there are also some addresses pointing to .spec files some are located, but some(after searching
on the companies site)where still no where to be found. In this case I just changed the address
to the company site this way the users can contact the company and they can locate them for the users.

Signed-off-by: Justin P. Mattock &lt;justinmattock@gmail.com&gt;
Signed-off-by: Thomas Weber &lt;weber@corscience.de&gt;
Signed-off-by: Mike Frysinger &lt;vapier.adi@gmail.com&gt;
Cc: Paulo Marques &lt;pmarques@grupopie.com&gt;
Cc: Randy Dunlap &lt;rdunlap@xenotime.net&gt;
Cc: Michael Neuling &lt;mikey@neuling.org&gt;
Signed-off-by: Jiri Kosina &lt;jkosina@suse.cz&gt;


</td></tr>
<tr class='logheader'><td><span title='2009-12-13 20:41:53 -0800'>2009-12-13</span></td><td class='logsubject'><a href='/distro/kernel/commit/Documentation/cdrom?h=linux-6.12.y&amp;id=1c8a375185935f8106a45221bd187b7b272f97c2'>ide: doc: remove compilation options section from ide-cd documentation</a></td><td>Thadeu Lima de Souza Cascardo</td></tr>
<tr class='nohover-highlight'><td/><td colspan='3' class='logmsg'>
This section pointed out to compilation options which no longer exist.

VERBOSE_IDE_CD_ERRORS has been replace by config option
CONFIG_BLK_DEV_IDECD_VERBOSE_ERRORS.

STANDARD_ATAPI is no longer needed, since the non-standard drivers, which
required bcd2bin are now detected, and there's a flag for them.

NO_DOOR_LOCKING is now a sysctl parameter for cdrom drivers.

CDROM_NBLOCKS_BUFFER is not used anymore. The READAUDIO is now in cdrom.c and it
allocates as much as user space has requested to read, backing off if it fails.

TEST is not there anymore or in cdrom either. ide allows to send ATA commands
through ioctl, although it may be helpful to send MMC packets through the cdrom
layer directly.

Signed-off-by: Thadeu Lima de Souza Cascardo &lt;cascardo@holoscopio.com&gt;
Signed-off-by: David S. Miller &lt;davem@davemloft.net&gt;


</td></tr>
<tr class='logheader'><td><span title='2009-06-15 21:30:28 -0700'>2009-06-15</span></td><td class='logsubject'><a href='/distro/kernel/commit/Documentation/cdrom?h=linux-6.12.y&amp;id=156f5a7801195fa2ce44aeeb62d6cf8468f3332a'>debugfs: Fix terminology inconsistency of dir name to mount debugfs filesystem.</a></td><td>GeunSik Lim</td></tr>
<tr class='nohover-highlight'><td/><td colspan='3' class='logmsg'>
Many developers use "/debug/" or "/debugfs/" or "/sys/kernel/debug/"
directory name to mount debugfs filesystem for ftrace according to
./Documentation/tracers/ftrace.txt file.

And, three directory names(ex:/debug/, /debugfs/, /sys/kernel/debug/) is
existed in kernel source like ftrace, DRM, Wireless, Documentation,
Network[sky2]files to mount debugfs filesystem.

debugfs means debug filesystem for debugging easy to use by greg kroah
hartman. "/sys/kernel/debug/" name is suitable as directory name
of debugfs filesystem.
- debugfs related reference: http://lwn.net/Articles/334546/

Fix inconsistency of directory name to mount debugfs filesystem.

* From Steven Rostedt
  - find_debugfs() and tracing_files() in this patch.

Signed-off-by: GeunSik Lim &lt;geunsik.lim@samsung.com&gt;
Acked-by     : Inaky Perez-Gonzalez &lt;inaky@linux.intel.com&gt;
Reviewed-by  : Steven Rostedt &lt;rostedt@goodmis.org&gt;
Reviewed-by  : James Smart &lt;james.smart@emulex.com&gt;
CC: Jiri Kosina &lt;trivial@kernel.org&gt;
CC: David Airlie &lt;airlied@linux.ie&gt;
CC: Peter Osterlund &lt;petero2@telia.com&gt;
CC: Ananth N Mavinakayanahalli &lt;ananth@in.ibm.com&gt;
CC: Anil S Keshavamurthy &lt;anil.s.keshavamurthy@intel.com&gt;
CC: Masami Hiramatsu &lt;mhiramat@redhat.com&gt;
Signed-off-by: Greg Kroah-Hartman &lt;gregkh@suse.de&gt;



</td></tr>
