gethostname man page on SmartOS

Man page or keyword search:  
man Server   16655 pages
apropos Keyword Search (all sections)
Output format
SmartOS logo
[printable version]

GETHOSTNAME(3C)						       GETHOSTNAME(3C)

NAME
       gethostname, sethostname - get or set name of current host

SYNOPSIS
       #include <unistd.h>

       int gethostname(char *name, int namelen);

       int sethostname(char *name, int namelen);

DESCRIPTION
       The  gethostname() function returns the standard host name for the cur‐
       rent processor, as previously set by sethostname(). The	namelen	 argu‐
       ment  specifies	the size of the array pointed to by name. 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 supe‐
       ruser and is normally used only when the system is bootstrapped.

       Host names are limited to  MAXHOSTNAMELEN  characters,  currently  256,
       defined in the <netdb.h> header.

RETURN VALUES
       Upon  successful	 completion, gethostname() and sethostname() return 0.
       Otherwise, they return −1 and set errno to indicate the error.

ERRORS
       The gethostname() and sethostname() functions will fail if:

       EFAULT
		 The name or namelen argument gave an invalid address.

       The sethostname() function will fail if:

       EPERM
		The {PRIV_SYS_ADMIN} privilege was not asserted in the	effec‐
		tive set of the calling process.

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

       ┌────────────────────┬─────────────────┐
       │  ATTRIBUTE TYPE    │ ATTRIBUTE VALUE │
       ├────────────────────┼─────────────────┤
       │Interface Stability │ Standard	      │
       ├────────────────────┼─────────────────┤
       │MT-Level	    │ MT-Safe	      │
       └────────────────────┴─────────────────┘

SEE ALSO
       sysinfo(2), uname(2), gethostid(3C), attributes(5), standards(5)

				 Mar 22, 2004		       GETHOSTNAME(3C)
[top]

List of man pages available for SmartOS

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net