7aecfe70459ad95cc47832cf5b145b5d768253a7
[openafs.git] / src / man / kas_debuginfo.1
1 kas debuginfo              AFS Commands           kas debuginfo
2
3
4 NAME
5
6    kas    debuginfo -- produce   debugging   trace   for   the
7
8                        Authentication Server.
9
10
11    kas debuginfo  [-hostname <authentication server host name>]
12           [-admin_username <admin principal to use for
13    authentication>]
14    [-password_for_admin <admin password>]  [-cell <cell name>]
15                                                              +
16           [-servers <explicit list of authentication servers> ]
17    [-noauth]
18    [-help]
19
20 ACCEPTABLE ABBREVIATIONS/ALIASES
21
22    kas deb  [-ho <authentication server host name>]
23    [-a <admin principal to use for authentication>]
24    [-p <admin password>]  [-c <cell name>]
25                                                 +
26    [-s <explicit list of authentication servers> ]  [-n]  [-he]
27
28 DESCRIPTION
29
30    Displays information on the standard output device  (stdout)
31    which  is  helpful  in  debugging the Authentication Server.
32    This information is useful only for  someone  familiar  with
33    the  implementation  of  the  Authentication  Server and the
34    internal structure of the  Authentication  Database.    Most
35    system administrators will not find it helpful.
36
37 ARGUMENTS
38
39    -hostname         names  the  database  server  machine  for
40                      which  to  display  debugging  information
41                      about  the  Authentication Server instance
42                      it is running.
43
44    -admin_username   specifies the user name  under  which  the
45                      issuer wishes to perform the command.  See
46                      section 4.3 in the  Reference  Manual  for
47                      more details.  -password_for_admin
48                      specifies  the  issuer's  password.     If
49                      provided  here, the password is visible on
50                      the  screen.    If  the  issuer  does  not
51                      provide  it,  it  will be prompted for and
52                      not be visible on the screen.  See section
53                      4.3  in  the  Reference  Manual  for  more
54                      details.  -cell
55                      specifies  the  cell  in  which to run the
56                      command, if  not  the  local  cell.    See
57                      section  4.3  in  the Reference Manual for
58                      more details.  -servers
59                      specifies  the  database server machine(s)
60                      with which to establish a connection.  See
61                      section  4.3  in  the Reference Manual for
62                      more details.  -noauth
63                      establishes  an unauthenticated connection
64                      between  the  Authentication  Servers  and
65
66
67
68                      issuer,  whom they assign the unprivileged
69                      identity anonymous rather than  attempting
70                      mutual authentication.  See section 4.3 in
71                      the Reference  Manual  for  more  details.
72                      -help
73                      prints the online help for  this  command.
74                      Do  not  provide  any  other  arguments or
75                      flags with this one.  See section  4.3  in
76                      the Reference Manual for more details.
77
78 PRIVILEGE REQUIRED
79
80    None.    A  password will be prompted for unless the -noauth
81    flag is provided.   The  issuer  must  type  some  character
82    string  at the prompt, but even providing the wrong one does
83    not  prevent  the  command  from  being  executed,   despite
84    possible error messages.
85
86 MORE INFORMATION
87
88    kas statistics