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