Gethostname – Comtrol eCos User Manual

Page 508

Advertising

Chapter 38. TCP/IP Library Reference

If the buffer passed to getdomainname() is too small, other operating

systems may not guarantee termination with NUL.

HISTORY

The getdomainname function call appeared in SunOS 3.x.

BSD

May 6, 1994

BSD

gethostname

GETHOSTNAME(3)

System Library Functions Manual

GETHOSTNAME(3)

NAME

gethostname, sethostname - get/set name of current host

SYNOPSIS

#include

unistd.h>

int

gethostname(char *name, size_t namelen);

int

sethostname(const char *name, size_t namelen);

DESCRIPTION

The gethostname() function returns the standard host name for the current

processor, as previously set by sethostname().

The parameter namelen

specifies the size of the name array.

If insufficient space is provided,

the returned name is truncated.

The returned name is always null termi-

nated.

sethostname() sets the name of the host machine to be name, which has

length namelen.

This call is restricted to the superuser and is normally

used only when the system is bootstrapped.

RETURN VALUES

If the call succeeds a value of 0 is returned.

If the call fails, a

value of -1 is returned and an error code is placed in the global vari-

able errno.

ERRORS

The following errors may be returned by these calls:

[EFAULT]

The name or namelen parameter gave an invalid address.

[EPERM]

The caller tried to set the hostname and was not the

superuser.