Return to README CVS log

Up to [local] / src / usr.bin / sudo

Annotation of src/usr.bin/sudo/README, Revision 1.4

1.4     ! millert     1: This is Sudo version 1.6.3
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
                     13: from ftp.courtesan.com 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.courtesan.com/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: ===================
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
                     43: 2.5.2 or later and either bison or byacc (sudo comes with a
                     44: pre-flex'd tokenizer and pre-yacc'd grammar parser).  You'll also
                     45: have to uncomment a few lines from the Makefile.  You can get flex
                     46: via anonymous ftp from ftp://ftp.ee.lbl.gov/pub/flex* as well as
                     47: any GNU mirror.  You can get GNU bison from
                     48: ftp://prep.ai.mit.edu/pub/gnu/bison* or any GNU mirror.
                     49:
                     50: Building the release
                     51: ====================
                     52: Please read the installation guide in the `INSTALL' file before
                     53: trying to build sudo.  The `RUNSON' file contains a list of of
                     54: platforms that this version of sudo is known to work on.  If you
                     55: can add to this list, please send mail to sudo@courtesan.com.
                     56: If something goes wrong you may want to refer to the `TROUBLESHOOTING'
                     57: file.
                     58:
                     59: Copyright
                     60: =========
                     61: Sudo is distributed under a BSD-style license.
                     62: Please refer to the `LICENSE' file included with the release for details.
                     63:
                     64: Mailing lists
                     65: =============
                     66: sudo-announce  This list receives announcements whenever a new version
                     67:                of sudo is released.
                     68:
                     69: sudo-users     This list is for questions and general discussion about sudo.
                     70:
                     71: sudo-workers   This list is for people working on and porting sudo.
                     72:
1.2       millert    73: To subscribe to a list, send a mail message to "majordomo@courtesan.com"
1.1       millert    74: with a line in the message body (_not_ the subject) of "subscribe listname"
                     75: where "listname" is one of sudo-announce, sudo-users, or sudo-workers.
                     76:
                     77: Currently all the lists are fairly low-volume so there hasn't been a
                     78: need for digest versions.
                     79:
                     80: Web page
                     81: ========
                     82: There is a sudo `web page' at http://www.courtesan.com/sudo/
                     83: that contains an overview of sudo as well as pointers to BETA versions
                     84: and other useful info.
                     85:
                     86: Bug reports
                     87: ===========
                     88: A list of known bugs may be found in the `BUGS' file.  If you have
                     89: found what you believe to be a bug, you can file a bug report with
                     90: the sudo bug database, on at web at http://www.courtesan.com/sudo/bugs/.
                     91:
                     92: Please read over the `TROUBLESHOOTING' file *before* submitting a
                     93: bug report.  When reporting bugs, please be sure to include the
                     94: version of sudo you are using as well as the platform you are running
                     95: it on.