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> file. The B<bos> command interpreter presents the
  75 ticket to the BOS Server during mutual authentication. Do not combine this
  76 flag with the B<-cell> or B<-noauth> options. For more details, see
  77 L<bos(8)>.
  78
  79 =item B<-help>
  80
  81 Prints the online help for this command. All other valid options are
  82 ignored.
  83
  84 =back
  85
  86 =head1 OUTPUT
  87
  88 For each file specified with the -file argument, the output displays the
  89 time stamp on the current (unmarked), C<.BAK>, and C<.OLD> version. The
  90 output explicitly reports that a version does not exist, rather than
  91 simply omitting it.
  92
  93 =head1 EXAMPLES
  94
  95 The following command examines the time stamps on the files with basename
  96 C<kaserver> on the machine C<fs2.abc.com>:
  97
  98    % bos getdate -server fs2.abc.com -file kaserver
  99    File /usr/afs/bin/kaserver dated Mon Jan 4 10:00:36 1999.
 100    .BAK file dated Wed Dec 9 18:55:04 1998, no .OLD file.
 101
 102 =head1 PRIVILEGE REQUIRED
 103
 104 None
 105
 106 =head1 SEE ALSO
 107
 108 L<KeyFile(5)>,
 109 L<bos(8)>,
 110 L<bos_install(8)>,
 111 L<bos_prune(8)>,
 112 L<bos_uninstall(8)>
 113
 114 =head1 COPYRIGHT
 115
 116 IBM Corporation 2000. <http://www.ibm.com/> All Rights Reserved.
 117
 118 This documentation is covered by the IBM Public License Version 1.0.  It was
 119 converted from HTML to POD by software written by Chas Williams and Russ
 120 Allbery, based on work by Alf Wachsmann and Elizabeth Cassell.