diff options
Diffstat (limited to 'usr/src/man/man1/chown.1')
-rw-r--r-- | usr/src/man/man1/chown.1 | 326 |
1 files changed, 18 insertions, 308 deletions
diff --git a/usr/src/man/man1/chown.1 b/usr/src/man/man1/chown.1 index f309fa3e37..6ec6a8247a 100644 --- a/usr/src/man/man1/chown.1 +++ b/usr/src/man/man1/chown.1 @@ -45,61 +45,31 @@ .\" Portions Copyright (c) 1982-2007 AT&T Knowledge Ventures .\" Copyright (c) 2008, Sun Microsystems, Inc. All Rights Reserved .\" -.TH CHOWN 1 "Jul 11, 2008" +.TH CHOWN 1 "Feb 21, 2019" .SH NAME chown \- change file ownership .SH SYNOPSIS -.SS "/usr/bin/chown" .LP .nf -\fB/usr/bin/chown\fR [\fB-fhR\fR] \fIowner\fR[:\fIgroup\fR] \fIfile\fR... +\fBchown\fR [\fB-fhR\fR] \fIowner\fR[:\fIgroup\fR] \fIfile\fR... .fi .LP .nf -\fB/usr/bin/chown\fR \fB-s\fR [\fB-fhR\fR] \fIownersid\fR[:\fIgroupsid\fR] \fIfile\fR... +\fBchown\fR \fB-s\fR [\fB-fhR\fR] \fIownersid\fR[:\fIgroupsid\fR] \fIfile\fR... .fi .LP .nf -\fB/usr/bin/chown\fR \fB-R\fR [\fB-f\fR] [\fB-H\fR | \fB-L\fR | \fB-P\fR] \fIowner\fR[:\fIgroup\fR] \fIfile\fR... +\fBchown\fR \fB-R\fR [\fB-f\fR] [\fB-H\fR | \fB-L\fR | \fB-P\fR] \fIowner\fR[:\fIgroup\fR] \fIfile\fR... .fi .LP .nf -\fB/usr/bin/chown\fR \fB-s\fR \fB-R\fR [\fB-f\fR] [\fB-H\fR | \fB-L\fR | \fB-P\fR] \fIownersid\fR[:\fIgroupsid\fR] \fIfile\fR... -.fi - -.SS "/usr/xpg4/bin/chown" -.LP -.nf -\fB/usr/xpg4/bin/chown\fR [\fB-fhR\fR] \fIowner\fR[:\fIgroup\fR] \fIfile\fR... -.fi - -.LP -.nf -\fB/usr/xpg4/bin/chown\fR \fB-s\fR [\fB-fhR\fR] \fIownersid\fR[:\fIgroupsid\fR] \fIfile\fR... -.fi - -.LP -.nf -\fB/usr/xpg4/bin/chown\fR \fB-R\fR [\fB-f\fR] [\fB-H\fR | \fB-L\fR | \fB-P\fR] \fIowner\fR[:\fIgroup\fR] \fIfile\fR... -.fi - -.LP -.nf -\fB/usr/xpg4/bin/chown\fR \fB-s\fR \fB-R\fR [\fB-f\fR] [\fB-H\fR | \fB-L\fR | \fB-P\fR] \fIownersid\fR[:\fIgroupsid\fR] \fIfile\fR... -.fi - -.SS "ksh93" -.LP -.nf -\fBchown\fR [\fB-cflhmnvHLPRX\fR] [\fB-r\fR \fIfile\fR] \fIowner\fR[:\fIgroup\fR] \fIfile\fR... +\fBchown\fR \fB-s\fR \fB-R\fR [\fB-f\fR] [\fB-H\fR | \fB-L\fR | \fB-P\fR] \fIownersid\fR[:\fIgroupsid\fR] \fIfile\fR... .fi .SH DESCRIPTION -.SS "/usr/bin/chown and /usr/xpg4/bin/chown" -.sp .LP The \fBchown\fR utility sets the user \fBID\fR of the file named by each \fBfile\fR to the user \fBID\fR specified by \fIowner\fR, and, optionally, sets @@ -142,22 +112,7 @@ To disable this option, include the following line in \fB/etc/system\fR: .LP \fB{_POSIX_CHOWN_RESTRICTED}\fR is enabled by default. See \fBsystem\fR(4) and \fBfpathconf\fR(2). -.SS "ksh93" -.sp -.LP -The \fBchown\fR built-in in \fBksh93\fR is associated with the \fB/bin\fR and -\fB/usr/bin\fR paths. It is invoked when \fBchown\fR is executed without a -pathname prefix and the pathname search finds a \fB/bin/chown\fR or -/usr/bin/chown executable. -.sp -.LP -\fBchown\fR changes the ownership of each file to \fIowner\fR. \fIowner\fR can -be specified as either a user name or a numeric user id. The group ownership of -each file can also be changed to \fIgroup\fR by appending \fI:group\fR to the -user name. .SH OPTIONS -.SS "/usr/bin/chown and /usr/xpg4/bin/chown" -.sp .LP The following options are supported: .sp @@ -222,239 +177,33 @@ of the file hierarchy. .sp .ne 2 .na -\fB\fB-s\fR\fR -.ad -.RS 6n -The owner and/or group arguments are Windows SID strings. This option requires -a file system that supports storing SIDs, such as ZFS. -.RE - -.sp -.LP -Specifying more than one of the mutually-exclusive options \fB-H\fR, \fB-L\fR, -or \fB-P\fR is not considered an error. The last option specified determines -the behavior of \fBchown\fR. -.SS "/usr/bin/chown" -.sp -.LP -The following options are supported: -.sp -.ne 2 -.na \fB\fB-R\fR\fR .ad .RS 6n Recursive. \fBchown\fR descends through the directory, and any subdirectories, setting the specified ownership \fBID\fR as it proceeds. When a symbolic link -is encountered, the owner of the target file is changed, unless the \fB-h\fR or -\fB-P\fR option is specified. However, no recursion takes place, unless the -\fB-H\fR or \fB-L\fR option is specified. +is encountered, the owner of the symbolic link is changed, unless the +\fB-H\fR or \fB-L\fR option is specified. Unless the \fB-H\fR, \fB-L\fR, or \fB-P\fR +option is specified, the \fB-P\fR option is used as the default mode. .RE -.SS "/usr/xpg4/bin/chown" -.sp -.LP -The following options are supported: .sp .ne 2 .na -\fB\fB-R\fR\fR +\fB\fB-s\fR\fR .ad .RS 6n -Recursive. \fBchown\fR descends through the directory, and any subdirectories, -setting the specified ownership \fBID\fR as it proceeds. When a symbolic link -is encountered, the owner of the target file is changed, unless the \fB-h\fR or -\fB-P\fR option is specified. Unless the \fB-H\fR, \fB-L\fR, or \fB-P\fR option -is specified, the \fB-L\fR option is used as the default mode. +The owner and/or group arguments are Windows SID strings. This option requires +a file system that supports storing SIDs, such as ZFS. .RE -.SS "ksh93" .sp .LP -The following options are supported by the \fBksh93\fR built-in \fBchown\fR -command: -.sp -.ne 2 -.na -\fB\fB-c\fR\fR -.ad -.br -.na -\fB\fB--changes\fR\fR -.ad -.sp .6 -.RS 4n -Describe only files whose ownership actually changes. -.RE - -.sp -.ne 2 -.na -\fB\fB-f\fR\fR -.ad -.br -.na -\fB\fB--quiet | silent\fR\fR -.ad -.sp .6 -.RS 4n -Do not report files whose ownership fails to change. -.RE - -.sp -.ne 2 -.na -\fB\fB-l | h\fR\fR -.ad -.br -.na -\fB\fB--symlink\fR\fR -.ad -.sp .6 -.RS 4n -Change the ownership of the symbolic links on systems that support this option. -.RE - -.sp -.ne 2 -.na -\fB\fB-m\fR\fR -.ad -.br -.na -\fB\fB--map\fR\fR -.ad -.sp .6 -.RS 4n -Interpret the first operand as a file that contains a map of: -.sp -.in +2 -.nf -\fIfrom_uid\fR:\fIfrom_gid to_uid:to_gid\fR -.fi -.in -2 -.sp - -pairs. Ownership of files matching the \fIfrom\fR part of any pair is changed -to the corresponding \fIto\fR part of the pair. The process stops at the first -match for each file. Unmatched files are silently ignored. -.RE - -.sp -.ne 2 -.na -\fB\fB-n\fR\fR -.ad -.br -.na -\fB\fB--show\fR\fR -.ad -.sp .6 -.RS 4n -Show actions but do not execute. -.RE - -.sp -.ne 2 -.na -\fB\fB-r\fR\fR -.ad -.br -.na -\fB\fB--reference=file\fR\fR -.ad -.sp .6 -.RS 4n -Omit the explicit ownership operand and use the ownership of the file instead. -.RE - -.sp -.ne 2 -.na -\fB\fB-v\fR\fR -.ad -.br -.na -\fB\fB--verbose\fR\fR -.ad -.sp .6 -.RS 4n -Describe the changed permissions of all files. -.RE - -.sp -.ne 2 -.na -\fB\fB-H\fR\fR -.ad -.br -.na -\fB\fB--metaphysical\fR\fR -.ad -.sp .6 -.RS 4n -Follow symbolic links for command arguments. Otherwise do not follow symbolic -links when traversing directories. -.RE - -.sp -.ne 2 -.na -\fB\fB-L\fR\fR -.ad -.br -.na -\fB\fB--logical | follow\fR\fR -.ad -.sp .6 -.RS 4n -Follow symbolic links when traversing directories. -.RE - -.sp -.ne 2 -.na -\fB\fB-P\fR\fR -.ad -.br -.na -\fB\fB--physical | nofollow\fR\fR -.ad -.sp .6 -.RS 4n -Do not follow symbolic links when traversing directories. -.RE - -.sp -.ne 2 -.na -\fB\fB-R\fR\fR -.ad -.br -.na -\fB\fB--recursive\fR\fR -.ad -.sp .6 -.RS 4n -Recursively change ownership of directories and their contents. -.RE - -.sp -.ne 2 -.na -\fB\fB-X\fR\fR -.ad -.br -.na -\fB\fB--test\fR\fR -.ad -.sp .6 -.RS 4n -Canonicalize output for testing. -.RE +Specifying more than one of the mutually-exclusive options \fB-H\fR, \fB-L\fR, +or \fB-P\fR is not considered an error. The last option specified determines +the behavior of \fBchown\fR. .SH OPERANDS -.sp .LP The following operands are supported: .sp @@ -486,7 +235,6 @@ A path name of a file whose user \fBID\fR is to be modified. .RE .SH USAGE -.sp .LP See \fBlargefile\fR(5) for the description of the behavior of \fBchown\fR when encountering files greater than or equal to 2 Gbyte ( 2^31 bytes). @@ -507,13 +255,11 @@ example% \fBchown \(miR \(mih \fIowner\fR[:group] \fIfile\fR...\fR .sp .SH ENVIRONMENT VARIABLES -.sp .LP See \fBenviron\fR(5) for descriptions of the following environment variables that affect the execution of \fBchown\fR: \fBLANG\fR, \fBLC_ALL\fR, \fBLC_CTYPE\fR, \fBLC_MESSAGES\fR, and \fBNLSPATH\fR. .SH EXIT STATUS -.sp .LP The following exit values are returned: .sp @@ -535,7 +281,6 @@ An error occurred. .RE .SH FILES -.sp .ne 2 .na \fB\fB/etc/passwd\fR\fR @@ -545,28 +290,8 @@ System password file .RE .SH ATTRIBUTES -.sp .LP See \fBattributes\fR(5) for descriptions of the following attributes: -.SS "/usr/bin/chown" -.sp - -.sp -.TS -box; -c | c -l | l . -ATTRIBUTE TYPE ATTRIBUTE VALUE -_ -CSI Enabled. See NOTES. -_ -Interface Stability Committed -_ -Standard See \fBstandards\fR(5). -.TE - -.SS "/usr/xpg4/bin/chown" -.sp .sp .TS @@ -582,31 +307,16 @@ _ Standard See \fBstandards\fR(5). .TE -.SS "ksh93" -.sp - -.sp -.TS -box; -c | c -l | l . -ATTRIBUTE TYPE ATTRIBUTE VALUE -_ -Interface Stability See below. -.TE - -.sp -.LP -The \fBksh93\fR built-in binding to \fB/bin\fR and \fB/usr/bin\fR is Volatile. -The built-in interfaces are Uncommitted. .SH SEE ALSO -.sp .LP \fBchgrp\fR(1), \fBchmod\fR(1), \fBksh93\fR(1), \fBchown\fR(2), \fBfpathconf\fR(2), \fBpasswd\fR(4), \fBsystem\fR(4), \fBattributes\fR(5), \fBenviron\fR(5), \fBlargefile\fR(5), \fBstandards\fR(5) .SH NOTES -.sp .LP \fBchown\fR is \fBCSI\fR-enabled except for the \fIowner\fR and \fIgroup\fR names. +.sp +.LP +In the past the behavior of \fB/usr/xpg4/bin/chown\fR and +\fB/usr/bin/chown\fR utilities was different. Now they behave the same way. |