getuniverse(2)                                     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 char-
     acter.  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 path-
     name 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.  Other-
     wise, 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.

SEE ALSO
     intro(2), symlink(2), universe(1), ln(1).












Page 1                        CX/UX Programmer's Reference Manual