=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 [<noderange>] [-V| --verbose] [-i ip[,ip..]][-w][-r|-x|-z][-n][-s CEC|FRAME|MM|IVM|RSA|HMC|CMM][-t tries][-I][-C counts][-T timeout][--vpdtable]>


=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, -z and --vpdtable 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<noderange>   The nodes which the user want to discover.
            If the user specify the noderange, lsslp will just return the nodes in 
            the node range. Which means it will help to add the new nodes to the xCAT
            database without modifying the existed definitions. But the nodes' name 
            specified in noderange should be defined in database in advance. The specified
            nodes' type can be frame/cec/hmc/fsp/bpa. If the it is frame or cec, lsslp
            will list the bpa or fsp nodes within the nodes(bap for frame, fsp for cec).
            Please do not use noderange with the flag -s.


B<-i>          IP(s) the command will send out (defaults to all available adapters).

B<-h>          Display usage message.

B<-n>          Only display and write the newly discovered hardwares.

B<-r>          Display Raw SLP response.

B<-C>          The number of the nodes expected to find, specified by the user. 
            When using this flag, lsslp will not return until the it has found all the nodes or time out.
            The default max time is 5 minutes. The user can use -T flag the specify the time they want to use.
            A short time will limite the time costing, while a long time will help to find all the nodes.

B<-T>          The number in seconds to limite the time costing of lsslp. Must be used with the flag -C.
            See the help of flag -C for more details.            


B<-s>          Service type interested in discovering.

B<-t>          Number or service-request attempts.

B<--vpdtable>  Output the SLP response in vpdtable formatting. Easy for writting data to vpd table.

B<-v>          Command Version.

B<-V>          Verbose output.

B<-w>          Writes output to xCAT database.

B<-x>          XML format.

B<-z>          Stanza formated output.

B<-I>          Give the warning message for the nodes in database which have no SLP responses.
            Please note that this flag noly can be used after the database migration finished successfully.


=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, enter:

 lsslp -s HMC

Output is similar to:

 device type-model serial-number ip-addresses   hostname
 HMC    7310CR2    103F55A        1.1.1.115      hmc01
 HMC    7310CR2    105369A        3.3.3.103      hmc02
 HMC    7310CR3    KPHHK24        3.3.3.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 CEC -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>00:14:5E:E0:CB:1E</id>
    <mgt>blade</mgt>
    <mtm>029310C</mtm>
    <node>Server-029310C-SN100485A-A</node>
    <nodetype>mm</nodetype>
    <otherinterfaces>9.114.47.229</otherinterfaces>
    <serial>100485A</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:

c76v1hmc02:
        objtype=node
        hcp=c76v1hmc02
        nodetype=hmc
        mtm=7315CR2
        serial=10407DA
        ip=192.168.200.125
        groups=hmc,all
        mgt=hmc
        mac=00:1a:64:fb:7d:50        
        hidden=0
192.168.200.244:
        objtype=node
        hcp=192.168.200.244
        nodetype=fsp
        mtm=9125-F2A
        serial=0262662
        side=A-0
        otherinterfaces=192.168.200.244
        groups=fsp,all
        mgt=fsp
        id=4
        parent=Server-9125-F2A-SN0262662
        mac=00:1a:64:fa:01:fe
        hidden=1
Server-8205-E6B-SN1074CDP:
        objtype=node
        hcp=Server-8205-E6B-SN1074CDP
        nodetype=cec
        mtm=8205-E6B
        serial=1074CDP
        groups=cec,all
        mgt=fsp
        id=0
        hidden=0
192.168.200.33:
        objtype=node
        hcp=192.168.200.33
        nodetype=bpa
        mtm=9458-100
        serial=99201WM
        side=B-0
        otherinterfaces=192.168.200.33
        groups=bpa,all
        mgt=bpa
        id=0
        mac=00:09:6b:ad:19:90
        hidden=1
Server-9125-F2A-SN0262652:
        objtype=node
        hcp=Server-9125-F2A-SN0262652
        nodetype=frame
        mtm=9125-F2A
        serial=0262652
        groups=frame,all
        mgt=fsp
        id=5
        hidden=0



5. To list all discovered service types in stanza format and display the IP address, enter:

 lsslp -w 

Output is similar to:

 mm01:
    objtype=node
    nodetype=fsp
    mtm=8233-E8B
    serial=1000ECP
    side=A-0
    groups=fsp,all
    mgt=fsp
    id=0
    mac=00:14:5E:F0:5C:FD
    otherinterfaces=50.0.0.5

 bpa01:
    objtype=node
    nodetype=bpa
    mtm=9A01-100
    serial=0P1N746
    side=A-1
    groups=bpa,all
    mgt=bpa
    id=0
    mac=00:1A:64:54:8C:A5
    otherinterfaces=50.0.0.1


6. To list all the CECs, enter:

 lsslp -s CEC 
 
device  type-model  serial-number  side  ip-addresses  hostname
FSP     9117-MMB    105EBEP        A-1   20.0.0.138    20.0.0.138
FSP     9117-MMB    105EBEP        B-1   20.0.0.139    20.0.0.139
CEC     9117-MMB    105EBEP                            Server-9117-MMB-SN105EBEP

 
7. To list all the nodes defined in database which have no SLP response.

  lsslp -I 

Output is similar to:

   Warning: The node Server-8204-E8 has no response.
  
   Warning: The node Server-8203-E4 has no response.
  
  device  type-model  serial-number  side  ip-addresses       hostname
  BPA     9458-100    99201WM        B-1   10.1.255.250       10.1.255.250
  FSP     9125-F2A    0262652        A-0   192.168.200.16     192.168.200.16
  FSP     8233-E8B    1000ECP        A-0   192.168.200.19     192.168.200.19
  CEC     8205-E6B    1040C7P                                 Server-8205-E6B-SN1040C7P

8. To find the nodes within the user specified. Please make sure the noderange input have been defined in xCAT database.

   lsslp CEC1-CEC3
or lsslp CEC1,CEC2,CEC3

  device  type-model  serial-number  side  ip-addresses     hostname
  FSP     9A01-100    0P1P336        A-0   192.168.200.34  192.168.200.34
  FSP     9A01-100    0P1P336        B-0   192.168.200.35  192.168.200.35
  FSP     9A01-100    0P1P336        A-1   50.0.0.27       50.0.0.27
  FSP     9A01-100    0P1P336        B-1   50.0.0.28       50.0.0.28
  CEC     9A01-100    0P1P336                              CEC1
  FSP     8233-E8B    1040C7P        A-0   192.168.200.36  192.168.200.36
  FSP     8233-E8B    1040C7P        B-0   192.168.200.37  192.168.200.37
  FSP     8233-E8B    1040C7P        A-1   50.0.0.29       50.0.0.29
  FSP     8233-E8B    1040C7P        B-1   50.0.0.30       50.0.0.30
  CEC     8233-E8B    1040C7P                              CEC2
  FSP     8205-E6B    1000ECP        A-0   192.168.200.38  192.168.200.38
  FSP     8205-E6B    1000ECP        B-0   192.168.200.39  192.168.200.39
  FSP     8205-E6B    1000ECP        A-1   50.0.0.31       50.0.0.27
  FSP     8205-E6B    1000ECP        B-1   50.0.0.32       50.0.0.28
  CEC     8205-E6B    1000ECP                              CEC3  


9. To list all discovered CMM in stanza format, enter:
   lsslp -s CMM -m -z 

e114ngmm1:
        objtype=node
        mpa=e114ngmm1
        nodetype=cmm
        mtm=98939AX
        serial=102537A
        groups=cmm,all
        mgt=blade
        hidden=0
        otherinterfaces=70.0.0.30
        hwtype=cmm

=head1 FILES

/opt/xcat/bin/lsslp


=head1 SEE ALSO

L<rscan(1)|rscan.1>