'host' and 'dig' manpages lack solution to OS X DNS lookup behavior

Number:rdar://23757472 Date Originated:04-Dec-2015
Status:Open Resolved:
Product:OS X Product Version:10.11.2 Beta (15C48a)
Classification:UI/Usability Reproducible:N/A
The manpages for 'host' and 'dig' correctly point out that most OS X tools have a different lookup behavior:

       The host command does not use the host name and address resolution or
       the DNS query routing mechanisms used by other processes running on Mac
       OS X.  The results of name or address queries printed by host may
       differ from those found by other processes that use the Mac OS X native
       name and address resolution mechanisms.  The results of DNS queries may
       also differ from queries that use the Mac OS X DNS routing library.

However, it's not clear from this description how to work around this.

To get roughly the expected results from 'host example.com', 'dscacheutil -q host -a name example.com' appears to be a suitable substitute.

The manpages should be amended to point to dscacheutil's -q host feature, and ideally, there should be a shortcut for a simpler syntax; as a workaround, I use this alias:

alias osxhost "dscacheutil -q host -a name"

Steps to Reproduce:
1. look up example.com using 'host'
2. notice discrepancy between 'host' and e.g. Safari
3. notice that 'host' manpage points this out

Expected Results:
The manpage helpfully shows me the command I probably meant to use, which is dscacheutil -q host -a.

Actual Results:
The manpage doesn't provide a resolution.

10.11.2 Beta (15C48a)

The dscacheutil manpage is lacking in examples; there's not a single host lookup example.


Please note: Reports posted here will not necessarily be seen by Apple. All problems should be submitted at bugreport.apple.com before they are posted here. Please only post information for Radars that you have filed yourself, and please do not include Apple confidential information in your posts. Thank you!