xcat-core/xCAT-client/pods/man1/lsslp.1.pod
2010-01-27 02:36:40 +00:00

160 lines
4.4 KiB
Plaintext

=head1 NAME
B<lsslp> - Discovers selected networked services information within the same subnet.
=head1 SYNOPSIS
I<lsslp [-h| --help]>
I<lsslp [-v| --version]>
I<lsslp [-V| --verbose] [-i ip[,ip..]][-w][-r|-x|-z][-n][-s BPA|MM|IVM|RSA|FSP|HMC][-t tries][-m][-e command][-c [timeout[timeout,..]]]>
=head1 DESCRIPTION
The lsslp command discovers selected service types using the -s flag. All service types are returned if the -s flag is not specified. If a specific IP address is not specified using the -i flag, the request is sent out all available network adapters. The optional -r, -x, and -z flags format the output.
NOTE: SLP broadcast requests will propagate only within the subnet of the network adapter broadcast IPs specified by the -i flag.
=head1 OPTIONS
B<-c> Convergence timeout.
A value-list of 32 bit integers used as timeouts, in milliseconds, to
implement the convergence algorithm. Each value specifies the time
to wait before sending the next request, or until nothing new
has been learned from two successive requests. A maximum of 5 comma-
seperated values are allowed. Note that specifying -c with no arguments
will use the timeout values last specified. Not including -c will use
the hardcoded defaults of 500,750,1000,1500,2000 milliseconds.
B<-i> IP(s) the command will send out (defaults to all available adapters).
B<-e> Path and command name of IBM SLP slp_query (defaults to OpenSLP - slptool).
An IBM proprietary implementation of SLP can be also be used.
Contact IBM for details.
B<-h> Display usage message.
B<-m> Multicast mode (defaults to broadcast).
B<-n> Only display and write the newly discovered hardwares.
B<-r> Display Raw SLP response.
B<-s> Service type interested in discovering.
B<-t> Number or service-request attempts.
B<-v> Command Version.
B<-V> Verbose output.
B<-w> Writes output to xCAT database.
B<-x> XML format.
B<-z> Stanza formated output.
=head1 RETURN VALUE
0 The command completed successfully.
1 An error has occurred.
=head1 EXAMPLES
1. To list all discovered HMC service types in tabular format with convergence timeouts of 5000,5000,2000,1000,1000 milliseconds, enter:
lsslp -s HMC -c 5000,5000,2000,1000,1000
Output is similar to:
device type-model serial-number ip-addresses hostname
HMC 7310CR2 103F55A 1.1.1.115 2.2.2.164 3.3.3.102 hmc01
HMC 7310CR2 105369A 3.3.3.103 2.2.2.103 1.1.1.163 hmc02
HMC 7310CR3 KPHHK24 3.3.3.154 2.2.2.110 1.1.1.154 hmc03
2. list all discovered FSP service types in raw response format on subnet 30.0.0.255, enter:
lsslp -i 3.0.0.255 -s FSP -r
Output is similar to:
(type=cec-service-processor),(serial-number=10A3AEB),(machinetype-model=9117-570),(fru-serial-number=YL11C5338102),(hostname=),(frame-number=0),(cage-number=0),(ip-address=3.0.0.94,1.1.1.147),(web-url=https://3.0.0.94:473 ), (slot=1),(bpc-machinetype-model=0),(bpc-serial-number=0),(Image=fips240/b0630a_0623.240)
(type=cec-service-processor),(serial-number=10A3E2B),(machinetype-model=9117-570),(fru-serial- number=YL11C5338250),(hostname=),(frame-number=0),(cage-number=0),(ip-address=3.0.0.95,1.1.1.147), (web-url=https://3.0.0.95:473 ),(slot=1),(bpc-machinetype-model=0),(bpc-serial-number=0),(Image=fips240/b0630a_0623.240)
3. To list all discovered MM service types in XML format and write the output to the xCAT database, enter:
lsslp -s MM -x -w
Output is similar to:
<Node>
<groups>mm,all</groups>
<id>0</id>
<mgt>blade</mgt>
<model>86772XX</model>
<mpa>mm01</mpa>
<node>mm01</node>
<nodetype>mm</nodetype>
<serial>78AG034</serial>
</Node>
4. To list all discovered service types in stanza format and write the output to the xCAT database, enter:
lsslp -z -w
Output is similar to:
mm01:
objtype=node
nodetype=mm
model=86772XX
serial=78AG034
groups=mm,all
mgt=blade
mpa=mm01
id=0
hmc01:
objtype=node
nodetype=hmc
model=7310CR3
serial=KPHHK24
groups=hmc,all
mgt=hmc
mpa=
id=
fsp01:
objtype=node
nodetype=fsp
model=9110-51A
serial=1075EEF
groups=fsp,all
mgt=hmc
mpa=
id=
=head1 FILES
/opt/xcat/bin/lsslp
=head1 SEE ALSO
L<rscan(1)|rscan.1>