www.delorie.com/djgpp/doc/libc/libc_400.html   search  
libc.a reference

[ < ] [ > ]   [ << ] [ Up ] [ >> ]         [Top] [Contents] [Index] [ ? ]

gethostname

Syntax

 
#include <unistd.h>
#include <sys/param.h>

int gethostname (char *buf, int size);

Description

Get the name of the host the program is executing on. This name is obtained from the network software, if present, otherwise from the "HOSTNAME" environment variable, if present, finally defaulting to "pc".

The call fails if more than size characters are required to specify the host name. A buffer size of MAXGETHOSTNAME is guaranteed to be enough.

Return Value

Zero on success, nonzero on failure.

Portability

ANSI/ISO C No
POSIX No

Example

 
char *buf = (char *) malloc (MAXGETHOSTNAME);
if (buf && 0 == gethostname (buf, MAXGETHOSTNAME))
  printf ("We're on %s\n", buf);
if (buf) free(buf);


  webmaster   donations   bookstore     delorie software   privacy  
  Copyright 2004   by DJ Delorie     Updated Apr 2004