tail head cat sleep
QR code linking to this page
Main index Section 9
Go to:
日本語Options

Manual Pages  — VOP_OPEN

NAME

VOP_OPEN, VOP_CLOSE – open or close a file

CONTENTS

SYNOPSIS

#include <sys/param.h>
#include <sys/vnode.h>

int
VOP_OPEN(struct vnode *vp, int mode, struct ucred *cred, struct thread *td, struct file *fp);

int
VOP_CLOSE(struct vnode *vp, int mode, struct ucred *cred, struct thread *td);

DESCRIPTION

The VOP_OPEN() entry point is called before a file is accessed by a process and the VOP_CLOSE() entry point is called after a file is finished with by the process.

The arguments are:
vp
  The vnode of the file.
mode
  The access mode required by the calling process.
cred
  The caller's credentials.
td
  The thread which is accessing the file.
fp
  The file being opened.

Pointer to the file fp is useful for file systems which require such information, e.g., fdescfs(5). Use ‘NULL’ as fp argument to VOP_OPEN() for in-kernel opens.

The access mode is a set of flags, including FREAD, FWRITE, O_NONBLOCK, O_APPEND.

LOCKS

VOP_OPEN() expects vp to be locked on entry and will leave it locked on return.

VOP_CLOSE() expects at least a reference to be associated with the vnode and does not care whether the vnode is locked or not. The lock and reference state is left unchanged on return. Note that vn_close expects an unlocked, referenced vnode and will dereference the vnode prior to returning.

RETURN VALUES

Zero is returned on success, otherwise an error code is returned.

SEE ALSO

vnode(9), VOP_LOOKUP(9)

AUTHORS

This manual page was written by Doug Rabson.
VOP_OPEN (9) December 2, 2009
tail head cat sleep
QR code linking to this page
Main index Section 9
Go to:
日本語Options

Please direct any comments about this manual page service to Ben Bullock. Privacy policy.

“ This philosophy, in the hands of amateurs, leads to inexplicably mind-numbing botches like the existence of two programs, “head” and “tail,” which print the first part or the last part of a file, depending. Even though their operations are duals of one another, “head” and “tail” are different programs, written by different authors, and take different options! ”
— The Unix Haters' handbook