ezmlm-web/ezmlm-web
3
0
Fork 0
Code Issues Pull requests Projects Releases Wiki Activity

updated some docs

Browse source 
removed old 'debian-related' directory
This commit is contained in:
lars 2006-04-30 08:06:21 +00:00
parent b4507d7ec0
commit 5b2d8f7d01
12 changed files with 49 additions and 133 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

6
TODO
View file

@ -1,14 +1,10 @@
ezmlm-idx5: modsub and modpost are ignored, if the flag is not set
"cancel" button during text editing (simple "reset" input button)
restore user input after failed list_create (especially options) restore user input after failed list_create (especially options)
support for: support for:
* show subscription log * show subscription log
* 'mailinglist' (maybe) * 'mailinglist' (maybe)
choose basic/expert to disable questions choose basic/normal/expert to disable questions
export subscribers export subscribers

1
debian-related/DEBIAN/conffiles
View file

@ -1 +0,0 @@
/etc/ezmlm-web/ezmlmwebrc

21
debian-related/DEBIAN/control
View file

@ -1,21 +0,0 @@
Package: ezmlm-web
Version: 3.2-1
Section: admin
Priority: extra
Architecture: any
Depends: perl, httpd-cgi, libemail-address-perl, libemail-ezmlm-perl (>= 0.07)
Suggests: qmail-src, bash (>=2.0), gcc
Maintainer: Lars Kruse <devel@sumpfralle.de>
Description: Web interface for ezmlm-idx mailing list administration
This web interface allows you to configure every part of an ezmlm-idx
mailing list.
Access control makes it possible, to share the administrative work in a
controlled way.
This package depends on the following programs, that are not part of the main
debian distribution:
* qmail - http://cr.yp.to/qmail.html
* ezmlm-idx - http://ezmlm.org/
* clearsilver for perl (>= 0.10.2) - http://www.clearsilver.net/downloads/
* Mail::Ezmlm perl module via cpan or as debian package from
https://systemausfall.org/toolforge/debian

3
debian-related/DEBIAN/postinst
View file

@ -1,3 +0,0 @@
#!/bin/sh
true

3
debian-related/DEBIAN/postrm
View file

@ -1,3 +0,0 @@
#!/bin/sh
true

3
debian-related/DEBIAN/prerm
View file

@ -1,3 +0,0 @@
#!/bin/sh
true

54
debian-related/README.Debian
View file

@ -1,54 +0,0 @@
How to use ezmlm-web with debian
Table of content
1 - install the package
2 - install required additional software
3 - create user-sprecific suid binaries
4 - create a user-specific configuration
5 - access control
6 - testing
#################################################################
1) install the package
you surely did this already :)
2) install required additional software
clearsilver perl bindings:
* download clearsilver (http://clearsilver.net) v0.10.2 or higher
* compile and install it with perl enabled
3) create user-specific suid binaries
As perl-suid is considered deprecated, you have to compile a C-wrapper
for every user of your debian system, who wants to manage his mailing
lists with ezmlm-we.
Usually you do this only for your virtual mailing list user.
to create a wrapper, type the following:
ezmlm-web-make-suid USERNAME DESTINATION_FILE
e.g: ezmlm-web-make-suid john ~john/public_html/cgi-bin/ezmlm-web
4) create a user-specific configuration file (optional)
Copy /usr/share/doc/ezmlm-web/examples/ezmlmwebrc to ~john/.ezmlmwebrc
and change its content according to your setup.
5) access control (optional)
configure access control for the fresh cgi binary. Maybe you can
use the htaccess.sample file in /usr/share/doc/ezmlm-web/examples as
a template.
Now you should create a webusers file to define the permissions of all
possible web users. An example webusers file can be found at
/usr/share/doc/ezmlm-web/examples/webusers.sample.
See /usr/share/doc/ezmlm-web/README for details about access control.
6) testing
Now you can access the ezmlm-web interface by using your web browser.
e.g. point it to http://localhost/~john/cgi-bin/ezmlm-web

3
debian-related/changelog.Debian
View file

@ -1,3 +0,0 @@
ezmlm-web (0.3.2-1) unstable; urgency=low
* Initial release
-- Lars Kruse <devel@sumpfralle.de> Fri, 14 Apr 2006 14:36:47 +0100

10
debian-related/index.c
View file

@ -1,10 +0,0 @@
#include <stdio.h>
/* C wrapper to allow ezmlm-web.cgi to run suid */
/* Copyright (C) 1999/2000, Guy Antony Halse, All Rights Reserved */
/* See the README file in this distribution for copyright information */
int main(void) {
/* Change this path to wherever you decided to put ezmlm-web.cgi */
execv("/usr/lib/ezmlm-web/ezmlm-web.pl");
}

64
debian/README.Debian vendored
View file

@ -5,50 +5,62 @@ Table of content
2 - install required additional software 2 - install required additional software
3 - create user-sprecific suid binaries 3 - create user-sprecific suid binaries
4 - create a user-specific configuration 4 - create a user-specific configuration
5 - enable stylesheet
5 - access control 5 - access control
6 - testing 6 - testing
################################################################# #################################################################
1) install the package 1) install the package
you surely did this already :) you surely did this already :)
2) install required additional software 2) install required additional software
clearsilver perl bindings: clearsilver perl bindings:
* download clearsilver (http://clearsilver.net) v0.10.2 or higher * download clearsilver (http://clearsilver.net) v0.10.2 or higher
* compile and install it with perl enabled * compile and install it with perl enabled
3) create user-specific suid binaries 3) create user-specific suid binaries
As perl-suid is considered deprecated, you have to compile a C-wrapper As perl-suid is considered deprecated, you have to compile a C-wrapper
for every user of your debian system, who wants to manage his mailing for every user of your debian system, who wants to manage his mailing
lists with ezmlm-we. lists with ezmlm-we.
Usually you do this only for your virtual mailing list user. Usually you do this only for your virtual mailing list user.
to create a wrapper, type the following: to create a wrapper, type the following:
ezmlm-web-make-suid USERNAME DESTINATION_FILE ezmlm-web-make-suid USERNAME DESTINATION_FILE
e.g: ezmlm-web-make-suid john ~john/public_html/cgi-bin/ezmlm-web e.g: ezmlm-web-make-suid john ~john/public_html/cgi-bin/ezmlm-web
4) create a user-specific configuration file (optional) 4) create a user-specific configuration file (optional)
Copy /usr/share/doc/ezmlm-web/examples/ezmlmwebrc to ~john/.ezmlmwebrc Copy /usr/share/doc/ezmlm-web/examples/ezmlmwebrc to ~john/.ezmlmwebrc
and change its content according to your setup. and change its content according to your setup.
5) access control (optional) 5) enable the stylesheet
configure access control for the fresh cgi binary. Maybe you can Copy the stylesheet file (/usr/share/ezmlm-web/css/default.css)
use the htaccess.sample file in /usr/share/doc/ezmlm-web/examples as to a location of your choice. It has to be accessible by an URL - maybe
a template. a place like "/var/www/ezmlm-web.css" could be appropriate.
Now you may have to change the "HTML_CSS_FILE" setting in your
Now you should create a webusers file to define the permissions of all ezmlmwebrc file. This value is a URL - not the local filename.
possible web users. An example webusers file can be found at
/usr/share/doc/ezmlm-web/examples/webusers.sample.
See /usr/share/doc/ezmlm-web/README for details about access control.
6) testing 6) access control (optional)
Now you can access the ezmlm-web interface by using your web browser. Configure access control for the fresh cgi binary. Maybe you can
e.g. point it to http://localhost/~john/cgi-bin/ezmlm-web use the htaccess.sample file in /usr/share/doc/ezmlm-web/examples as
a template.
Now you should create a webusers file to define the permissions of all
possible web users. An example webusers file can be found at
/usr/share/doc/ezmlm-web/examples/webusers.sample.
See /usr/share/doc/ezmlm-web/README for details about access control.
7) testing
Now you can access the ezmlm-web interface by using your web browser.
e.g. point it to http://localhost/~john/cgi-bin/ezmlm-web
If the web interface looks not as colorful as you expected, then you
may have to revisit your stylesheet setting (HTML_CSS_FILE in ezmlmwebrc).

6
debian/docs vendored Normal file
View file

@ -0,0 +1,6 @@
changelog
INSTALL.clearsilver
README
README.gnupg
UPGRADING
TODO

8
man/ezmlm-web-make-suid.1
View file

@ -6,11 +6,11 @@ ezmlm-web-make-suid \- create user-specific suid wrappers for ezmlm-web
[\fIUSERNAME\fR] \fIDESTINATION_FILE\fR [\fIUSERNAME\fR] \fIDESTINATION_FILE\fR
.SH DESCRIPTION .SH DESCRIPTION
.PP .PP
Compile a user-specific suid wrapper for ezmlm-web. This is necessary, as Create a user-specific copy of the suid wrapper for ezmlm-web. This is
the mailing lists are usually not owned by the webserver, that executes necessary, as the mailing lists are usually not owned by the user of the
the cgi. webserver, that executes the cgi.
.PP .PP
The destination file determines where to put the resulting binary. The destination file determines where to put the resulting wrapper.
.PP .PP
Only root is allowed to choose a username. Only root is allowed to choose a username.
.SH EXAMPLES .SH EXAMPLES