Return to gethostname.2 CVS log

Up to [CSRG BSD Unix] / 43BSDTahoe / man / man2

Annotation of 43BSDTahoe/man/man2/gethostname.2, revision 1.1.1.1

1.1       root        1: .\" Copyright (c) 1983 Regents of the University of California.
                      2: .\" All rights reserved.  The Berkeley software License Agreement
                      3: .\" specifies the terms and conditions for redistribution.
                      4: .\"
                      5: .\"    @(#)gethostname.2       6.4 (Berkeley) 5/22/86
                      6: .\"
                      7: .TH GETHOSTNAME 2 "May 22, 1986"
                      8: .UC 5
                      9: .SH NAME
                     10: gethostname, sethostname \- get/set name of current host
                     11: .SH SYNOPSIS
                     12: .nf
                     13: .ft B
                     14: gethostname(name, namelen)
                     15: char *name;
                     16: int namelen;
                     17: .PP
                     18: .ft B
                     19: sethostname(name, namelen)
                     20: char *name;
                     21: int namelen;
                     22: .fi
                     23: .SH DESCRIPTION
                     24: .I Gethostname
                     25: returns the standard host name for the current processor, as
                     26: previously set by
                     27: .IR sethostname . 
                     28: The parameter
                     29: .I namelen
                     30: specifies the size of the 
                     31: .I name
                     32: array.  The returned name is null-terminated unless insufficient
                     33: space is provided.
                     34: .PP
                     35: .I Sethostname
                     36: sets the name of the host machine to be
                     37: .IR name ,
                     38: which has length
                     39: .IR namelen .
                     40: This call is restricted to the super-user and
                     41: is normally used only when the system is bootstrapped.
                     42: .SH "RETURN VALUE
                     43: If the call succeeds a value of 0 is returned.  If the call
                     44: fails, then a value of \-1 is returned and an error code is
                     45: placed in the global location \fIerrno\fP.
                     46: .SH "ERRORS
                     47: The following errors may be returned by these calls:
                     48: .TP 15
                     49: [EFAULT]
                     50: The \fIname\fP or \fInamelen\fP parameter gave an
                     51: invalid address.
                     52: .TP 15
                     53: [EPERM]
                     54: The caller tried to set the hostname and was not the super-user.
                     55: .SH SEE ALSO
                     56: gethostid(2)
                     57: .SH BUGS
                     58: Host names are limited to MAXHOSTNAMELEN (from
                     59: .IR <sys/param.h> )
                     60: characters, currently 64.

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.