Go to file

王子凌 5fd6a79721 Warn during build if generating resources fails (#75 ) Add warm notice when failed to execute the `build.rs`. If we don't set the `-vv` flag when executing `cargo build`, the current command line output will not contain the `child_process` failures, so that we cannot know why the `build process` failed.		2024-07-01 08:47:45 -05:00
.cargo	Add a PR build workflow (#78 )	2024-06-04 11:26:58 -05:00
.github	Add a PR build workflow (#78 )	2024-06-04 11:26:58 -05:00
.pipelines	Initial release of the sudo source (#71 )	2024-05-22 18:48:06 -07:00
cpp	Initial release of the sudo source (#71 )	2024-05-22 18:48:06 -07:00
docs	Update versions.md (#77 )	2024-05-29 15:05:52 -05:00
img	Initial commit to standup Sudo for Windows repo	2024-02-08 10:41:07 -06:00
scripts	Fixed $null check for consistency, variable "$sudoOffset" typo (#17 )	2024-02-09 11:25:02 -06:00
sudo	Warn during build if generating resources fails (#75 )	2024-07-01 08:47:45 -05:00
sudo_events	Initial release of the sudo source (#71 )	2024-05-22 18:48:06 -07:00
tools	docs: update tests.ipynb (#79 )	2024-05-29 14:30:20 -05:00
win32resources	Initial release of the sudo source (#71 )	2024-05-22 18:48:06 -07:00
.clang-format	Initial commit to standup Sudo for Windows repo	2024-02-08 10:41:07 -06:00
.gitignore	Initial commit to standup Sudo for Windows repo	2024-02-08 10:41:07 -06:00
Building.md	Initial release of the sudo source (#71 )	2024-05-22 18:48:06 -07:00
CODE_OF_CONDUCT.md	Initial commit to standup Sudo for Windows repo	2024-02-08 10:41:07 -06:00
CONTRIBUTING.md	Initial release of the sudo source (#71 )	2024-05-22 18:48:06 -07:00
Cargo.lock	Update `windows` crate dependency to 0.57 (#90 )	2024-07-01 08:37:51 -05:00
Cargo.toml	Update `windows` crate dependency to 0.57 (#90 )	2024-07-01 08:37:51 -05:00
LICENSE	Initial commit to standup Sudo for Windows repo	2024-02-08 10:41:07 -06:00
NOTICE.md	Initial commit to standup Sudo for Windows repo	2024-02-08 10:41:07 -06:00
README.md	docs: remove extraneous word (#87 )	2024-06-04 11:27:57 -05:00
SECURITY.md	Initial commit to standup Sudo for Windows repo	2024-02-08 10:41:07 -06:00
SUPPORT.md	Fix references to the other repo in SUPPORT.md (#13 )	2024-02-09 11:23:32 -06:00
enable_sudo.cmd	Initial release of the sudo source (#71 )	2024-05-22 18:48:06 -07:00

README.md

Sudo for Windows

Welcome to the repository for Sudo for Windows 🥪. Sudo for Windows allows users to run elevated commands directly from unelevated terminal windows.

The "Inbox" version of sudo is available for Windows 11 builds 26045 and later. If you're on an Insiders build with sudo, you can enable it in the Windows Settings app, on the "Developer Features" page.

Here you can report issues and file feature requests.

Relationship to `sudo` on Unix/Linux

Everything about permissions and the command line experience is different between Windows and Linux. This project is not a fork of the Unix/Linux sudo project, nor is it a port of that sudo project. Instead, Sudo for Windows is a Windows-specific implementation of the sudo concept.

As the two are entirely different applications, you'll find that certain elements of the traditional sudo experience are not present in Sudo for Windows, and vice versa. Scripts and documentation that are written for sudo may not be able to be used directly with Sudo for Windows without some modification.

Documentation

All project documentation is located at aka.ms/sudo-docs. If you would like to contribute to the documentation, please submit a pull request on the Sudo for Windows Documentation repo.

Contributing

Check out CONTRIBUTING.md for details on how to contribute to this project.

`sudo.ps1`

In the meantime, you can contribute to the sudo.ps1 script. This script is meant to be a helper wrapper around sudo.exe that provides a more user-friendly experience for using sudo from PowerShell. This script is located in the scripts/ directory.

Communicating with the Team

The easiest way to communicate with the team is via GitHub issues.

Please file new issues, feature requests and suggestions, but DO search for similar open/closed preexisting issues before creating a new issue.

If you would like to ask a question that you feel doesn't warrant an issue (yet), try a discussion thread. Those are especially helpful for question & answer threads. Otherwise, you can reach out to us via your social media platform of choice:

Mike Griese, Senior Developer: @zadjii@mastodon.social
Jordi Adoumie, Product Manager: @joadoumie
Dustin Howett, Engineering Lead: @dhowett@mas.to
Clint Rutkas, Lead Product Manager: @crutkas

Code of Conduct

This project has adopted the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact opencode@microsoft.com with any additional questions or comments.