=head1 NAME
-bos prune - Removes obsolete versions of files from the /usr/afs/bin and
-B</usr/afs/logs> directories
+bos prune - Removes obsolete files from /usr/afs/bin and /usr/afs/logs
=head1 SYNOPSIS
-B<bos prune -server> <I<machine name>> [B<-bak>] [B<-old>] [B<-core>] [-all]
-[B<-cell> <I<cell name>>] [B<-noauth>] [B<-localauth>] [B<-help>]
+B<bos prune> B<-server> <I<machine name>> [B<-bak>] [B<-old>] [B<-core>]
+ [B<-all>] [B<-cell> <I<cell name>>] [B<-noauth>] [B<-localauth>]
+ [B<-help>]
-B<bos p -s> <I<machine name>> [B<-b>] [B<-o>] [B<-co>] [-a]
-[B<-ce> <I<cell name>>] [B<-n>] [B<-l>] [B<-h>]
+B<bos p> B<-s> <I<machine name>> [B<-b>] [B<-o>] [B<-co>] [B<-a>]
+ [B<-ce> <I<cell name>>] [B<-n>] [B<-l>] [B<-h>]
=head1 DESCRIPTION
-The bos prune command removes files from the local disk of the
-server machine named by the B<-server> argument, as specified by one
-or more of the following flags provided on the command line:
+The B<bos prune> command removes files from the local disk of the server
+machine named by the B<-server> argument, as specified by one or more of
+the following flags provided on the command line:
=over 4
=item *
-The -bak flag removes all files from the
-B</usr/afs/bin> directory that have a C<.BAK>
-extension.
-
+The B<-bak> flag removes all files from the F</usr/afs/bin> directory that
+have a C<.BAK> extension.
=item *
-The -old flag removes all files from the
-B</usr/afs/bin> directory that have a C<.OLD>
-extension.
-
+The B<-old> flag removes all files from the F</usr/afs/bin> directory that
+have a C<.OLD> extension.
=item *
-The -core flag removes all files from the
-B</usr/afs/logs> directory that have a C<core.>
-prefix.
-
+The B<-core> flag removes all files from the F</usr/afs/logs> directory
+that have a C<core.> prefix.
=item *
-The -all flag removes all three types of files at once.
-
+The B<-all> flag removes all three types of files at once.
=back
(If none of these flags are included, the command appears to succeed, but
removes no files at all.)
-To display the timestamp on the current, C<.BAK>, and
-C<.OLD> versions of one or more files, use the B<bos
-getdate> command.
+To display the timestamp on the current, C<.BAK>, and C<.OLD> versions of
+one or more files, use the B<bos getdate> command.
=head1 OPTIONS
=over 4
-=item -server
->
+=item B<-server> <I<machine name>>
-Indicates the server machine from which to remove files. Identify
-the machine by IP address or its host name (either fully-qualified or
-abbreviated unambiguously). For details, see the introductory reference
-page for the B<bos> command suite.
+Indicates the server machine from which to remove files. Identify the
+machine by IP address or its host name (either fully-qualified or
+abbreviated unambiguously). For details, see L<bos(8)>.
-=item -bak
->
+=item B<-bak>
-Removes all files from the /usr/afs/bin directory that have a
-C<.BAK> extension. Do not combine this flag and the
-B<-all> flag.
+Removes all files from the F</usr/afs/bin> directory that have a C<.BAK>
+extension. Do not combine this flag and the B<-all> flag.
-=item -old
->
+=item B<-old>
-Removes all files from the /usr/afs/bin directory that have a
-C<.OLD> extension. Do not combine this flag and the
-B<-all> flag.
+Removes all files from the F</usr/afs/bin> directory that have a C<.OLD>
+extension. Do not combine this flag and the B<-all> flag.
-=item -core
->
+=item B<-core>
-Removes all files from the /usr/afs/logs directory that have a
-C<core.> prefix. Do not combine this flag and the
-B<-all> flag.
+Removes all files from the F</usr/afs/logs> directory that have a C<core.>
+prefix. Do not combine this flag and the B<-all> flag.
-=item -all
->
+=item B<-all>
-Combines the effect of the B<-bak>, -old, and
-B<-core> flags. Do not combine this flag with any of those
-three.
+Combines the effect of the B<-bak>, B<-old>, and B<-core> flags. Do not
+combine this flag with any of those three.
-=item -cell
->
+=item B<-cell> <I<cell name>>
-Names the cell in which to run the command. Do not combine this
-argument with the B<-localauth> flag. For more details, see the
-introductory B<bos> reference page.
+Names the cell in which to run the command. Do not combine this argument
+with the B<-localauth> flag. For more details, see L<bos(8)>.
-=item -noauth
->
+=item B<-noauth>
-Assigns the unprivileged identity anonymous to the
-issuer. Do not combine this flag with the B<-localauth>
-flag. For more details, see the introductory B<bos> reference
-page.
+Assigns the unprivileged identity C<anonymous> to the issuer. Do not
+combine this flag with the B<-localauth> flag. For more details, see
+L<bos(8)>.
-=item -localauth
->
+=item B<-localauth>
Constructs a server ticket using a key from the local
-B</usr/afs/etc/KeyFile> file. The B<bos> command
-interpreter presents the ticket to the BOS Server during mutual
-authentication. Do not combine this flag with the B<-cell> or
-B<-noauth> options. For more details, see the introductory
-B<bos> reference page.
+F</usr/afs/etc/KeyFile> file. The B<bos> command interpreter presents the
+ticket to the BOS Server during mutual authentication. Do not combine this
+flag with the B<-cell> or B<-noauth> options. For more details, see
+L<bos(8)>.
-=item -help
+=item B<-help>
-Prints the online help for this command. All other valid options
-are ignored.
+Prints the online help for this command. All other valid options are
+ignored.
=back
=head1 EXAMPLES
-The following example removes all files from the /usr/afs/bin
-directory on the machine B<fs3.abc.com> that have a
-C<.BAK> or C<.OLD> extension.
+The following example removes all files from the F</usr/afs/bin> directory
+on the machine C<fs3.abc.com> that have a C<.BAK> or C<.OLD> extension.
% bos prune -server fs3.abc.com -bak -old
-The following example removes all files from the /usr/afs/bin
-directory on the machine B<db2.abc.com> that have a
-C<.BAK> or C<.OLD> extension, and all files from
-the B</usr/afs/logs> directory that have a C<core.>
+The following example removes all files from the F</usr/afs/bin> directory
+on the machine C<db2.abc.com> that have a C<.BAK> or C<.OLD> extension,
+and all files from the F</usr/afs/logs> directory that have a C<core.>
prefix.
% bos prune -server db2.abc.com -all
=head1 PRIVILEGE REQUIRED
-The issuer must be listed in the /usr/afs/etc/UserList file on
-the machine named by the B<-server> argument, or must be logged onto a
-server machine as the local superuser B<root> if the
-B<-localauth> flag is included.
+The issuer must be listed in the F</usr/afs/etc/UserList> file on the
+machine named by the B<-server> argument, or must be logged onto a server
+machine as the local superuser C<root> if the B<-localauth> flag is
+included.
=head1 SEE ALSO
-L<KeyFile(1)>,
-L<UserList(1)>,
-L<bos(1)>,
-L<bos_getdate(1)>
+L<KeyFile(5)>,
+L<UserList(5)>,
+L<bos(8)>,
+L<bos_getdate(8)>
=head1 COPYRIGHT