Login or Register to Ask a Question and Join Our Community

Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

fc_remote_port_add(9) [suse man page]

FC_REMOTE_PORT_ADD(9)						  SCSI mid layer					     FC_REMOTE_PORT_ADD(9)

NAME

       fc_remote_port_add - notify fc transport of the existence of a remote FC port.

SYNOPSIS

       struct fc_rport * fc_remote_port_add(struct Scsi_Host * shost, int channel, struct fc_rport_identifiers * ids);

ARGUMENTS

       shost
	   scsi host the remote port is connected to.

       channel
	   Channel on shost port connected to.

       ids
	   The world wide names, fc address, and FC4 port roles for the remote port.

DESCRIPTION

       The LLDD calls this routine to notify the transport of the existence of a remote port. The LLDD provides the unique identifiers (wwpn,wwn)
       of the port, it's FC address (port_id), and the FC4 roles that are active for the port.

       For ports that are FCP targets (aka scsi targets), the FC transport maintains consistent target id bindings on behalf of the LLDD. A
       consistent target id binding is an assignment of a target id to a remote port identifier, which persists while the scsi host is attached.
       The remote port can disappear, then later reappear, and it's target id assignment remains the same. This allows for shifts in FC addressing
       (if binding by wwpn or wwnn) with no apparent changes to the scsi subsystem which is based on scsi host number and target id values.
       Bindings are only valid during the attachment of the scsi host. If the host detaches, then later re-attaches, target id bindings may
       change.

       This routine is responsible for returning a remote port structure. The routine will search the list of remote ports it maintains internally
       on behalf of consistent target id mappings. If found, the remote port structure will be reused. Otherwise, a new remote port structure will
       be allocated.

       Whenever a remote port is allocated, a new fc_remote_port class device is created.

       Should not be called from interrupt context.

NOTES

       This routine assumes no locks are held on entry.

AUTHORS

       James Bottomley <James.Bottomley@hansenpartnership.com>
	   Author.

       Rob Landley <rob@landley.net>
	   Author.

COPYRIGHT

Kernel Hackers Manual 2.6.					     July 2010						     FC_REMOTE_PORT_ADD(9)

Check Out this Related Man Page

libssh2_channel_forward_listen_ex(3)				  libssh2 manual			      libssh2_channel_forward_listen_ex(3)

NAME

       libssh2_channel_forward_listen_ex - listen to inbound connections

SYNOPSIS

       #include <libssh2.h>

       LIBSSH2_LISTENER * libssh2_channel_forward_listen_ex(LIBSSH2_SESSION *session, char *host, int port, int *bound_port, int queue_maxsize);

       LIBSSH2_LISTENER * libssh2_channel_forward_listen(LIBSSH2_SESSION *session, int port);

DESCRIPTION

       Instruct  the  remote  SSH  server  to  begin listening for inbound TCP/IP connections. New connections will be queued by the library until
       accepted by libssh2_channel_forward_accept(3).

       session - instance as returned by libssh2_session_init().

       host - specific address to bind to on the remote host. Binding to 0.0.0.0 (default  when  NULL  is  passed)  will  bind	to  all  available
       addresses.

       port - port to bind to on the remote host. When 0 is passed, the remote host will select the first available dynamic port.

       bound_port - Populated with the actual port bound on the remote host. Useful when requesting dynamic port numbers.

       queue_maxsize - Maximum number of pending connections to queue before rejecting further attempts.

       libssh2_channel_forward_listen(3) is a macro.

RETURN VALUE

       A newly allocated LIBSSH2_LISTENER instance or NULL on failure.

ERRORS

       LIBSSH2_ERROR_ALLOC - An internal memory allocation call failed.

       LIBSSH2_ERROR_SOCKET_SEND - Unable to send data on socket.

       LIBSSH2_ERROR_PROTO - An invalid SSH protocol response was received on the socket.

       LIBSSH2_ERROR_REQUEST_DENIED - The remote server refused the request.

       LIBSSH2_ERROR_EAGAIN - Marked for non-blocking I/O but the call would block.

SEE ALSO

       libssh2_channel_forward_accept(3)

libssh2 0.15							    1 Jun 2007				      libssh2_channel_forward_listen_ex(3)
Man Page