GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  CMDEBUG (1)

.ds Aq ’

NAME

cmdebug - Reports the status of a host Cache Manager

CONTENTS

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.

Search for    or go to Top of page |  Section 1 |  Main Index


OpenAFS CMDEBUG (1) 2015-10-28

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.