GETXVERS(3,L)               AIX Technical Reference               GETXVERS(3,L)



-------------------------------------------------------------------------------
getxvers, setxvers



PURPOSE

Manages the execution version string for hidden directories.

LIBRARY

Standard C Library (libc.a)

SYNTAX

getxvers (xvers, length)
char *xvers;
int length;

setxvers (xvers)
char *xvers;

DESCRIPTION

The getxvers and setxvers system calls get and set the process's xvers string.

The xvers string is used to modify the hidden directory search path (see
"getspath, setspath").  It is a null-terminated string.

When searching to choose a component of a hidden directory, each element of the
site path is used in turn.  For each element of the site path, the system first
searches for the xvers string, concatenated with the machine type name, then
for just the machine type name.

To undo the xvers string, set it to a zero length string.

RETURN VALUE

These calls will fail if any of the following are true:

EINVAL    The current process's xvers string (including the null character) is
          longer than the length characters (getxvers only).

EINVAL    The string pointed to by xvers is longer than the system-imposed
          limit (setxvers only).

EFAULT    xvers points to an invalid address.

ERROR CONDITIONS






Processed November 7, 1990       GETXVERS(3,L)                                1

GETXVERS(3,L)               AIX Technical Reference               GETXVERS(3,L)



Upon successful completion, these calls will return a value of 0 to the calling
process.  Otherwise, a value of -1 is returned and errno is set to indicate the
error.

RELATED INFORMATION

In this book:  "exec:  execl, execv, execle, execve, execlp, execvp,"
"getspath, setspath," and "open, openx, creat."

The csh and sh commands in AIX Operating System Commands Reference.













































Processed November 7, 1990       GETXVERS(3,L)                                2