Portability and doc fixes, including my own portability patches and some suggestions...

[userv.git] / INSTALL

diff --git a/INSTALL b/INSTALL
index 304f2a36cbc223b274f82081b67cad4580ea6f1b..3fe90525d356feeb0f13211556cbcd460e79dcc1 100644 (file)
--- a/INSTALL
+++ b/INSTALL
@@ -14,7 +14,7 @@ Programs:
 
 * md5sum (GNU textutils; alternatively, Colin Plumb's, as shipped with
           Debian in the `dpkg' package) - used during build only
-* GNU m4 (only if you need to change the m4 input)
+* GNU m4 [fixme: should ship the output]
 * GNU make
 * GNU flex [fixme: should ship the output]
 * GCC is preferred but other compilers ought to work (though
@@ -205,3 +205,19 @@ PROBLEMS
   The bug is actually in your system header files, for not specifying
   the number and types of arguments to signal handler functions when
   they cast in the SIG_IGN and SIG_DFL macros.
+
+DEBUGGING VERSION
+
+If you run configure with --enable-debug, a debugging version will be
+built.  This will look in the current directory (the build directory)
+for the base of various things, including the IPC area (which you must
+therefore construct yourself).  The debugging version will produce
+extra output at various points.  It will not attempt to call
+setgroups(), instead just checking that the groups list is right, so
+it will work non-setuid if the daemon is invoked as the service user.
+The daemon won't fork for each request; instead, it will handle a
+single request and exit.
+
+There may be other changes.  Consult the code for details.  Making the
+debugging version of the client or daemon setuid root is probably a
+bad idea.  They may not work if they are run as different users.