NAME
cmdebug - Reports the status of a host Cache Manager
SYNOPSIS
cmdebug -servers <machine> [-port <IP port>]
[-long] [-refcounts] [-callbacks] [-ctime] [-addrs]
[-cache] [-cellservdb] [-help]
cmdebug -s <machine> [-p <IP port>] [-l] [-r] [-cal]
[-ct] [-a] [-cac] -ce] [-h]
DESCRIPTION
The cmdebug command displays information about the Cache Manager and
client cache status on a local or remote AFS client machine. By
default, it displays all locked cache entries, but other information
can be requested via various options.
CAUTIONS
The -ctime option is only available with OpenAFS version 1.4.7 and
later or version 1.5.28 or later. This option can be used to gather
information from any version of the Unix OpenAFS client, but can only
query Windows clients running OpenAFS version 1.5.28 or later.
The -cellservdb option is only available with OpenAFS version 1.4.7 and
later or version 1.5.31 or later. This option can be used to gather
information from any version of the Unix OpenAFS client, but can only
query Windows clients running OpenAFS version 1.5.31 or later.
OPTIONS
-servers <machine>
Names the client machine for which to display Cache Manager status.
Provide the machine’s IP address in dotted decimal format, its
fully qualified host name (for example, fs1.example.com), or the
shortest abbreviated form of its host name that distinguishes it
from other machines. Successful use of an abbreviated form depends
on the availability of a name resolution service (such as the
Domain Name Service or a local host table) at the time the command
is issued.
-port <IP port>
Identifies the port on which to contact the Cache Manager. By
default, the standard port 7001 is used, so this option is very
rarely needed.
-long
Reports on all lock statuses and all cache entries, rather than
only locked cache entries. Do not use this option with -refcounts,
-callbacks, -addrs, -cache, or -cellservdb.
-refcounts
Reports only those cache entries with non-zero reference counts.
Do not use this option with -long, -callbacks, -addrs, or -cache.
-callbacks
Reports only those cache entries with callbacks. Do not use this
option with -long, -refcounts, -addrs, or -cache.
-ctime
Causes entry expiration times to be shown in human-readable format.
Do not use this option with -addrs or -cache.
-addrs
Rather than showing any cache entries, displays the interfaces the
Cache Manager answers on, including their netmasks and MTUs. This
is useful for analyzing clients that are multihomed and identifying
problems with netmasks or MTU settings. Do not use this option
with -long, -refcounts, -callbacks, or -cache.
-cache
Rather than showing any cache entries, displays the cache
configuration for the client machine. The information displayed is
essentially the information that can be configured via parameters
to afsd. Do not use this option with -long, -refcounts,
-callbacks, or -addrs.
-cellservdb
Lists all known volume location database records in a CellServDB-
compatible format. This includes all records in memory, including
those from the CellServDB file, AFSDB DNS records, and the fs
newcell command. This option could be used to see if a client has
the latest copy of the CellServDB file. Do not use this option with
-long, -refcounts, -callbacks, or -cache.
-help
Prints the online help for this command. All other valid options
are ignored.
EXAMPLES
Displays all of the locked cache entries on "client1":
% cmdebug client1
Displays the cache configuration for "client1.example.com":
% cmdebug client1.example.com -cache
Displays all cache entries for "client2.example.com":
% cmdebug client2.example.com -long
PRIVILEGE REQUIRED
None
SEE ALSO
afsd(8), CellServDB(5), fs_newcell(1)
COPYRIGHT
Copyright 2005 Russ Allbery <rra@stanford.edu>
This documentation is covered by the IBM Public License Version 1.0.
This man page was written by Russ Allbery for OpenAFS.