shadow/man/groupdel.8

64 lines
1.4 KiB
Groff

.\" Title: groupdel
.\" Author:
.\" Generator: DocBook XSL Stylesheets v1.70.1 <http://docbook.sf.net/>
.\" Date: 06/06/2006
.\" Manual: System Management Commands
.\" Source: System Management Commands
.\"
.TH "GROUPDEL" "8" "06/06/2006" "System Management Commands" "System Management Commands"
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.SH "NAME"
groupdel \- delete a group
.SH "SYNOPSIS"
.HP 9
\fBgroupdel\fR \fIgroup\fR
.SH "DESCRIPTION"
.PP
The
\fBgroupdel\fR
command modifies the system account files, deleting all entries that refer to
\fIgroup\fR. The named group must exist.
.PP
You must manually check all file systems to insure that no files remain with the named group as the file group ID.
.SH "CAVEATS"
.PP
You may not remove the primary group of any existing user. You must remove the user before you remove the group.
.SH "FILES"
.TP 3n
\fI/etc/group\fR
Group account information.
.TP 3n
\fI/etc/gshadow\fR
Secure group account information.
.SH "EXIT VALUES"
.PP
The
\fBgroupdel\fR
command exits with the following values:
.TP 3n
\fI0\fR
success
.TP 3n
\fI2\fR
invalid command syntax
.TP 3n
\fI8\fR
can't remove user's primary group
.TP 3n
\fI10\fR
can't update group file
.SH "SEE ALSO"
.PP
\fBchfn\fR(1),
\fBchsh\fR(1),
\fBpasswd\fR(1),
\fBgpasswd\fR(8),
\fBgroupadd\fR(8),
\fBgroupmod\fR(8),
\fBuseradd\fR(8),
\fBuserdel\fR(8),
\fBusermod\fR(8)