sethostname(2POSIX)

NAME | SYNOPSIS | FEATURES | DESCRIPTION | RETURN VALUES | ERRORS | ATTRIBUTES

NAME

hostname, gethostname, sethostname- get or set the name of the machine

SYNOPSIS

#include <unistd.h>

int gethostname(char * hostname, size_t len);
int sethostname(char * hostname, size_t len);

FEATURES

POSIX_SOCKETS

DESCRIPTION

The pair of primitives gethostname and sethostname are used to get and set the name of the machine, respectively. The value of the len field defines the length of the name, and is limited to MAXHOSTNAMELEN (from <sys/param.h>).

---

only -

Currently, the value of MAXHOSTNAMELEN is 64.

---

RETURN VALUES

Upon successful completion, these primitives return 0; otherwise -1 is returned, and the global variable errno is set to indicate one of the following error conditions.

ERRORS

The gethostname primitive fails if:

[EFAULT]

len is less than the current length of the machine name.

[EFAULT]

The name or namelen gave an invalid address.

The sethostname primitive fails if either of the following are true:

[EFAULT]

The new length of the machine name is greater than MAXHOSTNAMELEN.

---

only -

Currently, the value of MAXHOSTNAMELEN is 64

---

[EPERM]

The caller is not the superuser.

ATTRIBUTES

See attributes(5) for descriptions of the following attributes:

ATTRIBUTE TYPE	ATTRIBUTE VALUE
Interface Stability	Evolving

ChorusOS 4.0  Last Revised December 1999

NAME | SYNOPSIS | FEATURES | DESCRIPTION | RETURN VALUES | ERRORS | ATTRIBUTES