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