Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
FS_CHOWN(1)		     AFS Command Reference		   FS_CHOWN(1)

NAME
       fs_chown	- Changes the owner for	an object stored within	AFS [Windows
       only]

SYNOPSIS
       fs chown	-owner <owner> -path <dir/file path>+
	   [-literal][-help]

DESCRIPTION
       The fs chown command assigns the	specified owner	to each	object
       specified with the -path.

       If the -literal argument	is specified, the targets of symlinks and
       mountpoints are not resolved.  This permits the ownership of the
       symlink or mountpoint to	be assigned.

       The owner can be	specified by name or by	number.	 If specified by name,
       the name	will be	resolved to the	numeric	value by querying the
       protection server in the	cell for each specified	-path object.

       To display the current owner, use the fs	examine	command.

CAUTIONS
       Explicit	or implicit administrator access rights	are required to	be
       able to change the owner	of an object stored in AFS.  Changing
       ownership can alter the current user's implicit rights.

       This command is available in versions of	OpenAFS	for Windows 1.5.61 and
       higher.

OPTIONS
       -owner <owner>
	   A valid name	or number of a user identifier in the Protection
	   Service database.

       -path <dir/file path>+
	   Names each AFS directory or file, on	which the owner	will be	set.
	   Partial pathnames are interpreted relative to the current working
	   directory.

	   Specify the read/write path to each directory to avoid the failure
	   that	results	from attempting	to change a read-only volume. By
	   convention, the read/write path is indicated	by placing a period
	   before the cell name	at the pathname's second level (for example,
	   /afs/.abc.com). For further discussion of the concept of read/write
	   and read-only paths through the filespace, see the fs mkmount
	   reference page.

       -literal
	   When	specified, the targets of symlinks and mountpoints are not
	   resolved.  This permits the ownership of the	symlink	or mountpoint
	   to be assigned.

       -help
	   Prints the online help for this command. All	other valid options
	   are ignored.

PRIVILEGE REQUIRED
       The issuer must have the	"a" (administer) permission on the directory's
       ACL, a member of	the system:administrators group, or, as	a special
       case, must be the UID owner of the top-level directory of the volume
       containing the object.

SEE ALSO
       fs_examine(1), fs_chgrp(1)

COPYRIGHT
       This document was written by Jeffrey Altman and is released under the
       BSD license.

OpenAFS				  2016-12-14			   FS_CHOWN(1)

NAME | SYNOPSIS | DESCRIPTION | CAUTIONS | OPTIONS | PRIVILEGE REQUIRED | SEE ALSO | COPYRIGHT

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=fs_chown&sektion=1&manpath=FreeBSD+12.1-RELEASE+and+Ports>

home | help