doc/man-pages/pod8/bos_getdate.pod

   1 =head1 NAME
   2
   3 bos_getdate - Displays the time stamps on an AFS binary file
   4
   5 =head1 SYNOPSIS
   6
   7 =for html
   8 <div class="synopsis">
   9
  10 B<bos getdate> S<<< B<-server> <I<machine name>> >>> S<<< B<-file> <I<files to check>>+ >>>
  11     S<<< [B<-dir> <I<destination dir>>] >>> S<<< [B<-cell> <I<cell name>>] >>>
  12     [B<-noauth>] [B<-localauth>] [B<-help>]
  13
  14 B<bos getd> S<<< B<-s> <I<machine name>> >>> S<<< B<-f> <I<files to check>>+ >>>
  15     S<<< [B<-d> <I<destination dir>>] >>> S<<< [B<-c> <I<cell name>>] >>> [B<-n>] [B<-l>]
  16     [B<-h>]
  17
  18 =for html
  19 </div>
  20
  21 =head1 DESCRIPTION
  22
  23 The B<bos getdate> command displays the time stamps on the current
  24 version,C< .BAK> version (if any) and C<.OLD> version (if any) of each
  25 binary file named by the B<-file> argument. (The BOS Server automatically
  26 creates C<.BAK> and C<.OLD> versions when new binaries are installed with
  27 the B<bos install> command.) The files must reside in the F</usr/afs/bin>
  28 directory on the server machine named by the B<-server> argument unless
  29 the B<-dir> argument indicates an alternate directory.
  30
  31 To revert to the C<.BAK> version of a binary, use the B<bos uninstall>
  32 command. To remove obsolete binary files from the F</usr/afs/bin>
  33 directory, use the B<bos prune> command.
  34
  35 =head1 OPTIONS
  36
  37 =over 4
  38
  39 =item B<-server> <I<machine name>>
  40
  41 Indicates the server machine from which to list binary files.  Identify
  42 the machine by IP address or its host name (either fully-qualified or
  43 abbreviated unambiguously). For details, see L<bos(8)>.
  44
  45 All server machines of the same AFS system type show the same timestamps
  46 if the binaries were installed properly on the binary distribution machine
  47 for this machine's system type, and if all other machines of that type are
  48 running the appropriate C<upclientbin> process.
  49
  50 =item B<-file> <I<files to check>>+
  51
  52 Names each binary file to list.
  53
  54 =item B<-dir> <I<destination dir>>
  55
  56 Specifies the complete pathname of the local disk directory containing
  57 each file named by the B<-file> argument. It is necessary only if the
  58 files are not in the F</usr/afs/bin> directory.
  59
  60 =item B<-cell> <I<cell name>>
  61
  62 Names the cell in which to run the command. Do not combine this argument
  63 with the B<-localauth> flag. For more details, see L<bos(8)>.
  64
  65 =item B<-noauth>
  66
  67 Assigns the unprivileged identity C<anonymous> to the issuer. Do not
  68 combine this flag with the B<-localauth> flag. For more details, see
  69 L<bos(8)>.
  70
  71 =item B<-localauth>
  72
  73 Constructs a server ticket using a key from the local
  74 F</usr/afs/etc/KeyFile> or F</usr/afs/etc/KeyFileExt> file.
  75 The B<bos> command interpreter presents the
  76 ticket to the BOS Server during mutual authentication. Do not combine this
  77 flag with the B<-cell> or B<-noauth> options. For more details, see
  78 L<bos(8)>.
  79
  80 =item B<-help>
  81
  82 Prints the online help for this command. All other valid options are
  83 ignored.
  84
  85 =back
  86
  87 =head1 OUTPUT
  88
  89 For each file specified with the -file argument, the output displays the
  90 time stamp on the current (unmarked), C<.BAK>, and C<.OLD> version. The
  91 output explicitly reports that a version does not exist, rather than
  92 simply omitting it.
  93
  94 =head1 EXAMPLES
  95
  96 The following command examines the time stamps on the files with basename
  97 C<kaserver> on the machine C<fs2.example.com>:
  98
  99    % bos getdate -server fs2.example.com -file kaserver
 100    File /usr/afs/bin/kaserver dated Mon Jan 4 10:00:36 1999.
 101    .BAK file dated Wed Dec 9 18:55:04 1998, no .OLD file.
 102
 103 =head1 PRIVILEGE REQUIRED
 104
 105 None
 106
 107 =head1 SEE ALSO
 108
 109 L<KeyFile(5)>,
 110 L<KeyFileExt(5)>,
 111 L<bos(8)>,
 112 L<bos_install(8)>,
 113 L<bos_prune(8)>,
 114 L<bos_uninstall(8)>
 115
 116 =head1 COPYRIGHT
 117
 118 IBM Corporation 2000. <http://www.ibm.com/> All Rights Reserved.
 119
 120 This documentation is covered by the IBM Public License Version 1.0.  It was
 121 converted from HTML to POD by software written by Chas Williams and Russ
 122 Allbery, based on work by Alf Wachsmann and Elizabeth Cassell.