Linux Standard Base (LSB)

Noyau de base normalisé Linux (LSB)

General Information

Status
Published
Current Stage
4060 - Close of voting
Start Date
09-May-2020
Completion Date
08-May-2020
Ref Project

RELATIONS

Buy Standard

Draft
ISO/IEC DIS 23360-1-2 - Linux Standard Base (LSB)
English language
1046 pages
sale 15% off
Preview
sale 15% off
Preview

Standards Content (sample)

DRAFT INTERNATIONAL STANDARD
ISO/IEC DIS 23360-1-2
ISO/IEC JTC 1/SC 22 Secretariat: ANSI
Voting begins on: Voting terminates on:
2020-02-14 2020-05-08
Linux Standard Base (LSB) —
Part 1-2:
Core specification generic part
ICS: 35.080
THIS DOCUMENT IS A DRAFT CIRCULATED
FOR COMMENT AND APPROVAL. IT IS
THEREFORE SUBJECT TO CHANGE AND MAY
NOT BE REFERRED TO AS AN INTERNATIONAL
STANDARD UNTIL PUBLISHED AS SUCH.
IN ADDITION TO THEIR EVALUATION AS
BEING ACCEPTABLE FOR INDUSTRIAL,
This document is circulated as received from the committee secretariat.
TECHNOLOGICAL, COMMERCIAL AND
USER PURPOSES, DRAFT INTERNATIONAL
STANDARDS MAY ON OCCASION HAVE TO
BE CONSIDERED IN THE LIGHT OF THEIR
POTENTIAL TO BECOME STANDARDS TO
WHICH REFERENCE MAY BE MADE IN
Reference number
NATIONAL REGULATIONS.
ISO/IEC DIS 23360-1-2:2020(E)
RECIPIENTS OF THIS DRAFT ARE INVITED
TO SUBMIT, WITH THEIR COMMENTS,
NOTIFICATION OF ANY RELEVANT PATENT
RIGHTS OF WHICH THEY ARE AWARE AND TO
PROVIDE SUPPORTING DOCUMENTATION. ISO/IEC 2020
---------------------- Page: 1 ----------------------
ISO/IEC DIS 23360-1-2:2020(E)
COPYRIGHT PROTECTED DOCUMENT
© ISO/IEC 2020

All rights reserved. Unless otherwise specified, or required in the context of its implementation, no part of this publication may

be reproduced or utilized otherwise in any form or by any means, electronic or mechanical, including photocopying, or posting

on the internet or an intranet, without prior written permission. Permission can be requested from either ISO at the address

below or ISO’s member body in the country of the requester.
ISO copyright office
CP 401 • Ch. de Blandonnet 8
CH-1214 Vernier, Geneva
Phone: +41 22 749 01 11
Fax: +41 22 749 09 47
Email: copyright@iso.org
Website: www.iso.org
Published in Switzerland
ii © ISO/IEC 2020 – All rights reserved
---------------------- Page: 2 ----------------------
ISO/IEC DIS 23360-1-2:2020(E)
Contents

Contents .......................................................................................................................................................... iii

List of Tables ................................................................................................................................................ vii

Foreword ..................................................................................................................................................... xxii

Status of this Document .................................................................................................................... xxiv

Introduction ............................................................................................................................................... xxv

I Introductory Elements ............................................................................................................................. 1

1 Scope ................................................................................................................................................................ 2

1.1 General ...................................................................................................................................................... 2

1.2 Module Specific Scope ........................................................................................................................ 2

2 References ...................................................................................................................................................... 3

2.1 Normative References ........................................................................................................................ 3

2.2 Informative References/Bibliography......................................................................................... 5

3 Requirements ............................................................................................................................................... 8

3.1 Relevant Libraries ................................................................................................................................ 8

3.2 LSB Implementation Conformance............................................................................................... 8

3.3 LSB Application Conformance ...................................................................................................... 10

4 Terms and Definitions ............................................................................................................................ 11

5 Documentation Conventions ............................................................................................................... 13

6 Relationship To ISO/IEC 9945 POSIX .............................................................................................. 14

7 Relationship To Other Linux Foundation Specifications ......................................................... 15

II Executable And Linking Format (ELF) ............................................................................................ 16

8 Introduction ................................................................................................................................................ 17

9 Low Level System Information ........................................................................................................... 18

9.1 Operating System Interface ............................................................................................................ 18

9.2 Machine Interface ............................................................................................................................... 18

10 Object Format ............................................................................................................................................. 19

10.1 Object Files ......................................................................................................................................... 19

10.2 Sections ................................................................................................................................................ 19

10.3 Special Sections ................................................................................................................................ 23

10.4 Symbol Mapping ............................................................................................................................... 29

10.5 DWARF Extensions .......................................................................................................................... 29

10.6 Exception Frames ............................................................................................................................ 31

10.7 Symbol Versioning ........................................................................................................................... 36

10.8 ABI note tag ........................................................................................................................................ 40

11 Dynamic Linking ....................................................................................................................................... 41

11.1 Program Loading and Dynamic Linking ................................................................................ 41

11.2 Program Header ............................................................................................................................... 41

11.3 Dynamic Entries ............................................................................................................................... 41

12 C++ Class Representations ................................................................................................................... 46

12.1 C++ Data Representation.............................................................................................................. 46

13 Symbol Mapping ........................................................................................................................................ 50

13.1 Symbol Mapping ............................................................................................................................... 50

III Base Libraries ........................................................................................................................................ 51

14 Base Libraries ............................................................................................................................................. 52

14.1 Introduction ....................................................................................................................................... 52

14.2 Program Interpreter ....................................................................................................................... 52

14.3 Interfaces for libc ............................................................................................................................. 52

14.4 Data Definitions for libc ................................................................................................................ 72

14.5 Interface Definitions for libc .................................................................................................... 179

14.6 Interfaces for libm ........................................................................................................................ 391

© ISO/IEC 2020 – All rights reserved iii
---------------------- Page: 3 ----------------------
ISO/IEC DIS 23360-1-2:2020(E)

14.7 Data Definitions for libm ........................................................................................................... 394

14.8 Interface Definitions for libm .................................................................................................. 401

14.9 Interfaces for libpthread ............................................................................................................ 426

14.10 Data Definitions for libpthread ............................................................................................ 432

14.11 Interface Definitions for libpthread ................................................................................... 437

14.12 Interfaces for libgcc_s ............................................................................................................... 442

14.13 Data Definitions for libgcc_s .................................................................................................. 443

14.14 Interface Definitions for libgcc_s ......................................................................................... 444

14.15 Interfaces for libdl ..................................................................................................................... 450

14.16 Data Definitions for libdl......................................................................................................... 451

14.17 Interface Definitions for libdl ............................................................................................... 452

14.18 Interfaces for librt ...................................................................................................................... 455

14.19 Data Definitions for librt ......................................................................................................... 457

14.20 Interfaces for libcrypt .............................................................................................................. 459

14.21 Data Definitions for libcrypt.................................................................................................. 459

14.22 Interface Definitions for libcrypt ........................................................................................ 460

14.23 Interfaces for libpam ................................................................................................................ 462

14.24 Data Definitions for libpam ................................................................................................... 463

14.25 Interface Definitions for libpam .......................................................................................... 465

IV Utility Libraries .................................................................................................................................. 479

15 Utility Libraries ....................................................................................................................................... 480

15.1 Introduction .................................................................................................................................... 480

15.2 Interfaces for libz .......................................................................................................................... 480

15.3 Data Definitions for libz ............................................................................................................. 481

15.4 Interface Definitions for libz .................................................................................................... 484

15.5 Interfaces for libncurses ............................................................................................................ 531

15.6 Data Definitions for libncurses ............................................................................................... 535

15.7 Interface Definitions for libncurses ...................................................................................... 544

15.8 Interfaces for libncursesw ........................................................................................................ 552

15.9 Data Definitions for libncursesw ........................................................................................... 558

15.10 Interface Definitions for libncursesw ............................................................................... 585

15.11 Interfaces for libutil .................................................................................................................. 585

15.12 Data Definitions for libutil ..................................................................................................... 586

15.13 Interface Definitions for libutil ............................................................................................ 586

V C++ Libraries ......................................................................................................................................... 592

16 Libraries ..................................................................................................................................................... 593

16.1 Interfaces for libstdcxx ............................................................................................................... 593

16.2 Interface Definitions for libstdcxx ......................................................................................... 842

VI Commands and Utilities .................................................................................................................. 843

17 Commands and Utilities ...................................................................................................................... 844

17.1 Commands and Utilities ............................................................................................................. 844

17.2 Command Behavior ..................................................................................................................... 845

VII Execution Environment ................................................................................................................. 908

18 File System Hierarchy .......................................................................................................................... 909

18.1 /dev: Device Files ......................................................................................................................... 909

18.2 /etc: Host-specific system configuration ............................................................................ 909

18.3 User Accounting Databases ...................................................................................................... 911

18.4 Path For System Administration Utilities ........................................................................... 911

19 Additional Recommendations .......................................................................................................... 912

19.1 Recommendations for applications on ownership and permissions ................. 912

20 Additional Behaviors ............................................................................................................................ 914

iv © ISO/IEC 2020 – All rights reserved
---------------------- Page: 4 ----------------------
ISO/IEC DIS 23360-1-2:2020(E)

20.1 Mandatory Optional Behaviors............................................................................................... 914

20.2 Optional Mandatory Behaviors............................................................................................... 915

20.3 Executable Scripts ........................................................................................................................ 915

21 Localization .............................................................................................................................................. 917

21.1 Introduction .................................................................................................................................... 917

21.2 Regular Expressions .................................................................................................................... 917

21.3 Pattern Matching Notation ....................................................................................................... 917

VIII System Initialization ...................................................................................................................... 919

22 System Initialization ............................................................................................................................. 920

22.1 Cron Jobs ........................................................................................................................................... 920

22.2 Init Script Actions ......................................................................................................................... 921

22.3 Comment Conventions for Init Scripts ................................................................................ 923

22.4 Installation and Removal of Init Scripts.............................................................................. 925

22.5 Run Levels ........................................................................................................................................ 926

22.6 Facility Names ................................................................................................................................ 926

22.7 Script Names ................................................................................................................................... 927

22.8 Init Script Functions .................................................................................................................... 927

IX Users & Groups ................................................................................................................................... 930

23 Users & Groups ....................................................................................................................................... 931

23.1 User and Group Database .......................................................................................................... 931

23.2 User & Group Names ................................................................................................................... 931

23.3 User ID Ranges ............................................................................................................................... 932

23.4 Rationale ........................................................................................................................................... 932

X Network Security Services ............................................................................................................... 933

24 Libraries ..................................................................................................................................................... 934

24.1 Interfaces for libnspr4 ................................................................................................................ 934

24.2 Data Definitions for libnspr4 ................................................................................................... 935

24.3 Interfaces for libnss3 ................................................................................................................... 946

24.4 Data Definitions for libnss3 ...................................................................................................... 946

24.5 Interfaces for libssl3 .................................................................................................................... 969

24.6 Data Definitions for libssl3 ....................................................................................................... 971

XI Package Format and Installation ................................................................................................. 980

25 Software Installation ............................................................................................................................ 981

25.1 Introduction .................................................................................................................................... 981

25.2 Package File Format ..................................................................................................................... 981

25.3 Package Script Restrictions ................................................................................................... 1001

25.4 Package Tools .............................................................................................................................. 1001

25.5 Package Naming Conventions .............................................................................................. 1001

25.6 Package Dependencies ............................................................................................................ 1002

25.7 Package Architecture Considerations ............................................................................... 1003

Annex A Alphabetical Listing of Interfaces by Library ............................................................ 1004

A.1 libc ................................................................................................................................................................ 1004

A.2 libcrypt ....................................................................................................................................................... 1018

A.3 libdl .............................................................................................................................................................. 1019

A.4 libgcc_s ........................................................................................................................................................ 1019

A.5 libm .............................................................................................................................................................. 1019

A.6 libncurses .................................................................................................................................................. 1023

A.7 libncursesw .............................................................................................................................................. 1026

A.8 libpam ......................................................................................................................................................... 1032

A.9 libpthread .................................................................................................................................................. 1032

A.10 librt ............................................................................................................................................................ 1035

A.11 libutil ......................................................................................................................................................... 1036

© ISO/IEC 2020 – All rights reserved v
---------------------- Page: 5 ----------------------
ISO/IEC DIS 23360-1-2:2020(E)

A.12 libz ............................................................................................................................................................. 1036

A.13 libnspr4 ................................................................................................................................................... 1037

A.14 libnss3 ...................................................................................................................................................... 1039

A.15 libssl3 ....................................................................................................................................................... 1039

Annex B GNU Free Documentation License (Informative) ..................................................... 1041

B.1 PREAMBLE ................................................................................................................................................ 1041

B.2 APPLICABILITY AND DEFINITIONS .............................................................................................. 1041

B.3 VERBATIM COPYING ............................................................................................................................ 1042

B.4 COPYING IN QUANTITY....................................................................................................................... 1042

B.5 MODIFICATIONS ..................................................................................................................................... 1043

B.6 COMBINING DOCUMENTS ................................................................................................................. 1045

B.7 COLLECTIONS OF DOCUMENTS ...................................................................................................... 1045

B.8 AGGREGATION WITH INDEPENDENT WORKS ........................................................................ 1045

B.9 TRANSLATION ......................................................................................................................................... 1045

B.10 TERMINATION ...................................................................................................................................... 1046

B.11 FUTURE REVISIONS OF THIS LICENSE ..................................................................................... 1046

B.12 How to use this License for your documents .......................................................................... 1046

vi © ISO/IEC 2020 – All rights reserved
---------------------- Page: 6 ----------------------
ISO/IEC DIS 23360-1-2:2020(E)
List of Tables

Table 2-1 Normative References .............................................................................................................................. 3

Table 2-2 Other References ........................................................................................................................................ 5

Table 3-1 Standard Library Names ......................................................................................................................... 8

Table 3-2 Standard Library Names defined in the Architecture Specific Parts of the LSB Core

Specification ............................................................................................................................................................. 8

Table 9-1 Scalar Types ................................................................................................................................................ 18

Table 10-1 ELF Section Types .................................................................................................................................. 19

Table 10-2 Additional Section Types .................................................................................................................... 23

Table 10-3 ELF Special Sections ............................................................................................................................. 23

Table 10-4 Additional Special Sections ............................................................................................................... 27

Table 10-5 DWARF Exception Header value format ..................................................................................... 29

Table 10-6 DWARF Exception Header application......................................................................................... 30

Table 10-7 Additional DWARF Call Frame Instructions .............................................................................. 30

Table 10-8 Call Frame Information Format ....................................................................................................... 31

Table 10-9 Common Information Entry Format ...............................
...

Questions, Comments and Discussion

Ask us and Technical Secretary will try to provide an answer. You can facilitate discussion about the standard in here.