Utilities: Add groupdel

1 files changed, 45 insertions, 0 deletions

diff --git a/Base/usr/share/man/man8/groupdel.md b/Base/usr/share/man/man8/groupdel.md
new file mode 100644
index 0000000000..133738e8f2
--- /dev/null
+++ b/Base/usr/share/man/man8/groupdel.md
@@ -0,0 +1,45 @@
+## Name
+
+groupdel - delete a group
+
+## Synopsis
+
+```**sh
+# groupdel <group>
+```
+
+## Description
+
+This program deletes a group in the system.
+
+This program must be run as root.
+
+## Caveats
+
+You may not remove the primary group of any existing user. You must remove the user before you remove the group.
+
+You should manually check all file systems to ensure that no files remain owned by this group.
+
+You should manually check all users to ensure that no user remain in this group.
+
+## Exit Values
+
+* 0 - Success
+* 1 - Couldn't update the group file
+* 6 - Specified group doesn't exist
+* 8 - Can't remove user's primary group
+
+## Files
+
+* `/etc/group` - group information (such as GID) in this file is deleted.
+
+## Examples
+
+```sh
+# groupdel alice
+```
+
+## See Also
+
+* [`useradd`(8)](groupadd.md)
+