[lkml]   [2006]   [Feb]   [27]   [last100]   RSS Feed
Views: [wrap][no wrap]   [headers]  [forward] 
Messages in this thread
    SubjectRe: [RFC] Add kernel<->userspace ABI stability documentation
    Greg KH <> writes:

    > Hi all,
    > As has been noticed recently by a lot of different people, it seems like
    > we are breaking the userspace<->kernelspace interface a lot. Well, in
    > looking back over time, we always have been doing this, but no one seems
    > to notice (proc files changing format and location, netlink library
    > bindings, etc.)

    Ok, but how do you plan to address the basic practical problem?
    People cannot freely upgrade/downgrade kernels anymore since udev/hal
    are used widely in distributions.

    Does it imply you plan to change udev/hal to only use stable interfaces
    for now? I would applaud such a move, but I guess it would come
    at the cost of functionality.

    If these applications are not changed then the documentation is likely useless
    because it won't help anyways - things will still break, kernel
    hackers and users will curse you all the time when they want
    to test kernels etc.

    > --- /dev/null
    > +++ gregkh-2.6/Documentation/ABI/stable/syscalls
    > @@ -0,0 +1,10 @@
    > +What: The kernel syscall interface
    > +Description:
    > + This interface matches much of the POSIX interface and is based
    > + on it and other Unix based interfaces. It will only be added to
    > + over time, and not have things removed from it.

    Some ioctls and socket options unfortunately don't follow this. I
    guess you will need to document them separately.

    Could be ugly to have hundreds of files for ioctls though.
    Perhaps define core ioctls and then driver ioctls and define
    all the driver ioctls unstable by default? But that also
    would just mean the category stable would be useless
    because people always would need to use unstable interfaces

    > --- /dev/null
    > +++ gregkh-2.6/Documentation/ABI/testing/sysfs-class
    > @@ -0,0 +1,16 @@
    > +What: /sys/class/
    > +Date: Febuary 2006
    > +Contact: Greg Kroah-Hartman <>
    > +Description:
    > + The /sys/class directory will consist of a group of
    > + subdirectories describing individual classes of devices
    > + in the kernel. The individual directories will consist
    > + of either subdirectories, or symlinks to other
    > + directories.
    > +
    > + All programs that use this directory tree must be able
    > + to handle both subdirectories or symlinks in order to
    > + work properly.

    What good is it if you don't say anything about the stability of its contents?
    Looks far too vague to me.

    To unsubscribe from this list: send the line "unsubscribe linux-kernel" in
    the body of a message to
    More majordomo info at
    Please read the FAQ at

     \ /
      Last update: 2006-02-27 20:34    [W:4.043 / U:0.240 seconds]
    ©2003-2017 Jasper Spaans. hosted at Digital OceanAdvertise on this site