Document KeyFileExt(5)
[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> 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.