938fbadb7cd3b7d368d822d945e8a1b8aa11dd96
[openafs.git] / 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.example.com>:
97
98    % bos getdate -server fs2.example.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.