aboutsummaryrefslogtreecommitdiff
path: root/contrib/mod_passwd/README
diff options
context:
space:
mode:
Diffstat (limited to 'contrib/mod_passwd/README')
-rw-r--r--contrib/mod_passwd/README30
1 files changed, 30 insertions, 0 deletions
diff --git a/contrib/mod_passwd/README b/contrib/mod_passwd/README
new file mode 100644
index 0000000..6aa2352
--- /dev/null
+++ b/contrib/mod_passwd/README
@@ -0,0 +1,30 @@
+$Id: README,v 1.1 1999/03/13 23:06:15 kalt Exp $
+
+This is an example module for the authentication program (iauth) used by
+the IRC server.
+
+* This module demonstrates how a module can access and use the PASS and
+ USER information provided by users. It is *NOT* a finished product. In
+ particular, the actual password validation is not implemented.
+
+* This module also demonstrates how a DSM module should be written. You'll
+ note that it is completely identical to ordinary modules, except for one
+ extra function: "passwd_load()"
+
+To be used, this module needs to be compiled from the normal compilation
+directory. It should be linked as a dynamic library. Methods vary
+depending on the compiler and platform.
+
+$ gcc -c -g -I../iauth -I../common -I. ../contrib/mod_passwd/mod_passwd.c
+$ ld -Bshareable mod_passwd.o -o mod_passwd.so
+$ ls -l mod_passwd.so
+-rwxr--r-- 1 kalt staff 26932 Mar 13 17:59 mod_passwd.so
+$
+
+To be used by iauth, add the following lines to the iauth.conf file:
+
+ extinfo
+ shared passwd /path/to/mod_passwd.so
+ module passwd
+
+See iauth.conf(5) for more information on configuring iauth.