removed previous change from 3.0.1-tag

added 3.0.2 release
This commit is contained in:
lars 2006-01-08 06:00:22 +00:00
parent 078e99fc1d
commit ab64c6117d
58 changed files with 4420 additions and 2 deletions

View file

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

View file

@ -0,0 +1,20 @@
Package: ezmlm-web
Version: 3.0-2
Section: admin
Priority: extra
Architecture: all
Depends: perl, httpd-cgi
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/
* some perl modules (see README)

View file

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

View file

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

View file

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

View file

@ -0,0 +1,54 @@
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
Take a look at /usr/share/doc/ezmlm-web/README - section III (Requirements).
If you are able to run /usr/lib/ezmlm-web/ezmlm-web.pl without problems, then
you are ready for the next step.
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

@ -0,0 +1,7 @@
ezmlm-web (0.3.0-2) unstable; urgency=low
* small language fix
-- Lars Kruse <devel@sumpfralle.de> Sun, 08 Jan 2006 07:18:14 +0100
ezmlm-web (0.3.0-1) unstable; urgency=low
* Initial release
-- Lars Kruse <devel@sumpfralle.de> Sat, 07 Jan 2006 03:15:42 +0100

View file

@ -0,0 +1,33 @@
#!/bin/sh
#
# create user-specific suid binaries to call ezmlm-web.cgi
#
# parameters: [USERNAME] DESTINATION_FILE
# e.g.: john ~john/public_html/cgi-bin/ezmlm-web
# only root may choose a USERNAME
#
set -eu
C_SOURCE=/usr/share/ezmlm-web/index.c
which cc >/dev/null || { echo "no compiler (cc) installed - sorry" >&2; exit 1; }
[ $(id -u) -ne 0 ] && [ $# -ne 1 ] && echo "Syntax (for non-root): $(basename $0) DESTINATION_FILE" >&2 && exit 1
[ $(id -u) -eq 0 ] && [ $# -gt 2 -o $# -lt 1 ] && echo "Syntax (for root): $(basename $0) [USERNAME] DESTINATION_FILE" >&2 && exit 1
if [ $# -eq 1 ]
then EZ_USER=$(id -un)
EZ_FILE=$1
else EZ_USER=$1
EZ_FILE=$2
fi
cc -o "$EZ_FILE" "$C_SOURCE"
if [ $(id -u) -eq 0 ]
then chown "$EZ_USER". "$EZ_FILE" || { echo "the user '$EZ_USER' does not exist" >&2; rm "$EZ_FILE"; exit 1; }
fi
chmod u+s "$EZ_FILE"
echo "Successfully created '$EZ_FILE' for user '$EZ_USER'."

View file

@ -0,0 +1,10 @@
#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");
}

View file

@ -0,0 +1,25 @@
.TH ezmlm-web-make-suid 1 "January 02006" "ezmlm-web" "helper script"
.SH NAME
ezmlm-web-make-suid \- create user-specific suid wrappers for ezmlm-web
.SH SYNOPSIS
.B ezmlm-web-make-suid
[\fIUSERNAME\fR] \fIDESTINATION_FILE\fR
.SH DESCRIPTION
.PP
Create 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.
.PP
The destination file determines where to put the resulting binary.
.PP
Only root is allowed to choose a username.
.SH EXAMPLES
.PP
ezmlm-web-make-suid john ~john/public_html/ezmlm-web
.SH AUTHOR
Written by Lars Kruse
.SH "REPORTING BUGS"
Report bugs to <devel@sumpfralle.de>
.SH COPYRIGHT
Copyright \(co 02006 Lars Kruse