Differential D24168 Diff 70029 head/lib/libc/sys/chown.2

Changeset View

Standalone View

head/lib/libc/sys/chown.2

	Show All 22 Lines
	.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT			.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
	.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY			.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
	.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF			.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
	.\" SUCH DAMAGE.			.\" SUCH DAMAGE.
	.\"			.\"
	.\" @(#)chown.2 8.4 (Berkeley) 4/19/94			.\" @(#)chown.2 8.4 (Berkeley) 4/19/94
	.\" $FreeBSD$			.\" $FreeBSD$
	.\"			.\"
	.Dd November 11, 2018			.Dd March 30, 2020
	.Dt CHOWN 2			.Dt CHOWN 2
	.Os			.Os
	.Sh NAME			.Sh NAME
	.Nm chown ,			.Nm chown ,
	.Nm fchown ,			.Nm fchown ,
	.Nm lchown ,			.Nm lchown ,
	.Nm fchownat			.Nm fchownat
	.Nd change owner and group of a file			.Nd change owner and group of a file
	▲ Show 20 Lines • Show All 138 Lines • ▼ Show 20 Lines
	The named file resides on a read-only file system.			The named file resides on a read-only file system.
	.It Bq Er EFAULT			.It Bq Er EFAULT
	The			The
	.Fa path			.Fa path
	argument			argument
	points outside the process's allocated address space.			points outside the process's allocated address space.
	.It Bq Er EIO			.It Bq Er EIO
	An I/O error occurred while reading from or writing to the file system.			An I/O error occurred while reading from or writing to the file system.
				.It Bq Er EINTEGRITY
				Corrupted data was detected while reading from the file system.
	.El			.El
	.Pp			.Pp
	The			The
	.Fn fchown			.Fn fchown
	system call will fail if:			system call will fail if:
	.Bl -tag -width Er			.Bl -tag -width Er
	.It Bq Er EBADF			.It Bq Er EBADF
	The			The
	.Fa fd			.Fa fd
	argument			argument
	does not refer to a valid descriptor.			does not refer to a valid descriptor.
	.It Bq Er EINVAL			.It Bq Er EINVAL
	The			The
	.Fa fd			.Fa fd
	argument			argument
	refers to a socket, not a file.			refers to a socket, not a file.
	.It Bq Er EPERM			.It Bq Er EPERM
	The effective user ID is not the super-user.			The effective user ID is not the super-user.
	.It Bq Er EROFS			.It Bq Er EROFS
	The named file resides on a read-only file system.			The named file resides on a read-only file system.
	.It Bq Er EIO			.It Bq Er EIO
	An I/O error occurred while reading from or writing to the file system.			An I/O error occurred while reading from or writing to the file system.
				.It Bq Er EINTEGRITY
				Corrupted data was detected while reading from the file system.
	.El			.El
	.Pp			.Pp
	In addition to the errors specified for			In addition to the errors specified for
	.Fn chown			.Fn chown
	and			and
	.Fn lchown ,			.Fn lchown ,
	the			the
	.Fn fchownat			.Fn fchownat
	▲ Show 20 Lines • Show All 79 Lines • Show Last 20 Lines