Lines Matching refs:interface
32 typically occur as libraries are evolved, and shows how interface
36 1. Make interface additions to an existing library
37 - add a Public interface
38 - add a Private interface
39 2. Update an interface in an existing library
40 - remove an existing interface
41 - promote a Private interface to Public
42 - scope a Private interface to local
43 - move an interface from one library to another
89 for only two purposes: to specify externally-visible interface names while
201 4.0 Making interface additions to an existing library
203 4.1 Adding a Public interface
208 interface in the shared object, a new SUNW_1.1 version name must be introduced.
211 made to an interface. This could be the case if an API changes so dramatically
218 putback that makes an interface addition to the library. Rather, it is
221 4.2 Adding a Private interface
224 introducing a Public interface, a new entry is simply added to the
227 If this interface happens to be the first Private interface introduced
233 highest numbered private version name to version the new interface. There
243 which contains the implementation of the link-editor, the public interface to
244 which is provided by the ld command. When making a modification to the interface
313 Thus when adding a new public interface to an update, both the mapfiles
322 5.0 How to update an interface in an existing library
324 5.1 Removing an existing interface
326 5.1.1 Moving a Public interface
330 To move an interface from one library to (say) libc, the code has to be
332 library has to have the interface's entry changed from:
338 Follow the rules for adding a new interface for the necessary changes
339 to libc's mapfile to accommodate the moved interface. In particular,
340 the new interface must be added to the current highest libc version.
345 5.1.2 Removing a Private interface
348 it should first be established that the interface is not being used.
349 To remove a Private interface, simply delete the corresponding entry
355 5.2 Promoting a Private interface to Public
357 This is similar to what's done when adding a Public interface. Promoting an
358 existing Private interface to a Public one only requires a change to the
359 existing interface definition. Private interfaces have the symbol version name
360 "SUNWprivate" associated with them. To make the interface a Public one, the
361 interface must be put into a set associated with the current Public release
367 you wish to promote an existing Private interface to Public, or to introduce
368 a new Public interface, this (next successive minor numbered version level)
371 5.3 Scoping a Private interface local
378 outside the library. To move an interface from Private to local scope, simply
379 remove the Private interface from the mapfile-vers file and the header file
381 interface into a library-private header file. Scope reduction of Public
384 For the interface to be used in more than one file within the library, it
386 that uses the interface. For example:
408 new subdirectory of /usr/src/lib. The interface definition discipline is to