doc/man-pages/pod8/bos_getrestart.pod

   1 =head1 NAME
   2
   3 bos_getrestart - Displays the automatic restart times for server processes
   4
   5 =head1 SYNOPSIS
   6
   7 =for html
   8 <div class="synopsis">
   9
  10 B<bos getrestart> S<<< B<-server> <I<machine name>> >>> S<<< [B<-cell> <I<cell name>>] >>>
  11     [B<-noauth>] [B<-localauth>] [B<-help>]
  12
  13 B<bos getr> S<<< B<-s> <I<machine name>> >>> S<<< [B<-c> <I<cell name>>] >>> [B<-n>]
  14     [B<-l>] [B<-h>]
  15
  16 =for html
  17 </div>
  18
  19 =head1 DESCRIPTION
  20
  21 The bos getrestart command displays two restart times from the
  22 F</usr/afs/local/BosConfig> file on the server machine named by the
  23 B<-server> argument:
  24
  25 =over 4
  26
  27 =item *
  28
  29 The I<general restart> time at which the BOS Server process automatically
  30 restarts itself and all processes marked with status C<Run> in the
  31 F<BosConfig> file. The default is Sunday at 4:00 a.m.
  32
  33 =item *
  34
  35 The I<binary restart> time at which the BOS Server automatically restarts
  36 any process for which the time stamp on the binary file in the
  37 F</usr/afs/bin> directory is later than the last restart time for the
  38 process. The default is 5:00 a.m. Use the B<bos getdate> command to list a
  39 binary file's timestamp, and the B<-long> flag to the B<bos status>
  40 command to display a process's most recent restart time.
  41
  42 =back
  43
  44 Use the B<bos setrestart> command to set the restart times.
  45
  46 =head1 OPTIONS
  47
  48 =over 4
  49
  50 =item B<-server> <I<machine name>>
  51
  52 Indicates the server machine for which to display the restart
  53 times. Identify the machine by IP address or its host name (either
  54 fully-qualified or abbreviated unambiguously). For details, see L<bos(8)>.
  55
  56 =item B<-cell> <I<cell name>>
  57
  58 Names the cell in which to run the command. Do not combine this argument
  59 with the B<-localauth> flag. For more details, see L<bos(8)>.
  60
  61 =item B<-noauth>
  62
  63 Assigns the unprivileged identity C<anonymous> to the issuer. Do not
  64 combine this flag with the B<-localauth> flag. For more details, see
  65 L<bos(8)>.
  66
  67 =item B<-localauth>
  68
  69 Constructs a server ticket using a key from the local
  70 F</usr/afs/etc/KeyFile> or F</usr/afs/etc/KeyFileExt> file.
  71 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 OUTPUT
  84
  85 The output consists of two lines:
  86
  87    Server <machine_name> restarts at <time>
  88    Server <machine_name> restarts for new binaries at <time>
  89
  90 Possible values for <time> include:
  91
  92 =over 4
  93
  94 =item *
  95
  96 C<never>, indicating that the BOS Server never performs that type of
  97 restart.
  98
  99 =item *
 100
 101 C<now>, indicating that the BOS Server performs that type of restart only
 102 each time it restarts.
 103
 104 =item *
 105
 106 A specified day and time, indicating that the BOS Server performs that
 107 type of restart once per week. Example: C<sun 4:00 am>.
 108
 109 =item *
 110
 111 A specified time, indicating that the BOS Server performs that type of
 112 restart once per day. Examples: C<11:00 pm>, C<3:00 am>.
 113
 114 =back
 115
 116 =head1 EXAMPLES
 117
 118 The following example displays the restart times for the machine
 119 C<db2.example.com>:
 120
 121    % bos getrestart db2.example.com
 122    Server db2.example.com restarts at sun 4:00 am
 123    Server db2.example.com restarts for new binaries at 2:15 am
 124
 125 In the following example, the issuer abbreviates the machine name
 126 C<fs1.example.com> to C<fs1>, relying on the cell's name server to resolve the
 127 name. The output echoes the abbreviated form.
 128
 129    % bos getrestart fs1
 130    Server fs1 restarts at sat 5:00 am
 131    Server fs1 restarts for new binaries at 11:30 pm
 132
 133 =head1 PRIVILEGE REQUIRED
 134
 135 None
 136
 137 =head1 SEE ALSO
 138
 139 L<BosConfig(5)>,
 140 L<KeyFile(5)>,
 141 L<KeyFileExt(5)>,
 142 L<bos(8)>,
 143 L<bos_getdate(8)>,
 144 L<bos_setrestart(8)>,
 145 L<bos_status(8)>
 146
 147 =head1 COPYRIGHT
 148
 149 IBM Corporation 2000. <http://www.ibm.com/> All Rights Reserved.
 150
 151 This documentation is covered by the IBM Public License Version 1.0.  It was
 152 converted from HTML to POD by software written by Chas Williams and Russ
 153 Allbery, based on work by Alf Wachsmann and Elizabeth Cassell.