Linux Standard Base Specification for the PPC32 Architecture 1.3

Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.1; with no Invariant Sections, with no Front-Cover Texts, and with no Back-Cover Texts. A copy of the license is included in the section entitled "GNU Free Documentation License".

Portions of the text were taken from other copyrighted documents in accordance with the respective licenses of those documents.

Linux is a trademark of Linus Torvalds.

UNIX a registered trademark of the Open Group in the United States and other countries.

LSB is a trademark of the Free Standards Group in the USA and other countries.

Intel386 and Itanium are trademarks of Intel Corporation.

OpenGL is a registered trademark of Silicon Graphics, Inc.

Table of Contents

I. Introduction

1. Introduction

Introduction
Purpose
Related Standards
Relevant Libraries
How to Use this Standard
Definitions
Terminology

II. Low Level System Information

2. Machine Interface

Processor Architecture
Data Representation

3. Function Calling Sequence

CPU Registers
Floating Point Registers
Stack Frame
Arguments
Return Values

4. Operating System Interface

Processor Execution Mode
Exception Interface
Signal Delivery

5. Process Initialization

Special Registers
Process Stack (on entry)
Auxiliary Vector
Environment

6. Coding Examples

Code Model Overview/Architecture Constraints
Position-Independent Function Prologue
Data Objects
Function Calls
Branching

7. C Stack Frame

Variable Argument List
Dynamic Allocation of Stack Space

8. Debug Information

III. Object Format

9. ELF Header

Machine Information

10. Sections

Special Sections
Linux Special Sections
Section Types
Section Attribute Flags
Special Section Types

11. Symbol Table

12. Relocation

Relocation Types

IV. Program Loading and Dynamic Linking

13. Program Header

Types
Flags

14. Program Loading

15. Dynamic Linking

Program Interpreter/Dynamic Linker
Dynamic Section
Global Offset Table
Shared Object Dependencies
Function Addresses
Procedure Linkage Table
Initialization and Termination Functions

V. Base Libraries

16. Libraries

Interfaces for libc
Data Definitions for libc
Interfaces for libm
Data Definitions for libm
Interfaces for libpthread
Data Definitions for libpthread
Interfaces for libdl
Data Definitions for libdl
Interfaces for libcrypt
Data Definitions for libcrypt

VI. Package Format and Installation

17. Software Installation

Package Architecture Considerations

A. Alphabetical Listing of Interfaces

B. GNU Free Documentation License

PREAMBLE
APPLICABILITY AND DEFINITIONS
VERBATIM COPYING
COPYING IN QUANTITY
MODIFICATIONS
COMBINING DOCUMENTS
COLLECTIONS OF DOCUMENTS
AGGREGATION WITH INDEPENDENT WORKS
TRANSLATION
TERMINATION
FUTURE REVISIONS OF THIS LICENSE
How to use this License for your documents

List of Tables
1-1. Related Standards
1-2. Standard Library Names
2-1. Scalar Types
5-1. Extra Auxiliary Types
10-1. ELF Special Sections
10-2. Additional Special Sections
16-1. libc Definition
16-2. libc - RPC Function Interfaces
16-3. libc - System Calls Function Interfaces
16-4. libc - System Calls Deprecated Function Interfaces
16-5. libc - Standard I/O Function Interfaces
16-6. libc - Standard I/O Deprecated Function Interfaces
16-7. libc - Standard I/O Data Interfaces
16-8. libc - Signal Handling Function Interfaces
16-9. libc - Signal Handling Data Interfaces
16-10. libc - Localization Functions Function Interfaces
16-11. libc - Localization Functions Deprecated Function Interfaces
16-12. libc - Localization Functions Data Interfaces
16-13. libc - Socket Interface Function Interfaces
16-14. libc - Wide Characters Function Interfaces
16-15. libc - String Functions Function Interfaces
16-16. libc - IPC Functions Function Interfaces
16-17. libc - Regular Expressions Function Interfaces
16-18. libc - Regular Expressions Data Interfaces
16-19. libc - Character Type Functions Function Interfaces
16-20. libc - Character Type Functions Data Interfaces
16-21. libc - Time Manipulation Function Interfaces
16-22. libc - Time Manipulation Data Interfaces
16-23. libc - Terminal Interface Functions Function Interfaces
16-24. libc - System Database Interface Function Interfaces
16-25. libc - System Database Interface Deprecated Function Interfaces
16-26. libc - Language Support Function Interfaces
16-27. libc - Large File Support Function Interfaces
16-28. libc - Large File Support Deprecated Function Interfaces
16-29. libc - Standard Library Function Interfaces
16-30. libc - Standard Library Data Interfaces
16-31. libm Definition
16-32. libm - Math Function Interfaces
16-33. libm - Math Data Interfaces
16-34. libpthread Definition
16-35. libpthread - Posix Threads Function Interfaces
16-36. libdl Definition
16-37. libcrypt Definition

List of Figures
5-1. Initial Process Stack

I. Introduction

Table of Contents
1. Introduction

Chapter 1. Introduction

Introduction

This is version 1.3 of the Linux Standard Base Specification for 32 bit implementations of the PowerPC™ Architecture. An implementation of this version of the specification may not claim to be an implementation of the Linux Standard Base unless it has successfully completed the compliance process as defined by the Free Standards Group.

Purpose

The Linux Standard Base (LSB) defines a system interface for compiled applications and a minimal environment for support of installation scripts. Its purpose is to enable a uniform industry standard environment for high-volume applications conforming to the LSB.

The LSB defines a binary interface for application programs that are compiled and packaged for LSB-conforming implementations on many different hardware architectures. Since a binary specification must include information specific to the computer processor architecture for which it is intended, it is not possible for a single document to specify the interface for all possible LSB-conforming implementations. Therefore, the LSB is a family of specifications, rather than a single one.

The LSB is composed of two basic parts: A common part of the specification describes those parts of the interface that remain constant across all hardware implementations of the LSB, and an architecture-specific part of the specification describes the parts of the specification that are specific to a particular processor architecture. Together, the generic LSB and the architecture-specific supplement for a single hardware architecture provide a complete interface specification for compiled application programs on systems that share a common hardware architecture.

This document is the architecture-specific supplement. It must be used in conjunction with the generic LSB. This document provides architecture-specific information that supplements the generic LSB as well as additional information that is not found in the generic LSB.

This document should be used in conjunction with the documents it references. This document enumerates the system components it includes, but descriptions of those components may be included entirely or partly in this document, partly in other documents, or entirely in other reference documents. For example, the section that describes system service routines includes a list of the system routines supported in this interface, formal declarations of the data structures they use that are visible to applications, and a pointer to the underlying referenced specification for information about the syntax and semantics of each call. Only those routines not described in standards referenced by this document, or extensions to those standards, are described in the detail. Information referenced in this way is as much a part of this document as is the information explicitly included here.

Related Standards

The specifications listed below are referenced in whole or in part by the Linux Standard Base. Such references may be normative or non-normative; a reference to specification shall only be considered normative if it is explicitly cited as such. The LSB may make normative references to a portion of these specifications (that is, to define a specific function or group of functions); in such cases, only the explicitly referenced portion of the specification is to be considered normative.

Table 1-1. Related Standards

System V Application Binary Interface - DRAFT - 22 June 2000	http://www.caldera.com/developers/gabi/2000-07-17/contents.html
DWARF Debugging Information Format, Revision 2.0.0 (July 27, 1993)
Filesystem Hierarchy Standard (FHS) 2.2	http://www.pathname.com/fhs/
IEEE Standard for Binary Floating-Point Arithmetic	http://www.ieee.org/
System V Application Binary Interface, Edition 4.1	http://www.caldera.com/developers/devspecs/gabi41.pdf
ISO/IEC 9899: 1990, Programming Languages --C
ISO/IEC 9899: 1999, Programming Languages --C
ISO/IEC 14882: 1998(E) Programming languages --C++
Linux Assigned Names And Numbers Authority	http://www.lanana.org/
Large File Support	http://www.UNIX-systems.org/version2/whatsnew/lfs20mar.html
LI18NUX 2000 Globalization Specification, Version 1.0 with Amendment 4	http://www.li18nux.org/docs/html/LI18NUX-2000-amd4.htm
Linux Standard Base	http://www.linuxbase.org/spec/
OpenGL� Application Binary Interface for Linux	http://oss.sgi.com/projects/ogl-sample/ABI/
OSF-RFC 86.0	http://www.opengroup.org/tech/rfc/mirror-rfc/rfc86.0.txt
IEEE Std POSIX 1003.2-1992 (ISO/IEC 9945-2:1993)	http://www.ieee.org/
System V Application Binary Interface PowerPC Processor Supplement	http://www.esofta.com/pdfs/SVR4abippc.pdf
The PowerPC ™ Architecture: A Specification for a new family of RISC processors	http://www.austin.ibm.com
The PowerPC Architecture Book I changes	http://www-1.ibm.com/servers/eserver/pseries/library/ppc_chg1.html
The PowerPC Architecture Book II changes	http://www-1.ibm.com/servers/eserver/pseries/library/ppc_chg2.html
The PowerPC Architecture Book III changes	http://www-1.ibm.com/servers/eserver/pseries/library/ppc_chg3.html
POSIX 1003.1c	http://www.ieee.org/
RFC 1952: GZIP file format specification version 4.3	http://www.ietf.org/rfc/rfc1952.txt
RFC 2440: OpenPGP Message Format
CAE Specification, May 1996, X/Open Curses, Issue 4, Version 2 (ISBN: 1-85912-171-3, C610), plus Corrigendum U018	http://www.opengroup.org/publications/catalog/un.htm
CAE Specification, January 1997, System Interface Definitions (XBD),Issue 5 (ISBN: 1-85912-186-1, C605)	http://www.opengroup.org/publications/catalog/un.htm
CAE Specification, January 1997, Commands and Utilities (XCU), Issue 5 (ISBN: 1-85912-191-8, C604)	http://www.opengroup.org/publications/catalog/un.htm
CAE Specification, February 1997, Networking Services (XNS), Issue 5(ISBN: 1-85912-165-9, C523)	http://www.opengroup.org/
CAE Specification, January 1997, System Interfaces and Headers (XSH),Issue 5 (ISBN: 1-85912-181-0, C606)	http://www.opengroup.org/publications/catalog/un.htm
The Single UNIX� Specification(SUS) Version 1 (UNIX 95) System Interfaces & Headers	http://www.opengroup.org/publications/catalog/un.htm
The Single UNIX� Specification(SUS) Version 3	http://www.unix.org/version3/
System V Interface Definition, Issue 3 (ISBN 0201566524)
System V Interface Definition,Fourth Edition
Double Buffer Extension Library	http://www.x.org/
X Display Power Management Signaling (DPMS) Extension, Library Specification	http://www.x.org/
X Record Extension Library	http://www.x.org/
Security Extension Specification, Version 7.1	http://www.x.org/
X Nonrectangular Window Shape Extension Library Version 1.0	http://www.x.org/
MIT-SHM--The MIT Shared Memory Extension	http://www.x.org/
X Synchronization Extension Library	http://www.x.org/
XTEST Extension Library	http://www.x.org/
X11R6.4 X Inter-Client Exchange (ICE) Protocol	http://www.x.org/
X11R6.4 X11 Input Extension Library	http://www.x.org/
X11R6.4 Xlib - C library	http://www.x.org/
X/Open Portability Guide, Issue 4	http://www.opengroup.org/
X11R6.4 X Session Management Library	http://www.x.org/
X11R6.4 X Toolkit Intrinsics	http://www.x.org/
zlib 1.1.3 Manual	http://www.gzip.org/zlib/

Relevant Libraries

The libraries listed here shall be available on a Linux Standard Base system. This list is an addition to the list in the general specification.

Table 1-2. Standard Library Names

Library	Runtime Name
libm	libm.so.6
libdl	libdl.so.2
libcrypt	libcrypt.so.1
libc	libc.so.6
libpthread	libpthread.so.0
proginterp	/lib/ld-lsb-ppc32.so.1

These libraries will be in an implementation-dependent directory which the dynamic linker will search by default.

How to Use this Standard

The complete LSB specification is composed of a generic LSB specification and this supplemental processor-specific specification. These two documents constitute a specification that should be used in conjunction with the publicly-available standards documents it references. The LSB enumerates the system components it includes, but descriptions of those components may be included entirely in the LSB, partly in the LSB and partly in other documents, or entirely in other reference documents.

Definitions

gLSB

The common part of the LSB Specification that describes those parts of the interface that remain constant across all hardware implementations of the LSB.

archLSB

The architectural part of the LSB Specification which describes the specific parts of the interface that are platform specific. The archLSB is complementary to the gLSB.

LSB Implementation Conformance

An implementation satisfying the following requirements:

The implementation shall implement fully the architecture described in the hardware manual for the target processor architecture.
The implementation shall be capable of executing compiled applications having the format and using the system interfaces described in this document.
The implementation shall provide libraries containing the interfaces specified by this document, and shall provide a dynamic linking mechanism that allows these interfaces to be attached to applications at runtime. All the interfaces shall behave as specified in this document.
The map of virtual memory provided by the implementation shall conform to the requirements of this document.
The implementation's low-level behavior with respect to function call linkage, system traps, signals, and other such activities shall conform to the formats described in this document.
The implementation shall provide all of the mandatory interfaces in their entirety.
The implementation may provide one or more of the optional interfaces. Each optional interface that is provided shall be provided in its entirety. The product documentation shall state which optional interfaces are provided.
The implementation shall provide all files and utilities specified as part of this document in the format defined here and in other referenced documents. All commands and utilities shall behave as required by this document. The implementation shall also provide all mandatory components of an application's runtime environment that are included or referenced in this document.
The implementation, when provided with standard data formats and values at a named interface, shall provide the behavior defined for those values and data formats at that interface. However, a conforming implementation may consist of components which are separately packaged and/or sold. For example, a vendor of a conforming implementation might sell the hardware, operating system, and windowing system as separately packaged items.
The implementation may provide additional interfaces with different names. It may also provide additional behavior corresponding to data values outside the standard ranges, for standard named interfaces.

LSB Application Conformance

An application with the following characteristics:

Its executable files are either shell scripts or object files in the format defined for the Object File Format system interface.
Its object files participate in dynamic linking as defined in the Program Loading and Linking System interface.
It employs only the instructions, traps, and other low-level facilities defined in the Low-Level System interface as being for use by applications.
If it requires any optional interface defined in this document in order to be installed or to execute successfully, the requirement for that optional interface is stated in the application's documentation.
It does not use any interface or data format that is not required to be provided by a conforming implementation, unless:
- If such an interface or data format is supplied by another application through direct invocation of that application during execution, that application is in turn an LSB conforming application.
- The use of that interface or data format, as well as its source, is identified in the documentation of the application.
It must not use any values for a named interface that are reserved for vendor extensions.

A strictly conforming application does not require or use any interface, facility, or implementation-defined extension that is not defined in this document in order to be installed or to execute successfully.

Rationale

An LSB conforming application is expected to have no dependencies on any vendor extensions to this document. The most common such extensions are additional function entry points and additional libraries other than the ones defined in this document. If an application requires such extensions, it is not portable, since other LSB conforming implementations may not provide those extensions.

An LSB conforming application is required to use system services on the implementation on which it is running, rather than importing system routines from some other implementation. Thus, it must link dynamically to any routines in the implementation that perform system traps to kernel services.

It is to be expected that some applications may be companion applications to other applications. For example, a query application may be a companion to a database application; a preprocessor may be an adjunct to one or more compilers; a data reformatter may convert data from one document manager to another. In such cases, the application may or may not be LSB conforming, regardless of whether the other application on which it is dependent is LSB conforming. If such an application merely uses data produced by another application, the application's compliance is independent of the other application's compliance. If such an application actually invokes another application during execution (as, for example, a third-party math library), the invoking application is LSB conforming only if it also constitutes a LSB conforming application in combination with the invoked application.

Shell Script

A file that is read by an interpreter (e.g., awk). The first line of the shell script includes a reference to its interpreter binary.

Terminology

can

Describes a permissible optional feature or behavior available to the user or application. The feature or behavior is mandatory for an implementation that conforms to this document. An application can rely on the existence of the feature or behavior.

implementation-defined

Describes a value or behavior that is not defined by this document but is selected by an implementor. The value or behavior may vary among implementations that conform to this document. An application should not rely on the existence of the value or behavior. An application that relies on such a value or behavior cannot be assured to be portable across conforming implementations. The implementor shall document such a value or behavior so that it can be used correctly by an application.

may

Describes a feature or behavior that is optional for an implementation that conforms to this document. An application should not rely on the existence of the feature or behavior. An application that relies on such a feature or behavior cannot be assured to be portable across conforming implementations.

To avoid ambiguity, the opposite of may is expressed as need not, instead of may not.

must

Describes a feature or behavior that is mandatory for an application or user. An implementation that conforms to this document shall support this feature or behavior.

shall

Describes a feature or behavior that is mandatory for an implementation that conforms to this document. An application can rely on the existence of the feature or behavior.

should

For an implementation that conforms to this document, describes a feature or behavior that is recommended but not mandatory. An application should not rely on the existence of the feature or behavior. An application that relies on such a feature or behavior cannot be assured to be portable across conforming implementations.

For an application, describes a feature or behavior that is recommended programming practice for optimum portability.

undefined

Describes the nature of a value or behavior not defined by this document which results from use of an invalid program construct or invalid data input. The value or behavior may vary among implementations that conform to this document. An application should not rely on the existence or validity of the value or behavior. An application that relies on any particular value or behavior cannot be assured to be portable across conforming implementations.

unspecified

Describes the nature of a value or behavior not specified by this document which results from use of a valid program construct or valid data input. The value or behavior may vary among implementations that conform to this document. An application should not rely on the existence or validity of the value or behavior. An application that relies on any particular value or behavior cannot be assured to be portable across conforming implementations.

will

Same meaning as shall; shall is the preferred term.

II. Low Level System Information

Table of Contents
2. Machine Interface
3. Function Calling Sequence
4. Operating System Interface
5. Process Initialization
6. Coding Examples
7. C Stack Frame
8. Debug Information

Chapter 2. Machine Interface

Processor Architecture

The PowerPC Architecture is specified by the following documents:

System V Application Binary Interface PowerPC Processor Supplement
The PowerPC ™ Architecture: A Specification for a new family of RISC processors
The PowerPC Architecture Book I changes
The PowerPC Architecture Book II changes
The PowerPC Architecture Book III changes

Only the features of the PowerPC processor instruction set may be assumed to be present. An application is responsible for determining if any additional instruction set features are available before using those additional features. If a feature is not present, then the application may not use it.

An implementation must support the 32-bit computation mode as described in The PowerPC ™ Architecture: A Specification for a new family of RISC processors. Conforming applications shall not use instructions provided only for the 64-bit mode.

Applications conforming to this specification must provide feedback to the user if a feature that is required for correct execution of the application is not present. Applications conforming to this specification should attempt to execute in a diminished capacity if a required feature is not present.

This specification does not provide any performance guarantees of a conforming system. A system conforming to this specification may be implemented in either hardware or software.

Data Representation

LSB-conforming applications shall use the data representation as defined in Chapter 3 of the System V Application Binary Interface PowerPC Processor Supplement.

Byte Ordering

LSB-conforming applications shall use big-endian byte ordering. LSB-conforming implementations may support little-endian applications.

Fundamental Types

In addition to the fundamental types specified in Chapter 3 of the System V Application Binary Interface PowerPC Processor Supplement, a 64 bit data type is defined here.

Table 2-1. Scalar Types

Type	C	`sizeof`	Alignment (bytes)	IntelI386 Architecture
Integral	long long	`8`	8	signed double word
	signed long long	`8`	8	signed double word
	unsigned long long	`8`	8	unsigned double word

LSB-conforming applications shall not use the long double fundamental type.

Aggregates and Unions

Bit Fields

Chapter 3. Function Calling Sequence

LSB-conforming applications shall use the function calling sequence as defined in Chapter 3 of the System V Application Binary Interface PowerPC Processor Supplement.

CPU Registers

Floating Point Registers

Stack Frame

Arguments

Return Values

LSB-conforming applications shall not return structures or unions in registers as described in Section 3 of System V Application Binary Interface PowerPC Processor Supplement. Instead they must use the alternative method of passing the address of a buffer in a register as shown in the same section.

Chapter 4. Operating System Interface

LSB-conforming applications shall use the Operating System Interfaces as defined in Chapter 3 of the System V Application Binary Interface PowerPC Processor Supplement.

Processor Execution Mode

Exception Interface

Hardware Exception Types

Software Trap Types

Debugging Support

Process Startup

Signal Delivery

Signal Handler Interface

Chapter 5. Process Initialization

LSB-conforming applications shall use the Operating System Interfaces as defined in Chapter 3 of the System V Application Binary Interface PowerPC Processor Supplement.

Special Registers

Contrary to what is stated in the Registers part of Chapter 3 of the System V Application Binary Interface PowerPC Processor Supplement there are no values set in registers r3, r4, r5, r6 and r7. Instead the values specified to appear in all of those registers except r7 are placed on the stack. The value to be placed into register r7, the termination function pointer is not passed to the process.

Process Stack (on entry)

Figure 3-31 in System V Application Binary Interface PowerPC Processor Supplement is incorrect. The initial stack must look like the following.

Figure 5-1. Initial Process Stack

Auxiliary Vector

In addition to the types defined in Chapter 3 of the System V Application Binary Interface PowerPC Processor Supplement the following are also supported:

Table 5-1. Extra Auxiliary Types

Name	Value	Comment
AT_NOTELF	10	Program is not ELF
AT_UID	11	Real uid
AT_EUID	12	Effective uid
AT_GID	13	Real gid
AT_EGID	14	Effective gid
AT_PLATFORM	15	String identifying CPU for optimizations
AT_HWCAP	16	Arch dependent hints at CPU capabilities
AT_CLKTCK	17	Frequency at which times() increments
AT_DCACHEBSIZE	19	The a_val member of this entry gives the data cache block size for processors on the system on which this program is running. If the processors have unified caches, AT_DCACHEBSIZE is the same as AT_UCACHEBSIZE
AT_ICACHEBSIZE	20	The a_val member of this entyr gives the instruction cache block size for processors on the system on which this program is running. If the processors have unified caches, AT_DCACHEBSIZE is the same as AT_UCACHEBSIZE.
AT_UCACHEBSIZE	21	The a_val member of this entry is zero if the processors on the system on which this program is running do not have a unified instruction and data cache. Otherwise it gives the cache block size.
AT_IGNOREPPC	22	All entries of this type should be ignored.

The last three entries in the table above override the values specified in System V Application Binary Interface PowerPC Processor Supplement.

Environment

Chapter 6. Coding Examples

LSB-conforming applications may implement fundamental operations using the Coding Examples as defined in Chapter 3 of the System V Application Binary Interface PowerPC Processor Supplement.

Code Model Overview/Architecture Constraints

Position-Independent Function Prologue

Data Objects

Absolute Load & Store

Position Relative Load & Store

Function Calls

Absolute Direct Function Call

Absolute Indirect Function Call

Position-Independent Direct Function Call

Position-Independent Indirect Function Call

Branching

Branch Instruction

Absolute switch() code

Position-Independent switch() code

Chapter 7. C Stack Frame

Variable Argument List

Dynamic Allocation of Stack Space

Chapter 8. Debug Information

The LSB does not currently specify the format of Debug information.

III. Object Format

LSB-conforming implementations shall support an object file , called Executable and Linking Format (ELF) as defined by the System V Application Binary Interface PowerPC Processor Supplement and as supplemented by the Linux Standard Base Specification and this document. LSB-conforming implementations need not support tags related functionality. LSB-conforming applications must not rely on tags related functionality.

Table of Contents
9. ELF Header
10. Sections
11. Symbol Table
12. Relocation

Chapter 9. ELF Header

Machine Information

LSB-conforming applications shall use the Machine Information as defined in System V Application Binary Interface PowerPC Processor Supplement, Chapter 4.

File Class

Data Encoding

OS Identification

Processor Identification

Processor Specific Flags

Chapter 10. Sections

Special Sections

The following sections are defined in the System V Application Binary Interface PowerPC Processor Supplement.

Table 10-1. ELF Special Sections

Name	Type	Attributes
.got	SHT_PROGBITS	SHF_ALLOC+SHF_WRITE+SHF_EXECINSTR
.plt	SHT_NOBITS	SHF_ALLOC+SHF_WRITE+SHF_EXECINSTR
.sdata	SHT_PROGBITS	SHF_ALLOC+SHF_WRITE

.got: This section holds the global offset table. See `Coding Examples' in Chapter 3, `Special Sections' in Chapter 4, and `Global Offset Table' in Chapter 5 of the processor supplement for more information.
.plt: This section holds the Procedure Linkage Table
.sdata: This section holds initialized small data that contribute to the program memory image

Note that the .tags, .taglist and .tagsym sections described in System V Application Binary Interface PowerPC Processor Supplement are not supported.

Linux Special Sections

The following Linux PPC32 specific sections are defined here.

Table 10-2. Additional Special Sections

Name	Type	Attributes
.got2	SHT_PROGBITS	SHF_ALLOC+SHF_WRITE
.rela.bss	SHT_RELA	SHF_ALLOC
.rela.dyn	SHT_RELA	SHF_ALLOC
.rela.got	SHT_RELA	SHF_ALLOC
.rela.got2	SHT_RELA	SHF_ALLOC
.rela.plt	SHT_RELA	SHF_ALLOC
.rela.sbss	SHT_RELA	SHF_ALLOC

.got2: This section holds the second level GOT
.rela.bss: This section holds RELA type relocation information for the BSS section of a shared library or dynamically linked application
.rela.dyn: This section holds RELA type relocation information for all sections of a shared library except the PLT
.rela.got: This section holds RELA type relocation information for the GOT section of a shared library or dynamically linked application
.rela.got2: This section holds RELA type relocation information for the second level GOT section of a shared library or dynamically linked application
.rela.plt: This section holds RELA type relocation information for the PLT section of a shared library or dynamically linked application
.rela.sbss: This section holds RELA type relocation information for the SBSS section of a shared library or dynamically linked application

Section Types

Section Attribute Flags

Special Section Types

Chapter 11. Symbol Table

LSB-conforming applications shall use the Symbol Table as defined in Chapter 4 of the System V Application Binary Interface PowerPC Processor Supplement.

Chapter 12. Relocation

LSB-conforming applications shall use Relocations as defined in Chapter 4 of the System V Application Binary Interface PowerPC Processor Supplement.

Relocation Types

The relocation type R_PPC_ADDR30 as specified in Table 4-8 of System V Application Binary Interface PowerPC Processor Supplement is not supported.

IV. Program Loading and Dynamic Linking

LSB-conforming implementations shall support the object file information and system actions that create running programs as specified in the System V Application Binary Interface, Edition 4.1, System V Application Binary Interface PowerPC Processor Supplement and as supplemented by the Linux Standard Base Specification and this document.

Table of Contents
13. Program Header
14. Program Loading
15. Dynamic Linking

Chapter 13. Program Header

Types

Flags

Chapter 14. Program Loading

See System V Application Binary Interface PowerPC Processor Supplement, Chapter 5.1.

Chapter 15. Dynamic Linking

See System V Application Binary Interface PowerPC Processor Supplement, Chapter 5.4.

Program Interpreter/Dynamic Linker

The LSB specifies the Program Interpreter to be /lib/ld-lsb-ppc32.so.1.

Dynamic Section

The following dynamic entries are defined in the System V Application Binary Interface PowerPC Processor Supplement, Chapter 5.4.

Global Offset Table

See System V Application Binary Interface PowerPC Processor Supplement, Chapter 5.4.

Shared Object Dependencies

Function Addresses

Procedure Linkage Table

Initialization and Termination Functions

V. Base Libraries

Table of Contents
16. Libraries

Chapter 16. Libraries

An LSB-conforming implementation shall support base libraries which provide interfaces for accessing the operating system, processor and other hardware in the system.

Only those interfaces that are unique to the PowerPC 32 platform are defined here. This section should be used in conjunction with the corresponding section in the Linux Standard Base Specification.

Interfaces for libc

Table 16-1. libc Definition

Library:	libc
SONAME:	libc.so.6

The behavior of the interfaces in this library is specified by the following standards.

ISO/IEC 9899: 1999, Programming Languages --C[1]

Large File Support[2]

Linux Standard Base[3]

IEEE Std POSIX.1-1996 [ISO/IEC 9945-1:1996][4]

CAE Specification, February 1997, Networking Services (XNS), Issue 5(ISBN: 1-85912-165-9, C523)[5]

CAE Specification, January 1997, System Interfaces and Headers (XSH),Issue 5 (ISBN: 1-85912-181-0, C606)[6]

The Single UNIX� Specification(SUS) Version 3[7]

System V Interface Definition, Issue 3 (ISBN 0201566524)[8]

System V Interface Definition,Fourth Edition[9]

RPC

Table 16-2. libc - RPC Function Interfaces

authnone_create(GLIBC_2.0)[9]	svc_getreqset(GLIBC_2.0)[8]	xdr_bytes(GLIBC_2.0)[8]	xdr_opaque_auth(GLIBC_2.0)[8]	xdr_union(GLIBC_2.0)[8]
clnt_create(GLIBC_2.0)[9]	svcerr_auth(GLIBC_2.0)[8]	xdr_callhdr(GLIBC_2.0)[8]	xdr_pointer(GLIBC_2.0)[8]	xdr_vector(GLIBC_2.0)[8]
clnt_pcreateerror(GLIBC_2.0)[9]	svcerr_decode(GLIBC_2.0)[8]	xdr_callmsg(GLIBC_2.0)[8]	xdr_reference(GLIBC_2.0)[8]	xdr_void(GLIBC_2.0)[8]
clnt_perrno(GLIBC_2.0)[9]	svcerr_noproc(GLIBC_2.0)[8]	xdr_char(GLIBC_2.0)[8]	xdr_rejected_reply(GLIBC_2.0)[8]	xdr_wrapstring(GLIBC_2.0)[8]
clnt_perror(GLIBC_2.0)[9]	svcerr_noprog(GLIBC_2.0)[8]	xdr_double(GLIBC_2.0)[8]	xdr_replymsg(GLIBC_2.0)[8]	xdrmem_create(GLIBC_2.0)[8]
clnt_spcreateerror(GLIBC_2.0)[9]	svcerr_progvers(GLIBC_2.0)[8]	xdr_enum(GLIBC_2.0)[8]	xdr_short(GLIBC_2.0)[8]	xdrrec_create(GLIBC_2.0)[8]
clnt_sperrno(GLIBC_2.0)[9]	svcerr_systemerr(GLIBC_2.0)[8]	xdr_float(GLIBC_2.0)[8]	xdr_string(GLIBC_2.0)[8]	xdrrec_eof(GLIBC_2.0)[8]
clnt_sperror(GLIBC_2.0)[9]	svcerr_weakauth(GLIBC_2.0)[8]	xdr_free(GLIBC_2.0)[8]	xdr_u_char(GLIBC_2.0)[8]
getdomainname(GLIBC_2.0)[3]	xdr_accepted_reply(GLIBC_2.0)[8]	xdr_int(GLIBC_2.0)[8]	xdr_u_int(GLIBC_2.0)[3]
key_decryptsession(GLIBC_2.1)[8]	xdr_array(GLIBC_2.1)[8]	xdr_long(GLIBC_2.1)[8]	xdr_u_long(GLIBC_2.1)[8]
setdomainname(GLIBC_2.0)[3]	xdr_bool(GLIBC_2.0)[8]	xdr_opaque(GLIBC_2.0)[8]	xdr_u_short(GLIBC_2.0)[8]

System Calls

Table 16-3. libc - System Calls Function Interfaces

__fxstat(GLIBC_2.0)[3]	fchown(GLIBC_2.0)[6]	initgroups(GLIBC_2.0)[3]	read(GLIBC_2.0)[6]	setrlimit64(GLIBC_2.0)[2]
__getpgid(GLIBC_2.0)[3]	fcntl(GLIBC_2.0)[3]	ioctl(GLIBC_2.0)[3]	readdir(GLIBC_2.0)[6]	setsid(GLIBC_2.0)[6]
__lxstat(GLIBC_2.0)[3]	fdatasync(GLIBC_2.0)[6]	kill(GLIBC_2.0)[3]	readdir_r(GLIBC_2.0)[6]	setuid(GLIBC_2.0)[6]
__xmknod(GLIBC_2.0)[3]	flock(GLIBC_2.0)[3]	killpg(GLIBC_2.0)[6]	readlink(GLIBC_2.0)[6]	sleep(GLIBC_2.0)[6]
__xstat(GLIBC_2.0)[3]	fork(GLIBC_2.0)[6]	lchown(GLIBC_2.0)[6]	readv(GLIBC_2.0)[6]	statfs(GLIBC_2.0)[3]
access(GLIBC_2.0)[6]	fstatfs(GLIBC_2.0)[3]	link(GLIBC_2.0)[6]	rename(GLIBC_2.0)[6]	statvfs(GLIBC_2.0)[6]
acct(GLIBC_2.0)[3]	fstatvfs(GLIBC_2.0)[6]	lockf(GLIBC_2.0)[6]	rmdir(GLIBC_2.0)[6]	stime(GLIBC_2.0)[3]
alarm(GLIBC_2.0)[6]	fsync(GLIBC_2.0)[6]	lseek(GLIBC_2.0)[6]	sbrk(GLIBC_2.0)[6]	symlink(GLIBC_2.0)[6]
brk(GLIBC_2.0)[6]	ftime(GLIBC_2.0)[6]	mkdir(GLIBC_2.0)[6]	sched_get_priority_max(GLIBC_2.0)[6]	sync(GLIBC_2.0)[6]
chdir(GLIBC_2.0)[6]	ftruncate(GLIBC_2.0)[6]	mkfifo(GLIBC_2.0)[6]	sched_get_priority_min(GLIBC_2.0)[6]	sysconf(GLIBC_2.0)[6]
chmod(GLIBC_2.0)[6]	getcontext(GLIBC_2.0)[6]	mlock(GLIBC_2.0)[6]	sched_getparam(GLIBC_2.0)[6]	time(GLIBC_2.0)[6]
chown(GLIBC_2.1)[6]	getegid(GLIBC_2.1)[6]	mlockall(GLIBC_2.1)[6]	sched_getscheduler(GLIBC_2.1)[6]	times(GLIBC_2.1)[6]
chroot(GLIBC_2.0)[6]	geteuid(GLIBC_2.0)[6]	mmap(GLIBC_2.0)[6]	sched_rr_get_interval(GLIBC_2.0)[6]	truncate(GLIBC_2.0)[6]
clock(GLIBC_2.0)[6]	getgid(GLIBC_2.0)[6]	mprotect(GLIBC_2.0)[6]	sched_setparam(GLIBC_2.0)[6]	ulimit(GLIBC_2.0)[6]
close(GLIBC_2.0)[6]	getgroups(GLIBC_2.0)[6]	msync(GLIBC_2.0)[6]	sched_setscheduler(GLIBC_2.0)[6]	umask(GLIBC_2.0)[6]
closedir(GLIBC_2.0)[6]	getitimer(GLIBC_2.0)[6]	munlock(GLIBC_2.0)[6]	sched_yield(GLIBC_2.0)[6]	uname(GLIBC_2.0)[6]
creat(GLIBC_2.0)[6]	getloadavg(GLIBC_2.0)[3]	munlockall(GLIBC_2.0)[6]	select(GLIBC_2.0)[5]	unlink(GLIBC_2.0)[3]
dup(GLIBC_2.0)[6]	getpagesize(GLIBC_2.0)[6]	munmap(GLIBC_2.0)[6]	setcontext(GLIBC_2.0)[6]	utime(GLIBC_2.0)[6]
dup2(GLIBC_2.0)[6]	getpgid(GLIBC_2.0)[6]	nanosleep(GLIBC_2.0)[6]	setegid(GLIBC_2.0)[3]	utimes(GLIBC_2.0)[6]
execl(GLIBC_2.0)[6]	getpgrp(GLIBC_2.0)[6]	nice(GLIBC_2.0)[3]	seteuid(GLIBC_2.0)[3]	vfork(GLIBC_2.0)[6]
execle(GLIBC_2.0)[6]	getpid(GLIBC_2.0)[6]	open(GLIBC_2.0)[6]	setgid(GLIBC_2.0)[6]	wait(GLIBC_2.0)[6]
execlp(GLIBC_2.0)[6]	getppid(GLIBC_2.0)[6]	opendir(GLIBC_2.0)[6]	setitimer(GLIBC_2.0)[6]	wait3(GLIBC_2.0)[3]
execv(GLIBC_2.0)[6]	getpriority(GLIBC_2.0)[6]	pathconf(GLIBC_2.0)[6]	setpgid(GLIBC_2.0)[6]	wait4(GLIBC_2.0)[3]
execve(GLIBC_2.0)[6]	getrlimit(GLIBC_2.0)[6]	pause(GLIBC_2.0)[6]	setpgrp(GLIBC_2.0)[6]	waitid(GLIBC_2.0)[3]
execvp(GLIBC_2.0)[6]	getrusage(GLIBC_2.0)[6]	pipe(GLIBC_2.0)[6]	setpriority(GLIBC_2.0)[6]	waitpid(GLIBC_2.0)[3]
exit(GLIBC_2.0)[6]	getsid(GLIBC_2.0)[6]	poll(GLIBC_2.0)[6]	setregid(GLIBC_2.0)[6]	write(GLIBC_2.0)[6]
fchdir(GLIBC_2.0)[6]	getuid(GLIBC_2.0)[6]	pread(GLIBC_2.0)[6]	setreuid(GLIBC_2.0)[6]	writev(GLIBC_2.0)[6]
fchmod(GLIBC_2.0)[6]	getwd(GLIBC_2.0)[6]	pwrite(GLIBC_2.0)[6]	setrlimit(GLIBC_2.0)[6]

Table 16-4. libc - System Calls Deprecated Function Interfaces

fstatfs(GLIBC_2.0)[3]

statfs(GLIBC_2.0)[3]

waitid(GLIBC_2.0)[3]

Standard I/O

Table 16-5. libc - Standard I/O Function Interfaces

_IO_feof(GLIBC_2.0)[3]	fgetc(GLIBC_2.0)[6]	fseeko(GLIBC_2.0)[6]	putc(GLIBC_2.0)[6]	snprintf(GLIBC_2.0)[6]
_IO_getc(GLIBC_2.0)[3]	fgetpos(GLIBC_2.0)[6]	fsetpos(GLIBC_2.0)[6]	putc_unlocked(GLIBC_2.0)[6]	sprintf(GLIBC_2.0)[6]
_IO_putc(GLIBC_2.0)[3]	fgets(GLIBC_2.0)[6]	ftell(GLIBC_2.0)[6]	putchar(GLIBC_2.0)[6]	sscanf(GLIBC_2.0)[6]
_IO_puts(GLIBC_2.0)[3]	fgetwc_unlocked(GLIBC_2.0)[6]	ftello(GLIBC_2.0)[6]	putchar_unlocked(GLIBC_2.0)[6]	telldir(GLIBC_2.0)[6]
alphasort(GLIBC_2.0)[3]	fileno(GLIBC_2.0)[6]	fwrite(GLIBC_2.0)[6]	puts(GLIBC_2.0)[6]	tempnam(GLIBC_2.0)[6]
asprintf(GLIBC_2.0)[3]	flockfile(GLIBC_2.0)[6]	getc(GLIBC_2.0)[6]	putw(GLIBC_2.0)[6]	ungetc(GLIBC_2.0)[6]
clearerr(GLIBC_2.0)[6]	fopen(GLIBC_2.0)[6]	getc_unlocked(GLIBC_2.0)[6]	remove(GLIBC_2.0)[6]	vasprintf(GLIBC_2.0)[3]
ctermid(GLIBC_2.0)[6]	fprintf(GLIBC_2.0)[6]	getchar(GLIBC_2.0)[6]	rewind(GLIBC_2.0)[6]	vdprintf(GLIBC_2.0)[3]
fclose(GLIBC_2.1)[6]	fputc(GLIBC_2.1)[6]	getchar_unlocked(GLIBC_2.1)[6]	rewinddir(GLIBC_2.1)[6]	vfprintf(GLIBC_2.1)[6]
fdopen(GLIBC_2.1)[6]	fputs(GLIBC_2.1)[6]	gets(GLIBC_2.1)[3]	scanf(GLIBC_2.1)[6]	vprintf(GLIBC_2.1)[6]
feof(GLIBC_2.0)[6]	fread(GLIBC_2.0)[6]	getw(GLIBC_2.0)[6]	seekdir(GLIBC_2.0)[6]	vsnprintf(GLIBC_2.0)[6]
ferror(GLIBC_2.0)[6]	freopen(GLIBC_2.0)[6]	pclose(GLIBC_2.0)[6]	setbuf(GLIBC_2.0)[6]	vsprintf(GLIBC_2.0)[6]
fflush(GLIBC_2.0)[6]	fscanf(GLIBC_2.0)[6]	popen(GLIBC_2.0)[6]	setbuffer(GLIBC_2.0)[3]
fflush_unlocked(GLIBC_2.0)[6]	fseek(GLIBC_2.0)[6]	printf(GLIBC_2.0)[6]	setvbuf(GLIBC_2.0)[6]

Table 16-6. libc - Standard I/O Deprecated Function Interfaces

alphasort(GLIBC_2.0)[3]

Table 16-7. libc - Standard I/O Data Interfaces

stderr(GLIBC_2.0)[6]

stdin(GLIBC_2.0)[6]

stdout(GLIBC_2.0)[6]

Signal Handling

Table 16-8. libc - Signal Handling Function Interfaces

__libc_current_sigrtmax(GLIBC_2.1)[3]	sigaddset(GLIBC_2.1)[6]	sighold(GLIBC_2.1)[6]	sigpause(GLIBC_2.1)[6]	sigsuspend(GLIBC_2.1)[6]
__libc_current_sigrtmin(GLIBC_2.1)[3]	sigaltstack(GLIBC_2.1)[6]	sigignore(GLIBC_2.1)[6]	sigpending(GLIBC_2.1)[6]	sigtimedwait(GLIBC_2.1)[6]
__sigsetjmp(GLIBC_2.0)[3]	sigandset(GLIBC_2.0)[3]	siginterrupt(GLIBC_2.0)[6]	sigprocmask(GLIBC_2.0)[6]	sigwait(GLIBC_2.0)[6]
__sysv_signal(GLIBC_2.0)[3]	sigblock(GLIBC_2.0)[3]	sigisemptyset(GLIBC_2.0)[3]	sigqueue(GLIBC_2.0)[6]	sigwaitinfo(GLIBC_2.0)[6]
bsd_signal(GLIBC_2.0)[6]	sigdelset(GLIBC_2.0)[6]	sigismember(GLIBC_2.0)[6]	sigrelse(GLIBC_2.0)[6]
psignal(GLIBC_2.0)[3]	sigemptyset(GLIBC_2.0)[6]	siglongjmp(GLIBC_2.0)[6]	sigreturn(GLIBC_2.0)[3]
raise(GLIBC_2.0)[6]	sigfillset(GLIBC_2.0)[6]	signal(GLIBC_2.0)[6]	sigset(GLIBC_2.0)[6]
sigaction(GLIBC_2.0)[6]	siggetmask(GLIBC_2.0)[3]	sigorset(GLIBC_2.0)[3]	sigstack(GLIBC_2.0)[6]

Table 16-9. libc - Signal Handling Data Interfaces

_sys_siglist(GLIBC_2.1)[3]

Localization Functions

Table 16-10. libc - Localization Functions Function Interfaces

__dcgettext(GLIBC_2.0)[3]	catgets(GLIBC_2.0)[6]	dgettext(GLIBC_2.0)[3]	iconv_close(GLIBC_2.0)[6]	nl_langinfo(GLIBC_2.0)[6]
bind_textdomain_codeset(GLIBC_2.2)[3]	catopen(GLIBC_2.2)[6]	dngettext(GLIBC_2.2)[3]	iconv_open(GLIBC_2.2)[6]	setlocale(GLIBC_2.2)[6]
bindtextdomain(GLIBC_2.0)[3]	dcgettext(GLIBC_2.0)[3]	gettext(GLIBC_2.0)[3]	localeconv(GLIBC_2.0)[6]	textdomain(GLIBC_2.0)[3]
catclose(GLIBC_2.0)[6]	dcngettext(GLIBC_2.0)[3]	iconv(GLIBC_2.0)[6]	ngettext(GLIBC_2.0)[3]

Table 16-11. libc - Localization Functions Deprecated Function Interfaces

__dcgettext(GLIBC_2.0)[3]

Table 16-12. libc - Localization Functions Data Interfaces

_nl_msg_cat_cntr(GLIBC_2.0)[3]

Socket Interface

Table 16-13. libc - Socket Interface Function Interfaces

__h_errno_location(GLIBC_2.0)[3]	gethostbyname_r(GLIBC_2.0)[3]	getsockopt(GLIBC_2.0)[5]	send(GLIBC_2.0)[5]	socket(GLIBC_2.0)[5]
accept(GLIBC_2.0)[5]	gethostid(GLIBC_2.0)[6]	listen(GLIBC_2.0)[5]	sendmsg(GLIBC_2.0)[5]	socketpair(GLIBC_2.0)[5]
bind(GLIBC_2.0)[5]	gethostname(GLIBC_2.0)[5]	recv(GLIBC_2.0)[5]	sendto(GLIBC_2.0)[5]
bindresvport(GLIBC_2.0)[3]	getpeername(GLIBC_2.0)[5]	recvfrom(GLIBC_2.0)[5]	setsockopt(GLIBC_2.0)[5]
connect(GLIBC_2.0)[5]	getsockname(GLIBC_2.0)[5]	recvmsg(GLIBC_2.0)[5]	shutdown(GLIBC_2.0)[5]

Wide Characters

Table 16-14. libc - Wide Characters Function Interfaces

__wcstod_internal(GLIBC_2.0)[3]	mbsinit(GLIBC_2.0)[6]	vwscanf(GLIBC_2.0)[1]	wcsnlen(GLIBC_2.0)[3]	wcstoumax(GLIBC_2.0)[1]
__wcstof_internal(GLIBC_2.0)[3]	mbsnrtowcs(GLIBC_2.0)[3]	wcpcpy(GLIBC_2.0)[3]	wcsnrtombs(GLIBC_2.0)[3]	wcstouq(GLIBC_2.0)[3]
__wcstol_internal(GLIBC_2.0)[3]	mbsrtowcs(GLIBC_2.0)[6]	wcpncpy(GLIBC_2.0)[3]	wcspbrk(GLIBC_2.0)[1]	wcswcs(GLIBC_2.0)[6]
__wcstold_internal(GLIBC_2.0)[3]	mbstowcs(GLIBC_2.0)[6]	wcrtomb(GLIBC_2.0)[6]	wcsrchr(GLIBC_2.0)[6]	wcswidth(GLIBC_2.0)[6]
__wcstoul_internal(GLIBC_2.0)[3]	mbtowc(GLIBC_2.0)[6]	wcscasecmp(GLIBC_2.0)[3]	wcsrtombs(GLIBC_2.0)[6]	wcsxfrm(GLIBC_2.0)[6]
btowc(GLIBC_2.0)[6]	putwc(GLIBC_2.0)[1]	wcscat(GLIBC_2.0)[6]	wcsspn(GLIBC_2.0)[6]	wctob(GLIBC_2.0)[6]
fgetwc(GLIBC_2.2)[6]	putwchar(GLIBC_2.2)[1]	wcschr(GLIBC_2.2)[6]	wcsstr(GLIBC_2.2)[6]	wctomb(GLIBC_2.2)[6]
fgetws(GLIBC_2.2)[1]	swprintf(GLIBC_2.2)[6]	wcscmp(GLIBC_2.2)[6]	wcstod(GLIBC_2.2)[6]	wctrans(GLIBC_2.2)[6]
fputwc(GLIBC_2.2)[1]	swscanf(GLIBC_2.2)[1]	wcscoll(GLIBC_2.2)[6]	wcstof(GLIBC_2.2)[1]	wctype(GLIBC_2.2)[6]
fputws(GLIBC_2.2)[1]	towctrans(GLIBC_2.2)[6]	wcscpy(GLIBC_2.2)[6]	wcstoimax(GLIBC_2.2)[1]	wcwidth(GLIBC_2.2)[6]
fwide(GLIBC_2.2)[1]	towlower(GLIBC_2.2)[1]	wcscspn(GLIBC_2.2)[6]	wcstok(GLIBC_2.2)[6]	wmemchr(GLIBC_2.2)[6]
fwprintf(GLIBC_2.2)[6]	towupper(GLIBC_2.2)[6]	wcsdup(GLIBC_2.2)[3]	wcstol(GLIBC_2.2)[6]	wmemcmp(GLIBC_2.2)[6]
fwscanf(GLIBC_2.2)[1]	ungetwc(GLIBC_2.2)[1]	wcsftime(GLIBC_2.2)[1]	wcstold(GLIBC_2.2)[1]	wmemcpy(GLIBC_2.2)[6]
getwc(GLIBC_2.2)[1]	vfwprintf(GLIBC_2.2)[1]	wcslen(GLIBC_2.2)[6]	wcstoll(GLIBC_2.2)[1]	wmemmove(GLIBC_2.2)[6]
getwchar(GLIBC_2.2)[6]	vfwscanf(GLIBC_2.2)[1]	wcsncasecmp(GLIBC_2.2)[3]	wcstombs(GLIBC_2.2)[6]	wmemset(GLIBC_2.2)[6]
mblen(GLIBC_2.0)[6]	vswprintf(GLIBC_2.0)[1]	wcsncat(GLIBC_2.0)[6]	wcstoq(GLIBC_2.0)[3]	wprintf(GLIBC_2.0)[1]
mbrlen(GLIBC_2.0)[6]	vswscanf(GLIBC_2.0)[1]	wcsncmp(GLIBC_2.0)[6]	wcstoul(GLIBC_2.0)[6]	wscanf(GLIBC_2.0)[1]
mbrtowc(GLIBC_2.0)[6]	vwprintf(GLIBC_2.0)[1]	wcsncpy(GLIBC_2.0)[6]	wcstoull(GLIBC_2.0)[1]

String Functions

Table 16-15. libc - String Functions Function Interfaces

__mempcpy(GLIBC_2.0)[3]	bzero(GLIBC_2.0)[6]	strcasestr(GLIBC_2.0)[3]	strncasecmp(GLIBC_2.0)[6]	strtoimax(GLIBC_2.0)[1]
__rawmemchr(GLIBC_2.1)[3]	ffs(GLIBC_2.1)[6]	strcat(GLIBC_2.1)[6]	strncat(GLIBC_2.1)[6]	strtok(GLIBC_2.1)[6]
__stpcpy(GLIBC_2.0)[3]	index(GLIBC_2.0)[6]	strchr(GLIBC_2.0)[6]	strncmp(GLIBC_2.0)[6]	strtok_r(GLIBC_2.0)[3]
__strdup(GLIBC_2.0)[3]	memccpy(GLIBC_2.0)[6]	strcmp(GLIBC_2.0)[6]	strncpy(GLIBC_2.0)[6]	strtold(GLIBC_2.0)[1]
__strtod_internal(GLIBC_2.0)[3]	memchr(GLIBC_2.0)[6]	strcoll(GLIBC_2.0)[6]	strndup(GLIBC_2.0)[3]	strtoll(GLIBC_2.0)[1]
__strtof_internal(GLIBC_2.0)[3]	memcmp(GLIBC_2.0)[6]	strcpy(GLIBC_2.0)[6]	strnlen(GLIBC_2.0)[3]	strtoq(GLIBC_2.0)[3]
__strtok_r(GLIBC_2.0)[3]	memcpy(GLIBC_2.0)[6]	strcspn(GLIBC_2.0)[6]	strpbrk(GLIBC_2.0)[6]	strtoull(GLIBC_2.0)[1]
__strtol_internal(GLIBC_2.0)[3]	memmove(GLIBC_2.0)[6]	strdup(GLIBC_2.0)[6]	strptime(GLIBC_2.0)[3]	strtoumax(GLIBC_2.0)[1]
__strtold_internal(GLIBC_2.0)[3]	memrchr(GLIBC_2.0)[3]	strerror(GLIBC_2.0)[6]	strrchr(GLIBC_2.0)[6]	strtouq(GLIBC_2.0)[3]
__strtoll_internal(GLIBC_2.0)[3]	memset(GLIBC_2.0)[6]	strerror_r(GLIBC_2.0)[3]	strsep(GLIBC_2.0)[3]	strverscmp(GLIBC_2.0)[3]
__strtoul_internal(GLIBC_2.0)[3]	rindex(GLIBC_2.0)[6]	strfmon(GLIBC_2.0)[6]	strsignal(GLIBC_2.0)[3]	strxfrm(GLIBC_2.0)[6]
__strtoull_internal(GLIBC_2.0)[3]	stpcpy(GLIBC_2.0)[3]	strfry(GLIBC_2.0)[3]	strspn(GLIBC_2.0)[6]	swab(GLIBC_2.0)[6]
bcmp(GLIBC_2.0)[6]	stpncpy(GLIBC_2.0)[3]	strftime(GLIBC_2.0)[6]	strstr(GLIBC_2.0)[6]
bcopy(GLIBC_2.0)[6]	strcasecmp(GLIBC_2.0)[6]	strlen(GLIBC_2.0)[6]	strtof(GLIBC_2.0)[1]

IPC Functions

Table 16-16. libc - IPC Functions Function Interfaces

ftok(GLIBC_2.0)[6]	msgrcv(GLIBC_2.0)[6]	semget(GLIBC_2.0)[6]	shmctl(GLIBC_2.0)[6]
msgctl(GLIBC_2.2)[6]	msgsnd(GLIBC_2.2)[6]	semop(GLIBC_2.2)[6]	shmdt(GLIBC_2.2)[6]
msgget(GLIBC_2.0)[6]	semctl(GLIBC_2.0)[6]	shmat(GLIBC_2.0)[6]	shmget(GLIBC_2.0)[6]

Regular Expressions

Table 16-17. libc - Regular Expressions Function Interfaces

advance(GLIBC_2.0)[6]	re_exec(GLIBC_2.0)[6]	regerror(GLIBC_2.0)[6]	regfree(GLIBC_2.0)[6]
re_comp(GLIBC_2.0)[6]	regcomp(GLIBC_2.0)[6]	regexec(GLIBC_2.0)[6]	step(GLIBC_2.0)[6]

Table 16-18. libc - Regular Expressions Data Interfaces

loc1(GLIBC_2.0)[6]

loc2(GLIBC_2.0)[6]

locs(GLIBC_2.0)[6]

Character Type Functions

Table 16-19. libc - Character Type Functions Function Interfaces

__ctype_get_mb_cur_max(GLIBC_2.0)[3]	isdigit(GLIBC_2.0)[6]	iswalnum(GLIBC_2.0)[6]	iswlower(GLIBC_2.0)[6]	toascii(GLIBC_2.0)[6]
_tolower(GLIBC_2.0)[6]	isgraph(GLIBC_2.0)[6]	iswalpha(GLIBC_2.0)[6]	iswprint(GLIBC_2.0)[6]	tolower(GLIBC_2.0)[6]
_toupper(GLIBC_2.0)[6]	islower(GLIBC_2.0)[6]	iswblank(GLIBC_2.0)[7]	iswpunct(GLIBC_2.0)[6]	toupper(GLIBC_2.0)[6]
isalnum(GLIBC_2.0)[6]	isprint(GLIBC_2.0)[6]	iswcntrl(GLIBC_2.0)[6]	iswspace(GLIBC_2.0)[6]
isalpha(GLIBC_2.0)[6]	ispunct(GLIBC_2.0)[6]	iswctype(GLIBC_2.0)[3]	iswupper(GLIBC_2.0)[6]
isascii(GLIBC_2.0)[6]	isspace(GLIBC_2.0)[6]	iswdigit(GLIBC_2.0)[6]	iswxdigit(GLIBC_2.0)[6]
iscntrl(GLIBC_2.0)[6]	isupper(GLIBC_2.0)[6]	iswgraph(GLIBC_2.0)[6]	isxdigit(GLIBC_2.0)[6]

Table 16-20. libc - Character Type Functions Data Interfaces

__ctype_b(GLIBC_2.0)[3]

__ctype_tolower(GLIBC_2.0)[3]

__ctype_toupper(GLIBC_2.0)[3]

Time Manipulation

Table 16-21. libc - Time Manipulation Function Interfaces

adjtime(GLIBC_2.0)[3]	asctime_r(GLIBC_2.0)[6]	difftime(GLIBC_2.0)[6]	localtime(GLIBC_2.0)[6]	tzset(GLIBC_2.0)[6]
adjtimex(GLIBC_2.0)[3]	ctime(GLIBC_2.0)[6]	gmtime(GLIBC_2.0)[6]	localtime_r(GLIBC_2.0)[6]	ualarm(GLIBC_2.0)[6]
asctime(GLIBC_2.0)[6]	ctime_r(GLIBC_2.0)[6]	gmtime_r(GLIBC_2.0)[6]	mktime(GLIBC_2.0)[6]

Table 16-22. libc - Time Manipulation Data Interfaces

__daylight(GLIBC_2.0)[3]	__tzname(GLIBC_2.0)[3]	timezone(GLIBC_2.0)[6]
__timezone(GLIBC_2.0)[3]	daylight(GLIBC_2.0)[6]	tzname(GLIBC_2.0)[6]

Terminal Interface Functions

Table 16-23. libc - Terminal Interface Functions Function Interfaces

cfgetispeed(GLIBC_2.0)[6]	cfsetispeed(GLIBC_2.0)[6]	tcdrain(GLIBC_2.0)[6]	tcgetattr(GLIBC_2.0)[6]	tcsendbreak(GLIBC_2.0)[6]
cfgetospeed(GLIBC_2.0)[6]	cfsetospeed(GLIBC_2.0)[6]	tcflow(GLIBC_2.0)[6]	tcgetpgrp(GLIBC_2.0)[6]	tcsetattr(GLIBC_2.0)[6]
cfmakeraw(GLIBC_2.0)[3]	cfsetspeed(GLIBC_2.0)[3]	tcflush(GLIBC_2.0)[6]	tcgetsid(GLIBC_2.0)[6]	tcsetpgrp(GLIBC_2.0)[6]

System Database Interface

Table 16-24. libc - System Database Interface Function Interfaces

endgrent(GLIBC_2.0)[6]	getgrgid(GLIBC_2.0)[6]	getprotoent(GLIBC_2.0)[6]	getutent(GLIBC_2.0)[3]	setmntent(GLIBC_2.0)[3]
endhostent(GLIBC_2.0)[5]	getgrgid_r(GLIBC_2.0)[6]	getpwent(GLIBC_2.0)[6]	getutent_r(GLIBC_2.0)[3]	setnetent(GLIBC_2.0)[5]
endnetent(GLIBC_2.0)[5]	getgrnam(GLIBC_2.0)[6]	getpwnam(GLIBC_2.0)[6]	getutxent(GLIBC_2.0)[6]	setprotoent(GLIBC_2.0)[5]
endprotoent(GLIBC_2.0)[5]	getgrnam_r(GLIBC_2.0)[6]	getpwnam_r(GLIBC_2.0)[3]	getutxid(GLIBC_2.0)[6]	setpwent(GLIBC_2.0)[6]
endpwent(GLIBC_2.0)[6]	gethostbyaddr(GLIBC_2.0)[5]	getpwuid(GLIBC_2.0)[6]	getutxline(GLIBC_2.0)[6]	setservent(GLIBC_2.0)[5]
endservent(GLIBC_2.0)[5]	gethostbyname(GLIBC_2.0)[3]	getpwuid_r(GLIBC_2.0)[6]	pututxline(GLIBC_2.0)[6]	setutent(GLIBC_2.0)[3]
endutent(GLIBC_2.0)[6]	getnetbyaddr(GLIBC_2.0)[5]	getservbyname(GLIBC_2.0)[3]	setgrent(GLIBC_2.0)[6]	setutxent(GLIBC_2.0)[6]
endutxent(GLIBC_2.1)[6]	getprotobyname(GLIBC_2.1)[6]	getservbyport(GLIBC_2.1)[5]	setgroups(GLIBC_2.1)[3]
getgrent(GLIBC_2.0)[6]	getprotobynumber(GLIBC_2.0)[5]	getservent(GLIBC_2.0)[3]	sethostent(GLIBC_2.0)[5]

Table 16-25. libc - System Database Interface Deprecated Function Interfaces

endhostent(GLIBC_2.0)[5]

sethostent(GLIBC_2.0)[5]

setmntent(GLIBC_2.0)[3]

Language Support

Table 16-26. libc - Language Support Function Interfaces

__libc_start_main(GLIBC_2.0)[3]

_obstack_begin(GLIBC_2.0)[3]

_obstack_newchunk(GLIBC_2.0)[3]

obstack_free(GLIBC_2.0)[3]

Large File Support

Table 16-27. libc - Large File Support Function Interfaces

__fxstat64(GLIBC_2.2)[3]	fopen64(GLIBC_2.2)[2]	ftello64(GLIBC_2.2)[2]	mkstemp64(GLIBC_2.2)[2]	readdir64(GLIBC_2.2)[2]
__lxstat64(GLIBC_2.2)[3]	freopen64(GLIBC_2.2)[2]	ftruncate64(GLIBC_2.2)[2]	mmap64(GLIBC_2.2)[2]	statvfs64(GLIBC_2.2)[2]
__xstat64(GLIBC_2.2)[3]	fseeko64(GLIBC_2.2)[2]	ftw64(GLIBC_2.2)[2]	nftw64(GLIBC_2.2)[2]	tmpfile64(GLIBC_2.2)[2]
alphasort64(GLIBC_2.1)[3]	fsetpos64(GLIBC_2.1)[2]	getrlimit64(GLIBC_2.1)[2]	open64(GLIBC_2.1)[2]	truncate64(GLIBC_2.1)[2]
creat64(GLIBC_2.1)[2]	fstatfs64(GLIBC_2.1)[3]	lockf64(GLIBC_2.1)[2]	pread64(GLIBC_2.1)[2]
fgetpos64(GLIBC_2.2)[2]	fstatvfs64(GLIBC_2.2)[2]	lseek64(GLIBC_2.2)[2]	pwrite64(GLIBC_2.2)[2]

Table 16-28. libc - Large File Support Deprecated Function Interfaces

alphasort64(GLIBC_2.1)[3]

fstatfs64(GLIBC_2.1)[3]

Standard Library

Table 16-29. libc - Standard Library Function Interfaces

_Exit(GLIBC_2.1.1)[1]	div(GLIBC_2.1.1)[6]	globfree64(GLIBC_2.1.1)[3]	longjmp(GLIBC_2.1.1)[6]	srand(GLIBC_2.1.1)[6]
__assert_fail(GLIBC_2.0)[3]	drand48(GLIBC_2.0)[6]	grantpt(GLIBC_2.0)[6]	lrand48(GLIBC_2.0)[6]	srand48(GLIBC_2.0)[6]
__cxa_atexit(GLIBC_2.1.3)[3]	ecvt(GLIBC_2.1.3)[6]	hcreate(GLIBC_2.1.3)[6]	lsearch(GLIBC_2.1.3)[6]	srandom(GLIBC_2.1.3)[6]
__errno_location(GLIBC_2.0)[3]	erand48(GLIBC_2.0)[6]	hdestroy(GLIBC_2.0)[6]	makecontext(GLIBC_2.0)[6]	strtod(GLIBC_2.0)[6]
__fpending(GLIBC_2.2)[3]	err(GLIBC_2.2)[3]	hsearch(GLIBC_2.2)[6]	malloc(GLIBC_2.2)[6]	strtol(GLIBC_2.2)[6]
__getpagesize(GLIBC_2.0)[3]	error(GLIBC_2.0)[3]	htonl(GLIBC_2.0)[5]	memmem(GLIBC_2.0)[3]	strtoul(GLIBC_2.0)[6]
__isinf(GLIBC_2.0)[3]	errx(GLIBC_2.0)[3]	htons(GLIBC_2.0)[5]	mkstemp(GLIBC_2.0)[6]	swapcontext(GLIBC_2.0)[6]
__isinff(GLIBC_2.0)[3]	fcvt(GLIBC_2.0)[6]	imaxabs(GLIBC_2.0)[1]	mktemp(GLIBC_2.0)[6]	syslog(GLIBC_2.0)[6]
__isinfl(GLIBC_2.0)[3]	fmtmsg(GLIBC_2.0)[6]	imaxdiv(GLIBC_2.0)[1]	mrand48(GLIBC_2.0)[6]	system(GLIBC_2.0)[3]
__isnan(GLIBC_2.0)[3]	fnmatch(GLIBC_2.0)[6]	inet_addr(GLIBC_2.0)[5]	nftw(GLIBC_2.0)[6]	tdelete(GLIBC_2.0)[6]
__isnanf(GLIBC_2.0)[3]	fpathconf(GLIBC_2.0)[6]	inet_aton(GLIBC_2.0)[5]	nrand48(GLIBC_2.0)[6]	tfind(GLIBC_2.0)[6]
__isnanl(GLIBC_2.0)[3]	free(GLIBC_2.0)[6]	inet_ntoa(GLIBC_2.0)[5]	ntohl(GLIBC_2.0)[5]	tmpfile(GLIBC_2.0)[6]
__sysconf(GLIBC_2.2)[3]	freeaddrinfo(GLIBC_2.2)[7]	inet_ntop(GLIBC_2.2)[7]	ntohs(GLIBC_2.2)[5]	tmpnam(GLIBC_2.2)[6]
_exit(GLIBC_2.0)[6]	ftrylockfile(GLIBC_2.0)[6]	inet_pton(GLIBC_2.0)[7]	openlog(GLIBC_2.0)[6]	tsearch(GLIBC_2.0)[6]
_longjmp(GLIBC_2.0)[6]	ftw(GLIBC_2.0)[6]	initstate(GLIBC_2.0)[6]	perror(GLIBC_2.0)[6]	ttyname(GLIBC_2.0)[6]
_setjmp(GLIBC_2.0)[6]	funlockfile(GLIBC_2.0)[6]	insque(GLIBC_2.0)[6]	posix_memalign(GLIBC_2.0)[4]	ttyname_r(GLIBC_2.0)[6]
a64l(GLIBC_2.0)[6]	gai_strerror(GLIBC_2.0)[7]	isatty(GLIBC_2.0)[6]	ptsname(GLIBC_2.0)[6]	twalk(GLIBC_2.0)[6]
abort(GLIBC_2.0)[6]	gcvt(GLIBC_2.0)[6]	isblank(GLIBC_2.0)[7]	putenv(GLIBC_2.0)[6]	unlockpt(GLIBC_2.0)[6]
abs(GLIBC_2.0)[6]	getaddrinfo(GLIBC_2.0)[7]	isinf(GLIBC_2.0)[1]	qsort(GLIBC_2.0)[6]	unsetenv(GLIBC_2.0)[3]
atexit(GLIBC_2.0)[6]	getcwd(GLIBC_2.0)[6]	isinff(GLIBC_2.0)	rand(GLIBC_2.0)[6]	usleep(GLIBC_2.0)[6]
atof(GLIBC_2.0)[6]	getdate(GLIBC_2.0)[6]	isinfl(GLIBC_2.0)[1]	rand_r(GLIBC_2.0)[6]	verrx(GLIBC_2.0)[3]
atoi(GLIBC_2.0)[6]	getenv(GLIBC_2.0)[6]	isnan(GLIBC_2.0)[1]	random(GLIBC_2.0)[6]	vfscanf(GLIBC_2.0)[1]
atol(GLIBC_2.0)[6]	getlogin(GLIBC_2.0)[6]	isnanf(GLIBC_2.0)[1]	random_r(GLIBC_2.0)[3]	vscanf(GLIBC_2.0)[1]
atoll(GLIBC_2.0)[1]	getnameinfo(GLIBC_2.0)[7]	isnanl(GLIBC_2.0)[1]	realloc(GLIBC_2.0)[6]	vsscanf(GLIBC_2.0)[1]
basename(GLIBC_2.0)[6]	getopt(GLIBC_2.0)[3]	jrand48(GLIBC_2.0)[6]	realpath(GLIBC_2.0)[6]	vsyslog(GLIBC_2.0)[3]
bsearch(GLIBC_2.0)[6]	getopt_long(GLIBC_2.0)[3]	l64a(GLIBC_2.0)[6]	remque(GLIBC_2.0)[6]	warn(GLIBC_2.0)[3]
calloc(GLIBC_2.0)[6]	getopt_long_only(GLIBC_2.0)[3]	labs(GLIBC_2.0)[6]	seed48(GLIBC_2.0)[6]	warnx(GLIBC_2.0)[3]
closelog(GLIBC_2.0)[6]	getsubopt(GLIBC_2.0)[6]	lcong48(GLIBC_2.0)[6]	setenv(GLIBC_2.0)[3]	wordexp(GLIBC_2.0)[6]
confstr(GLIBC_2.0)[6]	gettimeofday(GLIBC_2.0)[6]	ldiv(GLIBC_2.0)[6]	sethostid(GLIBC_2.0)[3]	wordfree(GLIBC_2.0)[6]
cuserid(GLIBC_2.0)[6]	glob(GLIBC_2.0)[6]	lfind(GLIBC_2.0)[6]	sethostname(GLIBC_2.0)[3]
daemon(GLIBC_2.0)[3]	glob64(GLIBC_2.0)[3]	llabs(GLIBC_2.0)[1]	setlogmask(GLIBC_2.0)[6]
dirname(GLIBC_2.0)[6]	globfree(GLIBC_2.0)[6]	lldiv(GLIBC_2.0)[1]	setstate(GLIBC_2.0)[6]

Table 16-30. libc - Standard Library Data Interfaces

__environ(GLIBC_2.0)[3]	_sys_errlist(GLIBC_2.0)[3]	getdate_err(GLIBC_2.0)[6]	opterr(GLIBC_2.0)[3]	optopt(GLIBC_2.0)[3]
_environ(GLIBC_2.0)[3]	environ(GLIBC_2.0)[6]	optarg(GLIBC_2.0)[6]	optind(GLIBC_2.0)[3]

Data Definitions for libc

This section contains standard data definitions that describe system data. These definitions are organized into groups that correspond to system headers. This convention is used as a convenience for the reader, and does not imply the existence of these headers, or their content.

ISO C serves as the LSB reference programming language, and data definitions are specified in ISO C format. The C language is used here as a convenient notation. Using a C language description of these data objects does not preclude their use by other programming languages.

errno.h




#define EDEADLOCK	58

inttypes.h






typedef unsigned long long uintmax_t;
typedef long long intmax_t;
typedef unsigned int uintptr_t;

limits.h

#define ULONG_MAX	0xFFFFFFFFUL
#define LONG_MAX	2147483647L






#define CHAR_MIN	0
#define CHAR_MAX	255

setjmp.h






typedef int __jmp_buf[58];

signal.h
























struct sigaction
{
  union
  {
    __sighandler_t _sa_handler;
    void (*_sa_sigaction) (int, siginfo_t *, void *);
  }
  __sigaction_handler;
  sigset_t sa_mask;
  unsigned long sa_flags;
  void (*sa_restorer) (void);
}
 ;











struct sigcontext
{
  long _unused[4];
  int signal;
  unsigned long handler;
  unsigned long oldmask;
  struct pt_regs *regs;
}
 ;

stddef.h



typedef unsigned int size_t;
typedef int ptrdiff_t;

sys/ioctl.h

#define TIOCNOTTY	0x5422
#define FIONREAD	1074030207

sys/ipc.h



struct ipc_perm
{
  key_t __key;
  uid_t uid;
  gid_t gid;
  uid_t cuid;
  uid_t cgid;
  mode_t mode;
  long __seq;
  int __pad1;
  unsigned long long __unused1;
  unsigned long long __unused2;
}
 ;

sys/mman.h

#define MCL_FUTURE	16384
#define MCL_CURRENT	8192

sys/msg.h






typedef unsigned long msglen_t;
typedef unsigned long msgqnum_t;


struct msqid_ds
{
  struct ipc_perm msg_perm;
  unsigned int __unused1;
  time_t msg_stime;
  unsigned int __unused2;
  time_t msg_rtime;
  unsigned int __unused3;
  time_t msg_ctime;
  unsigned long __msg_cbytes;
  msgqnum_t msg_qnum;
  msglen_t msg_qbytes;
  pid_t msg_lspid;
  pid_t msg_lrpid;
  unsigned long __unused4;
  unsigned long __unused5;
}
 ;

sys/sem.h



struct semid_ds
{
  struct ipc_perm sem_perm;
  unsigned int __unused1;
  time_t sem_otime;
  unsigned int __unused2;
  time_t sem_ctime;
  unsigned long sem_nsems;
  unsigned long __unused3;
  unsigned long __unused4;
}
 ;

sys/shm.h

#define SHMLBA	(__getpagesize())





typedef unsigned long shmatt_t;


struct shmid_ds
{
  struct ipc_perm shm_perm;
  unsigned int __unused1;
  time_t shm_atime;
  unsigned int __unused2;
  time_t shm_dtime;
  unsigned int __unused3;
  time_t shm_ctime;
  unsigned int __unused4;
  size_t shm_segsz;
  pid_t shm_cpid;
  pid_t shm_lpid;
  shmatt_t shm_nattch;
  unsigned long __unused5;
  unsigned long __unused6;
}
 ;

sys/stat.h

#define _STAT_VER	3


struct stat64
{
  dev_t st_dev;
  ino64_t st_ino;
  mode_t st_mode;
  nlink_t st_nlink;
  uid_t st_uid;
  gid_t st_gid;
  dev_t st_rdev;
  unsigned short __pad2;
  off64_t st_size;
  blksize_t st_blksize;
  blkcnt64_t st_blocks;
  time_t st_atime;
  unsigned long __unused1;
  time_t st_mtime;
  unsigned long __unused2;
  time_t st_ctime;
  unsigned long __unused3;
  unsigned long __unused4;
  unsigned long __unused5;
}
 ;
struct stat
{
  dev_t st_dev;
  unsigned short __pad1;
  ino_t st_ino;
  mode_t st_mode;
  nlink_t st_nlink;
  uid_t st_uid;
  gid_t st_gid;
  dev_t st_rdev;
  unsigned short __pad2;
  off_t st_size;
  blksize_t st_blksize;
  blkcnt_t st_blocks;
  time_t st_atime;
  unsigned long __unused1;
  time_t st_mtime;
  unsigned long __unused2;
  time_t st_ctime;
  unsigned long __unused3;
  unsigned long __unused4;
  unsigned long __unused5;
}
 ;

sys/statvfs.h



struct statvfs
{
  unsigned long f_bsize;
  unsigned long f_frsize;
  fsblkcnt_t f_blocks;
  fsblkcnt_t f_bfree;
  fsblkcnt_t f_bavail;
  fsfilcnt_t f_files;
  fsfilcnt_t f_ffree;
  fsfilcnt_t f_favail;
  unsigned long f_fsid;
  int __f_unused;
  unsigned long f_flag;
  unsigned long f_namemax;
  int __f_spare[6];
}
 ;
struct statvfs64
{
  unsigned long f_bsize;
  unsigned long f_frsize;
  fsblkcnt64_t f_blocks;
  fsblkcnt64_t f_bfree;
  fsblkcnt64_t f_bavail;
  fsfilcnt64_t f_files;
  fsfilcnt64_t f_ffree;
  fsfilcnt64_t f_favail;
  unsigned long f_fsid;
  int __f_unused;
  unsigned long f_flag;
  unsigned long f_namemax;
  int __f_spare[6];
}
 ;

sys/types.h



typedef int ssize_t;

termios.h

#define TAB1	1024
#define CR3	12288
#define CRDLY	12288
#define FF1	16384
#define FFDLY	16384
#define XCASE	16384
#define ONLCR	2
#define TAB2	2048
#define TAB3	3072
#define TABDLY	3072
#define BS1	32768
#define BSDLY	32768
#define OLCUC	4
#define CR1	4096
#define IUCLC	4096
#define VT1	65536
#define VTDLY	65536
#define NLDLY	768
#define CR2	8192









#define VWERASE	10
#define VREPRINT	11
#define VSUSP	12
#define VSTART	13
#define VSTOP	14
#define VDISCARD	16
#define VMIN	5
#define VEOL	6
#define VEOL2	8
#define VSWTC	9



#define IXOFF	1024
#define IXON	512






#define CSTOPB	1024
#define HUPCL	16384
#define CREAD	2048
#define CS6	256
#define CLOCAL	32768
#define PARENB	4096
#define CS7	512
#define VTIME	7
#define CS8	768
#define CSIZE	768
#define PARODD	8192



#define NOFLSH	-2147483648
#define ECHOKE	1
#define IEXTEN	1024
#define ISIG	128
#define ECHONL	16
#define ECHOE	2
#define ICANON	256
#define ECHOPRT	32
#define ECHOK	4
#define TOSTOP	4194304
#define PENDIN	536870912
#define ECHOCTL	64
#define FLUSHO	8388608

ucontext.h



struct pt_regs
{
  unsigned long gpr[32];
  unsigned long nip;
  unsigned long msr;
  unsigned long orig_gpr3;
  unsigned long ctr;
  unsigned long link;
  unsigned long xer;
  unsigned long ccr;
  unsigned long mq;
  unsigned long trap;
  unsigned long dar;
  unsigned long dsisr;
  unsigned long result;
}
 ;



#define NGREG	48




















typedef struct sigcontext mcontext_t;


typedef struct ucontext
{
  unsigned long uc_flags;
  struct ucontext *uc_link;
  stack_t uc_stack;
  mcontext_t uc_mcontext;
  sigset_t uc_sigmask;
}
ucontext_t;

unistd.h



typedef int intptr_t;

Interfaces for libm

Table 16-31. libm Definition

Library:	libm
SONAME:	libm.so.6

The behavior of the interfaces in this library is specified by the following standards.

ISO/IEC 9899: 1999, Programming Languages --C[10]

CAE Specification, January 1997, System Interfaces and Headers (XSH),Issue 5 (ISBN: 1-85912-181-0, C606)[11]

Math

Table 16-32. libm - Math Function Interfaces

acos(GLIBC_2.0)[11]	ceill(GLIBC_2.0)[10]	erfl(GLIBC_2.0)[10]	j1f(GLIBC_2.0)[10]	remainder(GLIBC_2.0)[11]
acosf(GLIBC_2.0)[10]	cexp(GLIBC_2.0)[10]	exp(GLIBC_2.0)[11]	j1l(GLIBC_2.0)[10]	remainderf(GLIBC_2.0)[10]
acosh(GLIBC_2.0)[11]	cexpf(GLIBC_2.0)[10]	expf(GLIBC_2.0)[10]	jn(GLIBC_2.0)[11]	remainderl(GLIBC_2.0)[10]
acoshf(GLIBC_2.0)[10]	cexpl(GLIBC_2.0)[10]	expl(GLIBC_2.0)[10]	jnf(GLIBC_2.0)[10]	remquo(GLIBC_2.0)[10]
acoshl(GLIBC_2.0)[10]	cimag(GLIBC_2.0)[10]	expm1(GLIBC_2.0)[11]	jnl(GLIBC_2.0)[10]	remquof(GLIBC_2.0)[10]
acosl(GLIBC_2.0)[10]	cimagf(GLIBC_2.0)[10]	fabs(GLIBC_2.0)[11]	ldexp(GLIBC_2.0)[11]	remquol(GLIBC_2.0)[10]
asin(GLIBC_2.0)[11]	cimagl(GLIBC_2.0)[10]	fabsf(GLIBC_2.0)[10]	ldexpf(GLIBC_2.0)[10]	rint(GLIBC_2.0)[11]
asinf(GLIBC_2.0)[10]	clog(GLIBC_2.0)[10]	fabsl(GLIBC_2.0)[10]	ldexpl(GLIBC_2.0)[10]	rintf(GLIBC_2.0)[10]
asinh(GLIBC_2.0)[11]	clog10(GLIBC_2.0)[10]	fdim(GLIBC_2.0)[10]	lgamma(GLIBC_2.0)[11]	rintl(GLIBC_2.0)[10]
asinhf(GLIBC_2.0)[10]	clog10f(GLIBC_2.0)[10]	fdimf(GLIBC_2.0)[10]	lgamma_r(GLIBC_2.0)[10]	round(GLIBC_2.0)[10]
asinhl(GLIBC_2.0)[10]	clog10l(GLIBC_2.0)[10]	fdiml(GLIBC_2.0)[10]	lgammaf(GLIBC_2.0)[10]	roundf(GLIBC_2.0)[10]
asinl(GLIBC_2.0)[10]	clogf(GLIBC_2.0)[10]	feclearexcept(GLIBC_2.0)[10]	lgammaf_r(GLIBC_2.0)[10]	roundl(GLIBC_2.0)[10]
atan(GLIBC_2.0)[11]	clogl(GLIBC_2.0)[10]	fegetenv(GLIBC_2.0)[10]	lgammal(GLIBC_2.0)[10]	scalb(GLIBC_2.0)[11]
atan2(GLIBC_2.0)[11]	conj(GLIBC_2.0)[10]	fegetexceptflag(GLIBC_2.0)[10]	lgammal_r(GLIBC_2.0)[10]	scalbf(GLIBC_2.0)[10]
atan2f(GLIBC_2.0)[10]	conjf(GLIBC_2.0)[10]	fegetround(GLIBC_2.0)[10]	llrint(GLIBC_2.0)[10]	scalbl(GLIBC_2.0)[10]
atan2l(GLIBC_2.0)[10]	conjl(GLIBC_2.0)[10]	feholdexcept(GLIBC_2.0)[10]	llrintf(GLIBC_2.0)[10]	scalbln(GLIBC_2.0)[10]
atanf(GLIBC_2.0)[10]	copysign(GLIBC_2.0)[10]	feraiseexcept(GLIBC_2.0)[10]	llrintl(GLIBC_2.0)[10]	scalblnf(GLIBC_2.0)[10]
atanh(GLIBC_2.0)[11]	copysignf(GLIBC_2.0)[10]	fesetenv(GLIBC_2.0)[10]	llround(GLIBC_2.0)[10]	scalblnl(GLIBC_2.0)[10]
atanhf(GLIBC_2.0)[10]	copysignl(GLIBC_2.0)[10]	fesetexceptflag(GLIBC_2.0)[10]	llroundf(GLIBC_2.0)[10]	scalbn(GLIBC_2.0)[10]
atanhl(GLIBC_2.0)[10]	cos(GLIBC_2.0)[11]	fesetround(GLIBC_2.0)[10]	llroundl(GLIBC_2.0)[10]	scalbnf(GLIBC_2.0)[10]
atanl(GLIBC_2.0)[10]	cosf(GLIBC_2.0)[10]	fetestexcept(GLIBC_2.0)[10]	log(GLIBC_2.0)[11]	scalbnl(GLIBC_2.0)[10]
cabs(GLIBC_2.1)[11]	cosh(GLIBC_2.1)[11]	feupdateenv(GLIBC_2.1)[10]	log10(GLIBC_2.1)[11]	significand(GLIBC_2.1)[10]
cabsf(GLIBC_2.1)[10]	coshf(GLIBC_2.1)[10]	finite(GLIBC_2.1)[11]	log10f(GLIBC_2.1)[10]	significandf(GLIBC_2.1)[10]
cabsl(GLIBC_2.1)[10]	coshl(GLIBC_2.1)[10]	finitef(GLIBC_2.1)[10]	log10l(GLIBC_2.1)[10]	significandl(GLIBC_2.1)[10]
cacos(GLIBC_2.1)[10]	cosl(GLIBC_2.1)[10]	finitel(GLIBC_2.1)[10]	log1p(GLIBC_2.1)[11]	sin(GLIBC_2.1)[11]
cacosf(GLIBC_2.1)[10]	cpow(GLIBC_2.1)[10]	floor(GLIBC_2.1)[11]	logb(GLIBC_2.1)[11]	sincos(GLIBC_2.1)[10]
cacosh(GLIBC_2.1)[10]	cpowf(GLIBC_2.1)[10]	floorf(GLIBC_2.1)[10]	logf(GLIBC_2.1)[10]	sincosf(GLIBC_2.1)[10]
cacoshf(GLIBC_2.1)[10]	cpowl(GLIBC_2.1)[10]	floorl(GLIBC_2.1)[10]	logl(GLIBC_2.1)[10]	sincosl(GLIBC_2.1)[10]
cacoshl(GLIBC_2.1)[10]	cproj(GLIBC_2.1)[10]	fma(GLIBC_2.1)[10]	lrint(GLIBC_2.1)[10]	sinf(GLIBC_2.1)[10]
cacosl(GLIBC_2.1)[10]	cprojf(GLIBC_2.1)[10]	fmaf(GLIBC_2.1)[10]	lrintf(GLIBC_2.1)[10]	sinh(GLIBC_2.1)[11]
carg(GLIBC_2.1)[10]	cprojl(GLIBC_2.1)[10]	fmal(GLIBC_2.1)[10]	lrintl(GLIBC_2.1)[10]	sinhf(GLIBC_2.1)[10]
cargf(GLIBC_2.1)[10]	creal(GLIBC_2.1)[10]	fmax(GLIBC_2.1)[10]	lround(GLIBC_2.1)[10]	sinhl(GLIBC_2.1)[10]
cargl(GLIBC_2.1)[10]	crealf(GLIBC_2.1)[10]	fmaxf(GLIBC_2.1)[10]	lroundf(GLIBC_2.1)[10]	sinl(GLIBC_2.1)[10]
casin(GLIBC_2.1)[10]	creall(GLIBC_2.1)[10]	fmaxl(GLIBC_2.1)[10]	lroundl(GLIBC_2.1)[10]	sqrt(GLIBC_2.1)[11]
casinf(GLIBC_2.1)[10]	csin(GLIBC_2.1)[10]	fmin(GLIBC_2.1)[10]	matherr(GLIBC_2.1)[10]	sqrtf(GLIBC_2.1)[10]
casinh(GLIBC_2.1)[10]	csinf(GLIBC_2.1)[10]	fminf(GLIBC_2.1)[10]	modf(GLIBC_2.1)[11]	tan(GLIBC_2.1)[11]
casinhf(GLIBC_2.1)[10]	csinh(GLIBC_2.1)[10]	fminl(GLIBC_2.1)[10]	modff(GLIBC_2.1)[10]	tanf(GLIBC_2.1)[10]
casinhl(GLIBC_2.1)[10]	csinhf(GLIBC_2.1)[10]	fmod(GLIBC_2.1)[11]	modfl(GLIBC_2.1)[10]	tanh(GLIBC_2.1)[11]
casinl(GLIBC_2.1)[10]	csinhl(GLIBC_2.1)[10]	fmodf(GLIBC_2.1)[10]	nan(GLIBC_2.1)[10]	tanhf(GLIBC_2.1)[10]
catan(GLIBC_2.1)[10]	csinl(GLIBC_2.1)[10]	fmodl(GLIBC_2.1)[10]	nanf(GLIBC_2.1)[10]	tanhl(GLIBC_2.1)[10]
catanf(GLIBC_2.1)[10]	csqrt(GLIBC_2.1)[10]	frexp(GLIBC_2.1)[11]	nanl(GLIBC_2.1)[10]	tanl(GLIBC_2.1)[10]
catanh(GLIBC_2.1)[10]	csqrtf(GLIBC_2.1)[10]	frexpf(GLIBC_2.1)[10]	nearbyint(GLIBC_2.1)[10]	tgamma(GLIBC_2.1)[10]
catanhf(GLIBC_2.1)[10]	csqrtl(GLIBC_2.1)[10]	frexpl(GLIBC_2.1)[10]	nearbyintf(GLIBC_2.1)[10]	tgammaf(GLIBC_2.1)[10]
catanhl(GLIBC_2.1)[10]	ctan(GLIBC_2.1)[10]	gamma(GLIBC_2.1)[11]	nearbyintl(GLIBC_2.1)[10]	tgammal(GLIBC_2.1)[10]
catanl(GLIBC_2.1)[10]	ctanf(GLIBC_2.1)[10]	gammaf(GLIBC_2.1)[10]	nextafter(GLIBC_2.1)[11]	trunc(GLIBC_2.1)[10]
cbrt(GLIBC_2.0)[11]	ctanh(GLIBC_2.0)[10]	gammal(GLIBC_2.0)[10]	nextafterf(GLIBC_2.0)[10]	truncf(GLIBC_2.0)[10]
cbrtf(GLIBC_2.0)[10]	ctanhf(GLIBC_2.0)[10]	hypot(GLIBC_2.0)[11]	nextafterl(GLIBC_2.0)[10]	truncl(GLIBC_2.0)[10]
cbrtl(GLIBC_2.0)[10]	ctanhl(GLIBC_2.0)[10]	hypotf(GLIBC_2.0)[10]	nexttoward(GLIBC_2.0)[10]	y0(GLIBC_2.0)[11]
ccos(GLIBC_2.1)[10]	ctanl(GLIBC_2.1)[10]	hypotl(GLIBC_2.1)[10]	nexttowardf(GLIBC_2.1)[10]	y0f(GLIBC_2.1)[10]
ccosf(GLIBC_2.1)[10]	dremf(GLIBC_2.1)[10]	ilogb(GLIBC_2.1)[11]	nexttowardl(GLIBC_2.1)[10]	y0l(GLIBC_2.1)[10]
ccosh(GLIBC_2.1)[10]	dreml(GLIBC_2.1)[10]	ilogbf(GLIBC_2.1)[10]	pow(GLIBC_2.1)[10]	y1(GLIBC_2.1)[11]
ccoshf(GLIBC_2.1)[10]	erf(GLIBC_2.1)[11]	ilogbl(GLIBC_2.1)[10]	pow10(GLIBC_2.1)[10]	y1f(GLIBC_2.1)[10]
ccoshl(GLIBC_2.1)[10]	erfc(GLIBC_2.1)[11]	j0(GLIBC_2.1)[11]	pow10f(GLIBC_2.1)[10]	y1l(GLIBC_2.1)[10]
ccosl(GLIBC_2.1)[10]	erfcf(GLIBC_2.1)[10]	j0f(GLIBC_2.1)[10]	pow10l(GLIBC_2.1)[10]	yn(GLIBC_2.1)[11]
ceil(GLIBC_2.0)[11]	erfcl(GLIBC_2.0)[10]	j0l(GLIBC_2.0)[10]	powf(GLIBC_2.0)[10]	ynf(GLIBC_2.0)[10]
ceilf(GLIBC_2.0)[10]	erff(GLIBC_2.0)[10]	j1(GLIBC_2.0)[11]	powl(GLIBC_2.0)[10]	ynl(GLIBC_2.0)[10]

Table 16-33. libm - Math Data Interfaces

signgam(GLIBC_2.0)[11]

Data Definitions for libm

Interfaces for libpthread

Table 16-34. libpthread Definition

Library:	libpthread
SONAME:	libpthread.so.0

The behavior of the interfaces in this library is specified by the following standards.

Linux Standard Base[12]

CAE Specification, January 1997, System Interfaces and Headers (XSH),Issue 5 (ISBN: 1-85912-181-0, C606)[13]

Posix Threads

Table 16-35. libpthread - Posix Threads Function Interfaces

pthread_attr_destroy(GLIBC_2.0)[13]	pthread_attr_setstackaddr(GLIBC_2.0)[13]	pthread_getspecific(GLIBC_2.0)[13]	pthread_once(GLIBC_2.0)[13]	pthread_setcanceltype(GLIBC_2.0)[13]
pthread_attr_getdetachstate(GLIBC_2.0)[13]	pthread_attr_setstacksize(GLIBC_2.0)[13]	pthread_join(GLIBC_2.0)[13]	pthread_rwlock_destroy(GLIBC_2.0)[13]	pthread_setconcurrency(GLIBC_2.0)[13]
pthread_attr_getguardsize(GLIBC_2.1)[13]	pthread_cancel(GLIBC_2.1)[13]	pthread_key_create(GLIBC_2.1)[13]	pthread_rwlock_init(GLIBC_2.1)[13]	pthread_setschedparam(GLIBC_2.1)[13]
pthread_attr_getinheritsched(GLIBC_2.0)[13]	pthread_cond_broadcast(GLIBC_2.0)[13]	pthread_key_delete(GLIBC_2.0)[13]	pthread_rwlock_rdlock(GLIBC_2.0)[13]	pthread_setspecific(GLIBC_2.0)[13]
pthread_attr_getschedparam(GLIBC_2.0)[13]	pthread_cond_destroy(GLIBC_2.0)[13]	pthread_kill(GLIBC_2.0)[13]	pthread_rwlock_timedrdlock(GLIBC_2.0)[13]	pthread_sigmask(GLIBC_2.0)[13]
pthread_attr_getschedpolicy(GLIBC_2.0)[13]	pthread_cond_init(GLIBC_2.0)[13]	pthread_mutex_destroy(GLIBC_2.0)[13]	pthread_rwlock_timedwrlock(GLIBC_2.0)[13]	pthread_testcancel(GLIBC_2.0)[13]
pthread_attr_getscope(GLIBC_2.0)[13]	pthread_cond_signal(GLIBC_2.0)[13]	pthread_mutex_init(GLIBC_2.0)[13]	pthread_rwlock_tryrdlock(GLIBC_2.0)[13]	sem_close(GLIBC_2.0)[13]
pthread_attr_getstackaddr(GLIBC_2.1)[13]	pthread_cond_timedwait(GLIBC_2.1)[13]	pthread_mutex_lock(GLIBC_2.1)[13]	pthread_rwlock_trywrlock(GLIBC_2.1)[13]	sem_destroy(GLIBC_2.1)[13]
pthread_attr_getstacksize(GLIBC_2.1)[13]	pthread_cond_wait(GLIBC_2.1)[13]	pthread_mutex_trylock(GLIBC_2.1)[13]	pthread_rwlock_unlock(GLIBC_2.1)[13]	sem_getvalue(GLIBC_2.1)[13]
pthread_attr_init(GLIBC_2.1)[13]	pthread_condattr_destroy(GLIBC_2.1)[13]	pthread_mutex_unlock(GLIBC_2.1)[13]	pthread_rwlock_wrlock(GLIBC_2.1)[13]	sem_init(GLIBC_2.1)[13]
pthread_attr_setdetachstate(GLIBC_2.0)[13]	pthread_condattr_init(GLIBC_2.0)[13]	pthread_mutexattr_destroy(GLIBC_2.0)[13]	pthread_rwlockattr_destroy(GLIBC_2.0)[13]	sem_open(GLIBC_2.0)[13]
pthread_attr_setguardsize(GLIBC_2.1)[13]	pthread_create(GLIBC_2.1)[13]	pthread_mutexattr_getpshared(GLIBC_2.1)[13]	pthread_rwlockattr_getpshared(GLIBC_2.1)[13]	sem_post(GLIBC_2.1)[13]
pthread_attr_setinheritsched(GLIBC_2.0)[13]	pthread_detach(GLIBC_2.0)[13]	pthread_mutexattr_gettype(GLIBC_2.0)[13]	pthread_rwlockattr_init(GLIBC_2.0)[13]	sem_timedwait(GLIBC_2.0)[12]
pthread_attr_setschedparam(GLIBC_2.0)[13]	pthread_equal(GLIBC_2.0)[13]	pthread_mutexattr_init(GLIBC_2.0)[13]	pthread_rwlockattr_setpshared(GLIBC_2.0)[13]	sem_trywait(GLIBC_2.0)[13]
pthread_attr_setschedpolicy(GLIBC_2.0)[13]	pthread_exit(GLIBC_2.0)[13]	pthread_mutexattr_setpshared(GLIBC_2.0)[13]	pthread_self(GLIBC_2.0)[13]	sem_unlink(GLIBC_2.0)[13]
pthread_attr_setscope(GLIBC_2.0)[13]	pthread_getschedparam(GLIBC_2.0)[13]	pthread_mutexattr_settype(GLIBC_2.0)[13]	pthread_setcancelstate(GLIBC_2.0)[13]	sem_wait(GLIBC_2.0)[13]

Data Definitions for libpthread

Interfaces for libdl

Table 16-36. libdl Definition

Library:	libdl
SONAME:	libdl.so.2

Dynamic Loader

Data Definitions for libdl

Interfaces for libcrypt

Table 16-37. libcrypt Definition

Library:	libcrypt
SONAME:	libcrypt.so.1

Encryption

Data Definitions for libcrypt

VI. Package Format and Installation

Table of Contents
17. Software Installation

Chapter 17. Software Installation

Package Architecture Considerations

All packages must specify an architecture of ppc. A LSB runtime environment must accept an architecture of ppc even if the native architecture is different.

The archnum value in the Lead Section shall be 0x0005.

Appendix A. Alphabetical Listing of Interfaces

Appendix B. GNU Free Documentation License

Version 1.1, March 2000

Copyright (C) 2000 Free Software Foundation, Inc. 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA Everyone is permitted to copy and distribute verbatim copies of this license document, but changing it is not allowed.

PREAMBLE

The purpose of this License is to make a manual, textbook, or other written document "free" in the sense of freedom: to assure everyone the effective freedom to copy and redistribute it, with or without modifying it, either commercially or noncommercially. Secondarily, this License preserves for the author and publisher a way to get credit for their work, while not being considered responsible for modifications made by others.

This License is a kind of "copyleft", which means that derivative works of the document must themselves be free in the same sense. It complements the GNU General Public License, which is a copyleft license designed for free software.

We have designed this License in order to use it for manuals for free software, because free software needs free documentation: a free program should come with manuals providing the same freedoms that the software does. But this License is not limited to software manuals; it can be used for any textual work, regardless of subject matter or whether it is published as a printed book. We recommend this License principally for works whose purpose is instruction or reference.

APPLICABILITY AND DEFINITIONS

This License applies to any manual or other work that contains a notice placed by the copyright holder saying it can be distributed under the terms of this License. The "Document", below, refers to any such manual or work. Any member of the public is a licensee, and is addressed as "you".

A "Modified Version" of the Document means any work containing the Document or a portion of it, either copied verbatim, or with modifications and/or translated into another language.

A "Secondary Section" is a named appendix or a front-matter section of the Document that deals exclusively with the relationship of the publishers or authors of the Document to the Document's overall subject (or to related matters) and contains nothing that could fall directly within that overall subject. (For example, if the Document is in part a textbook of mathematics, a Secondary Section may not explain any mathematics.) The relationship could be a matter of historical connection with the subject or with related matters, or of legal, commercial, philosophical, ethical or political position regarding them.

The "Invariant Sections" are certain Secondary Sections whose titles are designated, as being those of Invariant Sections, in the notice that says that the Document is released under this License.

The "Cover Texts" are certain short passages of text that are listed, as Front-Cover Texts or Back-Cover Texts, in the notice that says that the Document is released under this License.

A "Transparent" copy of the Document means a machine-readable copy, represented in a format whose specification is available to the general public, whose contents can be viewed and edited directly and straightforwardly with generic text editors or (for images composed of pixels) generic paint programs or (for drawings) some widely available drawing editor, and that is suitable for input to text formatters or for automatic translation to a variety of formats suitable for input to text formatters. A copy made in an otherwise Transparent file format whose markup has been designed to thwart or discourage subsequent modification by readers is not Transparent. A copy that is not "Transparent" is called "Opaque".

Examples of suitable formats for Transparent copies include plain ASCII without markup, Texinfo input format, LaTeX input format, SGML or XML using a publicly available DTD, and standard-conforming simple HTML designed for human modification. Opaque formats include PostScript, PDF, proprietary formats that can be read and edited only by proprietary word processors, SGML or XML for which the DTD and/or processing tools are not generally available, and the machine-generated HTML produced by some word processors for output purposes only.

The "Title Page" means, for a printed book, the title page itself, plus such following pages as are needed to hold, legibly, the material this License requires to appear in the title page. For works in formats which do not have any title page as such, "Title Page" means the text near the most prominent appearance of the work's title, preceding the beginning of the body of the text.

VERBATIM COPYING

You may copy and distribute the Document in any medium, either commercially or noncommercially, provided that this License, the copyright notices, and the license notice saying this License applies to the Document are reproduced in all copies, and that you add no other conditions whatsoever to those of this License. You may not use technical measures to obstruct or control the reading or further copying of the copies you make or distribute. However, you may accept compensation in exchange for copies. If you distribute a large enough number of copies you must also follow the conditions in section 3.

You may also lend copies, under the same conditions stated above, and you may publicly display copies.

COPYING IN QUANTITY

If you publish printed copies of the Document numbering more than 100, and the Document's license notice requires Cover Texts, you must enclose the copies in covers that carry, clearly and legibly, all these Cover Texts: Front-Cover Texts on the front cover, and Back-Cover Texts on the back cover. Both covers must also clearly and legibly identify you as the publisher of these copies. The front cover must present the full title with all words of the title equally prominent and visible. You may add other material on the covers in addition. Copying with changes limited to the covers, as long as they preserve the title of the Document and satisfy these conditions, can be treated as verbatim copying in other respects.

If the required texts for either cover are too voluminous to fit legibly, you should put the first ones listed (as many as fit reasonably) on the actual cover, and continue the rest onto adjacent pages.

If you publish or distribute Opaque copies of the Document numbering more than 100, you must either include a machine-readable Transparent copy along with each Opaque copy, or state in or with each Opaque copy a publicly-accessible computer-network location containing a complete Transparent copy of the Document, free of added material, which the general network-using public has access to download anonymously at no charge using public-standard network protocols. If you use the latter option, you must take reasonably prudent steps, when you begin distribution of Opaque copies in quantity, to ensure that this Transparent copy will remain thus accessible at the stated location until at least one year after the last time you distribute an Opaque copy (directly or through your agents or retailers) of that edition to the public.

It is requested, but not required, that you contact the authors of the Document well before redistributing any large number of copies, to give them a chance to provide you with an updated version of the Document.

MODIFICATIONS

You may copy and distribute a Modified Version of the Document under the conditions of sections 2 and 3 above, provided that you release the Modified Version under precisely this License, with the Modified Version filling the role of the Document, thus licensing distribution and modification of the Modified Version to whoever possesses a copy of it. In addition, you must do these things in the Modified Version:

Use in the Title Page (and on the covers, if any) a title distinct from that of the Document, and from those of previous versions (which should, if there were any, be listed in the History section of the Document). You may use the same title as a previous version if the original publisher of that version gives permission.
List on the Title Page, as authors, one or more persons or entities responsible for authorship of the modifications in the Modified Version, together with at least five of the principal authors of the Document (all of its principal authors, if it has less than five).
State on the Title page the name of the publisher of the Modified Version, as the publisher.
Preserve all the copyright notices of the Document.
Add an appropriate copyright notice for your modifications adjacent to the other copyright notices.
Include, immediately after the copyright notices, a license notice giving the public permission to use the Modified Version under the terms of this License, in the form shown in the Addendum below.
Preserve in that license notice the full lists of Invariant Sections and required Cover Texts given in the Document's license notice.
Include an unaltered copy of this License.
Preserve the section entitled "History", and its title, and add to it an item stating at least the title, year, new authors, and publisher of the Modified Version as given on the Title Page. If there is no section entitled "History" in the Document, create one stating the title, year, authors, and publisher of the Document as given on its Title Page, then add an item describing the Modified Version as stated in the previous sentence.
Preserve the network location, if any, given in the Document for public access to a Transparent copy of the Document, and likewise the network locations given in the Document for previous versions it was based on. These may be placed in the "History" section. You may omit a network location for a work that was published at least four years before the Document itself, or if the original publisher of the version it refers to gives permission.
In any section entitled "Acknowledgements" or "Dedications", preserve the section's title, and preserve in the section all the substance and tone of each of the contributor acknowledgements and/or dedications given therein.
Preserve all the Invariant Sections of the Document, unaltered in their text and in their titles. Section numbers or the equivalent are not considered part of the section titles.
Delete any section entitled "Endorsements". Such a section may not be included in the Modified Version.
Do not retitle any existing section as "Endorsements" or to conflict in title with any Invariant Section.

If the Modified Version includes new front-matter sections or appendices that qualify as Secondary Sections and contain no material copied from the Document, you may at your option designate some or all of these sections as invariant. To do this, add their titles to the list of Invariant Sections in the Modified Version's license notice. These titles must be distinct from any other section titles.

You may add a section entitled "Endorsements", provided it contains nothing but endorsements of your Modified Version by various parties--for example, statements of peer review or that the text has been approved by an organization as the authoritative definition of a standard.

You may add a passage of up to five words as a Front-Cover Text, and a passage of up to 25 words as a Back-Cover Text, to the end of the list of Cover Texts in the Modified Version. Only one passage of Front-Cover Text and one of Back-Cover Text may be added by (or through arrangements made by) any one entity. If the Document already includes a cover text for the same cover, previously added by you or by arrangement made by the same entity you are acting on behalf of, you may not add another; but you may replace the old one, on explicit permission from the previous publisher that added the old one.

The author(s) and publisher(s) of the Document do not by this License give permission to use their names for publicity for or to assert or imply endorsement of any Modified Version.

COMBINING DOCUMENTS

You may combine the Document with other documents released under this License, under the terms defined in section 4 above for modified versions, provided that you include in the combination all of the Invariant Sections of all of the original documents, unmodified, and list them all as Invariant Sections of your combined work in its license notice.

The combined work need only contain one copy of this License, and multiple identical Invariant Sections may be replaced with a single copy. If there are multiple Invariant Sections with the same name but different contents, make the title of each such section unique by adding at the end of it, in parentheses, the name of the original author or publisher of that section if known, or else a unique number. Make the same adjustment to the section titles in the list of Invariant Sections in the license notice of the combined work.

In the combination, you must combine any sections entitled "History" in the various original documents, forming one section entitled "History"; likewise combine any sections entitled "Acknowledgements", and any sections entitled "Dedications". You must delete all sections entitled "Endorsements."

COLLECTIONS OF DOCUMENTS

You may make a collection consisting of the Document and other documents released under this License, and replace the individual copies of this License in the various documents with a single copy that is included in the collection, provided that you follow the rules of this License for verbatim copying of each of the documents in all other respects.

You may extract a single document from such a collection, and distribute it individually under this License, provided you insert a copy of this License into the extracted document, and follow this License in all other respects regarding verbatim copying of that document.

AGGREGATION WITH INDEPENDENT WORKS

A compilation of the Document or its derivatives with other separate and independent documents or works, in or on a volume of a storage or distribution medium, does not as a whole count as a Modified Version of the Document, provided no compilation copyright is claimed for the compilation. Such a compilation is called an "aggregate", and this License does not apply to the other self-contained works thus compiled with the Document, on account of their being thus compiled, if they are not themselves derivative works of the Document.

If the Cover Text requirement of section 3 is applicable to these copies of the Document, then if the Document is less than one quarter of the entire aggregate, the Document's Cover Texts may be placed on covers that surround only the Document within the aggregate. Otherwise they must appear on covers around the whole aggregate.

TRANSLATION

Translation is considered a kind of modification, so you may distribute translations of the Document under the terms of section 4. Replacing Invariant Sections with translations requires special permission from their copyright holders, but you may include translations of some or all Invariant Sections in addition to the original versions of these Invariant Sections. You may include a translation of this License provided that you also include the original English version of this License. In case of a disagreement between the translation and the original English version of this License, the original English version will prevail.

TERMINATION

You may not copy, modify, sublicense, or distribute the Document except as expressly provided for under this License. Any other attempt to copy, modify, sublicense or distribute the Document is void, and will automatically terminate your rights under this License. However, parties who have received copies, or rights, from you under this License will not have their licenses terminated so long as such parties remain in full compliance.

FUTURE REVISIONS OF THIS LICENSE

The Free Software Foundation may publish new, revised versions of the GNU Free Documentation License from time to time. Such new versions will be similar in spirit to the present version, but may differ in detail to address new problems or concerns. See http://www.gnu.org/copyleft/.

Each version of the License is given a distinguishing version number. If the Document specifies that a particular numbered version of this License "or any later version" applies to it, you have the option of following the terms and conditions either of that specified version or of any later version that has been published (not as a draft) by the Free Software Foundation. If the Document does not specify a version number of this License, you may choose any version ever published (not as a draft) by the Free Software Foundation.

How to use this License for your documents

To use this License in a document you have written, include a copy of the License in the document and put the following copyright and license notices just after the title page:

Copyright (c) YEAR YOUR NAME. Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.1 or any later version published by the Free Software Foundation; with the Invariant Sections being LIST THEIR TITLES, with the Front-Cover Texts being LIST, and with the Back-Cover Texts being LIST. A copy of the license is included in the section entitled "GNU Free Documentation License".

If you have no Invariant Sections, write "with no Invariant Sections" instead of saying which ones are invariant. If you have no Front-Cover Texts, write "no Front-Cover Texts" instead of "Front-Cover Texts being LIST"; likewise for Back-Cover Texts.

If your document contains nontrivial examples of program code, we recommend releasing these examples in parallel under your choice of free software license, such as the GNU General Public License, to permit their use in free software.