This commit is contained in:
Joel Sherrill
1998-03-11 22:06:41 +00:00
parent e25b7eecf2
commit 2d19ed6c69
21 changed files with 754 additions and 0 deletions

156
doc/posix1003.1/Makefile Normal file
View File

@@ -0,0 +1,156 @@
#
# COPYRIGHT (c) 1988-1998.
# On-Line Applications Research Corporation (OAR).
# All rights reserved.
#
# $Id$
#
include ../Make.config
PROJECT=posix1003_1
all:
COMMON_FILES=../common/cpright.texi ../common/setup.texi
GENERATED_FILES=ch01.texi ch02.texi ch03.texi ch04.texi ch05.texi \
ch06.texi ch07.texi ch08.texi ch08.texi ch10.texi \
ch11.texi ch12.texi ch13.texi ch14.texi ch15.texi \
ch16.texi ch17.texi ch18.texi
FILES= $(PROJECT).texi \
preface.texi $(GENERATED_FILES)
all:
INFOFILES=$(wildcard $(PROJECT) $(PROJECT)-*)
info: $(PROJECT)
#cp $(wildcard $(PROJECT) $(PROJECT)-*) $(INFO_INSTALL)
cp $(PROJECT) $(INFO_INSTALL)
$(P{ROJECT): $(FILES)
$(MAKEINFO) $(PROJECT).texi
vinfo: info
$(INFO) -f $(PROJECT)
dvi: $(PROJECT).dvi
ps: $(PROJECT).ps
$(PROJECT).ps: $(PROJECT).dvi
dvips -o $(PROJECT).ps $(PROJECT).dvi
cp $(PROJECT).ps $(PS_INSTALL)
dv: dvi
$(XDVI) $(PROJECT).dvi
view: ps
$(GHOSTVIEW) $(PROJECT).ps
$(PROJECT).dvi: $(FILES)
$(TEXI2DVI) $(PROJECT).texi
ch01.t.texi: ch01.t
$(BMENU) -p "Preface" \
-u "Top" \
-n "Terminology and General Requirements" $*
ch02.t.texi: ch02.t
$(BMENU) -p "Conformance" \
-u "Top" \
-n "Process Primitives" $*
ch03.t.texi: ch03.t
$(BMENU) -p "Symbolic Constants" \
-u "Top" \
-n "Process Environment" $*
ch04.t.texi: ch04.t
$(BMENU) -p "Delay Process Execution" \
-u "Top" \
-n "Files and Directories" $*
ch05.t.texi: ch05.t
$(BMENU) -p "Get Configurable System Variables" \
-u "Top" \
-n "Input and Output Primitives" $*
ch06.t.texi: ch06.t
$(BMENU) -p "Get Configurable Pathname Variables" \
-u "Top" \
-n "Device- and Class-Specific Functions" $*
ch07.t.texi: ch07.t
$(BMENU) -p " Asynchronous File Synchronization" \
-u "Top" \
-n "Language-Specific Services for the C Programming Language" $*
ch08.t.texi: ch08.t
$(BMENU) -p "Set Foreground Process Group ID" \
-u "Top" \
-n "System Databases" $*
ch09.t.texi: ch09.t
$(BMENU) -p "Pseudo-Random Sequence Generation Functions" \
-u "Top" \
-n "Data Interchange Format" $*
ch10.t.texi: ch10.t
$(BMENU) -p "User Database Access" \
-u "Top" \
-n "Synchronization" $*
ch11.t.texi: ch11.t
$(BMENU) -p "Multiple Volumes" \
-u "Top" \
-n "Memory Management" $*
ch12.t.texi: ch12.t
$(BMENU) -p "Waiting on a Condition" \
-u "Top" \
-n "Execution Scheduling" $*
ch13.t.texi: ch13.t
$(BMENU) -p "Remove a Shared Memory Object" \
-u "Top" \
-n "Clocks and Timers" $*
ch14.t.texi: ch14.t
$(BMENU) -p "Change the Priority Ceiling of a Mutex" \
-u "Top" \
-n "Message Passing" $*
ch15.t.texi: ch15.t
$(BMENU) -p "High Resolution Sleep" \
-u "Top" \
-n "Thread Management" $*
ch16.t.texi: ch16.t
$(BMENU) -p "Get Message Queue Attributes" \
-u "Top" \
-n "Thread-Specific Data" $*
ch17.t.texi: ch17.t
$(BMENU) -p "Dynamic Package Initialization" \
-u "Top" \
-n "Thread Cancellation" $*
ch18.t.texi: ch18.t
$(BMENU) -p "Thread-Specific Data Key Deletion" \
-u "Top" \
-n "Command and Variable Index" $*
html: $(FILES)
-mkdir $(WWW_INSTALL)/$(PROJECT)
$(TEXI2WWW) $(TEXI2WWW_ARGS) -dir $(WWW_INSTALL)/$(PROJECT) \
$(PROJECT).texi
clean:
rm -f *.o $(PROG) *.txt core
rm -f *.dvi *.ps *.log *.aux *.cp *.fn *.ky *.pg *.toc *.tp *.vr $(BASE)
rm -f $(PROJECT) $(PROJECT)-* $(GENERATED_FILES)
rm -f *.fixed _*

13
doc/posix1003.1/ch01.t Normal file
View File

@@ -0,0 +1,13 @@
@c
@c COPYRIGHT (c) 1988-1998.
@c On-Line Applications Research Corporation (OAR).
@c All rights reserved.
@c
@c $Id$
@c
@chapter General
@section Scope
@section Normative References
@section Conformance

19
doc/posix1003.1/ch02.t Normal file
View File

@@ -0,0 +1,19 @@
@c
@c COPYRIGHT (c) 1988-1998.
@c On-Line Applications Research Corporation (OAR).
@c All rights reserved.
@c
@c $Id$
@c
@chapter Terminology and General Requirements
@section Conventions
@section Definitions
@section General Concepts
@section Error Numbers
@section Primitive System Types
@section Environment Description
@section C Language Definitions
@section Numerical Limits
@section Symbolic Constants

32
doc/posix1003.1/ch03.t Normal file
View File

@@ -0,0 +1,32 @@
@c
@c COPYRIGHT (c) 1988-1998.
@c On-Line Applications Research Corporation (OAR).
@c All rights reserved.
@c
@c $Id$
@c
@chapter Process Primitives
@section Process Creation and Execution
@subsection Process Creation
@subsection Execute a File
@subsection Register Fork Handlers
@section Process Termination
@subsection Wait for Process Termination
@subsection Terminate a Process
@section Signals
@subsection Signal Concepts
@subsection Send a Signal to a Process
@subsection Manipulate Signal Sets
@subsection Examine and Change Signal Action
@subsection Examine and Change Blocked Signals
@subsection Examine Pending Signals
@subsection Wait for a Signal
@subsection Synchronously Accept a Signal
@subsection Queue a Signal to a Process
@subsection Send a Signal to a Thread
@section Timer Operations
@subsection Schedule Alarm
@subsection Suspend Process Execution
@subsection Delay Process Execution

33
doc/posix1003.1/ch04.t Normal file
View File

@@ -0,0 +1,33 @@
@c
@c COPYRIGHT (c) 1988-1998.
@c On-Line Applications Research Corporation (OAR).
@c All rights reserved.
@c
@c $Id$
@c
@chapter Process Environment
@section Process Identification
@subsection Get Process and Parent Process IDs
@section User Identification
@subsection Get Real User Effective User, Real Group, and Effective Group IDs
@subsection Set User and Group IDs
@subsection Get Supplementary Group IDs
@subsection Get User Name
@section Process Groups
@subsection Get Process Group ID
@subsection Create Session and Set Process Group ID
@subsection Set Process Group ID for Job Control
@section System Identification
@subsection Get System Name
@section Time
@subsection Get System Time
@subsection Get Process Times
@section Environment Variables
@subsection Environment Access
@section Terminal Identification
@subsection Generate Terminal Pathname
@subsection Determine Terminal Device Name
@section Configurable System Variables
@subsection Get Configurable System Variables

38
doc/posix1003.1/ch05.t Normal file
View File

@@ -0,0 +1,38 @@
@c
@c COPYRIGHT (c) 1988-1998.
@c On-Line Applications Research Corporation (OAR).
@c All rights reserved.
@c
@c $Id$
@c
@chapter Files and Directories
@section Directories
@subsection Format of Directory Entries
@subsection Directory Operations
@section Working Directory
@subsection Change Current Working Directory
@subsection Get Working Directory Pathname
@section General File Creation
@subsection Open a File
@subsection Create a New File or Rewrite an Existing One
@subsection Set File Creation Mask
@subsection Link to a File
@section Special File Creation
@subsection Make a Directory
@subsection Make a FIFO Special File
@section File Removal
@subsection Remove Directory Entries
@subsection Remove a Directory
@subsection Rename a File
@section File Characteristics
@subsection File Characteristics: Header and Data Structure
@subsection Get File Status
@subsection Check File Accessibility
@subsection Change File Modes
@subsection Change Owner and Group of a File
@subsection Set File Access and Modification Times
@subsection Truncate a File to a Specified Length
@section Configurable Pathname Variable
@subsection Get Configurable Pathname Variables

36
doc/posix1003.1/ch06.t Normal file
View File

@@ -0,0 +1,36 @@
@c
@c COPYRIGHT (c) 1988-1998.
@c On-Line Applications Research Corporation (OAR).
@c All rights reserved.
@c
@c $Id$
@c
@chapter Input and Output Primitives
@section Pipes
@subsection Create an Inter-Process Channel
@section File Descriptor Manipulation
@subsection Duplicate an Open File Descriptor
@section File Descriptor Deassignment
@subsection Close a File
@section Input and Output
@subsection Read from a File
@subsection Write to a File
@section Control Operations on Files
@subsection Data Definitions for File Control Operations
@subsection File Control
@subsection Reposition Read/Write File Offset
@section File Synchronization
@subsection Synchronize the State of a File
@subsection Synchronize the Data of a File
@section Asynchronous Input and Output
@subsection Data Definitions for Asynchronous Input and Output
@subsection Asynchronous Read
@subsection Asynchronous Write
@subsection List Directed I/O
@subsection Retrieve Error Status of Asynchronous I/O Operation
@subsection Retrieve Return Status of Asynchronous I/O Operation
@subsection Cancel Asynchronous I/O Request
@subsection Wait for Asynchronous I/O Request
@subsection Asynchronous File Synchronization

43
doc/posix1003.1/ch07.t Normal file
View File

@@ -0,0 +1,43 @@
@c
@c COPYRIGHT (c) 1988-1998.
@c On-Line Applications Research Corporation (OAR).
@c All rights reserved.
@c
@c $Id$
@c
@chapter Device- and Class-Specific Functions
@section General Terminal Interface
@subsection Interface Characteristics
@subsubsection Opening a Terminal Device File
@subsubsection Process Groups
@subsubsection The Controlling Terminal
@subsubsection Terminal Access Control
@subsubsection Input Processing and Reading Data
@subsubsection Canonical Mode Input Processing
@subsubsection Noncanonical Mode Input Processing
@subsubsection Writing Data and Output Processing
@subsubsection Special Characters
@subsubsection Modem Disconnect
@subsubsection Closing a Terminal Device File
@subsection Parameters That Can Be Set
@subsubsection termios Structure
@subsubsection Input Modes
@subsubsection Output Modes
@subsubsection Control Modes
@subsubsection Local Modes
@subsubsection Special Control Characters
@subsubsection Baud Rate Values
@subsubsection @subsection Baud Rate Functions
@subsubsection Synopsis
@subsubsection Description
@subsubsection Returns
@subsubsection Errors
@subsubsection Cross-References
@section General Terminal Interface Control Functions
@subsection Get and Set State
@subsection Line Control Functions
@subsection Get Foreground Process Group ID
@subsection Set Foreground Process Group ID

31
doc/posix1003.1/ch08.t Normal file
View File

@@ -0,0 +1,31 @@
@c
@c COPYRIGHT (c) 1988-1998.
@c On-Line Applications Research Corporation (OAR).
@c All rights reserved.
@c
@c $Id$
@c
@chapter Language-Specific Services for the C Programming Language
@section Referenced C Language Routines
@subsection Extensions to Time Functions
@subsection Extensions to setlocale() Function
@section C Language Input/Output Functions
@subsection Map a Stream Pointer to a File Descriptor
@subsection Open a Stream on a File Descriptor
@subsection Interactions of Other FILE-Type C Functions
@subsection Operations on Files -- the remove() Function
@subsection Temporary File Name -- the tmpnam() Function
@subsection Stdio Locking Functions
@subsection Stdio With Explicit Client Locking
@section Other C Language Functions
@subsection Nonlocal Jumps
@subsection Set Time Zone
@subsection Find String Token
@subsection ASCII Time Representation
@subsection Current Time Representation
@subsection Coordinated Universal Time
@subsection Local Time
@subsection Pseudo-Random Sequence Generation Functions

6
doc/posix1003.1/ch09.t Normal file
View File

@@ -0,0 +1,6 @@
@chapter System Databases
@section System Databases
@section Database Access
@section Group Database Access
@section User Database Access

14
doc/posix1003.1/ch10.t Normal file
View File

@@ -0,0 +1,14 @@
@c
@c COPYRIGHT (c) 1988-1998.
@c On-Line Applications Research Corporation (OAR).
@c All rights reserved.
@c
@c $Id$
@c
@chapter Data Interchange Format
@section Archive/Interchange File Format
@subsubsection Extended tar Format
@subsubsection Extended cpio Format
@subsubsection Multiple Volumes

29
doc/posix1003.1/ch11.t Normal file
View File

@@ -0,0 +1,29 @@
@c
@c COPYRIGHT (c) 1988-1998.
@c On-Line Applications Research Corporation (OAR).
@c All rights reserved.
@c
@c $Id$
@c
@chapter Synchronization
@section Semaphore Characteristics
@section Semaphore Functions
@subsubsection Initialize an Unnamed Semaphore
@subsubsection Destroy an Unnamed Semaphore
@subsubsection Initialize/Open a Named Semaphore
@subsubsection Close a Named Semaphore
@subsubsection Remove a Named Semaphore
@subsubsection Lock a Semaphore
@subsubsection Unlock a Semaphore
@subsubsection Get the Value of a Semaphore
@section Mutexes
@subsubsection Mutex Initialization Attributes
@subsubsection Initializing and Destroying a Mutex
@subsubsection Locking and Unlocking a Mutex
@section Condition Variables
@subsubsection Condition Variable Initialization Attributes
@subsubsection Initialization and Destroying Condition Variables
@subsubsection Broadcasting and Signaling a Condition
@subsubsection Waiting on a Condition

21
doc/posix1003.1/ch12.t Normal file
View File

@@ -0,0 +1,21 @@
@c
@c COPYRIGHT (c) 1988-1998.
@c On-Line Applications Research Corporation (OAR).
@c All rights reserved.
@c
@c $Id$
@c
@chapter Memory Management
@section Memory Locking Functions
@subsubsection Lock/Unlock the Address Space of a Process
@subsubsection Lock/Unlock a Rand of Process Address Space
@section Memory Mapping Functions
@subsubsection Map Process Addresses to a Memory Object
@subsubsection Unmap Previously Mapped Addresses
@subsubsection Change Memory Protection
@subsubsection Memory Object Synchronization
@section Shared Memory Functions
@subsubsection Open a Shared Memory Object
@subsubsection Remove a Shared Memory Object

33
doc/posix1003.1/ch13.t Normal file
View File

@@ -0,0 +1,33 @@
@c
@c COPYRIGHT (c) 1988-1998.
@c On-Line Applications Research Corporation (OAR).
@c All rights reserved.
@c
@c $Id$
@c
@chapter Execution Scheduling
@section Scheduling Parameters
@section Scheduling Policies
@subsubsection SCHED_FIFO
@subsubsection SCHED_RR
@subsubsection SCHED_OTHER
@section Process Scheduling Functions
@subsubsection Set Scheduling Parameters
@subsubsection Get Scheduling Parameters
@subsubsection Set Scheduling Policy and Scheduling Parameters
@subsubsection Get Scheduling Policy
@subsubsection Yield Processor
@subsubsection Get Scheduling Parameter Limits
@section Thread Scheduling
@subsubsection Thread Scheduling Attributes
@subsubsection Scheduling Contention Scope
@subsubsection Scheduling Allocation Domain
@subsubsection Scheduling Documentation
@section Thread Scheduling Functions
@subsubsection Thread Creation Scheduling Attributes
@subsubsection Dynamic Thread Scheduling Parameters Access
@section Synchronization Scheduling
@subsubsection Mutex Initialization Scheduling Attributes
@subsubsection Change the Priority Ceiling of a Mutex

21
doc/posix1003.1/ch14.t Normal file
View File

@@ -0,0 +1,21 @@
@c
@c COPYRIGHT (c) 1988-1998.
@c On-Line Applications Research Corporation (OAR).
@c All rights reserved.
@c
@c $Id$
@c
@chapter Clocks and Timers
@section Data Definitions for Clocks and Timers
@subsubsection Time Value Specification Structures
@subsubsection Timer Event Notification Control Block
@subsubsection Type Definitions
@subsubsection Manifest Constants
@section Clock and Timer Functions
@subsubsection Clocks
@subsubsection Create a Per-Process Timer
@subsubsection Delete a Per-Process Timer
@subsubsection Per-Process Timers
@subsubsection High Resolution Sleep

21
doc/posix1003.1/ch15.t Normal file
View File

@@ -0,0 +1,21 @@
@c
@c COPYRIGHT (c) 1988-1998.
@c On-Line Applications Research Corporation (OAR).
@c All rights reserved.
@c
@c $Id$
@c
@chapter Message Passing
@section Data Definitions for Message Queues
@subsubsection Data Structures
@section Message Passing Functions
@subsubsection Open a Message Queue
@subsubsection Close a Message Queue
@subsubsection Remove a Message Queue
@subsubsection Send a Message to a Message Queue
@subsubsection Receive a Message From a Message Queue
@subsubsection Notify Process That a Message is Available on a Queue
@subsubsection Set Message Queue Attributes
@subsubsection Get Message Queue Attributes

20
doc/posix1003.1/ch16.t Normal file
View File

@@ -0,0 +1,20 @@
@c
@c COPYRIGHT (c) 1988-1998.
@c On-Line Applications Research Corporation (OAR).
@c All rights reserved.
@c
@c $Id$
@c
@chapter Thread Management
@section Threads
@section Thread Functions
@subsubsection Thread Creation Attributes
@subsubsection Thread Creation
@subsubsection Wait for Thread Termination
@subsubsection Detaching a Thread
@subsubsection Thread Termination
@subsubsection Get Thread ID
@subsubsection Compare Thread IDs
@subsubsection Dynamic Package Initialization

14
doc/posix1003.1/ch17.t Normal file
View File

@@ -0,0 +1,14 @@
@c
@c COPYRIGHT (c) 1988-1998.
@c On-Line Applications Research Corporation (OAR).
@c All rights reserved.
@c
@c $Id$
@c
@chapter Thread-Specific Data
@section Thread-Specific Data Functions
@subsubsection Thread-Specific Data Key Creation
@subsubsection Thread-Specific Data Management
@subsubsection Thread-Specific Data Key Deletion

25
doc/posix1003.1/ch18.t Normal file
View File

@@ -0,0 +1,25 @@
@c
@c COPYRIGHT (c) 1988-1998.
@c On-Line Applications Research Corporation (OAR).
@c All rights reserved.
@c
@c $Id$
@c
@chapter Thread Cancellation
@section Thread Cancellation Overview
@subsection Cancelability States
@subsubsection Cancellation Points
@subsubsection Thread Cancellation Cleanup Handlers
@subsubsection Async-Cancel Safety
@section Thread Cancellation Functions
@subsubsection Canceling Execution of a Thread
@subsubsection Setting Cancelability State
@subsubsection Establishing Cancellation Handlers
@section Language-Independent Cancellation Functionality
@subsubsection Requesting Cancellation
@subsubsection Associating Cleanup Code With Scopes
@subsubsection Controlling Cancellation Within Scopes
@subsubsection Defined Cancellation Sequence
@subsubsection List of Cancellation Points

View File

@@ -0,0 +1,136 @@
\input ../texinfo/texinfo @c -*-texinfo-*-
@c %**start of header
@setfilename posix1003_1
@syncodeindex vr fn
@synindex ky cp
@paragraphindent 0
@c @smallbook
@c %**end of header
@c
@c COPYRIGHT (c) 1988-1998.
@c On-Line Applications Research Corporation (OAR).
@c All rights reserved.
@c
@c $Id$
@c
@c
@c Master file for the KA9Q TCP/IP Supplement
@c
@include ../common/setup.texi
@ignore
@ifinfo
@format
START-INFO-DIR-ENTRY
* RTEMS KA9Q TCP/IP Supplement (posix1003_1):
END-INFO-DIR-ENTRY
@end format
@end ifinfo
@end ignore
@c
@c Title Page Stuff
@c
@set edition 970904
@set version 970904
@set update-date 4 September 1997
@set update-month September 1997
@c
@c I don't really like having a short title page. --joel
@c
@c @shorttitlepage RTEMS KA9Q TCP/IP Supplement
@setchapternewpage odd
@settitle RTEMS KA9Q TCP/IP Supplement
@titlepage
@finalout
@title RTEMS KA9Q TCP/IP Supplement
@subtitle Edition @value{edition}, for RTEMS @value{version}
@sp 1
@subtitle @value{update-month}
@author On-Line Applications Research Corporation
@page
@include ../common/cpright.texi
@end titlepage
@c This prevents a black box from being printed on "overflow" lines.
@c The alternative is to rework a sentence to avoid this problem.
@include preface.texi
@include ch01.texi
@include ch02.texi
@include ch03.texi
@include ch04.texi
@include ch05.texi
@include ch06.texi
@include ch07.texi
@include ch08.texi
@include ch09.texi
@include ch10.texi
@include ch11.texi
@include ch12.texi
@include ch13.texi
@include ch14.texi
@include ch15.texi
@include ch16.texi
@include ch17.texi
@include ch18.texi
@ifinfo
@node Top, Preface, (dir), (dir)
@top posix1003_1
This is the online version of the RTEMS KA9Q TCP/IP Supplement.
@menu
* Preface::
* General::
* Terminology and General Requirements::
* Process Primitives::
* Process Environment::
* Files and Directories::
* Input and Output Primitives::
* Device- and Class-Specific Functions::
* Language-Specific Services for the C Programming Language::
* System Databases::
* Data Interchange Format::
* Synchronization::
* Memory Management::
* Execution Scheduling::
* Clocks and Timers::
* Message Passing::
* Thread Management::
* Thread-Specific Data::
* Thread Cancellation::
* Command and Variable Index::
* Concept Index::
@end menu
@end ifinfo
@c
@c
@c Need to copy the emacs stuff and "trailer stuff" (index, toc) into here
@c
@node Command and Variable Index, Concept Index, List of Cancellation Points, Top
@unnumbered Command and Variable Index
There are currently no Command and Variable Index entries.
@c @printindex fn
@node Concept Index, , Command and Variable Index, Top
@unnumbered Concept Index
There are currently no Concept Index entries.
@c @printindex cp
@c @contents
@bye

View File

@@ -0,0 +1,13 @@
@c
@c COPYRIGHT (c) 1988-1998.
@c On-Line Applications Research Corporation (OAR).
@c All rights reserved.
@c
@c $Id$
@c
@unnumbered Preface
This lists each section number in POSIX 1003.1 and which functions
are defined in that document per section number.