doc/man-pages/pod8/bos_uninstall.pod

   1 =head1 NAME
   2
   3 bos_uninstall - Reverts to the former version of a process's binary file
   4
   5 =head1 SYNOPSIS
   6
   7 =for html
   8 <div class="synopsis">
   9
  10 B<bos uninstall> S<<< B<-server> <I<machine name>> >>>
  11     S<<< B<-file> <I<files to uninstall>>+ >>> S<<< [B<-dir> <I<destination dir>>] >>>
  12     S<<< [B<-cell> <I<cell name>>] >>> [B<-noauth>] [B<-localauth>] [B<-help>]
  13
  14 B<bos u> S<<< B<-s> <I<machine name>> >>> S<<< B<-f> <I<files to uninstall>>+ >>>
  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 uninstall> command replaces each binary file specified by the
  24 B<-file> argument with its C<.BAK> version on the server machine named by
  25 the B<-server> argument, which is normally the binary distribution machine
  26 for its CPU/operating system type. It also changes the extension on the
  27 current C<.OLD> version (if any) to C<.BAK>. Each binary file must reside
  28 in the local F</usr/afs/bin> directory unless the B<-dir> argument names
  29 an alternate directory.
  30
  31 To start using the reverted binary immediately, issue the B<bos restart>
  32 command. Otherwise, the BOS Server automatically restarts the process at
  33 the time defined in the F</usr/afs/local/BosConfig> file; use the B<bos
  34 getrestart> command to display the time and the B<bos setrestart> time to
  35 set it.
  36
  37 =head1 OPTIONS
  38
  39 =over 4
  40
  41 =item B<-server> <I<machine name>>
  42
  43 Indicates the binary distribution machine on which to revert to the
  44 C<.BAK> version of binaries. Identify the machine by IP address or its
  45 host name (either fully-qualified or abbreviated unambiguously). For
  46 details, see L<bos(8)>.
  47
  48 If the machine is not a binary distribution machine and is running an
  49 C<upclientbin> process, then the files are overwritten the next time the
  50 C<upclientbin> process fetches the corresponding file from the
  51 distribution machine (by default within five minutes).
  52
  53 =item B<-file> <I<files to uninstall>>+
  54
  55 Names each binary file to replace with its C<.BAK> version.
  56
  57 =item B<-dir> <I<destinatino dir>>
  58
  59 Provides the complete pathname of the local disk directory containing each
  60 file named by the B<-file> argument. It is necessary only if the binaries
  61 are not in the F</usr/afs/bin> directory.
  62
  63 =item B<-cell> <I<cell name>>
  64
  65 Names the cell in which to run the command. Do not combine this argument
  66 with the B<-localauth> flag. For more details, see L<bos(8)>.
  67
  68 =item B<-noauth>
  69
  70 Assigns the unprivileged identity C<anonymous> to the issuer. Do not
  71 combine this flag with the B<-localauth> flag. For more details, see
  72 L<bos(8)>.
  73
  74 =item B<-localauth>
  75
  76 Constructs a server ticket using a key from the local
  77 F</usr/afs/etc/KeyFile> or F</usr/afs/etc/KeyFileExt> file.
  78 The B<bos> command interpreter presents the
  79 ticket to the BOS Server during mutual authentication. Do not combine this
  80 flag with the B<-cell> or B<-noauth> options. For more details, see
  81 L<bos(8)>.
  82
  83 =item B<-help>
  84
  85 Prints the online help for this command. All other valid options are
  86 ignored.
  87
  88 =back
  89
  90 =head1 EXAMPLES
  91
  92 The following example command overwrites the F</usr/afs/bin/kaserver> file
  93 on the machine C<fs4.example.com> with its C<.BAK> version, and the current
  94 C<.BAK> version by the C<.OLD> version.
  95
  96    % bos uninstall -server fs4.example.com -file kaserver
  97
  98 =head1 PRIVILEGE REQUIRED
  99
 100 The issuer must be listed in the F</usr/afs/etc/UserList> file on the
 101 machine named by the B<-server> argument, or must be logged onto a server
 102 machine as the local superuser C<root> if the B<-localauth> flag is
 103 included.
 104
 105 The B<bos uninstall> command cannot be run against servers running in
 106 restricted mode.
 107
 108 =head1 SEE ALSO
 109
 110 L<BosConfig(5)>,
 111 L<KeyFile(5)>,
 112 L<KeyFileExt(5)>,
 113 L<UserList(5)>,
 114 L<bos(8)>,
 115 L<bos_getrestart(8)>,
 116 L<bos_restart(8)>,
 117 L<bos_setrestart(8)>,
 118 L<upclient(8)>
 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.