doc/man-pages/pod/kas_help.pod

   1 =head1 NAME
   2
   3 kas help - Displays the syntax of each specified C<kas> command or lists functional
   4 descriptions of all C<kas> commands
   5
   6 =head1 SYNOPSIS
   7
   8 kas help [B<-topic> I<help string> [I<help string> ...]]  [B<-help>]
   9
  10 kas h [B<-t> I<help string> [I<help string> ...]]  [B<-h>]
  11
  12 =head1 DESCRIPTION
  13
  14 The C<kas help> command displays the complete online help entry (short
  15 description and syntax statement) for each command operation code
  16 specified by the B<-topic> argument. If the B<-topic> argument is omitted,
  17 the output includes the first line (name and short description) of the
  18 online help entry for every C<kas> command.
  19
  20 To list every C<kas> command whose name or short description includes a
  21 specified keyword, use the C<kas apropos> command.
  22
  23 =head1 OPTIONS
  24
  25 =over 4
  26
  27 =item B<-topic> I<help string> [I<help string> ...]
  28
  29 Indicates each command for which to display the complete online
  30 help entry. Omit the kas part of the command name, providing
  31 only the operation code (for example, specify B<setpassword>, not
  32 B<kas setpassword>). If this argument is omitted, the output
  33 briefly describes every C<kas> command.
  34
  35 =item B<-help>
  36
  37 Prints the online help for this command. All other valid
  38 options are ignored.
  39
  40 =back
  41
  42 =head1 OUTPUT
  43
  44 The online help entry for each C<kas> command consists of the following
  45 two or three lines:
  46
  47 =over
  48
  49 =item *
  50
  51 The first line names the command and briefly describes its
  52 function.
  53
  54 =item *
  55
  56 The second line lists aliases for the command, if any.
  57
  58 =item *
  59
  60 The final line, which begins with the string C<Usage>, lists the
  61 command's options in the prescribed order. Online help entries use
  62 the same symbols (for example, brackets) as the reference pages in
  63 this document.
  64
  65 =back
  66
  67 =head1 EXAMPLES
  68
  69 The following command displays the online help entry for the C<kas
  70 setpassword> command:
  71
  72 B<    kas help setpassword>
  73    kas setpassword: set a user's password
  74    aliases: sp
  75    Usage: kas setpassword -name <name of user>
  76    [-new_password <new password>] [-kvno <key version number>]
  77    [-admin_username <admin principal to use for authentication>]
  78    [-password_for_admin <password>] [-cell <cell name>]
  79    [-servers <explicit list of authentication servers>+] [-help]
  80
  81
  82 =head1 PRIVILEGE REQUIRED
  83
  84 None, and no password is required.
  85
  86 =head1 COPYRIGHT
  87
  88 IBM Corporation 2000. <http://www.ibm.com/> All Rights Reserved.
  89
  90 Converted from html to pod by Alf Wachsmann <alfw@slac.stanford.edu>, 2003,
  91 and Elizabeth Cassell <e_a_c@mailsnare.net>, 2004,
  92 Stanford Linear Accelerator Center, a department of Stanford University.
  93
  94 =head1 SEE ALSO
  95
  96 L<kas(1)>,
  97 L<kas_apropos(1)>
  98
  99 =cut