Other Alias
VOP_SETATTRSYNOPSIS
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 *credDESCRIPTION
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 .