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