From 0874502b511202a5d7a5befb1a0b9b5d8bf73550 Mon Sep 17 00:00:00 2001
From: Joel Sherrill <joel.sherrill@OARcorp.com>
Date: Sat, 14 Mar 1998 16:31:11 +0000
Subject: Added functions from POSIX standard.

---
 doc/posix1003.1/ch03.t           | 103 +++++++++++++++++
 doc/posix1003.1/ch04.t           |  90 +++++++++++++++
 doc/posix1003.1/ch05.t           | 111 ++++++++++++++++++
 doc/posix1003.1/ch06.t           |  95 ++++++++++++++++
 doc/posix1003.1/ch07.t           |  51 +++++++++
 doc/posix1003.1/ch08.t           | 235 ++++++++++++++++++++++++++++++++++++++-
 doc/posix1003.1/posix1003_1.texi |   8 +-
 7 files changed, 686 insertions(+), 7 deletions(-)

(limited to 'doc')

diff --git a/doc/posix1003.1/ch03.t b/doc/posix1003.1/ch03.t
index 4055267a5d..0ed0e3dea9 100644
--- a/doc/posix1003.1/ch03.t
+++ b/doc/posix1003.1/ch03.t
@@ -7,26 +7,129 @@
 @c
 
 @chapter Process Primitives
+
 @section Process Creation and Execution
+
 @subsection Process Creation
+
+@example
+fork(), Unimplementable
+@end example
+
+
 @subsection Execute a File
+
+@example
+execl(), Unimplementable
+execv(), Unimplementable
+execle(), Unimplementable
+execve(), Unimplementable
+execlp(), Unimplementable
+execvp(), Unimplementable
+@end example
+
 @subsection Register Fork Handlers
+
+@example
+pthread_atfork(), Implemented
+@end example
+
 @section Process Termination
+
 @subsection Wait for Process Termination
+
+@example
+wait(), Implemented
+waitpid(), Implemented
+@end example
+
 @subsection Terminate a Process
+
+@example
+_exit(), Implemented
+@end example
+
 @section Signals
+
 @subsection Signal Concepts
+
 @subsection Send a Signal to a Process
+
+@example
+kill(), Implemented
+@end example
+
 @subsection Manipulate Signal Sets
+
+@example
+sigemptyset(), Implemented
+sigfillset(), Implemented
+sigaddset(), Implemented
+sigdelset(), Implemented
+sigismember(), Implemented
+@end example
+
 @subsection Examine and Change Signal Action
+
+@example
+sigaction(), Implemented
+@end example
+
 @subsection Examine and Change Blocked Signals
+
+@example
+pthread_sigmask(), Implemented
+sigprocmask(), Implemented
+@end example
+
 @subsection Examine Pending Signals
+
+@example
+sigpending(), Implemented
+@end example
+
 @subsection Wait for a Signal
+
+@example
+sigsuspend(), Implemented
+@end example
+
 @subsection Synchronously Accept a Signal
+
+@example
+sigwait(), Implemented
+sigwaitinfo(), Implemented
+sigtimedwait(), Implemented
+@end example
+
 @subsection Queue a Signal to a Process
+
+@example
+sigqueue(), Implemented
+@end example
+
 @subsection Send a Signal to a Thread
+
+@example
+pthread_kill(), Implemented
+@end example
+
 @section Timer Operations
+
 @subsection Schedule Alarm
+
+@example
+alarm(), Implemented
+@end example
+
 @subsection Suspend Process Execution
+
+@example
+pause(), Implemented
+@end example
+
 @subsection Delay Process Execution
 
+@example
+sleep(), Implemented
+@end example
diff --git a/doc/posix1003.1/ch04.t b/doc/posix1003.1/ch04.t
index 8a9471c743..939aa0b256 100644
--- a/doc/posix1003.1/ch04.t
+++ b/doc/posix1003.1/ch04.t
@@ -7,27 +7,117 @@
 @c
 
 @chapter Process Environment
+
 @section Process Identification
+
 @subsection Get Process and Parent Process IDs
+
+@example
+getpid()
+getppid()
+@end example
+
 @section User Identification
+
 @subsection Get Real User Effective User Real Group and Effective Group IDs
+
+@example
+getuid()
+geteuid()
+getgid()
+getegid()
+@end example
+
 @subsection Set User and Group IDs
+
+@example
+setuid()
+setgid()
+@end example
+
 @subsection Get Supplementary Group IDs
+
+@example
+getgroups()
+@end example
+
 @subsection Get User Name
+
+@example
+getlogin()
+getlogin_r()
+@end example
+
 @section Process Groups
+
 @subsection Get Process Group ID
+
+@example
+getpgrp()
+@end example
+
 @subsection Create Session and Set Process Group ID
+
+@example
+setsid()
+@end example
+
 @subsection Set Process Group ID for Job Control
+
+@example
+setpgid()
+@end example
+
 @section System Identification
+
 @subsection Get System Name
+
+@example
+uname()
+@end example
+
 @section Time
+
 @subsection Get System Time
+
+@example
+time()
+@end example
+
 @subsection Get Process Times
+
+@example
+times()
+@end example
+
 @section Environment Variables
+
 @subsection Environment Access
+
+@example
+getenv()
+@end example
+
 @section Terminal Identification
+
 @subsection Generate Terminal Pathname
+
+@example
+ctermid()
+@end example
+
 @subsection Determine Terminal Device Name
+
+@example
+ttyname()
+ttyname_r()
+isatty()
+@end example
+
 @section Configurable System Variables
+
 @subsection Get Configurable System Variables
 
+@example
+sysconf()
+@end example
diff --git a/doc/posix1003.1/ch05.t b/doc/posix1003.1/ch05.t
index 0e03e49d35..66e2868515 100644
--- a/doc/posix1003.1/ch05.t
+++ b/doc/posix1003.1/ch05.t
@@ -7,32 +7,143 @@
 @c
 
 @chapter Files and Directories
+
 @section Directories
+
 @subsection Format of Directory Entries
+
 @subsection Directory Operations
+
+@example
+opendir()
+readdir()
+readdir_r()
+rewinddir()
+closedir()
+@end example
+
 @section Working Directory
+
 @subsection Change Current Working Directory
+
+@example
+chdir()
+@end example
+
 @subsection Get Working Directory Pathname
+
+@example
+getcwd()
+@end example
+
 @section General File Creation
+
 @subsection Open a File
+
+@example
+open()
+@end example
+
 @subsection Create a New File or Rewrite an Existing One
+
+@example
+creat()
+@end example
+
 @subsection Set File Creation Mask
+
+@example
+umask()
+@end example
+
 @subsection Link to a File
+
+@example
+link()
+@end example
+
 @section Special File Creation
+
 @subsection Make a Directory
+
+@example
+mkdir()
+@end example
+
 @subsection Make a FIFO Special File
+
+@example
+mkfifo()
+@end example
+
 @section File Removal
+
 @subsection Remove Directory Entries
+
+@example
+unlink()
+@end example
+
 @subsection Remove a Directory
+
+@example
+rmdir()
+@end example
+
 @subsection Rename a File
+
+@example
+rename()
+@end example
+
 @section File Characteristics
+
 @subsection File Characteristics Header and Data Structure
+
 @subsection Get File Status
+
+@example
+stat()
+fstat()
+@end example
+
 @subsection Check File Accessibility
+
+@example
+access()
+@end example
+
 @subsection Change File Modes
+
+@example
+chmod()
+fchmod()
+@end example
+
 @subsection Change Owner and Group of a File
+
+@example
+chown()
+@end example
+
 @subsection Set File Access and Modification Times
+
+@example
+utime()
+@end example
+
 @subsection Truncate a File to a Specified Length
+
+@example
+ftruncate()
+@end example
+
 @section Configurable Pathname Variable
+
+@example
+pathconf()
+fpathconf()
+@end example
+
 @subsection Get Configurable Pathname Variables
 
diff --git a/doc/posix1003.1/ch06.t b/doc/posix1003.1/ch06.t
index b3be22feb3..81d0a53e90 100644
--- a/doc/posix1003.1/ch06.t
+++ b/doc/posix1003.1/ch06.t
@@ -7,30 +7,125 @@
 @c
 
 @chapter Input and Output Primitives
+
 @section Pipes
+
 @subsection Create an Inter-Process Channel
+
+@example
+pipe()
+@end example
+
 @section File Descriptor Manipulation
+
 @subsection Duplicate an Open File Descriptor
+
+@example
+dup()
+dup2()
+@end example
+
 @section File Descriptor Deassignment
+
 @subsection Close a File
+
+@example
+close()
+@end example
+
 @section Input and Output
+
 @subsection Read from a File
+
+@example
+read()
+@end example
+
 @subsection Write to a File
+
+@example
+write()
+@end example
+
 @section Control Operations on Files
+
 @subsection Data Definitions for File Control Operations
+
 @subsection File Control
+
+@example
+fcntl()
+@end example
+
 @subsection Reposition Read/Write File Offset
+
+@example
+lseek()
+@end example
+
 @section File Synchronization
+
 @subsection Synchronize the State of a File
+
+@example
+fsync()
+@end example
+
 @subsection Synchronize the Data of a File
+
+@example
+fdatasync()
+@end example
+
 @section Asynchronous Input and Output
+
 @subsection Data Definitions for Asynchronous Input and Output
+
 @subsection Asynchronous Read
+
+@example
+aio_read()
+@end example
+
 @subsection Asynchronous Write
+
+@example
+aio_write()
+@end example
+
 @subsection List Directed I/O
+
+@example
+aio_listio()
+@end example
+
 @subsection Retrieve Error Status of Asynchronous I/O Operation
+
+@example
+aio_error()
+@end example
+
 @subsection Retrieve Return Status of Asynchronous I/O Operation
+
+@example
+aio_return()
+@end example
+
 @subsection Cancel Asynchronous I/O Request
+
+@example
+aio_cancel()
+@end example
+
 @subsection Wait for Asynchronous I/O Request
+
+@example
+aio_suspend()
+@end example
+
 @subsection Asynchronous File Synchronization
 
+@example
+aio_fsync()
+@end example
+
diff --git a/doc/posix1003.1/ch07.t b/doc/posix1003.1/ch07.t
index 0de037b39c..c226f47da1 100644
--- a/doc/posix1003.1/ch07.t
+++ b/doc/posix1003.1/ch07.t
@@ -7,37 +7,88 @@
 @c
 
 @chapter Device- and Class-Specific Functions
+
 @section General Terminal Interface
+
 @subsection Interface Characteristics
+
 @subsubsection Opening a Terminal Device File
+
 @subsubsection Process Groups (TTY)
+
 @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
+
 @subsection Baud Rate Values
+
 @subsubsection 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
+
+@example
+tcgetattr()
+tcsetattr()
+@end example
+
 @subsection Line Control Functions
+
+@example
+tcsendbreak()
+tcdrain()
+tcflush()
+tcflow()
+@end example
+
 @subsection Get Foreground Process Group ID
+
+@example
+tcgetprgrp()
+@end example
+
 @subsection Set Foreground Process Group ID
 
+@example
+tcsetprgrp()
+@end example
 
diff --git a/doc/posix1003.1/ch08.t b/doc/posix1003.1/ch08.t
index 8b3bfa8c7a..7fd56b6c3f 100644
--- a/doc/posix1003.1/ch08.t
+++ b/doc/posix1003.1/ch08.t
@@ -7,25 +7,254 @@
 @c
 
 @chapter Language-Specific Services for the C Programming Language
+
 @section Referenced C Language Routines
+
+ANSI C Section 4.2 --- Diagnostics
+
+@example
+assert()
+@end example
+
+ANSI C Section 4.3 --- Character Handling
+
+@example
+isalnum()
+isalpha()
+iscntrl()
+isdigit()
+isgraph()
+islower()
+isprint()
+ispunct()
+isspace()
+isupper()
+isxdigit()
+tolower()
+toupper()
+@end example
+
+ANSI C Section 4.4 --- Localization
+
+@example
+setlocale()
+@end example
+
+ANSI C Section 4.5 --- Mathematics
+
+@example
+acos()
+asin()
+atan()
+atan2()
+cos()
+sin()
+tan()
+cosh()
+sinh()
+tanh()
+exp()
+frexp()
+ldexp()
+log()
+log10()
+modf()
+pow()
+sqrt()
+ceil()
+fabs()
+floor()
+fmod()
+@end example
+
+ANSI C Section 4.6 --- Non-Local Jumps
+
+@example
+setjmp()
+longjmp()
+@end example
+
+ANSI C Section 4.9 --- Input/Output
+
+@example
+clearerr()
+fclose()
+feof()
+ferror()
+fflush()
+fgetc()
+fgets()
+fopen()
+fputc()
+fputs()
+fread()
+freopen()
+fseek()
+ftell()
+fwrite()
+getc()
+getchar()
+gets()
+perror()
+printf()
+fprintf()
+sprintf()
+putc()
+putchar()
+puts()
+remove()
+rename()
+rewind()
+scanf()
+fscanf()
+sscanf()
+setbuf()
+tmpfile()
+tmpnam()
+ungetc()
+@end example
+
+ANSI C Section 4.10 --- General Utilities
+
+@example
+abs()
+atof()
+atoi()
+atol()
+rand()
+srand()
+calloc()
+free()
+malloc()
+realloc()
+abort()
+exit()
+getenv()
+bsearch()
+qsort()
+@end example
+
+ANSI C Section 4.11 --- String Handling
+
+@example
+strcpy()
+strncpy()
+strcat()
+strncat()
+strcmp()
+strncmp()
+strchr()
+strcspn()
+strpbrk()
+strrchr()
+strspn()
+strstr()
+strtok()
+strlen()
+@end example
+
+ANSI C Section 4.12 --- Date and Time Handling
+
+@example
+time()
+asctime()
+ctime()
+gmtime()
+localtime()
+mktime()
+strftime()
+@end example
+
 @subsection Extensions to Time Functions
-@subsection Extensions to setlocale() Function
+
+@subsection Extensions to @code{setlocale} Function
+
 @section C Language Input/Output Functions
+
 @subsection Map a Stream Pointer to a File Descriptor
+
+@example
+fileno()
+@end example
+
 @subsection Open a Stream on a File Descriptor
+
+@example
+fdopen()
+@end example
+
 @subsection Interactions of Other FILE-Type C Functions
-@subsection Operations on Files -- the remove() Function
-@subsection Temporary File Name -- the tmpnam() Function
+
+@subsection Operations on Files -- the @code{remove} Function
+
+@subsection Temporary File Name -- the @code{tmpnam} Function
+
 @subsection Stdio Locking Functions
+
+@example
+flockfile()
+ftrylockfile()
+funlockfile()
+@end example
+
 @subsection Stdio With Explicit Client Locking
+
+@example
+getc_unlocked()
+getchar_unlocked()
+putc_unlocked()
+putchar_unlocked()
+@end example
+
 @section Other C Language Functions
+
 @subsection Nonlocal Jumps
+
+@example
+sigsetjmp()
+siglongjmp()
+@end example
+
 @subsection Set Time Zone
+
+@example
+tzset()
+@end example
+
 @subsection Find String Token
+
+@example
+strtok_r()
+@end example
+
 @subsection ASCII Time Representation
+
+@example
+asctime_r()
+@end example
+
 @subsection Current Time Representation
+
+@example
+ctime_r()
+@end example
+
 @subsection Coordinated Universal Time
+
+@example
+gmtime_r()
+@end example
+
 @subsection Local Time
+
+@example
+localtime_r()
+@end example
+
 @subsection Pseudo-Random Sequence Generation Functions
 
+@example
+rand_r()
+@end example
+
 
diff --git a/doc/posix1003.1/posix1003_1.texi b/doc/posix1003.1/posix1003_1.texi
index 832ad79ef1..f751081cf5 100644
--- a/doc/posix1003.1/posix1003_1.texi
+++ b/doc/posix1003.1/posix1003_1.texi
@@ -35,10 +35,10 @@ END-INFO-DIR-ENTRY
 @c  Title Page Stuff
 @c
 
-@set edition 970904
-@set version 970904
-@set update-date 4 September 1997
-@set update-month September 1997
+@set edition @value{RTEMS-EDITION}
+@set version @value{RTEMS-VERSION}
+@set update-date @value{RTEMS-UPDATE-DATE}
+@set update-month @value{RTEMS-UPDATE-MONTH}
 
 @c
 @c  I don't really like having a short title page.  --joel
-- 
cgit v1.2.3