]> granicus.if.org Git - sudo/blob - README
If the sudoreplay ID option is a fully-qualified path, use it directly.
[sudo] / README
1 The sudo philosophy
2 ===================
3 Sudo is a program designed to allow a sysadmin to give limited root privileges
4 to users and log root activity.  The basic philosophy is to give as few
5 privileges as possible but still allow people to get their work done.
6
7 Where to find sudo
8 ==================
9 Before you try and build sudo, *please* make sure you have the current
10 version.  The latest sudo may always be gotten via anonymous ftp from
11 ftp.sudo.ws in the directory /pub/sudo/ or from the sudo web site,
12 https://www.sudo.ws/
13
14 The distribution is sudo-M.m.tar.gz where `M' is the major version
15 number and `m' is the minor version number.  BETA versions of sudo may
16 also be available.  If you join the `sudo-workers' mailing list you
17 will get the BETA announcements (see the `Mailing lists' section below).
18
19 What's new
20 ==========
21 See the NEWS file for a list of major changes in this release.
22 For a complete list of changes, see the ChangeLog file.  For a
23 summary of major changes to the current stable release, see the web
24 page, https://www.sudo.ws/stable.html.
25
26 If you are upgrading from an earlier version of Sudo, please see
27 the UPGRADE file in the doc directory.
28
29 For a history of sudo please see the HISTORY file in the doc directory.
30 You can find a list of contributors to sudo in the doc/CONTRIBUTORS file.
31
32 Building the release
33 ====================
34 Please read the installation guide in the `INSTALL' file before trying to
35 build sudo.  Pay special attention to the "OS dependent notes" section.
36
37 Copyright
38 =========
39 Sudo is distributed under an ISC-style license.
40 Please refer to the `LICENSE' file included with the release for details.
41
42 Mailing lists
43 =============
44 sudo-announce   This list receives announcements whenever a new version
45                 of sudo is released.
46                 https://www.sudo.ws/mailman/listinfo/sudo-announce
47
48 sudo-users      This list is for questions and general discussion about sudo.
49                 https://www.sudo.ws/mailman/listinfo/sudo-users
50
51 sudo-workers    This list is for people working on and porting sudo.
52                 https://www.sudo.ws/mailman/listinfo/sudo-workers
53
54 sudo-commits    This list receives a message for each commit made to
55                 the sudo source repository.
56                 https://www.sudo.ws/mailman/listinfo/sudo-commits
57
58 To subscribe to a list, visit its url (as listed above) and enter
59 your email address to subscribe.  Digest versions are available but
60 these are fairly low traffic lists so the digest versions are not
61 a significant win.
62
63 Mailing list archives are also available.  See the mailing list web sites
64 for the appropriate links.
65
66 Web page
67 ========
68 There is a sudo web page at https://www.sudo.ws/ that contains an
69 overview of sudo, documentation, downloads, a bug tracker, information
70 about beta versions and other useful info.
71
72 Bug reports
73 ===========
74 If you have found what you believe to be a bug, you can file a bug
75 report in the sudo bug database, on the web at https://bugzilla.sudo.ws/.
76
77 Please read over the `TROUBLESHOOTING' file in the doc directory *before*
78 submitting a bug report.  When reporting bugs, please be sure to include
79 the version of sudo you are using as well as the platform you are running
80 it on.