From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from 003.mia.mailroute.net (003.mia.mailroute.net [199.89.3.6]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id AC18332A3C1 for ; Wed, 24 Sep 2025 20:32:28 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=199.89.3.6 ARC-Seal:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1758745950; cv=none; b=m6Z/kJl6JofgYNAcBHXGrOxh/E28yxM1GgiOtL05trqD8McA1klSmFb7lncet7PgN3ZfD6lkTZvVJb0btEZoTPUvC/p9b9NdtmTMC0QlCeQO9PwiKcHh6pqkVb93Wf2QOniTxDYaqVQmjeeoEvUb8Lhyi8a7q8nLEhuLkFXQ0rI= ARC-Message-Signature:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1758745950; c=relaxed/simple; bh=WoSYAdAHQZa9v9sY2C+CXzniHGMy4segWKUrDbCzT2w=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version; b=NQrBkNL6mOVtctTUbYQr7yjM+gNQDFkT6qRkw5uhQY96VvdSvrxFSRF93RWTzegGCM6GxXINqFIQvpGNv5zJTzoJpBi2U1dWUiHj7sTgsBtLQbATij4LIKz1/8BHV2NXLockXc7FKkpxIvwF+lN0hzWZYgZPXPTRAwsm+vOsH+A= ARC-Authentication-Results:i=1; smtp.subspace.kernel.org; dmarc=pass (p=reject dis=none) header.from=acm.org; spf=pass smtp.mailfrom=acm.org; dkim=pass (2048-bit key) header.d=acm.org header.i=@acm.org header.b=hIAVCwIb; arc=none smtp.client-ip=199.89.3.6 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=reject dis=none) header.from=acm.org Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=acm.org Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=acm.org header.i=@acm.org header.b="hIAVCwIb" Received: from localhost (localhost [127.0.0.1]) by 003.mia.mailroute.net (Postfix) with ESMTP id 4cX7nR5LRVzlgqxw; Wed, 24 Sep 2025 20:32:27 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=acm.org; h= content-transfer-encoding:mime-version:references:in-reply-to :x-mailer:message-id:date:date:subject:subject:from:from :received:received; s=mr01; t=1758745946; x=1761337947; bh=/0uH6 Mg1oVA94fPvdiHGsnKXfgHRCoeKz48RrN+YGGg=; b=hIAVCwIbeSm3kpT9rsnFX Se5s/ccSaFCOv78NN+CDSwkXMhXvUrY00nHPJ1eYjzXgyDPIV7dQkc0Lt5HZuNyz CGDqdrO3GdE3JcpX0NpJNP+JBzlaUl2eiA4lei7fnGxdjKIlJ0lUHGjlKJX9/ona uYlNRCKD3aju8ElTYbYdA+Z3/1CQfAkpg+QC8HXBczdWwXqsnxUx54zx6O/QBOF8 5fU4tWlCk+qLU4sMISTujcXm3pV8ATC6l7YQfcfvxRBxvfSmxRMd3ik9nhXtsvXa 54Y7AscPn53jHCU81+7yvALaVvKvPlCXzmfVD9uLuiqhQ3MUvoCMU4DifAwi0k83 Q== X-Virus-Scanned: by MailRoute Received: from 003.mia.mailroute.net ([127.0.0.1]) by localhost (003.mia [127.0.0.1]) (mroute_mailscanner, port 10029) with LMTP id LE4wxbq35Aml; Wed, 24 Sep 2025 20:32:26 +0000 (UTC) Received: from bvanassche.mtv.corp.google.com (unknown [104.135.180.219]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (2048 bits) server-digest SHA256) (No client certificate requested) (Authenticated sender: bvanassche@acm.org) by 003.mia.mailroute.net (Postfix) with ESMTPSA id 4cX7nL3Qhxzlh3sc; Wed, 24 Sep 2025 20:32:21 +0000 (UTC) From: Bart Van Assche To: "Martin K . Petersen" Cc: linux-scsi@vger.kernel.org, Bart Van Assche , Hannes Reinecke , John Garry , "James E.J. Bottomley" Subject: [PATCH v5 06/28] scsi: core: Add scsi_{get,put}_internal_cmd() helpers Date: Wed, 24 Sep 2025 13:30:25 -0700 Message-ID: <20250924203142.4073403-7-bvanassche@acm.org> X-Mailer: git-send-email 2.51.0.536.g15c5d4f767-goog In-Reply-To: <20250924203142.4073403-1-bvanassche@acm.org> References: <20250924203142.4073403-1-bvanassche@acm.org> Precedence: bulk X-Mailing-List: linux-scsi@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable From: Hannes Reinecke Add helper functions to allow LLDDs to allocate and free internal command= s. Cc: John Garry Signed-off-by: Hannes Reinecke [ bvanassche: changed the 'nowait' argument into a 'flags' argument / added scsi_get_internal_cmd_hctx(). See also https://lore.kernel.org/linux-scsi/20211125151048.103910-3-hare@suse.de= / ] Signed-off-by: Bart Van Assche --- drivers/scsi/scsi_lib.c | 79 ++++++++++++++++++++++++++++++++++++++ include/scsi/scsi_device.h | 7 ++++ 2 files changed, 86 insertions(+) diff --git a/drivers/scsi/scsi_lib.c b/drivers/scsi/scsi_lib.c index 868013cb1f46..b25677e967d4 100644 --- a/drivers/scsi/scsi_lib.c +++ b/drivers/scsi/scsi_lib.c @@ -1247,6 +1247,17 @@ struct request *scsi_alloc_request(struct request_= queue *q, blk_opf_t opf, } EXPORT_SYMBOL_GPL(scsi_alloc_request); =20 +static struct request *scsi_alloc_request_hctx(struct request_queue *q, + blk_opf_t opf, blk_mq_req_flags_t flags, unsigned int hctx_idx) +{ + struct request *rq; + + rq =3D blk_mq_alloc_request_hctx(q, opf, flags, hctx_idx); + if (!IS_ERR(rq)) + scsi_initialize_rq(rq); + return rq; +} + /* * Only called when the request isn't completed by SCSI, and not freed b= y * SCSI @@ -2134,6 +2145,74 @@ void scsi_mq_free_tags(struct kref *kref) complete(&shost->tagset_freed); } =20 +/** + * scsi_get_internal_cmd() - Allocate an internal SCSI command. + * @sdev: SCSI device from which to allocate the command + * @data_direction: Data direction for the allocated command + * @flags: request allocation flags, e.g. BLK_MQ_REQ_RESERVED or + * BLK_MQ_REQ_NOWAIT. + * + * Allocates a SCSI command for internal LLDD use. + */ +struct scsi_cmnd *scsi_get_internal_cmd(struct scsi_device *sdev, + enum dma_data_direction data_direction, + blk_mq_req_flags_t flags) +{ + enum req_op op =3D data_direction =3D=3D DMA_TO_DEVICE ? REQ_OP_DRV_OUT= : + REQ_OP_DRV_IN; + struct scsi_cmnd *scmd; + struct request *rq; + + rq =3D scsi_alloc_request(sdev->request_queue, op, flags); + if (IS_ERR(rq)) + return NULL; + scmd =3D blk_mq_rq_to_pdu(rq); + scmd->device =3D sdev; + + return scmd; +} +EXPORT_SYMBOL_GPL(scsi_get_internal_cmd); + +/** + * scsi_get_internal_cmd_hctx() - Allocate an internal SCSI command from= a given + * hardware queue. + * @sdev: SCSI device from which to allocate the command + * @data_direction: Data direction for the allocated command + * @flags: request allocation flags, e.g. BLK_MQ_REQ_RESERVED or + * BLK_MQ_REQ_NOWAIT. + * @hctx_idx: Hardware queue index. + * + * Allocates a SCSI command for internal LLDD use. + */ +struct scsi_cmnd *scsi_get_internal_cmd_hctx(struct scsi_device *sdev, + enum dma_data_direction data_direction, + blk_mq_req_flags_t flags, unsigned int hctx_idx) +{ + enum req_op op =3D data_direction =3D=3D DMA_TO_DEVICE ? REQ_OP_DRV_OUT= : + REQ_OP_DRV_IN; + struct scsi_cmnd *scmd; + struct request *rq; + + rq =3D scsi_alloc_request_hctx(sdev->request_queue, op, flags, hctx_idx= ); + if (IS_ERR(rq)) + return NULL; + scmd =3D blk_mq_rq_to_pdu(rq); + scmd->device =3D sdev; + + return scmd; +} +EXPORT_SYMBOL_GPL(scsi_get_internal_cmd_hctx); + +/** + * scsi_put_internal_cmd() - Free an internal SCSI command. + * @scmd: SCSI command to be freed + */ +void scsi_put_internal_cmd(struct scsi_cmnd *scmd) +{ + blk_mq_free_request(blk_mq_rq_from_pdu(scmd)); +} +EXPORT_SYMBOL_GPL(scsi_put_internal_cmd); + /** * scsi_device_from_queue - return sdev associated with a request_queue * @q: The request queue to return the sdev from diff --git a/include/scsi/scsi_device.h b/include/scsi/scsi_device.h index 3846f5dfc51c..1d83b17d95e6 100644 --- a/include/scsi/scsi_device.h +++ b/include/scsi/scsi_device.h @@ -558,6 +558,13 @@ int scsi_execute_cmd(struct scsi_device *sdev, const= unsigned char *cmd, const struct scsi_exec_args *args); void scsi_failures_reset_retries(struct scsi_failures *failures); =20 +struct scsi_cmnd *scsi_get_internal_cmd(struct scsi_device *sdev, + enum dma_data_direction data_direction, + blk_mq_req_flags_t flags); +struct scsi_cmnd *scsi_get_internal_cmd_hctx(struct scsi_device *sdev, + enum dma_data_direction data_direction, + blk_mq_req_flags_t flags, unsigned int hctx_idx); +void scsi_put_internal_cmd(struct scsi_cmnd *scmd); extern void sdev_disable_disk_events(struct scsi_device *sdev); extern void sdev_enable_disk_events(struct scsi_device *sdev); extern int scsi_vpd_lun_id(struct scsi_device *, char *, size_t);