Userland: Implement `pls`, a sudo clone

1 files changed, 41 insertions, 0 deletions

diff --git a/Base/usr/share/man/man8/pls.md b/Base/usr/share/man/man8/pls.md
new file mode 100644
index 0000000000..3bf540d374
--- /dev/null
+++ b/Base/usr/share/man/man8/pls.md
@@ -0,0 +1,41 @@
+## Name
+
+pls - Execute a command as root
+
+## Synopsis
+
+```**sh
+$ pls [command]
+```
+
+## Description
+
+Executes a command as the root user (uid and gid 0), given that the user executing `pls` is located in
+the sudoers file.
+
+It is possible to execute commands that contain hyphenated options via the use of `--`, which signifies the
+end of command options. For example:
+
+```sh
+$ pls -- ls -la
+```
+
+## Files
+/etc/sudoers - List of users that can run `pls`
+
+## Examples
+
+```sh
+$ pls whoami
+Password:
+root
+$
+```
+
+```sh
+$ pls sh
+Password:
+# whoami
+root
+#
+```