Merge branch 'maint' into next
[e2fsprogs.git] / INSTALL
blob2dd08f53bdae7c29b6c360125c51591383d907ba
1         To install the second extended file system management programs,
2 just follow the steps:
4 1) Change directory into the top of the e2fsprogs source tree
6 2) Create a build directory and cd into it:
8         mkdir build; cd build
10 3)  Run the configure script
12         ../configure
14         If you wish to turn on ELF shared libraries, add the option
15 --enable-elf-shlibs.  If you wish to build profiling libraries, add
16 the option --enable-profile.
18         Note that if you are building on an older system (i.e., a 2.4
19 kernel and/or glibc 2.2), the use of thread local storage will probably
20 cause programs that use the uuid library to core dump.  To disable
21 thread local storage, use the configure option --disable-tls.
23 4)  Compile the programs
25         make
27 5)   Check to make sure the installation built correctly:
29         make check
31 6)  Install the programs
33         Run `make install'
35 7)  Install the include files and libraries
37         You can run `make install-libs' to install the include files and
38 libraries.  Please note that this installation is not needed for the
39 programs to work.  It is only needed if you expect to develop other
40 programs using the libraries or if you want to compile other program
41 using these libraries (like the 4.4BSD dump and restore port).
43 8)  Remove any pre-formatted man pages.  
45         Some distributions will have pre-formatted manual pages which
46 will always be displayed in preference to newer man pages in /usr/man.
47 If this is the case, you may need to manually remove them in order to
48 see the correct manual pages.  The shell script in
49 install-utils/remove_preformat_manpages may be helpful in doing so.
51 9)  Make sure your /etc/fstab file is correct.
53         Some distributions install an /etc/fstab which is missing the
54 fifth and sixth field of filesystem entry, which are the dump
55 frequency, and the fsck pass number, respectively.  The problem with
56 this is that the getmntent() library routine interprets those missing
57 fields as "0", and a pass number of 0 is documented as meaning that
58 fsck should not check that particular filesystem.  If your entries in
59 your /etc/fstab file look like this:
61 /dev/hda4       /        ext2        defaults
63 you should add "1 1" at the end of each line, so that they look like this:
65 /dev/hda4       /        ext2        defaults   1       1
67         There is a script in install-utils/convfstab (donated by
68 Michael Weller) that may help you correct your /etc/fstab file.