Messages in this thread | | | Subject | Re: [RFC] Add kernel<->userspace ABI stability documentation | From | Andi Kleen <> | Date | 27 Feb 2006 20:31:28 +0100 |
| |
Greg KH <greg@kroah.com> 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 too.
> --- /dev/null > +++ gregkh-2.6/Documentation/ABI/testing/sysfs-class > @@ -0,0 +1,16 @@ > +What: /sys/class/ > +Date: Febuary 2006 > +Contact: Greg Kroah-Hartman <gregkh@suse.de> > +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.
-Andi - To unsubscribe from this list: send the line "unsubscribe linux-kernel" in the body of a message to majordomo@vger.kernel.org More majordomo info at http://vger.kernel.org/majordomo-info.html Please read the FAQ at http://www.tux.org/lkml/
| |