Copyright (c) 1983 Regents of the University of California.
All rights reserved. The Berkeley software License Agreement
specifies the terms and conditions for redistribution.

@(#)gethostname.3 6.1 (Berkeley) 05/15/85

C 5 gethostname, sethostname - get/set name of current host

gethostname(name, namelen)
char *name;
int namelen;

sethostname(name, namelen)
char *name;
int namelen;

Gethostname returns the standard host name for the current processor, as previously set by sethostname . The parameter namelen specifies the size of the name array. The returned name is null-terminated unless insufficient space is provided.

Sethostname sets the name of the host machine to be name , which has length namelen . This call is restricted to the super-user and is normally used only when the system is bootstrapped.

If the call succeeds a value of 0 is returned. If the call fails, then a value of -1 is returned and an error code is placed int the global location errno. The following errors may be returned by these calls:

15 [EFAULT] The name or namelen parameter gave an invalid address.

15 [EPERM] The caller was not the super-user.

gethostid(2) Host names are limited to 32 characters.