Annotation of src/usr.bin/sudo/README, Revision 1.8
1.8 ! millert 1: This is Sudo version 1.6.7
1.1 millert 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
1.5 millert 13: from ftp.sudo.ws in the directory /pub/sudo/.
1.1 millert 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,
1.5 millert 26: see the web page, http://www.sudo.ws/sudo/.
1.1 millert 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: ===================
1.2 millert 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.
1.1 millert 41:
42: If you wish to modify the parser then you will need flex version
1.5 millert 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
1.8 ! millert 48: get GNU bison from ftp://ftp.gnu.org/pub/gnu/bison/ or any GNU
1.5 millert 49: mirror.
1.1 millert 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
1.5 millert 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'
1.1 millert 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.
1.5 millert 69: http://www.sudo.ws/mailman/listinfo/sudo-announce
1.1 millert 70:
71: sudo-users This list is for questions and general discussion about sudo.
1.5 millert 72: http://www.sudo.ws/mailman/listinfo/sudo-users
1.1 millert 73:
74: sudo-workers This list is for people working on and porting sudo.
1.5 millert 75: http://www.sudo.ws/mailman/listinfo/sudo-workers
1.1 millert 76:
1.5 millert 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.
1.1 millert 81:
1.5 millert 82: Mailing list archives are also available. See the mailing list web sites
83: for the appropriate links.
1.1 millert 84:
85: Web page
86: ========
1.5 millert 87: There is a sudo `web page' at http://www.sudo.ws/sudo/
1.1 millert 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
1.5 millert 95: the sudo bug database, on at web at http://www.sudo.ws/bugs/.
1.1 millert 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.