setnodename(3)                      CLIX                      setnodename(3)



  NAME

    setnodename - Sets new nodename

  LIBRARY

    Intergraph Device Library (libix.a)

  SYNOPSIS

    int setnodename( s );
    char *s ;

  PARAMETERS

    s   A character string representing a nodename

  DESCRIPTION

    The setnodename() function sets the nodename of the system as known by the
    communications network to the character string pointed to by s.  This
    change is effective only until the next boot.  The setnodename() function
    truncates s to a maximum length of eight bytes.

    The current nodename can be obtained using uname().

  RETURN VALUES

    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

    The setnodename() function fails if any of the following is true:

    [EPERM]    The effective user ID is not superuser.

    [EFAULT]   The value of s points outside the allocated address space of
               the process.

    [EINVAL]   The size of s exceeds the maximum number of characters allowed
               for a nodename.

  RELATED INFORMATION

    Functions:  uname(2)








  2/94 - Intergraph Corporation                                              1