:man| Alphabetical   Categories   About us 
 
GETHOSTNAME (3) | C library functions | Unix Manual Pages | :man

NAME

gethostname, sethostname - get/set name of current host

CONTENTS

Library
Synopsis
Description
Return Values
Errors
See Also
Standards
History

LIBRARY


.Lb libc

SYNOPSIS


.In unistd.h int gethostname "char *name" "size_t namelen" int sethostname "const char *name" "int namelen"

DESCRIPTION

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

The sethostname function 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.

Host names are limited to
.Brq Dv HOST_NAME_MAX characters, not including the trailing null, currently 255.

RETURN VALUES


.Rv -std

ERRORS

The following errors may be returned by these calls:
[EFAULT]
The name or namelen argument gave an invalid address.
[ENAMETOOLONG]
The current host name is longer than namelen. (For gethostname only.)
[EPERM]
The caller tried to set the host name and was not the super-user.

SEE ALSO

sysconf(3), sysctl(3)

STANDARDS

HISTORY

 
Created by Blin Media, 2008-2013