groupmod(8) [suse man page]

groupmod(8)						      System Manager's Manual						       groupmod(8)

NAME

       groupmod - modify a group entry

SYNOPSIS

       groupmod [-D binddn] [-P path] [-g gid [-o]] [-p password]
	       [-A user] [-R user] [--service service] [--help] [-v]
	       [--usage] group

DESCRIPTION

       groupmod modifies a group entry using the values specified on the command line.

OPTIONS

       -g, --gid gid
	      Force  the new group ID to be the given number. This value must be positive and unique. The group of any file owned by the old group
	      must be changed manually.

       -o, --non-unique
	      Allow duplicate (non-unique) group IDs.

       -p, --password password
	      Set the encrypted password as returned by crypt(3) as the new group password.

       -A, --add-user user
	      Add the user account to the specified group.

       -R, --remove-user user
	      Remove the user account from the specified group.

       -D, --binddn binddn
	      Use the Distinguished Name binddn to bind to the LDAP directory.	The user will be prompted for a password  for  simple  authentica-
	      tion.

       -P, --path path
	      The group file is located below the specified directory path.  groupmod will use this file, not /etc/group.

       --service service
	      Modify the group from a special directory. The default is files, but ldap is also valid.

       --help Print a list of valid options with a short description.

       --usage
	      Print a short list of valid options.

       -v, --version
	      Print the version number and exit.

FILES

       /etc/group - group account information

SEE ALSO

       login.defs(5), group(5), groupadd(8), groupmod(8)

AUTHOR

       Thorsten Kukuk <kukuk@suse.de>

pwdutils							    April 2004							       groupmod(8)

groupmod(1M)						  System Administration Commands					      groupmod(1M)

NAME

       groupmod - modify a group definition on the system

SYNOPSIS

       /usr/sbin/groupmod [ -g gid [-o]] [-n name] group

DESCRIPTION

       The groupmod command modifies the definition of the specified group by modifying the appropriate entry in the /etc/group file.

OPTIONS

       The following options are supported:

       -g gid	Specify  the  new  group  ID  for  the group. This group ID must be a non-negative decimal integer less than MAXUID, as defined in
		<param.h>. The group ID defaults to the next available (unique) number above 99. (Group IDs from 0-99 are reserved  by	SunOS  for
		future applications.)

       -n name	Specify  the  new name for the group.  The name argument is a string of no more than eight bytes consisting of characters from the
		set of lower case alphabetic characters and numeric characters.
		 A warning message will be written if these restrictions are not met.  A future Solaris release may refuse to accept group  fields
		that  do  not  meet these requirements.  The name argument must contain at least one character and must not include a colon (:) or
		NEWLINE (
).

       -o	Allow the gid to be duplicated (non-unique).

OPERANDS

       The following operands are supported:

       group	An existing group name to be modified.

EXIT STATUS

       The groupmod utility exits with one of the following values:

       0	Success.

       2	Invalid command syntax. A usage message for the groupmod command is displayed.

       3	An invalid argument was provided to an option.

       4	gid is not unique (when the -o option is not used).

       6	group does not exist.

       9	name already exists as a group name.

       10	Cannot update the /etc/group file.

FILES

       /etc/group      group file

ATTRIBUTES

       See attributes(5) for descriptions of the following attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Availability		     |SUNWcsu			   |
       +-----------------------------+-----------------------------+

SEE ALSO

       users(1B), groupadd(1M), groupdel(1M), logins(1M), useradd(1M), userdel(1M), usermod(1M), group(4), attributes(5)

NOTES

       The groupmod utility only modifies group definitions in the /etc/group file. If a network name service such as NIS or NIS+ is being used to
       supplement  the local /etc/group file with additional entries, groupmod cannot change information supplied by the network name service. The
       groupmod utility will, however, verify the uniqueness of group name and group ID against the external name service.

SunOS 5.10							    5 Dec 1995							      groupmod(1M)