chiark / gitweb /
Update VERSION
[userv-utils] / README
CommitLineData
9e5d1969 1This is userv-utils. It is a collection of utilities, scripts and example
2configuration files that serve both as examples for how to use userv, and in
3some cases, hopefully as useful programs and services.
f9b4e3fe 4
9e5d1969 5Please see each individual directory for any details, installation
6instructions, documentation, invididual copyright statements, and anything
7else, that is available.
f9b4e3fe 8
9If you do not know what userv is, see its WWW page at
10http://www.chiark.greenend.org.uk/~ian/userv/. For now at least, the
11userv mailing lists should be used to discuss these and other
12userv-using programs.
13
14Please send bug reports and suggestions to
15userv-maint@chiark.greenend.org.uk, or to the userv-discuss mailing
16list if you are subscribed to it.
17
18
19Here is a quick summary of the currently available utilities
20
21Directory Status Description (UC=`users can ...')
22--------------- ----- ------------------------------------------------
9e5d1969 23groupmanage Y Y A UC create groups, add/remove members, &c
24www-cgi Y B A UC provide CGIs which run as themselves
f390139f 25ipif Y B P UC create IP interfaces/VPNs (Linux-specific)
9e5d1969 26misc/mailq Y S S UC list mail queue even if sendmail forbids
27misc/ndc-reload Y S S UC reload named after editing own zone files
28newsrc-lg X B X Acquire list of subscribed groups from .newsrcs
f9b4e3fe 29
30Key to the Status:
9e5d1969 31 First letter is completeness:
32 Y Complete.
33 P Partially complete, some glue or modification needed.
34 X Incomplete. Much extra stuff is required.
35 Second letter is general status:
f9b4e3fe 36 Y Released; hopefully of production quality.
37 B Beta. Not released, but hopefully useful with care.
9e5d1969 38 A Alpha. Probably buggy. Not well tested or widely used.
f9b4e3fe 39 X Example/experimental - for documentation purposes only,
40 not recommended for use.
9e5d1969 41 S Too small for this question to be relevant.
f9b4e3fe 42 Third letter is documentation:
9e5d1969 43 Y Full installation and use instructions included.
44 A Documentation is believed largely adequate, but a bit rough.
f9b4e3fe 45 P Partial documentation or hints. Good sysadmins should cope.
46 X No documentation. Good luck !
9e5d1969 47 S Too small to need any significant documentation.
f9b4e3fe 48
49userv-utils are
f390139f 50Copyright (C)1996-2000 Ian Jackson <ian@davenant.greenend.org.uk>.
9e5d1969 51Copyright (C)1998 David Damerell <damerell@chiark.greenend.org.uk>
f9b4e3fe 52
53All the utilities here are free software. You can redistribute it
54and/or modify them under the terms of the GNU General Public License
55as published by the Free Software Foundation; either version 2 of the
56License, or (at your option) any later version.
57
58These programs are distributed in the hope that they will be useful,
59but WITHOUT ANY WARRANTY; without even the implied warranty of
60MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
61General Public License for more details.
62
63You should have received a copy of the GNU General Public License
64along with userv-utils as the file COPYING; if not, email me at the
65address above or write to the Free Software Foundation, 59 Temple
66Place - Suite 330, Boston, MA 02111-1307, USA.
67
9e5d1969 68
f9b4e3fe 69Local variables:
70mode: text
71fill-column: 77
72End: