fc_remove_host(9) [suse man page]

FC_REMOVE_HOST(9)						  SCSI mid layer						 FC_REMOVE_HOST(9)

NAME

       fc_remove_host - called to terminate any fc_transport-related elements for a scsi host.

SYNOPSIS

       void fc_remove_host(struct Scsi_Host * shost);

ARGUMENTS

       shost
	   Which Scsi_Host

DESCRIPTION

       This routine is expected to be called immediately preceeding the a driver's call to scsi_remove_host.

WARNING

       A driver utilizing the fc_transport, which fails to call this routine prior to scsi_remove_host, will leave dangling objects in
       /sys/class/fc_remote_ports. Access to any of these objects can result in a system crash !!!

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_REMOVE_HOST(9)

scsi_hba_init(9F)					   Kernel Functions for Drivers 					 scsi_hba_init(9F)

NAME

       scsi_hba_init, scsi_hba_fini - SCSI Host Bus Adapter system initialization and completion routines

SYNOPSIS

       #include <sys/scsi/scsi.h>

       int scsi_hba_init(struct modlinkage *modlp);

       void scsi_hba_fini(struct modlinkage *modlp);

INTERFACE LEVEL

       Solaris architecture specific (Solaris DDI).

PARAMETERS

       modlp	       Pointer to the Host Bus Adapters module linkage structure.

DESCRIPTION

   scsi_hba_init()
       scsi_hba_init()	is the system-provided initialization routine for SCSI HBA drivers.  The scsi_hba_init() function registers the HBA in the
       system and allows the driver to accept configuration requests on behalf of SCSI target drivers. The scsi_hba_init() routine must be  called
       in  the HBA's _init(9E) routine before mod_install(9F) is called. If mod_install(9F) fails, the HBA's _init(9E) should call scsi_hba_fini()
       before returning failure.

   scsi_hba_fini()
       scsi_hba_fini() is the system provided completion routine for SCSI HBA drivers. scsi_hba_fini() removes all of the  system  references  for
       the HBA that were created in scsi_hba_init(). The scsi_hba_fini() routine should be called in the HBA's _fini(9E) routine if mod_remove(9F)
       is successful.

RETURN VALUES

       scsi_hba_init() returns 0 if successful, and a non-zero value otherwise. If scsi_hba_init() fails, the HBA's  _init()  entry  point  should
       return the value returned by scsi_hba_init().

CONTEXT

       scsi_hba_init() and scsi_hba_fini() should be called from _init(9E) or _fini(9E), respectively.

SEE ALSO

       _fini(9E), _init(9E), mod_install(9F), mod_remove(9F), scsi_pktalloc(9F), scsi_pktfree(9F), scsi_hba_tran(9S)

       Writing Device Drivers

NOTES

       The  HBA  is  responsible for ensuring that no DDI request routines are called on behalf of its SCSI target drivers once scsi_hba_fini() is
       called.

SunOS 5.10							    1 Nov 1993							 scsi_hba_init(9F)