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