[ Previous | Next | Contents | Home | Search ]
AIX Version 4.3 Kernel and Subsystems Technical Reference, Volume 1

vn_readlink Entry Point

Purpose

Reads the contents of a symbolic link.

Syntax

int vn_readlink (vp, uio, crp)
struct vnode *vp;
struct uio *uio;
struct ucred *crp;

Parameters

vp Points to a virtual node (v-node) structure. The vn_readlink entry point holds this v-node for the duration of the routine.
uio Points to a uio structure. This structure contains the information required to read the link. In addition, it contains the return buffer for the vn_readlink entry point.
crp Points to the cred structure. This structure contains data that the file system can use to validate access permission.

Description

The vn_readlink entry point is used by the logical file system to get the contents of a symbolic link, if the file system supports symbolic links. The logical file system finds the v-node (virtual node) for the symbolic link, so this routine simply reads the data blocks for the symbol link.

Execution Environment

The vn_readlink entry point can be called from the process environment only.

Return Values

0 Indicates success.

Nonzero return values are returned from the /usr/include/sys/errno.h file to indicate failure.

Related Information

The uio structure.

Virtual File System Overview, Virtual File System Kernel Extensions Overview, Logical File System Overview, Understanding Virtual Nodes (V-nodes) in AIX Kernel Extensions and Device Support Programming Concepts.

List of Virtual File System Operations.


[ Previous | Next | Contents | Home | Search ]