Updates to the COMPILING section.
git-svn-id: file:///home/hardaker/lib/sf-bkups/net-snmp-convert-svnrepo/trunk@15610 06827809-a52a-0410-b366-d66718629ded
diff --git a/FAQ b/FAQ
index 42cd33f..14fdee9 100644
--- a/FAQ
+++ b/FAQ
@@ -117,10 +117,7 @@
Can the agent run multi-threaded?
COMPILING
How do I compile with 'cc' instead of 'gcc'?
- But gcc doesn't compile it successfully on my new Solaris system. Why not?
- On RedHat 8.0 or up I get "/usr/bin/ld: cannot find -lelf". Why?
- What about '-lbz2' or '-lselinux' errors?
- What about a failed dependency on 'libcrypto'? Where can I get that?
+ The compilation is complaining about missing libraries. Why?
I'm getting an error "autoheader: not found" - what's wrong?
How can I reduce the memory footprint?
How can I reduce the installation footprint or speed up compilation?
@@ -2837,75 +2834,36 @@
-But gcc doesn't compile it successfully on my new Solaris system. Why not?
--------------------------------------------------------------------------
+The compilation is complaining about missing libraries. Why?
+-----------------------------------------------------------
- Whenever you upgrade the operating system under Solaris, you need to
- reinstall gcc, and run the 'fixincludes' script. (This is probably
- a sensible step to take when you upgrade any operating system).
- Under Solaris 2.6, there is also a bug in the gcc 'fixinc.sv4' script.
- This needs an additional line as follows:
+ This has been seen in a number of guises over the years - most
+ commonly on Linux systems (although the problem may also occur
+ elsewhere). A typical installation may not always include the full
+ set of library links required for building the Net-SNMP software.
-*** fixinc.svr4.cln Thu Jun 15 22:03:29 1995
---- fixinc.svr4 Tue Nov 25 09:47:57 1997
-***************
-*** 191,191 ****
---- 191,192 ----
- s/__STDC__ - 0 == 0/!defined (__STRICT_ANSI__)/g
-+ s/__STDC__ - 0 == 1/defined (__STRICT_ANSI__)/g
+ This problem can usually be fixed by installing the missing packages
+ (typically the development version of a package that is already there).
- NOTE: This appears to have been resolved.
+ Examples of this that we have come across include:
+ -lelf elfutils-devel
+ -lbz2 bzip2-devel
+ -lselinux libselinux-devel
+ -lcrypto openssl/openssl-devel
+ -lbeecrypt libbeecrypt/beecrypt/beecrypt-devel.
+ These are the names of the RedHat/Fedora RPMs. Other distributions
+ or O/S's may use different names, but the basic idea should be the
+ same.
-On RedHat 8.0 or up I get "/usr/bin/ld: cannot find -lelf"?
-----------------------------------------------------------
+ A alternative quick fix is to add the missing symbolic link, using
+ something like:
+ ln -s libelf.so.1 /usr/lib/libelf.so
- A typical installation of RedHat 8.0 and up doesn't always include
- the full set of 'libelf' library links. In order to build Net-SNMP
- you may need to install the 'elfutils-devel' RPM.
-
- A alternative quick fix is to add the missing symbolic link, using:
-
- ln -s libelf.so.1 /usr/lib/libelf.so
-
- (or whatever the correct library is on your system).
- This is typically only needed when you've configured the agent to
- include the Host Resources MIB support ('--with-mib-modules=host').
-
-
-
-What about '-lbz2' or '-lselinux' errors?
-----------------------------------------
-
- This is the same basic problem - the relevant development RPMs
- have not been installed. You should either install them
- (bzip2-devel and libselinux-devel respectively), or create
- any missing symbolic links by hand:
-
- (cd /usr/lib ; ls -s libbz2* libselinux*)
- ln -s libbz2.so.1 /usr/lib/libbz2.so
- ln -s libselinux.so.1 /usr/lib/libselinux.so
-
-
-
-What about a failed dependency on 'libcrypto'? Where can I get that?
---------------------------------------------------------------------
-
- This is typically encountered when installing a Linux RPM of
- the ucd-snmp package. This library is part of the 'openssl'
- suite, so simply install that RPM first, or download the source
- from ftp://ftp.openssl.org and compile and install that.
-
- When compiling {UCD,Net}-SNMP from source, the configure script
- should detect that this library is not present, and use alternative
- arrangements for MD5-based authentication.
-
- If encryption (or SHA1-based authentication) is required, then
- this typically requires compiling from source. Under Linux, both
- the 'openssl' and 'openssl-devel' RPMs should be installed, and the
- 'config.cache' file removed before running "configure --with-openssl"
- and re-compiling.
+ giving the appropriate generic library name from the error message,
+ and the correct number for whichever version of this library you
+ have installed.
@@ -2976,8 +2934,8 @@
--disable-manuals Do not install the manuals.
--disable-scripts Do not install the scripts (mib2c, ...).
--disable-mibs Do not install the mib files.
- --disable-mib-loading Do not include code that parses and
- manipulates the mib files.
+ --disable-mib-loading Do not include code that parses and
+ manipulates the mib files.
