4ab0c97ddf
git-svn-id: https://svn.code.sf.net/p/xcat/code/xcat-core/trunk@183 8638fb3e-16cb-4fca-ae20-7b5d299a9bcd
180 lines
3.6 KiB
Groff
180 lines
3.6 KiB
Groff
.TH xdshbak 12/13/07
|
|
xdshbak Command
|
|
.PP
|
|
.PP
|
|
\fBPurpose
|
|
\fR
|
|
.PP
|
|
\fBxdshbak\fR - Presents formatted output from the \fBxdsh\fR
|
|
command.
|
|
.PP
|
|
.PP
|
|
\fBSyntax
|
|
\fR
|
|
.PP
|
|
\fBxdshbak\fR [\fB-c\fR |\fB -x\fR]
|
|
.PP
|
|
\fBDescription
|
|
\fR
|
|
.PP
|
|
The \fBxdshbak\fR command formats output from the \fBxdsh\fR
|
|
command. The \fBxdshbak\fR command takes lines in the following
|
|
format:
|
|
.sp
|
|
.nf
|
|
host_name: line of output from remote command
|
|
.fi
|
|
.sp
|
|
.PP
|
|
The \fBxdshbak\fR command formats the lines as follows and writes them
|
|
to standard output. Assume that the output from host_name3 and
|
|
host_name4 is identical, and the \fB-c\fR flag was specified:
|
|
.sp
|
|
.nf
|
|
HOSTS --------------------------------------------------------
|
|
host_name1
|
|
--------------------------------------------------------------
|
|
\ .
|
|
\ .
|
|
lines from xdsh with host_names stripped off
|
|
\ .
|
|
\ .
|
|
HOSTS --------------------------------------------------------
|
|
host_name2
|
|
--------------------------------------------------------------
|
|
\ .
|
|
\ .
|
|
lines from xdsh with host_names stripped off
|
|
\ .
|
|
\ .
|
|
HOSTS --------------------------------------------------------
|
|
host_name3 host_name4
|
|
--------------------------------------------------------------
|
|
\ .
|
|
\ .
|
|
lines from xdsh with host_names stripped off
|
|
\ .
|
|
\ .
|
|
.fi
|
|
.sp
|
|
.PP
|
|
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. The
|
|
\fBxdshbak\fR command writes "." for each 1000 lines of output
|
|
filtered.
|
|
.PP
|
|
If the \fB-x\fR flag is specified, the extra header lines that xdshbak normally displays for each node will be omitted, and \fBxdshbak\fR still sorts the output by node name for easier viewing:
|
|
.sp
|
|
.nf
|
|
host_name1: lines from xdsh started
|
|
\ .
|
|
\ .
|
|
lines from xdsh continued
|
|
\ .
|
|
\ .
|
|
lines from xdsh ended
|
|
host_name2: lines from xdsh started
|
|
\ .
|
|
\ .
|
|
lines from xdsh continued
|
|
\ .
|
|
\ .
|
|
lines from xdsh ended
|
|
.fi
|
|
.sp
|
|
.PP
|
|
\fBParameters
|
|
\fR
|
|
.PP
|
|
None.
|
|
.PP
|
|
.PP
|
|
\fBFlags
|
|
\fR
|
|
.RS +3
|
|
\fB-c
|
|
\fR
|
|
.RE
|
|
.RS +9
|
|
Collapses identical output from more than one node so that it is displayed
|
|
only once.
|
|
.RE
|
|
.RS +3
|
|
\fB-x \fR
|
|
.RE
|
|
.RS +9
|
|
Omit the extra header lines that xdshbak normally displays for each node.
|
|
This provides
|
|
.RE
|
|
.RS +9
|
|
more compact output, but xdshbak still sorts the output by node name for easier viewing.
|
|
.RE
|
|
.RS +9
|
|
The flag should not be used with \fB-c\fR.
|
|
.RE
|
|
.PP
|
|
\fBSecurity
|
|
\fR
|
|
.PP
|
|
Security considerations are the same as those for the remote
|
|
shell command.
|
|
.PP
|
|
.PP
|
|
\fBExamples
|
|
\fR
|
|
.RS +3
|
|
.HP 3
|
|
1. To display the results of a command issued on several nodes, in the format
|
|
used in the Description, enter:
|
|
.sp
|
|
.nf
|
|
xdsh node1,node2,node3 cat /etc/passwd | xdshbak
|
|
.fi
|
|
.sp
|
|
.HP 3
|
|
2. To display the results of a command issued on several nodes with identical
|
|
output displayed only once, enter:
|
|
.sp
|
|
.nf
|
|
xdsh host1,host2,host3 pwd | xdshbak -c
|
|
.fi
|
|
.sp
|
|
.HP 3
|
|
3. To display the results of a command issued on several nodes with compact
|
|
output and be sorted alphabetically by host name, enter:
|
|
.sp
|
|
.nf
|
|
xdsh host1,host2,host3 date | xdshbak -x
|
|
.fi
|
|
.sp
|
|
.RE
|
|
.PP
|
|
.PP
|
|
\fBImplementation Specifics
|
|
\fR
|
|
.PP
|
|
This command is part of Extreme Cluster Systems Management (xCAT)
|
|
software.
|
|
.PP
|
|
.PP
|
|
\fBLocation
|
|
\fR
|
|
.PP
|
|
\fB/opt/xcat/bin/xdshbak\fR
|
|
.PP
|
|
.PP
|
|
\fBStandard Error
|
|
\fR
|
|
.PP
|
|
When the \fBxdshbak\fR 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 \fB-c\fR
|
|
flag.
|
|
.PP
|
|
.PP
|
|
\fBRelated Information
|
|
\fR
|
|
.PP
|
|
The \fBxdsh\fR command.
|