diff --git a/xCAT-client/pods/man1/xdshbak.1.pod b/xCAT-client/pods/man1/xdshbak.1.pod index 1ef0ab227..661f1f302 100644 --- a/xCAT-client/pods/man1/xdshbak.1.pod +++ b/xCAT-client/pods/man1/xdshbak.1.pod @@ -1,4 +1,4 @@ -=head1 B +=head1 NAME B - Formats the output of the B command. @@ -6,12 +6,12 @@ B - Formats the output of the B command. B [B<-c> | B<-x> | B<-h> | B<-q>] -=head1 B +=head1 DESCRIPTION The B command formats output from the B command. The B command takes, as input, lines in the following format: -host_name: line of output from remote command + host_name: line of output from remote command The B command formats the lines as follows and writes them to standard output. Assume that the output from node3 and node4 @@ -44,15 +44,15 @@ is identical, and the B<-c> (collapse) flag was specified: When output is displayed from more than one node in collapsed form, the host names are displayed alphabetically. When output is not collapsed, -output is displayed sorted alphabetically by host name. +output is displayed sorted alphabetically by host name. If the B<-q> quiet flag is not set then B command writes "." for each 1000 lines of output processed (to show progress), since it won't display the output until it has processed all of it. -If the B<-x> flag is specified, the extra header lines that xdshbak nor- -mally displays for each node will be omitted, and the hostname at the beginning -of each line is not stripped off, but B still sorts +If the B<-x> flag is specified, the extra header lines that xdshbak normally +displays for each node will be omitted, and the hostname at the beginning +of each line is not stripped off, but B still sorts the output by hostname for easier viewing: node1: lines from xdsh for node1 @@ -62,15 +62,15 @@ the output by hostname for easier viewing: . . -B B +=head2 Standard Error -When the B filter is used and standard error messages are gener- -ated, all error messages on standard error appear before all standard +When the B filter is used and standard error messages are generated, +all error messages on standard error appear before all standard output messages. This is true with and without the B<-c> flag. -=head1 B +=head1 OPTIONS -=over 4 +=over 6 =item B<-c> @@ -93,10 +93,8 @@ Displays usage information. Quiet mode, do not display "." for each 1000 lines of output. - =back - =head1 B =over 3 @@ -106,21 +104,21 @@ Quiet mode, do not display "." for each 1000 lines of output. To display the results of a command issued on several nodes, in the format used in the Description, enter: -B I | B + xdsh node1,node2,node3 cat /etc/passwd | xdshbak =item * -To display the results of a command issued on several nodes with +To display the results of a command issued on several nodes with identical output displayed only once, enter: -B I | B + xdsh host1,host2,host3 pwd | xdshbak -c =item * To display the results of a command issued on several nodes with compact output and be sorted alphabetically by host name, enter: -B I | B + xdsh host1,host2,host3 date | xdshbak -x =back