chown(1)						      General Commands Manual							  chown(1)

NAME

       chown, chgrp - change file owner or group

SYNOPSIS

       ] ] ownergroup] file ...

       ] ] group file ...

DESCRIPTION

       The command changes the owner ID of each specified file to owner and optionally the group ID of each specified file to group.

       The command changes the group ID of each specified file to group.

       Refer to usergroupname(5) to understand the functionality changes with the Numeric User Group Name feature.

       In  order  to  change  the  owner  or group, you must own the file and have the CHOWN privilege (see setprivgrp(1M)).  If either command is
       invoked on a regular file by other than the superuser, the set-user-ID and set-group-ID bits of the file  mode  (04000  and  02000  respec-
       tively) are cleared.  Note that a given user's or group's ability to use this command can be restricted by (see setprivgrp(1M)).

   Options
       and recognize the following options:

	      Change the owner or group of a symbolic link.

			By  default,  the  owner or group of the target file that a symbolic link points to is changed.  With the target file that
			the symbolic link points to is not affected.  If the target file is a directory, and you specify and  recursion  does  not
			take place.

	      If the	option	is  specified  and a symbolic link referencing a directory is specified on the command line, the owner or group of
			the directory referenced by the symbolic link and all files in the file hierarchy below it are changed.

	      If the	option is specified and a symbolic link referencing a directory is encountered on the command line or during the traversal
			of a file hierarchy, the owner or group of the directory referenced by the symbolic link and all files in the file hierar-
			chy below it are changed.

	      If the	option is specified and a symbolic link is encountered on the command line or during the traversal of  a  file	hierarchy,
			the  owner or group of the symbolic link are changed.  The utility shall not follow the symbolic link to any other part of
			the file hierarchy.

	      Recursively change the owner or group.
			For each file operand that names a directory, the owner or group of the directory and all files and subdirectories in  the
			file hierarchy below it are changed.

   Operands
       and recognize the following operands:

	      file	Target file for which the ownership is changed.

	      group	Either a decimal group ID or a group name found in the file.

	      owner	Either a decimal user ID or a login name found in the file.

   Access Control Lists - HFS File Systems Only
       Users can permit or deny specific individuals and groups to access a file by setting optional ACL entries in the file's access control list
       (see acl(5)).  When using in conjunction with HFS ACLs, if the new owner and/or group of a file does not have an optional ACL entry  corre-
       sponding to and/or in the file's access control list, the file's access permission bits remain unchanged.  However, if the new owner and/or
       group is already designated by an optional ACL entry of and/or in the file's ACL, sets the corresponding file access permission	bits  (and
       the corresponding base ACL entries) to the permissions contained in that entry.

   Access Control Lists - JFS File Systems Only
       Users can permit or deny specific individuals and groups to access a file by setting optional ACL entries in the file's access control list
       (see aclv(5)).  When using in conjunction with JFS ACLs, if the new owner and/or group of a file have optional ACL entries corresponding to
       and/or  in  the	file's	access control list, those entries remain in the ACL but no longer have any effect, being superseded by the file's
       and/or entries.

   Options
       and recognize the following options:

	      Change the owner or group of a symbolic link.

			By default, the owner or group of the target file that a symbolic link points to is changed.  With the	target	file  that
			the  symbolic  link  points to is not affected.  If the target file is a directory, and you specify and recursion does not
			take place.

	      Recursively change the owner or group.
			For each file operand that names a directory, the owner or group of the directory and all files and subdirectories in  the
			file hierarchy below it are changed.

EXTERNAL INFLUENCES

   Environment Variables
       determines the language in which messages are displayed.

       If is not specified in the environment or is set to the empty string, the value of is used as a default for each unspecified or empty vari-
       able.  If is not specified or is set to the empty string, a default of "C" (see lang(5)) is used instead of

       If any internationalization variable contains an invalid setting, behaves as if all internationalization variables are  set  to	"C".   See
       environ(5).

   International Code Set Support
       Single- and multi-byte character code sets are supported.

RETURN VALUE

       and return the following values:

	      Successful completion.
	      An error condition occurred.

EXAMPLES

       The following command changes the owner of the file to

       The following command searches the directory and changes each file in that directory to owner and group

WARNINGS

       The default operation of and for symbolic links has changed as of HP-UX release 10.0.  Use the option to get the former default operation.

FILES

SEE ALSO

       chmod(1), setprivgrp(1M), chown(2), group(4), passwd(4), acl(5), aclv(5), usergroupname(5).

STANDARDS CONFORMANCE

																	  chown(1)