updated some docs

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

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)
support for:
* show subscription log
* 'mailinglist' (maybe)
choose basic/expert to disable questions
choose basic/normal/expert to disable questions
export subscribers

View file

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

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

View file

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

View file

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

View file

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

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

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

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
3 - create user-sprecific suid binaries
4 - create a user-specific configuration
5 - enable stylesheet
5 - access control
6 - testing
#################################################################
1) install the package
you surely did this already :)
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
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.
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
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
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.
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.
5) enable the stylesheet
Copy the stylesheet file (/usr/share/ezmlm-web/css/default.css)
to a location of your choice. It has to be accessible by an URL - maybe
a place like "/var/www/ezmlm-web.css" could be appropriate.
Now you may have to change the "HTML_CSS_FILE" setting in your
ezmlmwebrc file. This value is a URL - not the local filename.
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
6) 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.
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

View file

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