











                           44..44BBSSDD


                  SSyysstteemm MMaannaaggeerr''ss MMaannuuaall



                           ((SSMMMM))




















































Now  in its twentieth year, the USENIX Association, the UNIX
and Advanced Computing Systems  professional  and  technical
organization,  is a not-for-profit membership association of
individuals and institutions with an interest  in  UNIX  and
UNIX-like  systems,  and,  by extension, C++, X windows, and
other advanced tools and technologies.

USENIX and its members are dedicated to:

+o    fostering innovation  and  communicating  research  and
     technological developments,

+o    sharing  ideas  and  experience relevant to UNIX, UNIX-
     related, and advanced computing systems, and

+o    providing a neutral forum for the exercise of  critical
     thought and airing of technical issues.

USENIX publishes a journal (CCoommppuuttiinngg SSyysstteemmss), a newsletter
(_;_l_o_g_i_n_:), Proceedings from  its  frequent  Conferences  and
Symposia, and a Book Series.

SAGE,  The Systems Administrators Guild, a Special Technical
Group with the  USENIX  Association,  is  dedicated  to  the
advancement of system administration as a profession.

SAGE brings together systems managers and administrators to:

+o    propagate knowledge of good professional practice,

+o    recruit talented individuals to the profession,

+o    recognize individuals who  attain  professional  excel-
     lence,

+o    foster  technical  development  and  share solutions to
     technical problems, and

+o    communicate in an organized voice with  users,  manage-
     ment, and vendors on system administration topics.





























                           44..44BBSSDD


                  SSyysstteemm MMaannaaggeerr''ss MMaannuuaall



                           ((SSMMMM))








               BBeerrkkeelleeyy SSooffttwwaarree DDiissttrriibbuuttiioonn


                        AApprriill,, 11999944








              CCoommppuutteerr SSyysstteemmss RReesseeaarrcchh GGrroouupp

            UUnniivveerrssiittyy ooff CCaalliiffoorrnniiaa aatt BBeerrkkeelleeyy

















                 AA UUSSEENNIIXX AAssssoocciiaattiioonn BBooookk
                OO''RReeiillllyy && AAssssoocciiaatteess,, IInncc..
                 110033 MMoorrrriiss SSttrreeeett,, SSuuiittee AA












                    SSeebbaassttooppooll,, CCAA 9944557722

































































First Printing, 1994
Second Printing, 1995


Copyright  1979,  1980,  1983, 1986, 1988, 1989, 1991, 1992,
1993, 1994 The Regents of the University of California.  All
rights reserved.


Other  than  the  specific manual pages and documents listed
below as copyrighted by AT&T, redistribution and use of this
manual in source and binary forms, with or without modifica-
tion, are permitted provided that the  following  conditions
are met:

1)   Redistributions  of  this  manual must retain the copy-
     right notices on this page, this list of conditions and
     the following disclaimer.

2)   Software  or  documentation  that  incorporates part of
     this manual must reproduce  the  copyright  notices  on
     this  page,  this  list of conditions and the following
     disclaimer in the documentation and/or other  materials
     provided with the distribution.

3)   All advertising materials mentioning features or use of
     this software must display the  following  acknowledge-
     ment: ``This product includes software developed by the
     University of California, Berkeley  and  its  contribu-
     tors.''

4)   Neither the name of the University nor the names of its
     contributors may be used to endorse or promote products
     derived from this software without specific prior writ-
     ten permission.

TTHHIISS SSOOFFTTWWAARREE IISS PPRROOVVIIDDEEDD BBYY TTHHEE  RREEGGEENNTTSS  AANNDD  CCOONNTTRRIIBBUUTTOORRSS
````AASS  IISS'''' AANNDD AANNYY EEXXPPRREESSSS OORR IIMMPPLLIIEEDD WWAARRRRAANNTTIIEESS,, IINNCCLLUUDDIINNGG,,
BBUUTT NNOOTT LLIIMMIITTEEDD TTOO,, TTHHEE IIMMPPLLIIEEDD WWAARRRRAANNTTIIEESS OOFF  MMEERRCCHHAANNTTAABBIILL--
IITTYY AANNDD FFIITTNNEESSSS FFOORR AA PPAARRTTIICCUULLAARR PPUURRPPOOSSEE AARREE DDIISSCCLLAAIIMMEEDD..  IINN
NNOO EEVVEENNTT SSHHAALLLL TTHHEE RREEGGEENNTTSS OORR CCOONNTTRRIIBBUUTTOORRSS BBEE LLIIAABBLLEE FFOORR AANNYY
DDIIRREECCTT,,  IINNDDIIRREECCTT,, IINNCCIIDDEENNTTAALL,, SSPPEECCIIAALL,, EEXXEEMMPPLLAARRYY,, OORR CCOONNSSEE--
QQUUEENNTTIIAALL DDAAMMAAGGEESS ((IINNCCLLUUDDIINNGG,, BBUUTT NNOOTT LLIIMMIITTEEDD TTOO,, PPRROOCCUURREEMMEENNTT
OOFF SSUUBBSSTTIITTUUTTEE GGOOOODDSS OORR SSEERRVVIICCEESS;; LLOOSSSS OOFF UUSSEE,, DDAATTAA,, OORR PPRROOFF--
IITTSS;; OORR BBUUSSIINNEESSSS IINNTTEERRRRUUPPTTIIOONN)) HHOOWWEEVVEERR  CCAAUUSSEEDD  AANNDD  OONN  AANNYY
TTHHEEOORRYY  OOFF LLIIAABBIILLIITTYY,, WWHHEETTHHEERR IINN CCOONNTTRRAACCTT,, SSTTRRIICCTT LLIIAABBIILLIITTYY,,
OORR TTOORRTT ((IINNCCLLUUDDIINNGG NNEEGGLLIIGGEENNCCEE OORR OOTTHHEERRWWIISSEE)) AARRIISSIINNGG  IINN  AANNYY
WWAAYY  OOUUTT OOFF TTHHEE UUSSEE OOFF TTHHIISS SSOOFFTTWWAARREE,, EEVVEENN IIFF AADDVVIISSEEDD OOFF TTHHEE
PPOOSSSSIIBBIILLIITTYY OOFF SSUUCCHH DDAAMMAAGGEE..


The Institute of Electrical and  Electronics  Engineers  and
the American National Standards Committee X3, on Information
Processing Systems  have  given  us  permission  to  reprint












portions of their documentation.

In  the following statement, the phrase ``this text'' refers
to portions of the system documentation.

``Portions of this text  are  reprinted  and  reproduced  in
electronic  form  in  4.4BSD from IEEE Std 1003.1-1988, IEEE
Standard Portable Operating System  Interface  for  Computer
Environments  (POSIX),  copyright  1988  by the Institute of
Electrical and Electronics Engineers, Inc.  In the event  of
any discrepancy between these versions and the original IEEE
Standard, the original IEEE Standard is  the  referee  docu-
ment.''

In  the  following  statement,  the phrase ``This material''
refers to portions of the system documentation.

``This material is reproduced with permission from  American
National  Standards  Committee X3, on Information Processing
Systems.   Computer  and  Business  Equipment  Manufacturers
Association  (CBEMA), 311 First St., NW, Suite 500, Washing-
ton, DC 20001-2178.  The developmental work  of  Programming
Language C was completed by the X3J11 Technical Committee.''


Manual pages cron.8, icheck.8, ncheck.8, and sa.8 and  docu-
ments SMM:15, 16, and 17 are copyright 1979, AT&T Bell Labo-
ratories, Incorporated.  Document SMM:14 is  a  modification
of an earlier document that is copyrighted 1979 by AT&T Bell
Laboratories, Incorporated.  Holders of  UNIXTM/32V,  System
III,  or  System  V  software licenses are permitted to copy
these documents, or any portion of them,  as  necessary  for
licensed use of the software, provided this copyright notice
and statement of permission are included.


The views and conclusions contained in this manual are those
of the authors and should not be interpreted as representing
official policies,  either  expressed  or  implied,  of  the
Regents of the University of California.


The  4.4BSD  Daemon  used  on the cover is copyright 1994 by
Marshall Kirk McKusick and is reproduced with permission.
This book was printed and bound  in  the  United  States  of
America.
Distributed by O'Reilly & Associates, Inc.


[recycle logo]  This book is printed on acid-free paper with
                50% recycled content,  10-13%  post-consumer
                waste. O'Reilly & Associates is committed to
                using paper with the highest  recycled  con-
                tent available consistent with high quality.












ISBN: 1-56592-080-5






































































                          CCoonntteennttss



Introduction                                             vii


List of Manual Pages                                      ix


Permuted Index                                         xxxix


Reference Manual Section 8                         tabbed M8

     Section 8 of the UNIX Programmer's Manual contains
     information  related to system operation, adminis-
     tration, and maintenance.


Installing and Operating 4.4BSD                     tabbed 1

     The definitive reference document for those  occa-
     sions  when you find you need to start over again.


Building 4.4BSD Kernels with _C_o_n_f_i_g                 tabbed 2

     In-depth discussions of the use and  operation  of
     the _c_o_n_f_i_g program, and how to build your very own
     Unix kernel.


Fsck - The UNIX File System Check Program           tabbed 3

     A reference document for using  the  _f_s_c_k  program
     during times of file system distress.


Disc Quotas in a UNIX Environment                   tabbed 4

     A  light introduction to the techniques for limit-
     ing the use of disc resources.


A Fast File System for UNIX                         tabbed 5

     A description of the 4.4BSD file system  organiza-
     tion, design and implementation.









Contents                                              - ix -


The 4.4BSD NFS Implementation                       tabbed 6

     An overview of the design, implementation, and use
     of NFS on 4.4BSD.


Line Printer Spooler Manual                         tabbed 7

     This document describes the structure and  instal-
     lation  procedure  for  the  line printer spooling
     system.


Sendmail Installation and Operation Guide           tabbed 8

     The last word  in  installing  and  operating  the
     _s_e_n_d_m_a_i_l program.


Sendmail - An Internetwork Mail Router              tabbed 9

     An overview document on the design and implementa-
     tion of _s_e_n_d_m_a_i_l.


Name Server Operations Guide for BIND              tabbed 10

     Setting up and  operating  the  name  to  Internet
     addressing  software.   If you have a network this
     will be of interest.


Timed Installation and Operation Guide             tabbed 11

     Describes how  to  maintain  time  synchronization
     between machines in a local network.


The Berkeley UNIX Time Synchronization Protocol    tabbed 12

     The  protocols  and  algorithms used by timed, the
     network time synchronization daemon.


AMD - The 4.4BSD Automounter                       tabbed 13

     Automatically mounting file systems on demand.


Installation and Operation of UUCP                 tabbed 14

     Describes the  implementation  of  uucp;  for  the
     installer and administrator.










- x -                                               Contents


A Dial-Up Network of UNIX Systems                  tabbed 15

     Describes  UUCP, a program for communicating files
     between UNIX systems.


On the Security of UNIX                            tabbed 16

     Hints on how to break UNIX, and how to avoid  your
     system being broken.


Password Security - A Case History                 tabbed 17

     How  the  bad  guys  used  to be able to break the
     password algorithm, and why they  cannot  now  (at
     least not so easily).


Networking Implementation Notes, 4.4BSD Edition    tabbed 18

     A  concise  description  of  the system interfaces
     used within the networking subsystem.


The PERL Programming Language                      tabbed 19

     The Practical Extraction and  Report  Language  is
     ideal   for   writing  those  pesky  adminitration
     scripts.


List of Documents                          inside back cover

































                          IInnttrroodduuccttiioonn



The documentation for 4.4BSD is in a format similar  to  the
one  used  for the 4.2BSD and 4.3BSD manuals.  It is divided
into three sets; each set consists of one or  more  volumes.
The  abbreviations for the volume names are listed in square
brackets; the abbreviations  for  the  manual  sections  are
listed in parenthesis.

     I. User's Documents
          User's Reference Manual [URM]
               Commands (1)
               Games (6)
               Macro packages and language conventions (7)
          User's Supplementary Documents [USD]
               Getting Started
               Basic Utilities
               Communicating with the World
               Text Editing
               Document Preparation
               Amusements

     II. Programmer's Documents
          Programmer's Reference Manual [PRM]
               System calls (2)
               Subroutines (3)
               Special files (4)
               File formats and conventions (5)
          Programmer's Supplementary Documents [PSD]
               Documents of Historic Interest
               Languages in common use
               Programming Tools
               Programming Libraries
               General Reference

     III. System Manager's Manual [SMM]
          Maintenance commands (8)
          System Installation and Administration


References  to  individual  documents  are  given  as ``vol-
ume:document'', thus USD:1 refers to the first  document  in
the  ``User's Supplementary Documents''.  References to man-
ual pages are given as ``_n_a_m_e(section)'' thus  _s_h(1)  refers
to the shell manual entry in section 1.

The  manual  pages  give descriptions of the features of the
4.4BSD system, as developed at the University of  California
at  Berkeley.  They do not attempt to provide perspective or
tutorial information about the 4.4BSD operating system,  its
facilities,  or  its  implementation.   Various documents on
those  topics   are   contained   in   the   ``UNIX   User's









- xii -                                         Introduction


Supplementary  Documents''  (USD),  the  ``UNIX Programmer's
Supplementary Documents'' (PSD), and ``UNIX System Manager's
Manual''  (SMM).   In  particular, for an overview see ``The
UNIX Time-Sharing System'' (PSD:1) by Ritchie and  Thompson;
for  a  tutorial  see  ``UNIX  for  Beginners''  (USD:1)  by
Kernighan, and for an guide to the new features of this lat-
est  version,  see  ``Berkeley  Software Architecture Manual
(4.4 Edition)'' (PSD:5).

Within the area it  surveys,  this  volume  attempts  to  be
timely,  complete  and concise.  Where the latter two objec-
tives conflict, the obvious is often left unsaid in favor of
brevity.   It  is intended that each program be described as
it is, not as it should be.   Inevitably,  this  means  that
various sections will soon be out of date.

Commands are programs intended to be invoked directly by the
user, in contrast to subroutines, that are  intended  to  be
called  by the user's programs.  User commands are described
in URM section 1.  Commands generally  reside  in  directory
_/_b_i_n  (for  _b_i_nary  programs).  Some programs also reside in
_/_u_s_r_/_b_i_n_, to save space  in  _/_b_i_n_.   These  directories  are
searched  automatically  by the command interpreters.  Addi-
tional directories that may be of interest include _/_u_s_r_/_c_o_n_-
_t_r_i_b_/_b_i_n_, which has contributed software _/_u_s_r_/_o_l_d_/_b_i_n_, which
has  old   but   sometimes   still   useful   software   and
_/_u_s_r_/_l_o_c_a_l_/_b_i_n_,  which contains software local to your site.

Games have been relegated to URM section 6  and  _/_u_s_r_/_g_a_m_e_s_,
to  keep  them from contaminating the more staid information
of URM section 1.

Miscellaneous collection of information necessary for  writ-
ing  in  various  specialized  languages  such  as character
codes, macro packages for typesetting, etc is  contained  in
URM section 7.

System  calls  are  entries into the BSD kernel.  The system
call interface is identical to a C language procedure  call;
the  equivalent C procedures are described in PRM section 2.

An  assortment  of  subroutines  is  available;   they   are
described  in PRM section 3.  The primary libraries in which
they are kept are described in _i_n_t_r_o(3).  The functions  are
described in terms of C.

PRM  section  4 discusses the characteristics of each system
``file'' that refers to an I/O device.  The  names  in  this
section  refer  to  the HP300 device names for the hardware,
instead of the names of the special files themselves.

The file formats and conventions (PRM section  5)  documents
the structure of particular kinds of files; for example, the
form of the output of the loader  and  assembler  is  given.









Introduction                                        - xiii -


Excluded are files used by only one command, for example the
assembler's intermediate files.

Commands and procedures intended for use  primarily  by  the
system  administrator  are  described in SMM section 8.  The
files described here are almost all kept  in  the  directory
_/_e_t_c_.   The  system administration binaries reside in _/_s_b_i_n_,
and _/_u_s_r_/_s_b_i_n_.

Each section consists of independent entries of a page or so
each.   The name of the entry is in the upper corners of its
pages, together with the  section  number.   Entries  within
each  section  are  alphabetized.   The page numbers of each
entry start at 1; it is infeasible to  number  consecutively
the  pages  of  a  document like this that is republished in
many variant forms.

All entries are based on a common format;  not  all  subsec-
tions always appear.

     The  _n_a_m_e  subsection lists the exact names of the com-
     mands and subroutines covered under the entry and gives
     a short description of their purpose.

     The  _s_y_n_o_p_s_i_s  summarizes  the use of the program being
     described.  A few conventions are used, particularly in
     the Commands subsection:

          BBoollddffaaccee  words  are  considered literals, and are
          typed just as they appear.

          Square brackets [ ] around an argument  show  that
          the  argument  is  optional.   When an argument is
          given as ``name'', it  always  refers  to  a  file
          name.

          Ellipses  ``...'' are used to show that the previ-
          ous argument-prototype may be repeated.

          A final convention is used by the  commands  them-
          selves.   An  argument beginning with a minus sign
          ``-'' usually means that it is an  option-specify-
          ing  argument,  even  if  it appears in a position
          where a file name could appear.  Therefore, it  is
          unwise to have files whose names begin with ``-''.

     The _d_e_s_c_r_i_p_t_i_o_n subsection discusses in detail the sub-
     ject at hand.

     The  _f_i_l_e_s subsection gives the names of files that are
     built into the program.

     A _s_e_e _a_l_s_o subsection gives pointers to related  infor-
     mation.









- xiv -                                         Introduction


     A _d_i_a_g_n_o_s_t_i_c_s subsection discusses the diagnostic indi-
     cations  that  may  be  produced.   Messages  that  are
     intended to be self-explanatory are not listed.

     The  _b_u_g_s  subsection  gives  known  bugs and sometimes
     deficiencies.  Occasionally the suggested fix  is  also
     described.

At  the  beginning  of URM, PRM, and SSM is a List of Manual
Pages, organized by section and alphabetically  within  each
section,  and  a  Permuted  Index  derived  from  that List.
Within each index entry, the title of the writeup  to  which
it  refers  is followed by the appropriate section number in
parentheses.  This fact is important because there  is  con-
siderable name duplication among the sections, arising prin-
cipally from commands that exist only to exercise a particu-
lar  system  call.  Finally, there is a list of documents on
the inside back cover of each volume.
















































                    LLiisstt ooff MMaannuuaall PPaaggeess

11.. CCoommmmaannddss aanndd AApppplliiccaattiioonn PPrrooggrraammss

22.. SSyysstteemm CCaallllss

33.. CC LLiibbrraarryy SSuubbrroouuttiinneess

44.. SSppeecciiaall FFiilleess

55.. FFiillee FFoorrmmaattss

66.. GGaammeess

77.. MMiisscceellllaanneeoouuss

88.. SSyysstteemm MMaaiinntteennaannccee








































Section 8                                 System Maintenance





- xvi -                                         Manual Pages



























































System Maintenance                                 Section 8









                       PPeerrmmuutteedd IInnddeexx























































4.4BSD                                            April 1994


