gethostname man page on Ultrix

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

gethostname(2)							gethostname(2)

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

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

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

       The  system call returns the standard host name for the current proces‐
       sor, as previously set by The namelen parameter specifies the  size  of
       the  name  array.  The returned name is null-terminated unless insuffi‐
       cient space is provided.

       The system call sets the name of the host machine to be name, which has
       length  namelen.	  This call is restricted to the superuser and is nor‐
       mally used only when the system is bootstrapped.

Return Values
	0   If the call succeeds, it returns a value of zero.

       -1   If the call fails, a value of -1 is returned and an error code  is
	    placed in the global location, errno.

       Host names are limited to 31 characters and may contain only lower case
       ASCII characters a to z, numbers 0 to 9, dashes (-),  underscores  (_),
       and periods (.).

       The system call fails under the following condition:

       [EFAULT]	      The  name	 parameter  points outside the process's allo‐
		      cated address space.

       The system call fails under the following conditions:

       [EPERM]	      The caller is not the superuser.

       [EINVAL]	      The name or namelen parameter is an invalid address.

See Also
       hostname(1), gethostid(2)


List of man pages available for Ultrix

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]
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