-
Notifications
You must be signed in to change notification settings - Fork 0
/
Copy pathREADME
147 lines (100 loc) · 4.06 KB
/
README
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
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 <[email protected]>