Switch to SpeakEasy.net DSL

The Modular Manual Browser

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

groupdel(8)							  groupdel(8)


  groupdel - Deletes a group definition	from the system


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


  -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:

	  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.

	  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.

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


  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.


  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.


  The groupdel command exits with one of the following values:

  0   Success.

  1   Failure.

  2   Warning.


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

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

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


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


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

  System Administration