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

vn_symlink Entry Point

Purpose

Creates a symbolic link.

Syntax

int vn_symlink (vp, linkname, target, crp)
struct vnode *vp;
char *linkname;
char *target;
struct ucred *crp;

Parameters

vp Points to the virtual node (v-node) of the parent directory where the link is created.
linkname Points to the name of the new symbolic link. The logical file system guarantees that the new link does not already exit.
target Points to the name of the object to which the symbolic link points. This name need not be a fully qualified path name or even an existing object.
crp Points to the cred structure. This structure contains data that the file system can use to validate access permission.

Description

The vn_symlink entry point is called by the logical file system to create a symbolic link. The path name specified by the linkname parameter is the name of the new symbolic link. This symbolic link points to the object named by the target parameter.

Execution Environment

The vn_symlink 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 symlink subroutine.

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 ]