.\" openfwtk project: maphostname.3 1-Nov-2000
.TH maphostname 3
.SH NAME
maphostname() \- inet_ntoa() frontend
.SH SYNOPSIS
.nf	
#include "fwfunc.h"
.fi
.sp 
char* \fBmaphostname\fP(char *name)
.SH DESCRIPTION
The \fImaphostname\fP function converts character host \fIname\fP (fqdn or ip)
to an ascii string representing its ip in `.' notation.
.PP
If a host does not resolve, a pointer to original \fIname\fP is returned.
.SH RETURN VALUES
The function returns a pointer to resulting string.
.SH SECURITY CONDITIONS
address entry returned by name lookup exceeds sizeof appropriate
structure,
.PP
\fBaction:\fP 'invalid host address length' securityalert is generated,
`\fIinvalid\fP' is returned.
.SH SEE ALSO
inet_ntoa(3)
.SH HISTORY
The function appears in fwtk since v1.0
.SH BUGS
The return value may point to a static memory area.