X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ian/git?p=userv.git;a=blobdiff_plain;f=INSTALL;h=681b61d3ceb6eb7c82d66d4e490ef73d4bf03371;hp=4b5d665b4eb0d98b2c0483474666ee1fc3d16bcd;hb=0aef92a12c32fd2e231d32dadc039a521a097b86;hpb=f7dd4f74d0a6b3399fe694f80911657aec351ffd diff --git a/INSTALL b/INSTALL index 4b5d665..681b61d 100644 --- a/INSTALL +++ b/INSTALL @@ -12,15 +12,18 @@ SYSTEM REQUIREMENTS: Programs: -* md5sum (Colin Plumb's or the GNU version) -* GNU m4 +* md5sum (GNU textutils; alternatively, Colin Plumb's, as shipped with + Debian in the `dpkg' package) - used during build only +* GNU m4 [fixme: should ship the output] * GNU make -* GNU flex +* GNU flex [fixme: should ship the output] * GCC is preferred but other compilers ought to work (though no portability testing has yet been done). ANSI C only. ints must be at least 32 bits. -* A sensible /bin/cat which notices write errors (ie not - SunOS4, BSD 4.3, or many others.) +* A sensible `cat' which notices write errors (ie not SunOS4, BSD 4.3, + or many others. GNU textutils has one. NB that this `cat' is used + at runtime and must be first on the system default PATH, so probably + in /bin.) C Library: @@ -150,6 +153,9 @@ completeness and as programming documentation. example, if the client receives a fatal signal of some kind from its execution environment (eg its controlling terminal). + 10 - The per-request child wishes the server to check whether it is + still the uservd. + 12 - The service failed onm the service side in an expected and controlled manner, for example because it was rejected in the configuration files. @@ -167,7 +173,7 @@ completeness and as programming documentation. internal error occurred. This can also occur if an attempt to block signals using sigprocmask fails. - 0-3,5-7,9-11,13-15,17-19 are not currently used. + 0-3,5-7,9,11,13-15,17-19 are not currently used by normal children. REENTRANCY IN THE LIBC: @@ -202,3 +208,44 @@ 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. + + +COPYRIGHT + +This file, INSTALL, contains installation instructions and other +details for userv. + +userv is +Copyright (C)1996-2000 Ian Jackson . +Copyright (C)2000 Ben Harris + +userv is free software; you can redistribute it and/or modify it under +the terms of the GNU General Public License as published by the Free +Software Foundation; either version 2 of the License, or (at your +option) any later version. + +This program is distributed in the hope that it will be useful, but +WITHOUT ANY WARRANTY; without even the implied warranty of +MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU +General Public License for more details. + +You should have received a copy of the GNU General Public License +along with userv as the file COPYING; if not, email me at the address +above or write to the Free Software Foundation, 59 Temple Place - +Suite 330, Boston, MA 02111-1307, USA.