src/lib/README.mapfiles

5 # Common Development and Distribution License (the "License").
11 # and limitations under the License.
14 # file and include the License file at usr/src/OPENSOLARIS.LICENSE.
22 # Copyright (c) 2006, 2010, Oracle and/or its affiliates. All rights reserved.
25 Mapfiles and versioning in ON
30 This README describes the engineering practices of creating and updating
32 typically occur as libraries are evolved, and shows how interface
60 details, see the Solaris Linker and Libraries Guide, which can be found
72 for shared libraries (shared objects) and with specifying their versions
77 and it should reside in the common source directory for that library, most
83 The "common" directory contains the source files and other common files
90 suppressing visibility of all other names, and to specify their respective
98 (the license notification and copyright notice is omitted here
161 a version SUNW_1.1 that always exports a symbol foo, and also exports
190 and no inheritance specification is present. The link-editor reads the
191 information from the common and ISA-specific mapfiles and merges them
206 to identify the current highest version name and properly increment the minor
214 and introducing code to continue to ship the .so.1 version of the library.
229 version numbers).  It inherits nothing and nothing inherits from it.
241 to ensure that the programs that depend on them are built and delivered as a
252 ships, and since it is generally impossible to know the full set of new
259 has version number SUNW_1.3 and Release N+1 will have SUNW_1.4, then
314 of the update release and next marketing release must be modified to be
331 deleted from the library and added to libc, then the mapfile for the
343 for libthread, libaio, and librt.
364 As an example, if we were modifying libwombat.so.1 and its version in the
379 remove the Private interface from the mapfile-vers file and the header file
382 interfaces is not allowed without specific ARC review and approval.
393 SYSVABI and SISCD are reserved version names for interfaces listed in the
394 System V Interface Definition and the Sparc Compliance Definition.  Avoid using
396 another library.  Instead, use SUNW_1.1 for a new library, and SUNW_m.n for
437 omitted and the two lines:
442 To decide which interfaces are Public (part of the ABI) and which are Private
446 for the new interfaces that prescribes which interfaces are Public and
447 which are not (hence, which interfaces have man pages and which do not).
480 	"Solaris Linker and Libraries Guide", http://docs.sun.com