chown(1)							      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  respectively)  are
       cleared.	  Note that a given user's or group's ability to use this com‐
       mand 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 hierarchy 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 sub‐
			directories  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 sub‐
			directories  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)

Vote for polarhome