Utility to execute a command as another user
Go to file
Todd C. Miller 3226c60e6a Quiet codespell 2.3.0 complaints. 2024-11-29 14:22:31 -07:00
.circleci Disable PAM before enabling Kerberos V. 2023-10-31 10:00:24 -06:00
.github Update CIFuzz GitHub action 2024-09-13 12:23:20 -06:00
docker Add Kerberos V build and test to CI. 2023-10-31 09:54:57 -06:00
docs Shell-style substitution is not supported in env_file. 2024-11-11 09:48:07 -07:00
etc Quiet codespell 2.3.0 complaints. 2024-11-29 14:22:31 -07:00
examples Add adminconfdir and --enable-adminconf to set it. 2023-05-02 10:37:39 -06:00
include Use NODEV macro instead of explicit (dev_t)-1. 2024-11-28 11:26:00 -07:00
lib Use NODEV macro instead of explicit (dev_t)-1. 2024-11-28 11:26:00 -07:00
logsrvd Fix the date written used by the exit record in sudo-format log files 2024-09-06 13:05:47 -06:00
m4 m4/openssl.m4: fix cross-compilation with wolfssl 2024-02-22 11:12:22 -07:00
plugins Use NODEV macro instead of explicit (dev_t)-1. 2024-11-28 11:26:00 -07:00
po Updated translations from translationproject.org 2024-07-27 10:17:59 -06:00
scripts Fix a syntax error in the systemd sudo-logsrvd.postinst script: 2024-05-18 19:31:11 -06:00
src Quiet codespell 2.3.0 complaints. 2024-11-29 14:22:31 -07:00
.clang-format Minor cleanup (#110) 2021-08-19 09:48:01 -06:00
.gitignore Add plugins/sudoers/tsgetusershell.c to ignore files. 2023-10-05 13:59:44 -06:00
.hgignore Add plugins/sudoers/tsgetusershell.c to ignore files. 2023-10-05 13:59:44 -06:00
.hgtags update tags 2010-01-18 05:45:25 +00:00
INSTALL.configure Sync with autoconf git. 2022-01-25 13:06:11 -07:00
INSTALL.md Remove trailing whitespace 2024-10-28 09:23:42 -06:00
LICENSE.md Remove trailing whitespace 2024-10-28 09:23:42 -06:00
MANIFEST Updated translations from translationproject.org 2024-06-25 20:08:49 -06:00
Makefile.in Add missing subdirs to depend target. 2024-02-21 13:01:15 -07:00
NEWS Sudo 1.9.16p2 2024-11-25 08:34:04 -07:00
README.LDAP.md Run igor on other docs too, not just man pages 2024-10-28 09:33:23 -06:00
README.md Make the sections on bug reporting consistent with each other. 2023-07-27 09:51:57 -06:00
aclocal.m4 Add configure tests for __builtin_clz/__builtin_clzl 2023-07-04 12:39:31 -06:00
autogen.sh If AUTOCONF_VERSION is unset, use version 2.71 not 2.69. 2022-11-16 10:11:21 -07:00
config.h.in Format ttydev as (signed) long long, not unsigned. 2024-08-14 07:53:00 -06:00
configure Sudo 1.9.16p2 2024-11-25 08:34:04 -07:00
configure.ac Sudo 1.9.16p2 2024-11-25 08:34:04 -07:00
pathnames.h.in Only define _PATH_ENVIRONMENT on systems where we use /etc/environment. 2023-09-20 16:49:27 -06:00

README.md

The sudo philosophy

Sudo is a program designed to allow a sysadmin to give limited root privileges to users and log root activity. The basic philosophy is to give as few privileges as possible but still allow people to get their work done.

Where to find sudo

Before building sudo, make sure you have the current version. The latest sudo may always be gotten via anonymous ftp from ftp.sudo.ws in the directory /pub/sudo/ or from the sudo web site, https://www.sudo.ws/

The distribution is sudo-M.m.tar.gz where M is the major version number and m is the minor version number. Beta versions of sudo may also be available. If you join the sudo-workers mailing list you will get the beta announcements (see the Mailing lists section below).

What's new

See the NEWS file for a list of major changes in this release. For a complete list of changes, see the ChangeLog. For a summary of major changes to the current stable release, see https://www.sudo.ws/releases/stable/.

If you are upgrading from an earlier version of Sudo, read docs/UPGRADE.md for information on changes in behavior that may affect you.

For a history of sudo see docs/HISTORY.md. You can find a list of contributors to sudo in docs/CONTRIBUTORS.md.

Building the release

Read the installation guide, INSTALL.md, before trying to build sudo. Pay special attention to the "OS dependent notes" section.

How to contribute

See docs/CONTRIBUTING.md for information on how you can help contribute to sudo.

Sudo is distributed under an ISC-style license. Refer to LICENSE.md for details.

Mailing lists

sudo-announce

This list receives announcements whenever a new version of sudo is released. https://www.sudo.ws/mailman/listinfo/sudo-announce

sudo-blog

This list receives a message when a new sudo blog article is available. https://www.sudo.ws/mailman/listinfo/sudo-blog

sudo-commits

This list receives a message for each commit made to the sudo source repository. https://www.sudo.ws/mailman/listinfo/sudo-commits

sudo-users

This list is for questions and general discussion about sudo. https://www.sudo.ws/mailman/listinfo/sudo-users

sudo-workers

This list is for people working on and porting sudo. https://www.sudo.ws/mailman/listinfo/sudo-workers

To subscribe to a list, visit its url (listed above) and enter your email address to subscribe. Digest versions are available but these are fairly low traffic lists so the digest versions are not a significant win.

Mailing list archives are also available. See the mailing list web sites for the appropriate links.

Sudo web page

There is a sudo web page at https://www.sudo.ws/ that contains documentation, downloads, a bug tracker, the source repo, the sudo blog, information about beta versions and other useful info.

Filing bug reports/issues

If you believe you have found a bug, you can either file a bug report in the sudo bug database, https://bugzilla.sudo.ws/, or open a GitHub issue, whichever you find easier. If you would prefer to use email, messages may be sent to the sudo-workers@sudo.ws mailing list (public) or to sudo@sudo.ws (private).

For sudo's security policy and how to report security issues, see docs/SECURITY.md.

Please check docs/TROUBLESHOOTING.md before submitting a bug report. When reporting bugs, be sure to include the version of sudo you are using, the operating system and/or distro that is affected, and, if possible, step-by-step instructions to reproduce the problem.