pod/sudo/original/README

   1 This is Sudo version 1.6.7
   2
   3 The sudo philosophy
   4 ===================
   5 Sudo is a program designed to allow a sysadmin to give limited root privileges
   6 to users and log root activity.  The basic philosophy is to give as few
   7 privileges as possible but still allow people to get their work done.
   8
   9 Where to find sudo
  10 ==================
  11 Before you try and build sudo, *please* make sure you have the current
  12 version.  The latest sudo may always be gotten via anonymous ftp
  13 from ftp.sudo.ws in the directory /pub/sudo/.
  14 The distribution is sudo-M.m.tar.gz where `M' is the major
  15 version number and `m' is the minor version number.
  16 BETA versions of sudo may also be available.  If you join
  17 the `sudo-workers' mailing list you will get the BETA announcements
  18 (see the `Mailing lists' section below).
  19
  20 What's new
  21 ==========
  22 For a history of sudo please see the HISTORY file that came with this
  23 release.
  24
  25 For a complete list of changes, see the CHANGES file.  For a summary,
  26 see the web page, http://www.sudo.ws/sudo/.
  27
  28 If you are upgrading from an earlier version of Sudo, please see
  29 the UPGRADE file.
  30
  31 NOTE: Starting with sudo 1.5.7 the configuration method has changed
  32       significantly as compared to previous versions.  All options
  33       are now set via the configure script.  See the `INSTALL' file
  34       for a list of all the configure options.
  35
  36 System requirements
  37 ===================
  38 To build sudo from the source distribution you need a machine running
  39 UN*X (most flavors of BSD, SYSV, or POSIX will do), a working C
  40 compiler, and the make utility.
  41
  42 If you wish to modify the parser then you will need flex version
  43 2.5.2 or later and either bison or byacc (sudo comes with a pre-flex'd
  44 tokenizer and pre-yacc'd grammar parser).  You'll also have to
  45 uncomment a few lines from the Makefile or run configure with the
  46 --with-devel option.  You can get flex via anonymous ftp from
  47 ftp://ftp.ee.lbl.gov/pub/flex* as well as any GNU mirror.  You can
  48 get GNU bison from ftp://ftp.gnu.org/pub/gnu/bison/ or any GNU
  49 mirror.
  50
  51 Building the release
  52 ====================
  53 Please read the installation guide in the `INSTALL' file before
  54 trying to build sudo.  The `RUNSON' file contains a list of of
  55 platforms that this version of sudo is known to work on.  If you
  56 can add to this list, please send mail to sudo@sudo.ws.  If
  57 something goes wrong you may want to refer to the `TROUBLESHOOTING'
  58 file.
  59
  60 Copyright
  61 =========
  62 Sudo is distributed under a BSD-style license.
  63 Please refer to the `LICENSE' file included with the release for details.
  64
  65 Mailing lists
  66 =============
  67 sudo-announce   This list receives announcements whenever a new version
  68                 of sudo is released.
  69                 http://www.sudo.ws/mailman/listinfo/sudo-announce
  70
  71 sudo-users      This list is for questions and general discussion about sudo.
  72                 http://www.sudo.ws/mailman/listinfo/sudo-users
  73
  74 sudo-workers    This list is for people working on and porting sudo.
  75                 http://www.sudo.ws/mailman/listinfo/sudo-workers
  76
  77 To subscribe to a list, visit its url (as listed above) and enter
  78 your email address to subscribe.  Digest versions are available but
  79 these are fairly low traffic lists so the digest versions are not
  80 a significant win.
  81
  82 Mailing list archives are also available.  See the mailing list web sites
  83 for the appropriate links.
  84
  85 Web page
  86 ========
  87 There is a sudo `web page' at http://www.sudo.ws/sudo/
  88 that contains an overview of sudo as well as pointers to BETA versions
  89 and other useful info.
  90
  91 Bug reports
  92 ===========
  93 A list of known bugs may be found in the `BUGS' file.  If you have
  94 found what you believe to be a bug, you can file a bug report with
  95 the sudo bug database, on at web at http://www.sudo.ws/bugs/.
  96
  97 Please read over the `TROUBLESHOOTING' file *before* submitting a
  98 bug report.  When reporting bugs, please be sure to include the
  99 version of sudo you are using as well as the platform you are running
 100 it on.