Function

v_rpn invokes the v_rpn callable service to accept a pathname of a file or directory and return a vnode token that represents this file or directory and the VFS token that represents the mounted file system that contains the file or directory.

Parameters

pathname

The absolute pathname to be resolved, specified as a string.

vfstoken

The name of a variable in which the VFS token for the resolved file is stored.

vntoken

The name of a variable in which the vnode token for the resolved file is stored.

stem

The name of a stem variable used to return the mount entry for the file system. To access mount table information, you can use a numeric value or the predefined variables beginning with MNTE_ used to derive the numeric value. See getmntent for a description of the MNTE_ variables; see REXX predefined variables for the numeric values.

stem2

Upon return, stem2.0 contains the number of attribute variables returned. The same information is returned in stem2 as if a v_getattr had been used on the file that was just resolved. You can use the predefined variables beginning with ST_ to access those respective values. For example, stem2.st_size accesses the file size. See stat for a description of the ST_ variables.

Usage notes

1. The mount point pathname is not available in the MNTE_ structure returned by the variable stem2.mnte_path.
2. The caller is responsible for freeing vnode tokens returned by the v_rpn service, by calling to the v_rel service when they are no longer needed.