Technical Reference: Kernel and Subsystems, Volume 1

fidtovp Kernel Service

Purpose

Maps a file system structure to a file ID.

Maps a file identifier to a mode.

Syntax

#include <sys/types.h>
#include <sys/vnode.h>
int fidtovp(fsid, fid, vpp)
fsid_t *fsid;
struct fileid *fid;
struct vnode **vpp;

Parameters

fsid	Points to a file system ID structure. The system uses this structure to determine which virtual file system (VFS) contains the requested file.
fid	Points to a file ID structure. The system uses this pointer to locate the specific file within the VFS.
vpp	Points to a location to store the file's vnode pointer upon successful return of the fidtovp kernel service.

Description

The fidtovp kernel service returns a pointer to a vnode for the file identified by fsid and fid, and increments the count on the vnode so the file is not removed. Subroutines that call the fidtovp kernel service must call VNOP_RELE to release the vnode pointer.

This kernel service is designed for use by the server side of distributed file systems.

Execution Environment

The fidtovp kernel service can be called from the process environment only.

Return Values

0	Indicates successful completion.
ESTALE	Indicates the requested file or file system was removed or recreated since last access with the given file system ID or file ID.