std-unix@longway.TIC.COM (Moderator, John S. Quarterman) (07/28/88)
From: uunet!unisoft!titipu!hlj (Hal Jespersen)
Hi, John. Could you pls post this to the stds newsgroup? Thanks.
[ Hal is the Technical Editor of IEEE 1003.1. -mod ]
Hal Jespersen
(415) 420-6410, ext 448
FAX: (415) 420-6499
...{uunet|amdahl|sun}!unisoft!hlj
UniSoft Corporation
6121 Hollis Street
Emeryville, CA 94608-2092
# This is a shell archive. Remove anything before this line,
# then unpack it by saving it in a file and typing "sh file".
#
# Wrapped by hlj on Wed Jul 27 21:16:11 PDT 1988
# Contents: posixheads.mm
echo x - posixheads.mm
sed 's/^@//' > "posixheads.mm" <<'@//E*O*F posixheads.mm//'
@.\"
@.\" This document contains the -mm header macros from the IEEE Std
@.\" 1003.1-1988 (POSIX). Only the normative portions of the standard are
@.\" included; the Appendix headings are omitted.
@.\"
@.\" The reason this is being disseminated electronically is that the
@.\" standard requires that each implementation provide a POSIX Conformance
@.\" Document that describes how it supports various limits and
@.\" implementation-defined things; see section 2.2.1.2 for a description of
@.\" this requirement. The implementation is required to format the
@.\" document so that the table of contents matches the standard itself.
@.\" So, these macros will give you a head start. I have included all the
@.\" heading levels (except for unnumbered headings), but I doubt that you
@.\" would be required to include every single one. For example, if you
@.\" have nothing to say about a certain function (all of which should be at
@.\" .H 3 levels), you shouldn't have to carry around the empty .H 4's
@.\" underneath it, such as:
@.\"
@.\" .H 4 "Synopsis."
@.\" .H 4 "Description."
@.\" .H 4 "Returns."
@.\" .H 4 "Errors."
@.\" .H 4 "References."
@.\"
@.\" But, keep them in if you like them.
@.\"
@.\" In case this prompts you to ask, the IEEE P1003 Working Group will not
@.\" be making the full copyrighted standard available in any machine-readable
@.\" format. There are two reasons for this:
@.\"
@.\" 1. We want to prevent unauthorized reprints, particularly
@.\" those with invisible modifications.
@.\"
@.\" 2. We want you to buy the book!
@.\"
@.\" It is planned that Draft 13 of the standard will be sent out from the IEEE
@.\" in late August; it will be dated August 15, 1988. A typeset hard cover
@.\" book version will follow in September/October (I hope). Except for the
@.\" inevitable formatting changes that crop up with working with
@.\" typesetters, though, Draft 13 is the final word.
@.\"
@.\" Hal Jespersen
@.\"
@.H 1 "Scope"
@.H 1 "Definitions and General Requirements"
@.H 2 "Terminology."
@.H 2 "Conformance."
@.H 3 "Implementation Conformance."
@.H 4 "Requirements."
@.H 4 "Documentation."
@.H 4 "Conforming Implementation Options."
@.H 3 "Application Conformance."
@.H 4 "Strictly Conforming \s-1POSIX\s0 Application."
@.H 4 "Conforming \s-1POSIX\s0 Application."
@.H 5 "\s-1ISO\s0 Conforming \s-1POSIX\s0 Application."
@.H 5 "<National Body> Conforming \s-1POSIX\s0 Application."
@.H 4 "Conforming \s-1POSIX\s0 Application Using Extensions."
@.H 3 "Language-Dependent Services for the C Programming Language."
@.H 4 "Types of Conformance."
@.H 4 "C Standard Language-Dependent System Support."
@.H 4 "Common Usage C Language-Dependent System Support."
@.H 3 "Other C Language Related Specifications."
@.H 2 "General Terms."
@.H 2 "General Concepts."
@.H 2 "Error Numbers."
@.H 2 "Primitive System Data Types."
@.H 2 "Environment Description."
@.H 2 "C Language Definitions."
@.H 3 "Symbols From The C Standard."
@.H 3 "\s-1POSIX\s0 Symbols."
@.H 4 "C Standard Language-Dependent Support."
@.H 4 "Common Usage-Dependent Support."
@.H 3 "Headers and Function Prototypes."
@.H 2 "Numerical Limits."
@.H 3 "C Language Limits."
@.H 3 "Minimum Values."
@.H 3 "Run-Time Increasable Values."
@.H 3 "Run-Time Invariant Values (Possibly Indeterminate)."
@.H 3 "Pathname Variable Values."
@.H 2 "Symbolic Constants."
@.H 3 "Symbolic Constants for the \f2access\fP\^(\^) Function."
@.H 3 "Symbolic Constant for the \f2lseek\fP\^(\^) Function."
@.H 3 "Compile-Time Symbolic Constants for Portability Specifications."
@.H 3 "Execution-Time Symbolic Constants for Portability Specifications."
@.H 1 "Process Primitives"
@.H 2 "Process Creation and Execution."
@.H 3 "Process Creation."
@.H 4 "Synopsis."
@.H 4 "Description."
@.H 4 "Returns."
@.H 4 "Errors."
@.H 4 "References."
@.H 3 "Execute a File."
@.H 4 "Synopsis."
@.H 4 "Description."
@.H 4 "Returns."
@.H 4 "Errors."
@.H 4 "References."
@.H 2 "Process Termination."
@.H 3 "Wait for Process Termination."
@.H 4 "Synopsis."
@.H 4 "Description."
@.H 4 "Returns."
@.H 4 "Errors."
@.H 4 "References."
@.H 3 "Terminate a Process."
@.H 4 "Synopsis."
@.H 4 "Description."
@.H 4 "Returns."
@.H 4 "References."
@.H 2 "Signals."
@.H 3 "Signal Concepts."
@.H 4 "Signal Names."
@.H 4 "Signal Generation and Delivery."
@.H 4 "Signal Actions."
@.H 4 "Signal Effects on Other Functions."
@.H 3 "Send a Signal to a Process."
@.H 4 "Synopsis."
@.H 4 "Description."
@.H 4 "Returns."
@.H 4 "Errors."
@.H 4 "References."
@.H 3 "Manipulate Signal Sets."
@.H 4 "Synopsis."
@.H 4 "Description."
@.H 4 "Returns."
@.H 4 "Errors."
@.H 4 "References."
@.H 3 "Examine and Change Signal Action."
@.H 4 "Synopsis."
@.H 4 "Description."
@.H 4 "Returns."
@.H 4 "Errors."
@.H 4 "References."
@.H 3 "Examine and Change Blocked Signals."
@.H 4 "Synopsis."
@.H 4 "Description."
@.H 4 "Returns."
@.H 4 "Errors."
@.H 4 "References."
@.H 3 "Examine Pending Signals."
@.H 4 "Synopsis."
@.H 4 "Description."
@.H 4 "Returns."
@.H 4 "Errors."
@.H 4 "References."
@.H 3 "Wait for a Signal."
@.H 4 "Synopsis."
@.H 4 "Description."
@.H 4 "Returns."
@.H 4 "Errors."
@.H 4 "References."
@.H 2 "Timer Operations."
@.H 3 "Schedule Alarm."
@.H 4 "Synopsis."
@.H 4 "Description."
@.H 4 "Returns."
@.H 4 "Errors."
@.H 4 "References."
@.H 3 "Suspend Process Execution."
@.H 4 "Synopsis."
@.H 4 "Description."
@.H 4 "Returns."
@.H 4 "Errors."
@.H 4 "References."
@.H 3 "Delay Process Execution."
@.H 4 "Synopsis."
@.H 4 "Description."
@.H 4 "Returns."
@.H 4 "Errors."
@.H 4 "References."
@.H 1 "Process Environment"
@.H 2 "Process Identification."
@.H 3 "Get Process and Parent Process \s-1ID\s0s."
@.H 4 "Synopsis."
@.H 4 "Description."
@.H 4 "Returns."
@.H 4 "Errors."
@.H 4 "References."
@.H 2 "User Identification."
@.H 3 "Get Real User, Effective User, Real Group, and Effective Group \s-1ID\s0s."
@.H 4 "Synopsis."
@.H 4 "Description."
@.H 4 "Returns."
@.H 4 "Errors."
@.H 4 "References."
@.H 3 "Set User and Group \s-1ID\s0s."
@.H 4 "Synopsis."
@.H 4 "Description."
@.H 4 "Returns."
@.H 4 "Errors."
@.H 4 "References."
@.H 3 "Get Supplementary Group \s-1ID\s0s."
@.H 4 "Synopsis."
@.H 4 "Description."
@.H 4 "Returns."
@.H 4 "Errors."
@.H 4 "References."
@.H 3 "Get User Name."
@.H 4 "Synopsis."
@.H 4 "Description."
@.H 4 "Returns."
@.H 4 "Errors."
@.H 4 "References."
@.H 2 "Process Groups."
@.H 3 "Get Process Group \s-1ID\s0."
@.H 4 "Synopsis."
@.H 4 "Description."
@.H 4 "Returns."
@.H 4 "Errors."
@.H 4 "References."
@.H 3 "Create Session and Set Process Group \s-1ID\s0."
@.H 4 "Synopsis."
@.H 4 "Description."
@.H 4 "Returns."
@.H 4 "Errors."
@.H 4 "References."
@.H 3 "Set Process Group \s-1ID\s0 for Job Control."
@.H 4 "Synopsis."
@.H 4 "Description."
@.H 4 "Returns."
@.H 4 "Errors."
@.H 4 "References."
@.H 2 "System Identification."
@.H 3 "System Name."
@.H 4 "Synopsis."
@.H 4 "Description."
@.H 4 "Returns."
@.H 4 "Errors."
@.H 2 "Time."
@.H 3 "Get System Time."
@.H 4 "Synopsis."
@.H 4 "Description."
@.H 4 "Returns."
@.H 4 "Errors."
@.H 3 "Process Times."
@.H 4 "Synopsis."
@.H 4 "Description."
@.H 4 "Returns."
@.H 4 "Errors."
@.H 4 "References."
@.H 2 "Environment Variables."
@.H 3 "Environment Access."
@.H 4 "Synopsis."
@.H 4 "Description."
@.H 4 "Returns."
@.H 4 "Errors."
@.H 4 "References."
@.H 2 "Terminal Identification."
@.H 3 "Generate Terminal Pathname."
@.H 4 "Synopsis."
@.H 4 "Description."
@.H 4 "Returns."
@.H 4 "Errors."
@.H 4 "References."
@.H 3 "Determine Terminal Device Name."
@.H 4 "Synopsis."
@.H 4 "Description."
@.H 4 "Returns."
@.H 4 "Errors."
@.H 2 "Configurable System Variables."
@.H 3 "Get Configurable System Variables."
@.H 4 "Synopsis."
@.H 4 "Description."
@.H 4 "Returns."
@.H 4 "Errors."
@.H 1 "Files and Directories"
@.H 2 "Directories."
@.H 3 "Format of Directory Entries."
@.H 3 "Directory Operations."
@.H 4 "Synopsis."
@.H 4 "Description."
@.H 4 "Returns."
@.H 4 "Errors."
@.H 4 "References."
@.H 2 "Working Directory."
@.H 3 "Change Current Working Directory."
@.H 4 "Synopsis."
@.H 4 "Description."
@.H 4 "Returns."
@.H 4 "Errors."
@.H 4 "References."
@.H 3 "Working Directory Pathname."
@.H 4 "Synopsis."
@.H 4 "Description."
@.H 4 "Returns."
@.H 4 "Errors."
@.H 4 "References."
@.H 2 "General File Creation."
@.H 3 "Open a File."
@.H 4 "Synopsis."
@.H 4 "Description."
@.H 4 "Returns."
@.H 4 "Errors."
@.H 4 "References."
@.H 3 "Create a New File or Rewrite an Existing One."
@.H 4 "Synopsis."
@.H 4 "Description."
@.H 4 "References."
@.H 3 "Set File Creation Mask."
@.H 4 "Synopsis."
@.H 4 "Description."
@.H 4 "Returns."
@.H 4 "Errors."
@.H 4 "References."
@.H 3 "Link to a File."
@.H 4 "Synopsis."
@.H 4 "Description."
@.H 4 "Returns."
@.H 4 "Errors."
@.H 4 "References."
@.H 2 "Special File Creation."
@.H 3 "Make a Directory."
@.H 4 "Synopsis."
@.H 4 "Description."
@.H 4 "Returns."
@.H 4 "Errors."
@.H 4 "References."
@.H 3 "Make a \s-1FIFO\s0 Special File."
@.H 4 "Synopsis."
@.H 4 "Description."
@.H 4 "Returns."
@.H 4 "Errors."
@.H 4 "References."
@.H 2 "File Removal."
@.H 3 "Remove Directory Entries."
@.H 4 "Synopsis."
@.H 4 "Description."
@.H 4 "Returns."
@.H 4 "Errors."
@.H 4 "References."
@.H 3 "Remove a Directory."
@.H 4 "Synopsis."
@.H 4 "Description."
@.H 4 "Returns."
@.H 4 "Errors."
@.H 4 "References."
@.H 3 "Rename a File."
@.H 4 "Synopsis."
@.H 4 "Description."
@.H 4 "Returns."
@.H 4 "Errors."
@.H 4 "References."
@.H 2 "File Characteristics."
@.H 3 "File Characteristics: Header and Data Structure."
@.H 4 "<sys/stat.h> File Types."
@.H 4 "<sys/stat.h> File Modes."
@.H 4 "<sys/stat.h> Time Entries."
@.H 4 "References."
@.H 3 "Get File Status."
@.H 4 "Synopsis."
@.H 4 "Description."
@.H 4 "Returns."
@.H 4 "Errors."
@.H 4 "References."
@.H 3 "File Accessibility."
@.H 4 "Synopsis."
@.H 4 "Description."
@.H 4 "Returns."
@.H 4 "Errors."
@.H 4 "References."
@.H 3 "Change File Modes."
@.H 4 "Synopsis."
@.H 4 "Description."
@.H 4 "Returns."
@.H 4 "Errors."
@.H 4 "References."
@.H 3 "Change Owner and Group of a File."
@.H 4 "Synopsis."
@.H 4 "Description."
@.H 4 "Returns."
@.H 4 "Errors."
@.H 4 "References."
@.H 3 "Set File Access and Modification Times."
@.H 4 "Synopsis."
@.H 4 "Description."
@.H 4 "Returns."
@.H 4 "Errors."
@.H 4 "References."
@.H 2 "Configurable Pathname Variables."
@.H 3 "Get Configurable Pathname Variables."
@.H 4 "Synopsis."
@.H 4 "Description."
@.H 4 "Returns."
@.H 4 "Errors."
@.H 1 "Input and Output Primitives"
@.H 2 "Pipes."
@.H 3 "Create an Inter-Process Channel."
@.H 4 "Synopsis."
@.H 4 "Description."
@.H 4 "Returns."
@.H 4 "Errors."
@.H 4 "References."
@.H 2 "File Descriptor Manipulation."
@.H 3 "Duplicate an Open File Descriptor."
@.H 4 "Synopsis."
@.H 4 "Description."
@.H 4 "Returns."
@.H 4 "Errors."
@.H 4 "References."
@.H 2 "File Descriptor Deassignment."
@.H 3 "Close a File."
@.H 4 "Synopsis."
@.H 4 "Description."
@.H 4 "Returns."
@.H 4 "Errors."
@.H 4 "References."
@.H 2 "Input and Output."
@.H 3 "Read from a File."
@.H 4 "Synopsis."
@.H 4 "Description."
@.H 4 "Returns."
@.H 4 "Errors."
@.H 4 "References."
@.H 3 "Write to a File."
@.H 4 "Synopsis."
@.H 4 "Description."
@.H 4 "Returns."
@.H 4 "Errors."
@.H 4 "References."
@.H 2 "Control Operations on Files."
@.H 3 "Data Definitions for File Control Operations."
@.H 3 "File Control."
@.H 4 "Synopsis."
@.H 4 "Description."
@.H 4 "Returns."
@.H 4 "Errors."
@.H 4 "References."
@.H 3 "Reposition Read/Write File Offset."
@.H 4 "Synopsis."
@.H 4 "Description."
@.H 4 "Returns."
@.H 4 "Errors."
@.H 4 "References."
@.H 1 "Device- and Class-Specific Functions"
@.H 2 "General Terminal Interface."
@.H 3 "Interface Characteristics."
@.H 4 "Description."
@.H 4 "Opening a Terminal Device File."
@.H 4 "Process Groups."
@.H 4 "The Controlling Terminal."
@.H 4 "Terminal Access Control."
@.H 4 "Input Processing and Reading Data."
@.H 4 "Canonical Mode Input Processing."
@.H 4 "Non-Canonical Mode Input Processing."
@.H 5 "Case A: \s-1MIN\s0 > 0, \s-1TIME\s0 > 0."
@.H 5 "Case B: \s-1MIN\s0 > 0, \s-1TIME\s0 \&\fC=\fP 0."
@.H 5 "Case C: \s-1MIN\s0 \&\fC=\fP 0, \s-1TIME\s0 > 0."
@.H 5 "Case D: \s-1MIN\s0 \&\fC=\fP 0, \s-1TIME\s0 \&\fC=\fP 0."
@.H 4 "Writing Data and Output Processing."
@.H 4 "Special Characters."
@.H 4 "Modem Disconnect."
@.H 4 "Closing a Terminal Device File."
@.H 3 "Settable Parameters."
@.H 4 "\f2termios\fP Structure."
@.H 4 "Input Modes."
@.H 4 "Output Modes."
@.H 4 "Control Modes."
@.H 4 "Local Modes."
@.H 4 "Special Control Characters."
@.H 4 "Baud Rate Functions."
@.H 5 "Synopsis."
@.H 5 "Description."
@.H 5 "Returns."
@.H 5 "Errors."
@.H 5 "References."
@.H 2 "General Terminal Interface Control Functions."
@.H 3 "Get and Set State."
@.H 4 "Synopsis."
@.H 4 "Description."
@.H 4 "Returns."
@.H 4 "Errors."
@.H 4 "References."
@.H 3 "Line Control Functions."
@.H 4 "Synopsis."
@.H 4 "Description."
@.H 4 "Returns."
@.H 4 "Errors."
@.H 4 "References."
@.H 3 "Get Foreground Process Group \s-1ID\s0."
@.H 4 "Synopsis."
@.H 4 "Description."
@.H 4 "Returns."
@.H 4 "Errors."
@.H 4 "References."
@.H 3 "Set Foreground Process Group \s-1ID\s0."
@.H 4 "Synopsis."
@.H 4 "Description."
@.H 4 "Returns."
@.H 4 "Errors."
@.H 1 "Language-Specific Services for the C Programming Language"
@.H 2 "Referenced C Language Routines."
@.H 3 "Extensions to Time Functions."
@.H 3 "Extensions to \f2setlocale\fP\^() Function."
@.H 4 "Synopsis."
@.H 4 "Description."
@.H 2 "\s-1FILE\s0-Type C Language Functions."
@.H 3 "Map a Stream Pointer to a File Descriptor."
@.H 4 "Synopsis."
@.H 4 "Description."
@.H 4 "Returns."
@.H 4 "Errors."
@.H 4 "References."
@.H 3 "Open a Stream on a File Descriptor."
@.H 4 "Synopsis."
@.H 4 "Description."
@.H 4 "Returns."
@.H 4 "Errors."
@.H 4 "References."
@.H 3 "Interactions of Other \s-1FILE\s0-Type C Functions."
@.H 4 "\f2fopen\fP\^()."
@.H 4 "\f2fclose\fP\^()."
@.H 4 "\f2freopen\fP\^()."
@.H 4 "\f2fflush\fP\^()."
@.H 4 "\f2fgetc\fP\^(), \f2fgets\fP\^(), \f2fread\fP\^(), \f2getc\fP\^(), \f2getchar\fP\^(), \f2gets\fP\^(), \f2scanf\fP\^(), \f2fscanf\fP\^()."
@.H 4 "\f2fputc\fP\^(), \f2fputs\fP\^(), \f2fwrite\fP\^(), \f2putc\fP\^(), \f2putchar\fP\^(), \f2puts\fP\^(), \f2printf\fP\^(), \f2vprintf\fP\^(), \f2vfprintf\fP\^()."
@.H 4 "\f2fseek\fP\^(), \f2rewind\fP\^()."
@.H 4 "\f2perror\fP\^()."
@.H 4 "\f2tmpfile\fP\^()."
@.H 4 "\f2ftell\fP\^()."
@.H 4 "Error Reporting."
@.H 4 "\f2exit\fP\^(), \f2abort\fP\^()."
@.H 3 "Operations on Files \(em the \f2remove\fP\^() Function."
@.H 2 "Other C Language Functions."
@.H 3 "Non-Local Jumps."
@.H 4 "Synopsis."
@.H 4 "Description."
@.H 4 "References."
@.H 3 "Set Time Zone."
@.H 4 "Synopsis."
@.H 4 "Description."
@.H 1 "System Databases"
@.H 2 "System Databases."
@.H 2 "Database Access."
@.H 3 "Group Database Access."
@.H 4 "Synopsis."
@.H 4 "Description."
@.H 4 "Errors."
@.H 4 "Returns."
@.H 4 "References."
@.H 3 "User Database Access."
@.H 4 "Synopsis."
@.H 4 "Description."
@.H 4 "Errors."
@.H 4 "Returns."
@.H 4 "References."
@.H 1 "Data Interchange Format"
@.H 2 "Archive/Interchange File Format."
@.H 3 "Extended \&\fCtar\fP Format."
@.H 4 "References."
@.H 3 "Extended \&\fCcpio\fP Format."
@.H 4 "Header."
@.H 4 "File Name."
@.H 4 "File Data."
@.H 4 "Special Entries."
@.H 4 "\&\fCcpio\fP Values."
@.H 4 "References."
@.H 3 "Multiple Volumes."
@//E*O*F posixheads.mm//
chmod u=rwx,g=r,o=r posixheads.mm
echo Inspecting for damage in transit...
temp=/tmp/shar$$; dtemp=/tmp/.shar$$
trap "rm -f $temp $dtemp; exit" 0 1 2 3 15
cat > $temp <<\!!!
558 2373 14684 posixheads.mm
!!!
wc posixheads.mm | sed 's=[^ ]*/==' | diff -b $temp - >$dtemp
if [ -s $dtemp ]
then echo "Ouch [diff of wc output]:" ; cat $dtemp
else echo "No problems found."
fi
exit 0
Volume-Number: Volume 14, Number 26