getuniverse(2)

NAME

getuniverse, setuniverse − get/set current universe

SYNOPSIS

#include <sys/param.h>
int getuniverse (univ)
char ∗univ;
int setuniverse (univ)
char ∗univ;

DESCRIPTION

Setuniverse sets the current universe to the null-terminated string univ. getuniverse returns the current universe to the buffer starting at univ, and terminates it with a null character. The maximum length of a universe name is MAXUNIVLEN (32), including the null byte.

A process’ universe affects its translation of conditional symbolic links. A conditional symbolic link is a symbolic link containing the character sequence ‘{}’. During pathname translation the braces are replaced by the current universe. For example, if lib is a conditional symbolic link with a value of ‘.{}lib’, and the current universe is att, the resulting pathname is ‘.attlib’.

The two currently supported universes are att and ucb, with att the default. A process inherits its universe from its parent.

RETURN VALUE

Upon successful completion a value of 0 is returned. Otherwise, a value of −1 is returned and errno is set to indicate the error.

ERRORS

[EFAULT] Univ points to an invalid address.

[EINVAL] Univ is more than MAXUNIVLEN bytes long.

Museum