Apache2
 All Data Structures Namespaces Files Functions Variables Typedefs Enumerations Enumerator Macros Groups Pages
Remote Host Resolution
Collaboration diagram for Remote Host Resolution:

Macros

#define REMOTE_HOST   (0)
 
#define REMOTE_NAME   (1)
 
#define REMOTE_NOLOOKUP   (2)
 
#define REMOTE_DOUBLE_REV   (3)
 

Functions

const char * ap_get_useragent_host (request_rec *req, int type, int *str_is_ip)
 
const char * ap_get_remote_host (conn_rec *conn, void *dir_config, int type, int *str_is_ip)
 

Detailed Description

Macro Definition Documentation

#define REMOTE_DOUBLE_REV   (3)

REMOTE_DOUBLE_REV will always force a DNS lookup, and also force a double reverse lookup, regardless of the HostnameLookups setting. The result is the (double reverse checked) hostname, or NULL if any of the lookups fail.

#define REMOTE_HOST   (0)

REMOTE_HOST returns the hostname, or NULL if the hostname lookup fails. It will force a DNS lookup according to the HostnameLookups setting.

#define REMOTE_NAME   (1)

REMOTE_NAME returns the hostname, or the dotted quad if the hostname lookup fails. It will force a DNS lookup according to the HostnameLookups setting.

#define REMOTE_NOLOOKUP   (2)

REMOTE_NOLOOKUP is like REMOTE_NAME except that a DNS lookup is never forced.

Function Documentation

const char* ap_get_remote_host ( conn_rec conn,
void dir_config,
int  type,
int str_is_ip 
)

Lookup the remote client's DNS name or IP address

Parameters
connThe current connection
dir_configThe directory config vector from the request
typeThe type of lookup to perform. One of:
    REMOTE_HOST returns the hostname, or NULL if the hostname
                lookup fails.  It will force a DNS lookup according to the
                HostnameLookups setting.
    REMOTE_NAME returns the hostname, or the dotted quad if the
                hostname lookup fails.  It will force a DNS lookup according
                to the HostnameLookups setting.
    REMOTE_NOLOOKUP is like REMOTE_NAME except that a DNS lookup is
                    never forced.
    REMOTE_DOUBLE_REV will always force a DNS lookup, and also force
                  a double reverse lookup, regardless of the HostnameLookups
                  setting.  The result is the (double reverse checked)
                  hostname, or NULL if any of the lookups fail.
str_is_ipunless NULL is passed, this will be set to non-zero on output when an IP address string is returned
Returns
The remote hostname (based on the connection client_ip)
const char* ap_get_useragent_host ( request_rec req,
int  type,
int str_is_ip 
)

Lookup the remote user agent's DNS name or IP address

Parameters
reqThe current request
typeThe type of lookup to perform. One of:
    REMOTE_HOST returns the hostname, or NULL if the hostname
                lookup fails.  It will force a DNS lookup according to the
                HostnameLookups setting.
    REMOTE_NAME returns the hostname, or the dotted quad if the
                hostname lookup fails.  It will force a DNS lookup according
                to the HostnameLookups setting.
    REMOTE_NOLOOKUP is like REMOTE_NAME except that a DNS lookup is
                    never forced.
    REMOTE_DOUBLE_REV will always force a DNS lookup, and also force
                  a double reverse lookup, regardless of the HostnameLookups
                  setting.  The result is the (double reverse checked)
                  hostname, or NULL if any of the lookups fail.
str_is_ipunless NULL is passed, this will be set to non-zero on output when an IP address string is returned
Returns
The remote hostname (based on the request useragent_ip)