NAME    [Toc]    [Back]

     VOP_READLINK -- read the target of a symbolic link

SYNOPSIS    [Toc]    [Back]

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

     int
     VOP_READLINK(struct vnode *vp, struct uio *uio, struct ucred *cred);

DESCRIPTION    [Toc]    [Back]

     This reads the target pathname of a symbolic link

     vp   the vnode of the symlink

     uio  the location of the data to be read or written

     cred
	  the credentials of the caller

LOCKS    [Toc]    [Back]

     The vnode should be locked on entry and will still be locked on exit.

RETURN VALUES    [Toc]    [Back]

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

PSEUDOCODE    [Toc]    [Back]

     int
     vop_readlink(struct vnode *vp, struct uio *uio, struct ucred *cred)
     {
	 int error = 0;

	 /*
	  * Read the target of the symlink.
	  */
	 ...;

	 return error;
     }

ERRORS    [Toc]    [Back]

     [EIO]		A read error occurred while reading the contents of
			the symlink.

SEE ALSO    [Toc]    [Back]

     uiomove(9), vnode(9)

AUTHORS    [Toc]    [Back]

     This man page was written by Doug Rabson.


FreeBSD 5.2.1			 July 24, 1996			 FreeBSD 5.2.1