Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

dscacheutil(1) [mojave man page]

dscacheutil(1)						    BSD General Commands Manual 					    dscacheutil(1)

dscacheutil -- gather information, statistics and initiate queries to the Directory Service cache. SYNOPSIS
dscacheutil -h dscacheutil -q category [-a key value] dscacheutil -cachedump [-buckets] [-entries [category]] dscacheutil -configuration dscacheutil -flushcache dscacheutil -statistics DESCRIPTION
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. FLAGS
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 EXAMPLES
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 SEE ALSO
DirectoryService(8), dsmemberutil(1) Darwin Jan 14, 2007 Darwin

Check Out this Related Man Page

cachefsstat(1M) 					  System Administration Commands					   cachefsstat(1M)

cachefsstat - Cache File System statistics SYNOPSIS
/usr/bin/cachefsstat [-z] [path...] DESCRIPTION
The cachefsstat command displays statistical information about the cache file system mounted on path. The statistical information includes cache hits and misses, consistency checking, and modification operations. If path is not specified, all mounted cache file systems are used. cachefsstat can also be used to reinitialize this information (see -z option). The statistical information has the following format: <cache hit rate> <consistency checks> <modifies> where: hit rate The percentage of cache hits over the total number of attempts, followed by the actual numbers of hits and misses. consistency checks The number of consistency checks performed, followed by the number that passed, and the number that failed. modifies The number of modify operations, including writes, creates, etc. OPTIONS
The following option is supported: -z Zero (reinitialize) statistics. Execute cachefsstat -z before executing cachefsstat again to gather statistics on the cache per- formance. This option can only be use by the superuser. The statistics printed reflect those just before the statistics are reinitialized. USAGE
See largefile(5) for the description of the behavior of cachefsstat when encountering files greater than or equal to 2 Gbyte (2**31 bytes). EXAMPLES
Example 1: Using cachefsstat The following example shows the cachefsstat command run on file system /test: example# cachefsstat /test /test cache hit rate: 100% (0 hits, 0 misses) consistency checks: 0 (0 pass, 0 fail) modifies: 0 garbage collection: 0 EXIT STATUS
The following exit values are returned: 0 Successful completion. non-zero An error occurred. ATTRIBUTES
See attributes(5) for descriptions of the following attributes: +-----------------------------+-----------------------------+ | ATTRIBUTE TYPE | ATTRIBUTE VALUE | +-----------------------------+-----------------------------+ |Availability |SUNWcsu | +-----------------------------+-----------------------------+ SEE ALSO
cachefslog(1M), cachefswssize(1M), cfsadmin(1M), attributes(5), largefile(5) SunOS 5.10 9 Oct 2003 cachefsstat(1M)
Man Page

Featured Tech Videos