[PATCH] Document pci_ids.h addition policy.



On Thu, Aug 06, 2009 at 11:33:26AM -0700, Greg Kroah-Hartman wrote:

I agree. In fact, I'd go further, and say that the bulk of what we have
in pci_ids.h is also pointlessly shared. Only a tiny fraction of the device
entries in that file are used by multiple files in the kernel.

I agree with that as well, which is why when I was PCI maintainer, I
didn't allow any new additions to the pci_ids.h file, unless it was
going to be an id that was shared by different drivers. That cut the
new additions down to about none :)

Perhaps documenting this is a good idea to prevent things being moved there,
as it still seems to be happening judging from the git log.

Signed-off-by: Dave Jones <davej@xxxxxxxxxx>

diff --git a/include/linux/pci_ids.h b/include/linux/pci_ids.h
index 73b46b6..f9156fd 100644
--- a/include/linux/pci_ids.h
+++ b/include/linux/pci_ids.h
@@ -2,6 +2,9 @@
* PCI Class, Vendor and Device IDs
*
* Please keep sorted.
+ *
+ * Do not add new entries to this file unless the definitions
+ * are shared between multiple drivers.
*/

/* Device classes and subclasses */
--
To unsubscribe from this list: send the line "unsubscribe linux-kernel" in
the body of a message to majordomo@xxxxxxxxxxxxxxx
More majordomo info at http://vger.kernel.org/majordomo-info.html
Please read the FAQ at http://www.tux.org/lkml/



Relevant Pages

  • Re: [take19 1/4] kevent: Core files.
    ... This forces to overflows in fixed sized memory mapped buffer. ... entries that the kernel can alloc from. ... The user has to notify when unused entries becomes available. ...
    (Linux-Kernel)
  • Re: Kernel Option Question.
    ... is enabled by default in GENERIC KERNEL. ... you would have to learn about the way these lookup ... moment in time, some of the directory entries may be `in use', others ... Thus, by sacrificing some of the memory available in the running system, ...
    (comp.unix.bsd.freebsd.misc)
  • Re: [BUG?] Recent feral ISP interaction with alpha dma
    ... * to get bus addresses of each of the SG entries and their lengths. ... > I have an Alphaserver 4100 where I have been testing a build of kernel ... > After poking around in the source, I am suspecting my problem in the feral ... send the line "unsubscribe linux-kernel" in ...
    (Linux-Kernel)
  • 4.9-PRE Fatal trap 9: general protection fault while in kernel mode
    ... general protection fault while in kernel mode ... Preloaded elf kernel "kernel" at 0xc036f000. ... Using $PIR table, 268435454 entries at 0xc00fdf10 ... pci0: <PCI bus> on pcib0 ...
    (freebsd-stable)
  • Re: open fd management
    ... file table entry will fail with ENFILE if all entries are in use. ... Exhausting the file table shouldn't directly cause a kernel panic. ... > consumes a vnode in the Virtual-Filesystem Interface layer. ... such as the maximum size of a shared memory segment ...
    (comp.unix.programmer)