HBA_SendSRL man page on Solaris

Man page or keyword search:  
man Server   20652 pages
apropos Keyword Search (all sections)
Output format
Solaris logo
[printable version]

HBA_SendRLS(CommonIFibre Channel HBA Information Library FHBA_SendRLS(3HBAAPI)

NAME
       HBA_SendRLS,  HBA_SendRPL,  HBA_SendRPS,	 HBA_SendSRL,  HBA_SendLIRR  -
       issue an Extended Link Service through the local HBA Port

SYNOPSIS
       cc [ flag... ] file... -lHBAAPI [ library... ]
       #include <hbaapi.h>

       HBA_STATUS  HBA_SendRLS(HBA_HANDLE handle, HBA_WWN hbaPortWWN,  HBA_WWN
       destWWN, void * pRspBuffer, HBA_UINT32 *pRspBufferSize);

       HBA_STATUS  HBA_SendRPL(HBA_HANDLE  handle, HBA_WWN hbaPortWWN, HBA_WWN
       agentWWN, HBA_UINT32 agent_domain, HBA_UINT32 portIndex, void  *	 pRsp‐
       Buffer, HBA_UINT32 *pRspBufferSize);

       HBA_STATUS  HBA_SendRPS(HBA_HANDLE  handle, HBA_WWN hbaPortWWN, HBA_WWN
       agentWWN,  HBA_UINT32  agent_domain,  HBA_WWN  object_wwn,   HBA_UINT32
       object_port_number, void * pRspBuffer, HBA_UINT32 *pRspBufferSize);

       HBA_STATUS  HBA_SendSRL(HBA_HANDLE  handle, HBA_WWN hbaPortWWN, HBA_WWN
       wwn, HBA_UINT32 domain, void * pRspBuffer, HBA_UINT32 *pRspBufferSize);

       HBA_STATUS HBA_SendLIRR(HBA_HANDLE handle, HBA_WWN hbaPortWWN,  HBA_WWN
       destWWN,	  HBA_UINT8  function,	HBA_UINT8  type,  void	*  pRspBuffer,
       HBA_UINT32 *pRspBufferSize);

PARAMETERS
       handle	       an open handle returned from HBA_OpenAdapter(3HBAAPI)

       hbaPortWWN
		       HBA_SendRLS()

			   the Port WWN of the local HBA through which to send
			   the RLS

		       HBA_SendRPL()

			   the Port WWN of the local HBA through which to send
			   the RPL

		       HBA_SendRPS()

			   the Port WWN of the local HBA through which to send
			   the RPS

		       HBA_SendSRL()

			   the Port WWN of the local HBA through which to send
			   the SRL

		       HBA_SendLIRR()

			   the Port WWN of the local HBA through which to send
			   the LIRR

       destWWN
		       HBA_SendRLS()

			   the	Port WWN of the remote Target to which the RLS
			   is sent

		       HBA_SendLIRR()

			   he Port WWN of the remote Target to which the  LIRR
			   is sent

       wwn	       If non-zero, wwn is the port WWN to be scanned.	If wwn
		       is zero, it is ignored.

       domain	       If wwn is zero, domain is the domain number  for	 which
		       loops  will  be scanned.	 If wwn is non-zero, domain is
		       ignored.

       agent_wwn       If non-zero, agent_wwn is the port WWN  for  which  the
		       port  list  is  requested.  If agent_wwn is zero, it is
		       ignored.

       agent_domain    If agent_wwn is non-zero, agent_domain  is  the	domain
		       number  and  the	 domain	 controller for which the port
		       list  is	 requested.   If  agent_wwn  is	 zero,	it  is
		       ignored.

       port_index      index  of  the  first  FC_Port returned in the response
		       list

       object_wwn      If non-zero, object_wwn is the port WWN for  which  the
		       Port Status is requested.  If object_wwn is zero, it is
		       ignored.

       object_port_numbIf object_wwn is zero, object_port_number is the	 rela‐
		       tive port number of the FC_Port for which the Port Sta‐
		       tus  is	requested.    If   object_wwn	is   non-zero,
		       object_port_number is ignored.

       function	       the registration function to be performed

       type	       If  type	 is non-zero, the type is the FC-4 device TYPE
		       for which specific link incident information  requested
		       is  requested.  If type is zero, only common link inci‐
		       dent information is requested.

       pRspBuffer
		       HBA_SendRLS()

			   a pointer to a buffer into which the	 RLS  response
			   is copied

		       HBA_SendRPL()

			   a  pointer  to a buffer into which the RPL response
			   is copied

		       HBA_SendRPS()

			   a pointer to a buffer into which the	 RPS  response
			   is copied

		       HBA_SendSRL()

			   a  pointer  to a buffer into which the SRL response
			   is copied

		       HBA_SendLIRR()

			   A pointer to a buffer into which  the  LIRRresponse
			   is copied.

       RspBufferSize   a pointer to the size of the buffer

		       HBA_SendRLS()
		       HBA_SendLIRR()

			   A   size  of	 28  is	 sufficient  for  the  largest
			   response.

		       HBA_SendRPS()

			   A  size  of	58  is	sufficient  for	 the   largest
			   response.

		       HBA_SendSRL()

			   A size of 8 is sufficient for the largest response.

DESCRIPTION
       The  HBA_SendRLS() function returns the Link Error Status Block associ‐
       ated with the agent WWN or  agent-domain.   For	more  information  see
       "Read Link Status Block (RLS)" in FC-FS.

       The  HBA_SendRPL()  function returns the Read Port List associated with
       the agent WWN or agent-domain.  For more	 information  see  "Read  Port
       List (RPL)" in FC-FS.

       The  HBA_SendRPS()  function returns the Read Port Status Block associ‐
       ated with the agent WWN or  agent-domain.   For	more  information  see
       "Read Port Status Block(RPS)" in FC-FS.

       The HBA_SendSRL() function returns the Scan Remote Loop associated with
       the agent WWN or agent-domain.  For more information see	 "Scan	Remote
       Loop(SRL)" in FC-FS.

       The  HBA_SendLIRR() function returns the Link Incident Record Registra‐
       tion associated with the destportWWN.  For more information  see	 "Link
       Incident Record Registration (LIRR) in FC-FS.

RETURN VALUES
       These functions return the following values:

       HBA_STATUS_OK

	   The LS_ACC for the ELS has been returned.

       HBA_STATUS_ERROR_ELS_REJECT

	   The ELS has been rejeced by the local HBA Port.

       HBA_STATUS_ERROR_ILLEGAL_WWN

	   The	value  of  hbaPortWWN is not a valid port WWN on the specified
	   HBA.

       HBA_STATUS_ERROR

	   An error occurred.

ATTRIBUTES
       See attributes(5) for descriptions of the following attributes:

       ┌─────────────────────────────┬─────────────────────────────┐
       │      ATTRIBUTE TYPE	     │	    ATTRIBUTE VALUE	   │
       ├─────────────────────────────┼─────────────────────────────┤
       │Interface Stability	     │Standard: FC-MI  1.92  (API  │
       │			     │version 1)		   │
       ├─────────────────────────────┼─────────────────────────────┤
       │			     │Standard:	 FC-HBA Version 4  │
       │			     │(API version 2)		   │
       ├─────────────────────────────┼─────────────────────────────┤
       │MT-Level		     │Safe			   │
       └─────────────────────────────┴─────────────────────────────┘

SEE ALSO
       HBA_OpenAdapter(3HBAAPI), libhbaapi(3LIB), attributes(5)

       T11 FC-MI Specification

SunOS 5.10			  1 Sep 2003		  HBA_SendRLS(3HBAAPI)
[top]

List of man pages available for Solaris

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net