dscacheutil —
gather information, statistics and
initiate queries to the Directory Service cache.
dscacheutil |
-q category
[-a key
value] |
dscacheutil |
-cachedump [-buckets]
[-entries [category]] |
dscacheutil |
-configuration |
dscacheutil does various operations
against the Directory Service cache including gathering statistics,
initiating lookups, inspection, cache flush, etc. This tool replaces most of
the functionality of the lookupd tool previously available in the OS.
A list of flags and their descriptions:
-h- Lists the options for calling
dscacheutil
-q
category- Initiate a query using standard calls. These calls will either return
results from the cache or go fetch live data and place them in the cache.
By default if no specific query is requested via
-a then all results within that category will be
returned.
-a
key value- Optional flag to
-q for a specific key with a
value.
-cachedump- Dumps an overview of the cache by default. Additional flags will provide
more detailed information.
-buckets- Used in conjunction with
-cachedump to also print
hash bucket usage of the current cache.
-entries
[category]- Used in conjunction with
-cachedump to dump
detailed information about cache entries. An optional category can be
supplied to only see types of interest. Dumping 'host' entries can only be
done by administrative users.
-configuration- Prints current configuration information, such as the search policy from
Directory Service and cache parameters.
-flushcache- Flushes the entire cache. This should only be used in extreme cases.
Validation information is used within the cache along with other
techniques to ensure the OS has valid information available to it.
-statistics- Prints statistics from the cache including an overview and detailed call
statistics. Some calls are not cached but are derived from other calls
internally. Cache hits and cache misses may not always be equal to
external calls. For example getaddrinfo is actually a combination of
gethostbyname with other calls internally to the cache to maximize cache
hit rate.
Available categories and associated keys:
- group
- name or gid
- host
- name or ip_address (used for both IPv6 and IPv4)
- mount
- name
- protocol
- name or number
- rpc
- name or number
- service
- name or port
- user
- name or uid
- Lookup a user:
-
% dscacheutil -q user -a name
jdoe
name: jdoe
password: ********
uid: 501
gid: 501
dir: /Users/jdoe
shell: /bin/csh
gecos: John Doe
- Lookup all users:
-
% dscacheutil -q
user
- Dump cache overview:
-
% dscacheutil
-cachedump
- Dump cache details with user entries:
-
% dscacheutil -cachedump -entries
user