
Click above to get retro games delivered to your door ever month!
X-Hacker.org- libc - <b>gethostname</b>
[<<Previous Entry] [^^Up^^] [Next Entry>>] [Menu] [About The Guide]
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.
Example
-------
char *buf = (char *) malloc (MAXGETHOSTNAME);
if (buf && 0 == gethostname (buf, MAXGETHOSTNAME))
printf ("We're on %s\n", buf);
if (buf) free(buf);
Online resources provided by: http://www.ousob.com --- NG 2 HTML conversion by Dave Pearson