src/usr.bin/sudo/README - annotate

1.4.6.1 ! millert     1: This is Sudo version 1.6.5
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.4.6.1 ! 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.4.6.1 ! 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.4.6.1 ! 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
        !            48: get GNU bison from ftp://prep.ai.mit.edu/pub/gnu/bison* or any GNU
        !            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.4.6.1 ! 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.4.6.1 ! 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.4.6.1 ! 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.4.6.1 ! millert    75:                http://www.sudo.ws/mailman/listinfo/sudo-workers
1.1       millert    76:
1.4.6.1 ! 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.4.6.1 ! 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.4.6.1 ! 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.4.6.1 ! 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.

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