suse man page for scsi_allocate_command

SCSI_ALLOCATE_COMMAN(9) 					  SCSI mid layer					   SCSI_ALLOCATE_COMMAN(9)

NAME
       scsi_allocate_command - get a fully allocated SCSI command

SYNOPSIS
       struct scsi_cmnd * scsi_allocate_command(gfp_t gfp_mask);

ARGUMENTS
       gfp_mask
	   allocation mask

DESCRIPTION
       This function is for use outside of the normal host based pools. It allocates the relevant command and takes an additional reference on the
       pool it used. This function *must* be paired with scsi_free_command which also has the identical mask, otherwise the free pool counts will
       eventually go wrong and you'll trigger a bug.

       This function should *only* be used by drivers that need a static command allocation at start of day for internal functions.

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

       Rob Landley <rob@landley.net>
	   Author.

COPYRIGHT
Kernel Hackers Manual 2.6.					     July 2010						   SCSI_ALLOCATE_COMMAN(9)