GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  SETHOSTNAME (3)

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

The gethostname function conforms to -p1003.1-2001. Callers should be aware that
.Brq Dv HOST_NAME_MAX may be variable or infinite, but is guaranteed to be no less than
.Brq Dv _POSIX_HOST_NAME_MAX . On older systems, this limit was defined in the non-standard header
.In sys/param.h as MAXHOSTNAMELEN, and counted the terminating null. The sethostname function and the error returns for gethostname are not standardized.

HISTORY

The gethostname function appeared in BSD 4.2 . The namelen argument to gethostname was changed to
.Vt size_t in
.Fx 5.2 for alignment with -p1003.1-2001.
Search for    or go to Top of page |  Section 3 |  Main Index


Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.