[thirdparty/kernel/linux.git] / block / blk-exec.c

// SPDX-License-Identifier: GPL-2.0
/*
 * Functions related to setting various queue properties from drivers
 */
#include <linux/kernel.h>
#include <linux/module.h>
#include <linux/bio.h>
#include <linux/blkdev.h>
#include <linux/blk-mq.h>
#include <linux/sched/sysctl.h>

#include "blk.h"
#include "blk-mq-sched.h"

/**
 * blk_end_sync_rq - executes a completion event on a request
 * @rq: request to complete
 * @error: end I/O status of the request
 */
static void blk_end_sync_rq(struct request *rq, blk_status_t error)
{
	struct completion *waiting = rq->end_io_data;

	rq->end_io_data = NULL;

	/*
	 * complete last, if this is a stack request the process (and thus
	 * the rq pointer) could be invalid right after this complete()
	 */
	complete(waiting);
}

/**
 * blk_execute_rq_nowait - insert a request to I/O scheduler for execution
 * @bd_disk:	matching gendisk
 * @rq:		request to insert
 * @at_head:    insert request at head or tail of queue
 * @done:	I/O completion handler
 *
 * Description:
 *    Insert a fully prepared request at the back of the I/O scheduler queue
 *    for execution.  Don't wait for completion.
 *
 * Note:
 *    This function will invoke @done directly if the queue is dead.
 */
void blk_execute_rq_nowait(struct gendisk *bd_disk, struct request *rq,
			   int at_head, rq_end_io_fn *done)
{
	WARN_ON(irqs_disabled());
	WARN_ON(!blk_rq_is_passthrough(rq));

	rq->rq_disk = bd_disk;
	rq->end_io = done;

	blk_account_io_start(rq);

	/*
	 * don't check dying flag for MQ because the request won't
	 * be reused after dying flag is set
	 */
	blk_mq_sched_insert_request(rq, at_head, true, false);
}
EXPORT_SYMBOL_GPL(blk_execute_rq_nowait);

/**
 * blk_execute_rq - insert a request into queue for execution
 * @bd_disk:	matching gendisk
 * @rq:		request to insert
 * @at_head:    insert request at head or tail of queue
 *
 * Description:
 *    Insert a fully prepared request at the back of the I/O scheduler queue
 *    for execution and wait for completion.
 */
void blk_execute_rq(struct gendisk *bd_disk, struct request *rq, int at_head)
{
	DECLARE_COMPLETION_ONSTACK(wait);
	unsigned long hang_check;

	rq->end_io_data = &wait;
	blk_execute_rq_nowait(bd_disk, rq, at_head, blk_end_sync_rq);

	/* Prevent hang_check timer from firing at us during very long I/O */
	hang_check = sysctl_hung_task_timeout_secs;
	if (hang_check)
		while (!wait_for_completion_io_timeout(&wait, hang_check * (HZ/2)));
	else
		wait_for_completion_io(&wait);
}
EXPORT_SYMBOL(blk_execute_rq);
Commit	Line	Data
3dcf60bc	1	// SPDX-License-Identifier: GPL-2.0
86db1e29 JA	2	/*
	3	* Functions related to setting various queue properties from drivers
	4	*/
	5	#include <linux/kernel.h>
	6	#include <linux/module.h>
	7	#include <linux/bio.h>
	8	#include <linux/blkdev.h>
320ae51f	9	#include <linux/blk-mq.h>
cf4aebc2	10	#include <linux/sched/sysctl.h>
86db1e29 JA	11
86db1e29 JA	12	#include "blk.h"
bd166ef1	13	#include "blk-mq-sched.h"
86db1e29	14
86db1e29 JA	15	/**
	16	* blk_end_sync_rq - executes a completion event on a request
	17	* @rq: request to complete
710027a4	18	* @error: end I/O status of the request
86db1e29	19	*/
2a842aca	20	static void blk_end_sync_rq(struct request *rq, blk_status_t error)
86db1e29 JA	21	{
	22	struct completion *waiting = rq->end_io_data;
	23
	24	rq->end_io_data = NULL;
86db1e29 JA	25
	26	/*
	27	* complete last, if this is a stack request the process (and thus
	28	* the rq pointer) could be invalid right after this complete()
	29	*/
	30	complete(waiting);
	31	}
86db1e29 JA	32
86db1e29 JA	33	/**
8eeed0b5	34	* blk_execute_rq_nowait - insert a request to I/O scheduler for execution
86db1e29 JA	35	* @bd_disk: matching gendisk
	36	* @rq: request to insert
	37	* @at_head: insert request at head or tail of queue
	38	* @done: I/O completion handler
	39	*
	40	* Description:
710027a4	41	* Insert a fully prepared request at the back of the I/O scheduler queue
86db1e29	42	* for execution. Don't wait for completion.
e81ca6fe MR	43	*
	44	* Note:
	45	* This function will invoke @done directly if the queue is dead.
86db1e29	46	*/
8eeed0b5 GJ	47	void blk_execute_rq_nowait(struct gendisk bd_disk, struct request rq,
8eeed0b5 GJ	48	int at_head, rq_end_io_fn *done)
86db1e29	49	{
8ba61435	50	WARN_ON(irqs_disabled());
57292b58	51	WARN_ON(!blk_rq_is_passthrough(rq));
e81ca6fe MR	52
	53	rq->rq_disk = bd_disk;
	54	rq->end_io = done;
320ae51f	55
b5af37ab	56	blk_account_io_start(rq);
48d9b0d4	57
43a5e4e2 ML	58	/*
43a5e4e2 ML	59	* don't check dying flag for MQ because the request won't
68bdf1ac	60	* be reused after dying flag is set
43a5e4e2	61	*/
a1ce35fa	62	blk_mq_sched_insert_request(rq, at_head, true, false);
86db1e29 JA	63	}
	64	EXPORT_SYMBOL_GPL(blk_execute_rq_nowait);
	65
	66	/**
	67	* blk_execute_rq - insert a request into queue for execution
86db1e29 JA	68	* @bd_disk: matching gendisk
	69	* @rq: request to insert
	70	* @at_head: insert request at head or tail of queue
	71	*
	72	* Description:
710027a4	73	* Insert a fully prepared request at the back of the I/O scheduler queue
86db1e29 JA	74	* for execution and wait for completion.
86db1e29 JA	75	*/
684da762	76	void blk_execute_rq(struct gendisk bd_disk, struct request rq, int at_head)
86db1e29 JA	77	{
86db1e29 JA	78	DECLARE_COMPLETION_ONSTACK(wait);
4b197769	79	unsigned long hang_check;
86db1e29	80
86db1e29	81	rq->end_io_data = &wait;
8eeed0b5	82	blk_execute_rq_nowait(bd_disk, rq, at_head, blk_end_sync_rq);
4b197769 ML	83
	84	/* Prevent hang_check timer from firing at us during very long I/O */
	85	hang_check = sysctl_hung_task_timeout_secs;
	86	if (hang_check)
5577022f	87	while (!wait_for_completion_io_timeout(&wait, hang_check * (HZ/2)));
4b197769	88	else
5577022f	89	wait_for_completion_io(&wait);
86db1e29	90	}
86db1e29	91	EXPORT_SYMBOL(blk_execute_rq);