1GETHOSTNAME(P)             POSIX Programmer's Manual            GETHOSTNAME(P)
2
3
4

NAME

6       gethostname - get name of current host
7

SYNOPSIS

9       #include <unistd.h>
10
11       int gethostname(char *name, size_t namelen);
12
13

DESCRIPTION

15       The  gethostname() function shall return the standard host name for the
16       current machine. The namelen argument shall specify  the  size  of  the
17       array  pointed  to  by  the  name argument.  The returned name shall be
18       null-terminated, except that if namelen is an  insufficient  length  to
19       hold the host name, then the returned name shall be truncated and it is
20       unspecified whether the returned name is null-terminated.
21
22       Host names are limited to {HOST_NAME_MAX} bytes.
23

RETURN VALUE

25       Upon successful completion, 0 shall be returned; otherwise, -1 shall be
26       returned.
27

ERRORS

29       No errors are defined.
30
31       The following sections are informative.
32

EXAMPLES

34       None.
35

APPLICATION USAGE

37       None.
38

RATIONALE

40       None.
41

FUTURE DIRECTIONS

43       None.
44

SEE ALSO

46       gethostid()    ,   uname()   ,   the   Base   Definitions   volume   of
47       IEEE Std 1003.1-2001, <unistd.h>
48

50       Portions of this text are reprinted and reproduced in  electronic  form
51       from IEEE Std 1003.1, 2003 Edition, Standard for Information Technology
52       -- Portable Operating System Interface (POSIX),  The  Open  Group  Base
53       Specifications  Issue  6,  Copyright  (C) 2001-2003 by the Institute of
54       Electrical and Electronics Engineers, Inc and The Open  Group.  In  the
55       event of any discrepancy between this version and the original IEEE and
56       The Open Group Standard, the original IEEE and The Open Group  Standard
57       is  the  referee document. The original Standard can be obtained online
58       at http://www.opengroup.org/unix/online.html .
59
60
61
62IEEE/The Open Group                  2003                       GETHOSTNAME(P)
Impressum