DataMuseum.dk

top - metrics - download

    Length: 1176 (0x498)
    Types: TextFile
    Notes: UNIX file
    Names: »gethostname.2«

└─⟦26887b7e0⟧ Bits:30009717 Comet 32 harddisk image
    └─⟦28c352965⟧ »/a« UNIX Filesystem
        └─⟦this⟧ »usr/man/man2/gethostname.2« 

TextFile

.ig
	@(#)gethostname.2	2.1	7/1/84
	@(#)Copyright (C) 1983 by National Semiconductor Corp.
..
.TH GETHOSTNAME 2
.SH NAME
gethostname, sethostname \- get/set name of current host
.SH SYNOPSIS
.nf
.B
gethostname (name, namelenp)
.B
	char *name;
.B
	int *namelenp;
.sp
.B
sethostname (name, namelen)
.B
	char *name;
.B
	int *namelen;
.fi
.SH DESCRIPTION
.I Gethostname
returns the standard host name for the current processor,
as previously set by
.IR sethostname .
The parameter
.I namelenp
specifies the size of the
.I name
array,
and is modified on return to indicate the actual size
of the host name returned.
The name is null-terminated.
.PP
.I Sethostname
sets the name of the host machine to be
.IR name ,
which has length
.IR namelen .
This system call is normally executed when the system is bootstrapped.
.SH "RETURN VALUE"
If the call succeeds, a value of 0 is returned.
If the call fails,
a value of -1 is returned
and an error code is placed in the global location
.IR errno .
.SH ERRORS
The following errors may be returned by these calls:
.sp
[EFAULT]	The
.I name
or
.I namelenp
parameter gave an invalid address.
.SH BUGS
Host names are limited to 255 characters.