chiark / gitweb /
dyndns: Docuument existence in README.
[userv-utils] / README
CommitLineData
4ef650d5 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
4ef650d5 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--------------- ----- ------------------------------------------------
4ef650d5 23groupmanage Y Y A UC create groups, add/remove members, &c
5124214b 24ipif Y Y A UC create IP interfaces/VPNs (Linux-specific)
a04d96bc 25www-cgi Y Y A UC provide CGIs which run as themselves
be995f34 26misc/mailq* Y S S UC list mail queue even if sendmail forbids
4ef650d5 27misc/ndc-reload Y S S UC reload named after editing own zone files
5e5500ed 28misc/checkpass* Y Y S UC check own password; some can check any passwd
ef974b1a 29git-daemon Y Y Y UC safely publish git repositories on port 9418
4ef650d5 30newsrc-lg X B X Acquire list of subscribed groups from .newsrcs
40ad9f41 31dyndns Y Y Y UC edit simple DNS entries for certian domains
f9b4e3fe 32
33Key to the Status:
4ef650d5 34 First letter is completeness:
35 Y Complete.
36 P Partially complete, some glue or modification needed.
37 X Incomplete. Much extra stuff is required.
38 Second letter is general status:
f9b4e3fe 39 Y Released; hopefully of production quality.
5edd1887 40 B Beta. Not fully released, but hopefully useful with care.
4ef650d5 41 A Alpha. Probably buggy. Not well tested or widely used.
f9b4e3fe 42 X Example/experimental - for documentation purposes only,
43 not recommended for use.
4ef650d5 44 S Too small for this question to be relevant.
f9b4e3fe 45 Third letter is documentation:
4ef650d5 46 Y Full installation and use instructions included.
47 A Documentation is believed largely adequate, but a bit rough.
f9b4e3fe 48 P Partial documentation or hints. Good sysadmins should cope.
49 X No documentation. Good luck !
4ef650d5 50 S Too small to need any significant documentation.
f9b4e3fe 51
52userv-utils are
5e5500ed 53Copyright (C)1996-2013 Ian Jackson <ian@davenant.greenend.org.uk>.
4ef650d5 54Copyright (C)1998 David Damerell <damerell@chiark.greenend.org.uk>
711a0748 55Copyright (C)1999,2003
56 Chancellor Masters and Scholars of the University of Cambridge
ef974b1a 57Copyright (C)2010 Tony Finch <fanf@dotat.at>
f9b4e3fe 58
59All the utilities here are free software. You can redistribute it
60and/or modify them under the terms of the GNU General Public License
61as published by the Free Software Foundation; either version 2 of the
62License, or (at your option) any later version.
63
64These programs are distributed in the hope that they will be useful,
65but WITHOUT ANY WARRANTY; without even the implied warranty of
66MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
67General Public License for more details.
68
69You should have received a copy of the GNU General Public License
70along with userv-utils as the file COPYING; if not, email me at the
71address above or write to the Free Software Foundation, 59 Temple
72Place - Suite 330, Boston, MA 02111-1307, USA.
73
4ef650d5 74
5124214b 75$Id$
76
f9b4e3fe 77Local variables:
78mode: text
79fill-column: 77
80End: