X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ian/git?p=userv-utils.git;a=blobdiff_plain;f=README;h=19dcace9fbf2305d554231e6c55be45aeafa9379;hp=3c18d1bafd37be050ef66d88358ddce135d0bce2;hb=4f937f540734e6f5977b9c279f8f24035a259310;hpb=f9b4e3fecc797d721aedd03c713c32c11dc3db3c diff --git a/README b/README index 3c18d1b..19dcace 100644 --- a/README +++ b/README @@ -1,10 +1,10 @@ -This is userv-utils. It is a collection of utilities and scripts that -serve both as examples for how to use userv, and in some cases, -hopefully as useful programs. +This is userv-utils. It is a collection of utilities, scripts and example +configuration files that serve both as examples for how to use userv, and in +some cases, hopefully as useful programs and services. -Please see each individual directory for details, installation -instructions, documentation, invididual copyright statements, and -anything else that might be available. +Please see each individual directory for any details, installation +instructions, documentation, invididual copyright statements, and anything +else, that is available. If you do not know what userv is, see its WWW page at http://www.chiark.greenend.org.uk/~ian/userv/. For now at least, the @@ -12,7 +12,7 @@ userv mailing lists should be used to discuss these and other userv-using programs. Please send bug reports and suggestions to -userv-maint@chiark.greenend.org.uk, or to the userv-discuss mailing +ijackson@chiark.greenend.org.uk, or to the userv-discuss mailing list if you are subscribed to it. @@ -20,48 +20,56 @@ Here is a quick summary of the currently available utilities Directory Status Description (UC=`users can ...') --------------- ----- ------------------------------------------------ -groupmanage Y Y P UC create groups, add/remove members, &c -www-cgi B Y Y UC provide CGIs which run as themselves -ipif B Y X UC create IP interfaces/tunnels (Linux only) -newsrc-lg B P X Acquire list of subscribed groups from .newsrcs -misc/mailq S C X UC list mail queue even if sendmail forbids -misc/ndc-reload S C X UC reload named after editing own zone files - +groupmanage Y Y A UC create groups, add/remove members, &c +ipif Y Y A UC create IP interfaces/VPNs (Linux-specific) +www-cgi Y Y A UC provide CGIs which run as themselves +misc/mailq* Y S S UC list mail queue even if sendmail forbids +misc/ndc-reload Y S S UC reload named after editing own zone files +misc/checkpass* Y Y S UC check own password; some can check any passwd +git-daemon Y Y Y UC safely publish git repositories on port 9418 +newsrc-lg X B X Acquire list of subscribed groups from .newsrcs +dyndns Y Y Y UC edit simple DNS entries for certian domains Key to the Status: - First letter is general status: - Y Released; hopefully of production quality. - B Beta. Not released, but hopefully useful with care. - A Alpha. Probably buggy. Not widely tested or debugged. - X Example/experimental - for documentation purposes only, - not recommended for use. - S Too small to be relevant - Second letter is completeness: + First letter is completeness: Y Complete. P Partially complete, some glue or modification needed. X Incomplete. Much extra stuff is required. + Second letter is general status: + Y Released; hopefully of production quality. + B Beta. Not fully released, but hopefully useful with care. + A Alpha. Probably buggy. Not well tested or widely used. + X Example/experimental - for documentation purposes only, + not recommended for use. + S Too small for this question to be relevant. Third letter is documentation: - Y Supplied documentation is believed adequate. + Y Full installation and use instructions included. + A Documentation is believed largely adequate, but a bit rough. P Partial documentation or hints. Good sysadmins should cope. X No documentation. Good luck ! + S Too small to need any significant documentation. userv-utils are -Copyright (C)1996-9 Ian Jackson . +Copyright 1996-2013,2016 Ian Jackson +Copyright 1998 David Damerell +Copyright 1999,2003 + Chancellor Masters and Scholars of the University of Cambridge +Copyright 2010 Tony Finch +Copyright 2013,2016 Mark Wooding -All the utilities here are free software. You can redistribute it -and/or modify them under the terms of the GNU General Public License -as published by the Free Software Foundation; either version 2 of the -License, or (at your option) any later version. +All the utilities here are free software; you can redistribute it and/or +modify it under the terms of the GNU General Public License as published by +the Free Software Foundation; either version 3 of the License, or (at your +option) any later version. -These programs are distributed in the hope that they will be useful, -but WITHOUT ANY WARRANTY; without even the implied warranty of +This program is distributed in the hope that it will be useful, but +WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License -along with userv-utils as the file COPYING; if not, email me at the -address above or write to the Free Software Foundation, 59 Temple -Place - Suite 330, Boston, MA 02111-1307, USA. +along with userv-utils; if not, see http://www.gnu.org/licenses/. + Local variables: mode: text