src/usr.bin/sudo/README - annotate

1.10    ! millert     1: This is Sudo version 1.6.9
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
1.10    ! millert    54: trying to build sudo.
1.1       millert    55:
                     56: Copyright
                     57: =========
1.10    ! millert    58: Sudo is distributed under an ISC-style license.
1.1       millert    59: Please refer to the `LICENSE' file included with the release for details.
                     60:
                     61: Mailing lists
                     62: =============
                     63: sudo-announce  This list receives announcements whenever a new version
                     64:                of sudo is released.
1.5       millert    65:                http://www.sudo.ws/mailman/listinfo/sudo-announce
1.1       millert    66:
                     67: sudo-users     This list is for questions and general discussion about sudo.
1.5       millert    68:                http://www.sudo.ws/mailman/listinfo/sudo-users
1.1       millert    69:
                     70: sudo-workers   This list is for people working on and porting sudo.
1.5       millert    71:                http://www.sudo.ws/mailman/listinfo/sudo-workers
1.1       millert    72:
1.5       millert    73: To subscribe to a list, visit its url (as listed above) and enter
                     74: your email address to subscribe.  Digest versions are available but
                     75: these are fairly low traffic lists so the digest versions are not
                     76: a significant win.
1.1       millert    77:
1.5       millert    78: Mailing list archives are also available.  See the mailing list web sites
                     79: for the appropriate links.
1.1       millert    80:
                     81: Web page
                     82: ========
1.5       millert    83: There is a sudo `web page' at http://www.sudo.ws/sudo/
1.1       millert    84: that contains an overview of sudo as well as pointers to BETA versions
                     85: and other useful info.
                     86:
                     87: Bug reports
                     88: ===========
                     89: A list of known bugs may be found in the `BUGS' file.  If you have
                     90: found what you believe to be a bug, you can file a bug report with
1.5       millert    91: the sudo bug database, on at web at http://www.sudo.ws/bugs/.
1.1       millert    92:
                     93: Please read over the `TROUBLESHOOTING' file *before* submitting a
                     94: bug report.  When reporting bugs, please be sure to include the
                     95: version of sudo you are using as well as the platform you are running
                     96: it on.

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