.\" Man page generated from reStructuredText.
.
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.TH "TSHOSTLOOKUP" "3ts" "Jan 06, 2024" "9.2" "Apache Traffic Server"
.SH NAME
TSHostLookup \- TSHostLookup API function
.SH SYNOPSIS
.INDENT 0.0
.INDENT 3.5
.sp
.EX
#include <ts/ts.h>
.EE
.UNINDENT
.UNINDENT
.INDENT 0.0
.TP
.B \fI\%TSAction\fP TSHostLookup(\fI\%TSCont\fP contp, const char *hostname, size_t namelen) 
.UNINDENT
.SH DESCRIPTION
.sp
Attempts host name resolution for the given \fIhostname\fP with length \fInamelen\fP\&. When a result is ready the handler of \fIcontp\fP is called with the \fI\%TS_EVENT_HOST_LOOKUP\fP event and a \fI\%TSHostLookupResult\fP\&. Use \fI\%TSHostLookupResultAddrGet()\fP to retrieve the resulting address from the \fI\%TSHostLookupResult\fP\&.
.sp
A call to \fI\%TSHostLookup()\fP may be synchronous—in which case the handler for \fIcontp\fP will be called with the answer before the call to \fI\%TSHostLookup()\fP returns—or the call to \fI\%TSHostLookup()\fP may be asynchronous—in which case it returns immediately with a \fI\%TSAction\fP, and the handler \fIcontp\fP will be called in the future. See \fI\%Actions\fP for guidance.
.sp
In particular, \fIcontp\fP must have been created with a \fI\%TSMutex\fP; see \fI\%TSContCreate()\fP
.SH COPYRIGHT
2024, dev@trafficserver.apache.org
.\" Generated by docutils manpage writer.
.