1 <!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML 3//EN">
3 <TITLE>Administration Reference</TITLE>
4 <!-- Begin Header Records ========================================== -->
5 <!-- /tmp/idwt3190/auarf000.scr converted by idb2h R4.2 (359) ID -->
6 <!-- Workbench Version (AIX) on 5 Nov 1999 at 13:58:29 -->
7 <META HTTP-EQUIV="updated" CONTENT="Fri, 05 Nov 1999 13:58:29">
8 <META HTTP-EQUIV="review" CONTENT="Sun, 05 Nov 2000 13:58:29">
9 <META HTTP-EQUIV="expires" CONTENT="Mon, 05 Nov 2001 13:58:29">
11 <!-- (C) IBM Corporation 2000. All Rights Reserved -->
12 <BODY bgcolor="ffffff">
13 <!-- End Header Records ============================================ -->
14 <A NAME="Top_Of_Page"></A>
15 <H1>Administration Reference</H1>
16 <HR><P ALIGN="center"> <A HREF="../index.htm"><IMG SRC="../books.gif" BORDER="0" ALT="[Return to Library]"></A> <A HREF="auarf002.htm#ToC"><IMG SRC="../toc.gif" BORDER="0" ALT="[Contents]"></A> <A HREF="auarf100.htm"><IMG SRC="../prev.gif" BORDER="0" ALT="[Previous Topic]"></A> <A HREF="#Bot_Of_Page"><IMG SRC="../bot.gif" BORDER="0" ALT="[Bottom of Topic]"></A> <A HREF="auarf102.htm"><IMG SRC="../next.gif" BORDER="0" ALT="[Next Topic]"></A> <A HREF="auarf284.htm#HDRINDEX"><IMG SRC="../index.gif" BORDER="0" ALT="[Index]"></A> <P>
18 <H2><A NAME="HDRBOS_GETDATE" HREF="auarf002.htm#ToC_115">bos getdate</A></H2>
19 <A NAME="IDX4516"></A>
20 <A NAME="IDX4517"></A>
21 <A NAME="IDX4518"></A>
22 <A NAME="IDX4519"></A>
23 <A NAME="IDX4520"></A>
24 <A NAME="IDX4521"></A>
25 <A NAME="IDX4522"></A>
26 <A NAME="IDX4523"></A>
27 <A NAME="IDX4524"></A>
28 <A NAME="IDX4525"></A>
29 <A NAME="IDX4526"></A>
30 <P><STRONG>Purpose</STRONG>
31 <P>Displays the time stamps on an AFS binary file
32 <P><STRONG>Synopsis</STRONG>
33 <PRE><B>bos getdate -server</B> <<VAR>machine name</VAR>> <B>-file</B> <<VAR>files to check</VAR>><SUP>+</SUP>
34 [<B>-dir</B> <<VAR>destination dir</VAR>>] [<B>-cell</B> <<VAR>cell name</VAR>>]
35 [<B>-noauth</B>] [<B>-localauth</B>] [<B>-help</B>]
37 <B>bos getd -s</B> <<VAR>machine name</VAR>> <B>-f</B> <<VAR>files to check</VAR>><SUP>+</SUP> [<B>-d</B> <<VAR>destination dir</VAR>>]
38 [<B>-c</B> <<VAR>cell name</VAR>>] [<B>-n</B>] [<B>-l</B>] [<B>-h</B>]
40 <P><STRONG>Description</STRONG>
41 <P>The <B>bos getdate</B> command displays the time stamps on the current
42 version,<TT> .BAK</TT> version (if any) and <TT>.OLD</TT>
43 version (if any) of each binary file named by the <B>-file</B>
44 argument. (The BOS Server automatically creates <TT>.BAK</TT>
45 and <TT>.OLD</TT> versions when new binaries are installed with the
46 <B>bos install</B> command.) The files must reside in the
47 <B>/usr/afs/bin</B> directory on the server machine named by the
48 <B>-server</B> argument unless the <B>-dir</B> argument indicates an
50 <P>To revert to the <TT>.BAK</TT> version of a binary, use the
51 <B>bos uninstall</B> command. To remove obsolete binary files from
52 the <B>/usr/afs/bin</B> directory, use the <B>bos prune</B>
54 <P><STRONG>Options</STRONG>
56 <P><DT><B><B>-server</B>
57 </B><DD>Indicates the server machine from which to list binary files.
58 Identify the machine by IP address or its host name (either fully-qualified or
59 abbreviated unambiguously). For details, see the introductory reference
60 page for the <B>bos</B> command suite.
61 <P>All server machines of the same AFS system type show the same timestamps if
62 the binaries were installed properly on the binary distribution machine for
63 this machine's system type, and if all other machines of that type are
64 running the appropriate <B>upclientbin</B> process.
65 <P><DT><B><B>-file</B>
66 </B><DD>Names each binary file to list.
68 </B><DD>Specifies the complete pathname of the local disk directory containing
69 each file named by the <B>-file</B> argument. It is necessary only
70 if the files are not in the <B>/usr/afs/bin</B> directory.
71 <P><DT><B><B>-cell</B>
72 </B><DD>Names the cell in which to run the command. Do not combine this
73 argument with the <B>-localauth</B> flag. For more details, see the
74 introductory <B>bos</B> reference page.
75 <P><DT><B><B>-noauth</B>
76 </B><DD>Assigns the unprivileged identity <B>anonymous</B> to the
77 issuer. Do not combine this flag with the <B>-localauth</B>
78 flag. For more details, see the introductory <B>bos</B> reference
80 <P><DT><B><B>-localauth</B>
81 </B><DD>Constructs a server ticket using a key from the local
82 <B>/usr/afs/etc/KeyFile</B> file. The <B>bos</B> command
83 interpreter presents the ticket to the BOS Server during mutual
84 authentication. Do not combine this flag with the <B>-cell</B> or
85 <B>-noauth</B> options. For more details, see the introductory
86 <B>bos</B> reference page.
88 </B><DD>Prints the online help for this command. All other valid options
91 <P><STRONG>Output</STRONG>
92 <P>For each file specified with the <B>-file</B> argument, the output
93 displays the time stamp on the current (unmarked), <TT>.BAK</TT>, and
94 <TT>.OLD</TT> version. The output explicitly reports that a
95 version does not exist, rather than simply omitting it.
96 <P><STRONG>Examples</STRONG>
97 <P>The following command examines the time stamps on the files with basename
98 <B>kaserver</B> on the machine <B>fs2.abc.com</B>:
99 <PRE> % <B>bos getdate -server fs2.abc.com -file kaserver</B>
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.
104 <P><STRONG>Privilege Required</STRONG>
106 <P><STRONG>Related Information</STRONG>
107 <P><A HREF="auarf023.htm#HDRKEYFILE">KeyFile</A>
108 <P><A HREF="auarf093.htm#HDRBOS_INTRO">bos</A>
109 <P><A HREF="auarf105.htm#HDRBOS_INSTALL">bos install</A>
110 <P><A HREF="auarf109.htm#HDRBOS_PRUNE">bos prune</A>
111 <P><A HREF="auarf123.htm#HDRBOS_UNINSTALL">bos uninstall</A>
113 <HR><P ALIGN="center"> <A HREF="../index.htm"><IMG SRC="../books.gif" BORDER="0" ALT="[Return to Library]"></A> <A HREF="auarf002.htm#ToC"><IMG SRC="../toc.gif" BORDER="0" ALT="[Contents]"></A> <A HREF="auarf100.htm"><IMG SRC="../prev.gif" BORDER="0" ALT="[Previous Topic]"></A> <A HREF="#Top_Of_Page"><IMG SRC="../top.gif" BORDER="0" ALT="[Top of Topic]"></A> <A HREF="auarf102.htm"><IMG SRC="../next.gif" BORDER="0" ALT="[Next Topic]"></A> <A HREF="auarf284.htm#HDRINDEX"><IMG SRC="../index.gif" BORDER="0" ALT="[Index]"></A> <P>
114 <!-- Begin Footer Records ========================================== -->
116 <br>© <A HREF="http://www.ibm.com/">IBM Corporation 2000.</A> All Rights Reserved
118 <!-- End Footer Records ============================================ -->
119 <A NAME="Bot_Of_Page"></A>