UNIX SVR4 Device Driver Interface/ Driver-Kerne/lnterface (OOIIOKI) Reference Manual

270 Pages·1990·16.507 MB·English

by  UNIX Software Operation

ATlaT
UNIX® SYSTEM V
RELEASE 4
Device Driver Interface/
Driver-Kerne/lnterface (OOIIOKI)
Reference Manual
UNIX Software Operation
Copyright 1990,1989,1988,1987,1986,1985,1984,1983 AT&T
All Rights Reserved
Printed In USA
Published by Prentice-Hall, Inc.
A Division of Simon & Schuster
Englewood Cliffs, New Jersey 07632
No part of this publication may be. reproduced or transmitted in any form or by any means-graphic,
electronic, electrical, mechanical, or chemical, including photocopying, recording in any medium, tap-
ing, by any computer or informatiOn storage and retrieval systems, etc., without prior permissions in
writing from AT&T.
IMPORTANT NOTE TO USERS
While every effOrt has been made to ensure the accuracy of all information in this document, AT&T
assumes no liability to any party for any loss or damage caused by errors or omissions or by state-
ments of any kind in this clQcument, its updates, supplements, or special editions, whether such er-
rors are omissions or statements resulting from negligence, accident, or any other cause. AT&T furth-
er assumes no liability arising out of the application or use of any product or system described
herein; nor any liability for incidental or consequential damages arising from the use of this docu-
ment. AT&T disclaims all warranties regarding the information contained herein, whether expressed,
implied or statutory, including implied warranties of merchantability or fitness for a particular purpose.
AT&T makes. no representation that the interconnection of products in the manner described herein
will not infringe on existing or future patent rights, nor do the descriptions contained herein imply the
granting or liCense to make,use or se.1I equipment constructed in accordance with this description.
AT&T reserves the right to make changes without further notice to any products herein to improve
reliability, fUnction, or design.
TRADEMARKS
are
UNIX and WE registered trademarkS of AT&T.
10 9 8 7 6 5 4 3 2 1
ISBN 0-13-933680-X
UNIX
PRESS
A Prentice Hall Title
PRE N T C E HAL L
ORDERING INFORMATION
UNIX® SYSTEM V, RELEASE 4 DOCUMENTATION
To order single copies of UNIX® SYSTEM V, Release 4 documentation,
please call [phone].
ATTENTION DOCUMENTATION MANAGERS AND TRAINING DIRECTORS:
For bulk purchases in excess of 30 copies please write to:
Corporate Sales
Prentice Hall
Englewood Cliffs, N.J. 07632.
Or call: [phone].
ATTENTION GOVERNMENT CUSTOMERS: For GSA and other pricing
information please call [phone].
Prentice-Hall International (UK) Limited, London
Prentice-Hall of Australia Pty. Limited, Sydney
Prentice-Hall Canada Inc., Toronto
Prentice-Hall Hispanoamericana, SA, Mexico
Prentice-Hall of India Private Limited, New Delhi
Prentice-Hall of Japan, Inc., Tokyo
Simon & Schuster Asia Pte. Ltd., Singapore
Editora Prentice-Hall do Brasil, Ltda., Rio de Janeiro
®
AT&T UNIX System V Release 4
General Use and System Administration
UNIX® System V Release 4 Network User's and Administrator's Guide
UNIX® System V Release 4 Product Overview and Master Index
UNIX® System V Release 4 System Administrator's Guide
(II
UNIX System V Release 4 System Administrator's Reference Manual
UNIX® System V Release 4 User's Guide
UNIX® System V Release 4 User's Reference Manual
General Programmer's Series
UNIX® System V Release 4 Programmer's Guide: ANSI C
and Programming Support Tools
UNIX® System V Release 4 Programmer's Guide: Character User Interface
(FMLI and ETI)
UNIX® System V Release 4 Programmer's Guide: Networking Interfaces
UNIX® System V Release 4 Programmer's Guide: POSIX Conformance
UNIX® System V Release 4 Programmer's Guide: System Services
and Application Packaging Tools
UNIX® System V Release 4 Programmer's Reference Manual
System Programmer's Series
UNIX® System V Release 4 ANSI C Transition Guide
UNIX® System V Release 4 BSD / XENIX® Compatibility Guide
UNIX® System V Release 4 Device Driver Interface / Driver-Kernel
Interface (DDI / DKI) Reference Manual
UNIX® System V Release 4 Migration Guide
UNIX® System V Release 4 Programmer's Guide: STREAMS
Ii
Available from Prentice Hall
Contents
1 Introduction
About This Document 1-1
Organization of Driver Reference Manuals 1-7
Conventions Used in This Document 1-8
Related Learning Materials 1-9
2 Driver Entry Points (02)
Introduction 2-1
Overview of Driver Entry-Point Routines and Naming
Conventions 2-2
Manual Pages 2-4
3 Kernel Functions (03)
Introduction 3-1
Manual Pages 3-7
4 Data Structures (04)
Introduction 4-1
Manual Pages 4-3
A
Appendix A: Error Codes
Table of Contents
Table of Contents ____________________
B Appendix B: Migration from Release 3.2 to
Release 4.0
Index
Permuted Index
II DDIIDKI Reference Manual
Figures and Tables
Figure 1-1: Scope of DDI and DKI 1-1
Table 1-1: Exclusive Entry Points, Functions, and Structures 1-5
Table 1-2: Textual Conventions Used in This Book 1-8
Table 2-1: STREAMS Driver Entry Point Summary 2-2
Table 2-2: Driver Entry Points not Specific to STREAMS 2·3
Table 3-1: STREAMS Kernel Function Summary 3-2
Table 3-2: Kernel FuncUcms Not Specific to STREAMS 3-4
Table 4-1: STREAMS Data Structure Summary 4-1
Table 4-2: Data Structures not Specific to STREAMS 4-2
Table A-1: Driver Error Codes A-1
Table A-2:Error Codes by Driver Routine A-2
Tallie 8-1: 3.2 to ｾＮｏ＠ Migration B-2
Table of Contents iii