INSTALL

   1         To install the second extended file system management program,
   2 just follow the steps:
   3
   4 1) Edit the file MCONFIG
   5
   6         This file contains definitions used in the various makefiles.  These
   7 definitions have reasonable default value but you may want to adjust them to
   8 your system configuration.
   9
  10         In particular, if you don't have the tools to build shared
  11 libraries, you'll want to comment out the "BUILD_DLL_SHLIBS = YES"
  12 line.
  13
  14 2) Compile the programs
  15
  16         Run `make world' to (a) create the dependencies files, (b)
  17 compile the libraries and the programs, and (c) run a test suite on
  18 e2fsck.  The test suite runs a series of tests; for each one, e2fsck
  19 should return an exit status of 1 on the first pass, and an exit
  20 status of 0 on the second pass.  The one exception to this is the
  21 "okgroup.img" test, which should return an exit status of 0 for both
  22 passes.
  23
  24 3) Install the programs
  25
  26         Run `make install'
  27
  28 4) Install the include files and libraries
  29
  30         You can run `make install-libs' to install the include files and
  31 libraries.  Please note that this installation is not needed for the
  32 programs to work.  It is only needed if you expect to develop other
  33 programs using the libraries or if you want to compile other program
  34 using these libraries (like the 4.4BSD dump and restore port).
  35
  36 5) Remove any pre-formatted man pages.  Some distributions will have
  37 pre-formatted manual pages which will always be displayed in
  38 preference to newer man pages in /usr/man.  If this is the case, you
  39 may need to manually remove them in order to see the correct manual
  40 pages.  The shell script in install-utils/remove_preformat_manpages
  41 may be helpful in doing so.
  42
  43 5) Make sure your /etc/fstab file is correct.
  44
  45         Some distributions install an /etc/fstab which is missing the
  46 fifth and sixth field of filesystem entry, which are the dump
  47 frequency, and the fsck pass number, respectively.  The problem with
  48 this is that the getmntent() library routine interprets those missing
  49 fields as "0", and a pass number of 0 is documented as meaning that
  50 fsck should not check that particular filesystem.  If your entries in
  51 your /etc/fstab file look liks this:
  52
  53 /dev/hda4       /        ext2        defaults
  54
  55 you should add "1 1" at the end of each line, so that they look like this:
  56
  57 /dev/hda4       /        ext2        defaults   1       1
  58
  59         There is a script in insatll-utils/convfstab (donated by
  60 Michael Weller) that may help you correct your /etc/fstab file.
  61