Usenet 1994 January/usenetsourcesnewsgroupsinfomagicjanuary1994.iso/sources/std_unix/volume.14/text0037.txt

Internet Message Format | 1989-01-07 | 16.0 KB

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
                [phone], ext 448
                FAX: [phone]
                ...{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 39