xref: /linux/Documentation/admin-guide/abi-testing.rst (revision 3231dd5862779c2e15633c96133a53205ad660ce)
1a7ee04b3SMauro Carvalho ChehabABI testing symbols
2a7ee04b3SMauro Carvalho Chehab===================
3a7ee04b3SMauro Carvalho Chehab
4a7ee04b3SMauro Carvalho ChehabDocuments interfaces that are felt to be stable,
5a7ee04b3SMauro Carvalho Chehabas the main development of this interface has been completed.
6a7ee04b3SMauro Carvalho Chehab
7a7ee04b3SMauro Carvalho ChehabThe interface can be changed to add new features, but the
8a7ee04b3SMauro Carvalho Chehabcurrent interface will not break by doing this, unless grave
9a7ee04b3SMauro Carvalho Chehaberrors or security problems are found in them.
10a7ee04b3SMauro Carvalho Chehab
11a7ee04b3SMauro Carvalho ChehabUserspace programs can start to rely on these interfaces, but they must
12a7ee04b3SMauro Carvalho Chehabbe aware of changes that can occur before these interfaces move to
13a7ee04b3SMauro Carvalho Chehabbe marked stable.
14a7ee04b3SMauro Carvalho Chehab
15a7ee04b3SMauro Carvalho ChehabPrograms that use these interfaces are strongly encouraged to add their
16a7ee04b3SMauro Carvalho Chehabname to the description of these interfaces, so that the kernel
17a7ee04b3SMauro Carvalho Chehabdevelopers can easily notify them if any changes occur.
18a7ee04b3SMauro Carvalho Chehab
19*3231dd58SVegard Nossum.. kernel-abi:: ABI/testing
2050865d04SMauro Carvalho Chehab   :rst:
21