share/doc/psd/contents/contents.ms

   1 .\" Copyright (c) 1986, 1993
   2 .\"     The Regents of the University of California.  All rights reserved.
   3 .\"
   4 .\" Redistribution and use in source and binary forms, with or without
   5 .\" modification, are permitted provided that the following conditions
   6 .\" are met:
   7 .\" 1. Redistributions of source code must retain the above copyright
   8 .\"    notice, this list of conditions and the following disclaimer.
   9 .\" 2. Redistributions in binary form must reproduce the above copyright
  10 .\"    notice, this list of conditions and the following disclaimer in the
  11 .\"    documentation and/or other materials provided with the distribution.
  12 .\" 3. Neither the name of the University nor the names of its contributors
  13 .\"    may be used to endorse or promote products derived from this software
  14 .\"    without specific prior written permission.
  15 .\"
  16 .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
  17 .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  18 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  19 .\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
  20 .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  21 .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
  22 .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  23 .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
  24 .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
  25 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  26 .\" SUCH DAMAGE.
  27 .\"
  28 .\"     @(#)00.contents 8.1 (Berkeley) 6/8/93
  29 .\" $FreeBSD$
  30 .\"
  31 .OH '''PSD Contents'
  32 .EH 'PSD Contents'''
  33 .TL
  34 UNIX Programmer's Supplementary Documents (PSD)
  35 .if !r.U .nr .U 0
  36 .if \n(.U \{\
  37 .br
  38 .>> <a href="Title.html">Title.html</a>
  39 .\}
  40 .sp
  41 \s-2 4.4 Berkeley Software Distribution\s+2
  42 .sp
  43 \fRJune, 1993\fR
  44 .PP
  45 This volume contains documents which supplement the manual pages in
  46 .I
  47 The
  48 .UX
  49 Programmer's Reference Manual
  50 .R
  51 for the FreeBSD system as distributed by the FreeBSD Project.
  52 .SH
  53 Documents of Historical Interest
  54 .IP
  55 .tl 'The Unix Time\-Sharing System''PSD:1'
  56 .QP
  57 Dennis Ritchie and Ken Thompson's original paper about UNIX, reprinted
  58 from Communications of the ACM.
  59 .sp
  60 .IP
  61 .tl 'Unix Implementation''PSD:2'
  62 .QP
  63 Ken Thompson's description of the implementation of the Version 7
  64 kernel and file system.
  65 .sp
  66 .IP
  67 .tl 'The Unix I/O System''PSD:3'
  68 .QP
  69 Dennis Ritchie's overview of the I/O System of Version 7; still helpful for
  70 those writing device drivers.
  71 .sp
  72 .IP
  73 .tl 'Unix Programming \- Second Edition ''PSD:4'
  74 .QP
  75 Describes the programming interface to the UNIX version 7 operating
  76 system and the standard I/O library.  Should be supplemented by
  77 Kernighan and Pike, ``The UNIX Programming Environment'',
  78 Prentice-Hall, 1984 and especially by the Programmer Reference Manual
  79 section 2 (system calls) and 3 (library routines).
  80 .sp
  81 .IP
  82 .tl 'Berkeley Software Architecture Manual (4.4 Edition)''PSD:5'
  83 .if \n(.U \{\
  84 .br
  85 .>> <a href="05.sysman/paper.html">05.sysman/paper.html</a>
  86 .\}
  87 .QP
  88 A concise and terse description of the system call interface
  89 provided in Berkeley Unix, as revised for 4.4BSD.
  90 This will never be a best seller.
  91
  92 .SH
  93 Languages in common use
  94 .IP
  95 .tl 'The C Programming Language \- Reference Manual''PSD:6'
  96 .QP
  97 Official statement of the syntax of C.
  98 Should be supplemented by ``The C Programming Language,''
  99 B.W. Kernighan and D.M. Ritchie, Prentice-Hall, 1978, that
 100 contains a tutorial introduction and many examples.
 101 .sp
 102 .IP
 103 .tl 'Berkeley Pascal User\'s Manual''PSD:7'
 104 .QP
 105 An implementation of this language popular for learning to program.
 106 (Not provided in FreeBSD.)
 107 .sp
 108 .IP
 109 .tl 'A Portable Fortran 77 Compiler''PSD:8'
 110 .QP
 111 A revised version of the document which originally appeared in
 112 Volume 2b of the Bell Labs documentation;
 113 this version reflects the work done at Berkeley.
 114 (Not provided in FreeBSD.)
 115 .sp
 116 .IP
 117 .tl 'Introduction to the f77 I/O Library''PSD:9'
 118 .QP
 119 A description of the revised input/output library for Fortran 77,
 120 reflecting work carried out at Berkeley.  (Not provided in FreeBSD.)
 121
 122 .SH
 123 Programming Tools
 124 .IP
 125 .tl 'Debugging with GDB: The GNU Source-Level Debugger''PSD:10'
 126 .QP
 127 How to debug programs using the source level \fIgdb\fP debugger
 128 (or how to debug programs without having to know much about machine language).
 129 (A TeXinfo version is provided separately.)
 130 .sp
 131 .IP
 132 .tl 'A Tutorial Introduction to ADB''PSD:11'
 133 .QP
 134 How to debug programs using the assembly-language level \fIadb\fP debugger.
 135 (Not provided in FreeBSD.)
 136 .sp
 137 .IP
 138 .tl 'Make \- A Program for Maintaining Computer Programs''PSD:12'
 139 .if \n(.U \{\
 140 .br
 141 .>> <a href="12.make/paper.html">12.make/paper.html</a>
 142 .\}
 143 .QP
 144 Indispensable tool for making sure large programs are properly
 145 compiled with minimal effort.
 146 .sp
 147 .IP
 148 .tl 'An Introduction to the Source Code Control System''PSD:14'
 149 .QP
 150 A useful introductory article for those users with
 151 installations licensed for SCCS.
 152 .sp
 153 .IP
 154 .tl 'YACC: Yet Another Compiler-Compiler''PSD:15'
 155 .QP
 156 Converts a BNF specification of a language and semantic actions
 157 written in C into a compiler for that language.
 158 .sp
 159 .IP
 160 .tl 'LEX \- A Lexical Analyzer Generator''PSD:16'
 161 .QP
 162 Creates a recognizer for a set of regular expressions:
 163 each regular expression can be followed by arbitrary C code
 164 to be executed upon finding the regular expression.
 165 .sp
 166 .IP
 167 .tl 'The M4 Macro Processor''PSD:17'
 168 .QP
 169 M4 is a macro processor useful in its own right and as a
 170 front-end for C, Ratfor, and Cobol.
 171 .sp
 172 .IP
 173 .tl 'gprof: a Call Graph Execution Profiler''PSD:18'
 174 .if \n(.U \{\
 175 .br
 176 .>> <a href="18.gprof/paper.html">18.gprof/paper.html
 177 .\}
 178 .QP
 179 A program to show the call graph and execution time of a program.
 180 Indispensable aid for improving the running time of almost everything.
 181
 182 .SH
 183 General Reference
 184 .IP
 185 .tl 'An Introductory 4.4BSD Interprocess Communication Tutorial''PSD:20'
 186 .if \n(.U \{\
 187 .br
 188 .>> <a href="20.ipctut/paper.html">20.ipctut/paper.html
 189 .\}
 190 .QP
 191 How to write programs that use the Interprocess Communication Facilities
 192 of 4.4BSD.
 193 .sp
 194 .IP
 195 .tl 'An Advanced 4.4BSD Interprocess Communication Tutorial''PSD:21'
 196 .if \n(.U \{\
 197 .br
 198 .>> <a href="21.ipc/paper.html">21.ipc/paper.html
 199 .\}
 200 .QP
 201 The reference document (with some examples) for the Interprocess Communication
 202 Facilities of 4.4BSD.
 203 .sp
 204 .IP
 205 .tl 'RPCGEN Programming Guide''PSD:22'
 206 .if \n(.U \{\
 207 .br
 208 .>> <a href="22.rpcgen/paper.html">22.rpcgen/paper.html
 209 .\}
 210 .QP
 211 Manual for the ONC RPC stub-generating program, provided by Sun Microsystems.
 212 .sp
 213 .IP
 214 .tl 'Remote Procedure Call Programming Guide''PSD:23'
 215 .if \n(.U \{\
 216 .br
 217 .>> <a href="23.rpc/paper.html">23.rpc/paper.html
 218 .\}
 219 .QP
 220 A tutorial introduction to programming the ONC RPC system, provided by
 221 Sun Microsystems.
 222 .sp
 223 .IP
 224 .tl 'External Data Representation: Sun Technical Notes''PSD:24'
 225 .if \n(.U \{\
 226 .br
 227 .>> <a href="24.xdr/paper.html">24.xdr/paper.html
 228 .\}
 229 .QP
 230 Technical details about the design of the XDR component of ONC RPC,
 231 provided by Sun Microsystems.
 232 .sp
 233 .IP
 234 .tl 'External Data Representation Standard: Protocol Specification''PSD:25'
 235 .if \n(.U \{\
 236 .br
 237 .>> <a href="25.xdrrfc/paper.html">25.xdrrfc/paper.html
 238 .\}
 239 .QP
 240 The Internet RFC specifying ONC XDR, provided by Sun Microsystems.
 241 .sp
 242 .IP
 243 .tl 'Remote Procedure Calls: Protocol Specification''PSD:26'
 244 .if \n(.U \{\
 245 .br
 246 .>> <a href="26.rpcrfc/paper.html">26.rpcrfc/paper.html
 247 .\}
 248 .QP
 249 The Internet RFC specifying ONC RPC, RFC 1050, as provided by Sun
 250 Microsystems.
 251 .sp
 252 .IP
 253 .tl 'Network File System: Version 2 Protocol Specification''PSD:27'
 254 .if \n(.U \{\
 255 .br
 256 .>> <a href="27.nfsrpc/paper.html">27.nfsrpc/paper.html
 257 .\}
 258 .QP
 259 The Internet RFC specifying NFS, as provided by Sun Microsystems.
 260 Note that the NFS-compatible filesystem itself, while
 261 compliant with this specification, was not provided by Sun.
 262 .sp
 263 .IP
 264 .tl 'CVS II: Parallelizing Software Development''PSD:28'
 265 .if \n(.U \{\
 266 .br
 267 .>> <a href="28.cvs/paper.html">28.cvs/paper.html
 268 .\}
 269 .QP
 270 CVS  (Concurrent Versions System) is a front end to the
 271 RCS revision control system  which  extends  the  notion  of
 272 revision  control  from  a  collection  of files in a single
 273 directory to a hierarchical collection of  directories  each
 274 containing revision controlled files.