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, DNS SRV or AFSDB  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.

OpenAFS                                            2025-05-19                                         CMDEBUG(1)