unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (OSF1-V5.1-alpha)
Page:
Section:
Apropos / Subsearch:
optional field



groupdel(8)							  groupdel(8)



NAME

  groupdel - Deletes a group definition	from the system

SYNOPSIS

  /usr/sbin/groupdel [-P] [-x extended_option] group_name

OPTIONS

  -P  Deletes a	PC group only.

  -x extended_option[extended_option...]
      Extended options are of the form attribute=value.	You may	enter any
      number of	extended options (within the character limit of	the command
      line) by separating each option with a space. Alternatively, they	may
      be entered separately following the -x switch. Note that some extended
      options are only available under specific	system environments.

      The following sets of extended_option attributes are available:

      local=0|1
	  Indicates that the group to be deleted is local. The value 0 indi-
	  cates	that the group is to be	deleted	from the NIS database.

      distributed=0|1
	  The value 1 indicates	that a group is	to be deleted from the NIS
	  database. You	must be	on the NIS master to delete a NIS group.

  group_name
      Specifies	the name of the	group to be deleted from the system.  The
      groupname	must exist.

DESCRIPTION

  The groupdel command lets the	system administrator delete existing groups
  from the system by group name.

  The -x options local and distributed let the system administrator specify
  whether the group to be deleted is local or distributed by NIS. If these
  options are not specified on the command line, the system deletes the	group
  from the appropriate database	as specified by	the system defaults. System
  defaults for groups may be set with the groupmod -D option. In the absence
  of any defaults, groupdel deletes a local group. Certain combinations	of
  these	settings are incompatible and produce an error:	it is invalid to set
  both of these	values to 0 or set both	of them	to 1.








RESTRICTIONS

  You must have	superuser privilege to execute this command.


  Advanced Server for UNIX (ASU) must be running to delete PC groups consist-
  ing of members who are holders of Windows NT domain accounts.

  You must be on the NIS master	to delete a NIS	group.

EXIT STATUS

  The groupdel command exits with one of the following values:

  0   Success.

  1   Failure.

  2   Warning.

EXAMPLES

   1.  The following example removes the group,	testgrp:
	    % groupdel testgrp

   2.  The following example removes the group,	testgrp, from the local	group
       database:
	    % groupdel -x local=1 testgrp

   3.  The following example removes the PC users group, domainbdev:
	    % groupdel -P domainbdev



FILES

  The groupdel command operates	on the appropriate files for the specific
  level	of system security.

SEE ALSO

  Commands:  groupadd(8), groupmod(8), useradd(8), userdel(8), usermod(8)

  System Administration

  Security