-
Notifications
You must be signed in to change notification settings - Fork 0
chaos/nph
Folders and files
Name | Name | Last commit message | Last commit date | |
---|---|---|---|---|
Repository files navigation
nph - PH Client and Library === nph is a modern client and API library for accessing PH servers. Installation ------------ To build nph, you should be able to simply run these commands: ./configure make make install Encap Package Support --------------------- To build this software as an Encap package, you can pass the --enable-encap option to configure. This will be automatically enabled if the epkg or mkencap programs are detected on the system, but can be overridden by the --disable-encap option. When building an Encap package, the configure script will automatically adjust the installation prefix to use an appropriate Encap package directory. It does this using a heuristic algorithm which examines the values of the ${ENCAP_SOURCE} and ${ENCAP_TARGET} environment variables and the argument to configure's --prefix option. If mkencap was detected on the system, it will be automatically run during "make install". By default, epkg will also be run, but this can be inhibited with the --disable-epkg-install configure option. For information on the Encap package management system, see the WSG Encap Archive: http://www.encap.org/ Readline Support ---------------- The configure script will attempt to find the readline library on your system. The readline package is available from: ftp://ftp.gnu.org/gnu/readline/ If you do not have readline-4.2 or newer, you will need to specify the --disable-readline option to configure. Installing nph Setuid --------------------- If you wish to use PH's email authentication mechanism, you must install nph to be setuid-root using the --enable-setuid-nph option to configure. SECURITY WARNING: Installing nph as a setuid-root binary may constitute a serious security hole! While I do not know of any security holes in nph, I make no guaruntees about your system security. I strongly recommend against using --enable-setuid-nph unless it is absolutely unavoidable. Default "mailmatch" Fields -------------------------- For PH servers that don't have a "mailmatches" entry in their siteinfo list, libphclient will use a built-in default for the list of fields to check when resolving email addresses. This default list can be set by specifying the --with-mailmatches=LIST option to configure. (Replace "LIST" with a ':'-delimited list of field names.) If this option is not specified, the default list is "alias:callsign". More Information ---------------- After you install nph, you will need to tell it what server to connect to. This can be set in the global ${sysconfdir}/ph_server file or by setting the environment variable ${PH_SERVER}. Alternately, you can invoke nph with "-s servername" to specify the server name on the commandline. For documentation on nph or on the libphclient API, see the enclosed manpages. For more information on the nph package, see: http://www.feep.net/nph/ Both source code and Encap binary distributions of the latest version of nph are available there. Supported Platforms ------------------- I develop and test nph on the following platforms: AIX 4.3.3 AIX 5.1 HP-UX 11.00 IRIX 6.5 RedHat Linux 7.2 Solaris 8 Solaris 9 The nph code should build properly on the following platforms, but I do not actively support them: AIX 3.2.5 AIX 4.2.1 FreeBSD HP-UX 10.20 Linux/libc5 RedHat Linux 8.0 Mac OS X OpenBSD Solaris 2.5 Solaris 2.6 Solaris 7 If you successfully build nph on another platform, please email me a patch and/or configuration information. Compatibility Code ------------------ nph depends on some library calls which are not available or not usable on some platforms. To accomodate these systems, I've included a version of these calls in the lib/compat subdirectory. I've slightly modified these functions for integration into this source tree, but the functionality has not been modified from the original source. Please note that while this code should work for you, I didn't write it, so please don't send me bug reports on it. Author ------ Feedback and bug reports are welcome. Mark D. Roth <roth@feep.net>