VOP_SETATTR(9) get and set attributes on a file or directory

Other Alias

VOP_GETATTR

SYNOPSIS

In sys/param.h In sys/vnode.h Ft int Fn VOP_GETATTR struct vnode *vp struct vattr *vap struct ucred *cred Ft int Fn VOP_SETATTR struct vnode *vp struct vattr *vap struct ucred *cred

DESCRIPTION

These entry points manipulate various attributes of a file or directory, including file permissions, owner, group, size, access time and modification time.

The arguments are:

Fa vp
The vnode of the file.
Fa vap
The attributes of the file.
Fa cred
The user credentials of the calling process.

Attributes which are not being modified by Fn VOP_SETATTR should be set to the value VNOVAL Fn VATTR_NULL may be used to clear all the values, and should generally be used to reset the contents of Fa *vap prior to setting specific values.

LOCKS

Fn VOP_GETATTR expects the vnode to be locked on entry and will leave the vnode locked on return. The lock type can be either shared or exclusive.

Fn VOP_SETATTR expects the vnode to be locked on entry and will leave the vnode locked on return. The lock type must be exclusive.

RETURN VALUES

Fn VOP_GETATTR returns 0 if it was able to retrieve the attribute data via Fa *vap , otherwise an appropriate error is returned. Fn VOP_SETATTR returns zero if the attributes were changed successfully, otherwise an appropriate error is returned.

ERRORS

Bq Er EPERM
The file is immutable.
Bq Er EACCES
The caller does not have permission to modify the file or directory attributes.
Bq Er EROFS
The file system is read-only.

AUTHORS

This manual page was written by An Doug Rabson .